QA: v0.1.9 Linux

[rudolfs]

Prerequisites

• [x] Make sure you are installing into an environment with no old configuration and no user data ℹ️
• [x] Make sure you have configured your name and email in git ℹ️
• [x] Download the binary package
• [x] Install Upstream from the downloaded package ℹ️
  • [ ] macOS Gatekeeper does not show the following message: macOS cannot verify that this app is free from malware

QA checklist

Packaging

• [x] App icon is shown correctly
  • macOS:
  • [ ] Dock
  • [ ] ⌘ + tab task switcher
  • [ ] Mounted dmg
  • [ ] App icon
  • Linux:
  • [x] Dock
  • [x] Menu bar

Onboarding

• [x] Start Upstream
  • on Linux: run PATH_TO_DOWNLOAD>/radicle-upstream-0.1.9.AppImage by executing it from the terminal or clicking on it
  • on macOS: run /Applications/Radicle Upstream.app by double clicking it
• [x] Onboarding starts on the Get started screen
• [x] Pressing enter leads to the next screen
• [x] Using $$ as the Display name shows a validation error
• [x] Entering two different passphrases shows a validation error
• [x] On the All set! screen clicking the Device ID copies it to the clipboard
• [x] Clicking the Go to my projects button leads to the Profile screen
• [x] Hovering the network icon in the sidebar shows You're connected to 1 peer

Creating projects

• [ ] Can create a new project with a new repository
  • [ ] Using %% for the project name shows a validation error
  • [ ] A placeholder is shown for the missing README.md
• [ ] Can create a new project from a larger existing repository
  • [ ] UI interaction is blocked while project creation is in progress
  • [ ] README.md files are shown by default and markdown is rendered as HTML
  • [ ] Links to external resources open in external browser
  • [ ] Links to internal resources don't do anything
  • [ ] Syntax highlighting works for source files (.toml, .sol, .ts, .svelte)
  • [ ] Binary files show a placeholder
  • [ ] It's possible to navigate to deeper hierarchies via the tree browser
  • [ ] It's possible to select different branches
  • [ ] Metadata and stats in UI reflect what is in the actual repository ℹ️
  • [ ] Commit tab shows a list of all the commits in the branch that was selected
  • [ ] Clicking on a commit shows the commit metadata as well as the diff
• [ ] No unreleased features are visible in the UI
  • [ ] Issues and Revisions tabs on the Project screen
  • [ ] Wallets tab on the User Profile screen
  • [ ] Tags are not visible in the revision selector on the Project Source screen

Settings

• [ ] Links to external help resources open in an external browser
• [ ] All documented shortcuts work. Press ? to open the Keyboard shortcuts help screen.
  • [ ] Only one modal is allowed at a time (no modal stacking possible)
  • [ ] Design Sytem Guide is not listed in the shortcuts modal ? and the respective global hotkey is disabled ⌘+d
• [ ] The version number in the Settings screen matches:
  • [ ] The version number in the package filename
  • [ ] The version number in the About Radicle Upstream dialog

Replicating projects

• [ ] Replicate a project from seedling.radicle.xyz
  • [ ] Pick a project from seedling.radicle.xyz and search for it by pasting the Radicle ID of the project into the search bar by pressing ⌘+p, then click the Follow button
  • [ ] The project shows up in the Following tab of the profile screen in the waiting area
  • [ ] After a while the project is replicated and moves out of the waiting area
  • [ ] When going to the Project source screen, the maintainer is selected in the peer selector
    • [ ] Your identity does not show up in the peer selector
  • [ ] Set up the remote helper according to the instructions in the Fork modal hint
  • [ ] Fork the replicated project to a local directory
  • [ ] The forked project should now appear in the Projects tab of the profile screen
  • [ ] Your identity shows up in the peer selector and is selected by default instead of the maintainer's identity
  • [ ] The button is now called Checkout instead of Fork
  • [ ] Create a commit and publish your chages via git rad push
    • [ ] The published commit appears in the Commits tab of the project
  • [ ] Add a remote that doesn't track the project, e.g. hync6jo9q9n4rfgag3o99gann391nsjhuq3oaemoe13oyn3gruwrgh
  • [ ] Shows the remote in the Still looking… section
  • [ ] Clicking the Unfollow button removes the remote

Lifecycle

• [ ] Preferences are persisted across app reboots
  • [ ] Color theme selection
  • [ ] Network seed changes
  • [ ] Remote helper hint (in the Checkout and "New project" modals) is not shown after app restart once it is dismissed by clicking the x icon in the top right corner
• [ ] Killing the proxy process while the app is running shows a blue error screen with the proxy logs
  • [ ] Clicking the button copies the logs to the clipboard

Hints

How to set up a clean environemnt? 🔗

Safe method: use a temporary user account on your computer.

• on macOS:
  • if you are not using FileVault, switch to the "Guest User". You may have to enable this in "System Preferences -> Users & Groups". When you're done, all data will be removed automatically.
  • if you are using FileVault, create a new user in "System Preferences -> Users & Groups". When you're done, you'll need to remove this user manually.
• on Linux:
  • create a new user with sudo useradd -m qa, and log into that account. When you're done, remove the user with sudo userdel -r qa. Note: "qa" is just an example user name, you can choose anything you like

Dangerous method: remove all directories manually.

You can use this script. Make sure you have a backup of your data, or are using this in combination with the safe method (i.e. while logged in with a temporary user account).

How to set up git? 🔗

git config --global user.name "Mona Lisa"
git config --global user.email "email@example.com"

How to install? 🔗

On macOS:

1. open the radicle-upstream-0.1.9.dmg package
2. install Upstream by dragging the Radicle Upstream binary to /Applications

On Linux (AppImage):

1. chmod +x <PATH_TO_DOWNLOAD>/radicle-upstream-0.1.9.AppImage

How to query repo stats from the CLI? 🔗

  # local branch count
  git branch | wc -l

  # all unique contributors across all branches
  git shortlog --summary --numbered --email --all

  # all unique contributors in a specific branch
  git shortlog --summary --numbered --email myfunkybranch

  # unique commit count across all branches
  git rev-list --all --count

  # commit count in a specific branch
  git rev-list --count myfunkybranch

[rudolfs]

Did a smoke test to see if the app onboards, skipping the rest of the QA because this is a minor release and it passed on macOS.