QA: v0.1.10 macOS

[NunoAlexandre]

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 Linux or macOS binary package
• [x] Install Upstream from the downloaded package ℹ️
  • [x] 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:
  • [x] Dock
  • [x] ⌘ + tab task switcher
  • [x] Mounted dmg
  • [x] App icon
  • Linux:
  • [ ] Dock
  • [ ] Menu bar

Onboarding

• [x] Start Upstream
  • on Linux: run PATH_TO_DOWNLOAD>/radicle-upstream-0.1.10.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

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

Settings

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

Replicating projects

• [x] Replicate a project from seedling.radicle.xyz
  • [x] 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
  • [x] The project shows up in the Following tab of the profile screen in the waiting area
  • [x] After a while the project is replicated and moves out of the waiting area
  • [x] When going to the Project source screen, the maintainer is selected in the peer selector
    • [x] Your identity does not show up in the peer selector
  • [x] Set up the remote helper according to the instructions in the Fork modal hint
  • [x] Fork the replicated project to a local directory
  • [x] The forked project should now appear in the Projects tab of the profile screen
  • [x] Your identity shows up in the peer selector and is selected by default instead of the maintainer's identity
  • [x] The button is now called Checkout instead of Fork
  • [x] Create a commit and publish your chages via git rad push
    • [x] The published commit appears in the Commits tab of the project
  • [x] Add a remote that doesn't track the project, e.g. hync6jo9q9n4rfgag3o99gann391nsjhuq3oaemoe13oyn3gruwrgh
  • [x] Shows the remote in the Still looking… section
  • [x] Clicking the Unfollow button removes the remote

Lifecycle

• [x] Preferences are persisted across app reboots
  • [x] Color theme selection
  • [x] Network seed changes
  • [x] 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
• [x] Killing the proxy process while the app is running shows a blue error screen with the proxy logs
  • [x] 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.10.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.10.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]

QA passed.