Add installer unit tests

Author: code-asher

.github/workflows/scripts.yml

@@ -0,0 +1,27 @@
+name: Script unit tests
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "*.sh"
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  centos:
+    name: Run script unit tests
+    runs-on: ubuntu-latest
+    # This runs on Alpine to make sure we're testing with actual sh.
+    container: "alpine:3.14"
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v2
+
+      - name: Install bats
+        run: apk add bats
+
+      - name: Install code-server
+        run: yarn test:scripts

ci/dev/test-scripts.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+main() {
+  cd "$(dirname "$0")/../.."
+  bats ./test/scripts
+}
+
+main "$@"

docs/CONTRIBUTING.md

@@ -54,6 +54,8 @@ There are several differences, however. Here is what is needed:
   - `apt-get install -y build-essential` - used by VS Code
 - `rsync` and `unzip`
   - used for code-server releases
+- `bats`
+  - used to run script unit tests
 
 ## Development Workflow
 

package.json

@@ -20,6 +20,7 @@
     "test:e2e": "./ci/dev/test-e2e.sh",
     "test:standalone-release": "./ci/build/test-standalone-release.sh",
     "test:unit": "./ci/dev/test-unit.sh",
+    "test:scripts": "./ci/dev/test-scripts.sh",
     "package": "./ci/build/build-packages.sh",
     "postinstall": "./ci/dev/postinstall.sh",
     "update:vscode": "./ci/dev/update-vscode.sh",

test/scripts/install.bats

@@ -0,0 +1,139 @@
+#!/usr/bin/env bats
+
+SCRIPT_NAME="install.sh"
+SCRIPT="$BATS_TEST_DIRNAME/../../$SCRIPT_NAME"
+
+function should-use-deb() {
+  DISTRO=$1 ARCH=$2 OS=linux run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  echo "${lines[1]}"
+  [[ "${lines[1]}" = "Installing v"*" of the $2 deb package from GitHub." ]]
+}
+
+function should-use-rpm() {
+  DISTRO=$1 ARCH=$2 OS=linux run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  [[ "${lines[1]}" = "Installing v"*" of the $2 rpm package from GitHub." ]]
+}
+
+function should-fallback-npm() {
+  DISTRO=$1 ARCH=$2 OS=linux run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  [ "${lines[1]}" = "No standalone releases for $2." ]
+  [ "${lines[2]}" = "Falling back to installation from npm." ]
+  [ "${lines[3]}" = "Installing latest from npm." ]
+}
+
+function should-use-npm() {
+  DISTRO=$1 ARCH=$2 OS=linux run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  [[ "${lines[1]}" = "Installing latest from npm." ]]
+}
+
+function should-use-aur() {
+  DISTRO=$1 ARCH=$2 OS=linux run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  [[ "${lines[1]}" = "Installing latest from the AUR." ]]
+}
+
+function should-fallback-npm-brew() {
+  BREW_PATH= OS=macos ARCH=$1 run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  [ "${lines[1]}" = "Homebrew not installed." ]
+  [ "${lines[2]}" = "Falling back to standalone installation." ]
+  [ "${lines[3]}" = "No standalone releases for $1." ]
+  [ "${lines[4]}" = "Falling back to installation from npm." ]
+  [ "${lines[5]}" = "Installing latest from npm." ]
+}
+
+function should-use-brew() {
+  BREW_PATH=brew OS=macos ARCH=$1 run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  [[ "${lines[1]}" = "Installing latest from Homebrew." ]]
+}
+
+@test "$SCRIPT_NAME: usage with --help" {
+  run "$SCRIPT" --help
+  [ "$status" -eq 0 ]
+  [ "${lines[0]}" = "Installs code-server." ]
+}
+
+# These use the deb but fall back to npm for unsupported arch.
+@test "$SCRIPT_NAME: debian arm64" {
+  should-use-deb "debian" "arm64"
+}
+@test "$SCRIPT_NAME: debian amd64" {
+  should-use-deb "debian" "amd64"
+}
+@test "$SCRIPT_NAME: debian i386" {
+  should-fallback-npm "debian" "i386"
+}
+
+# These use the rpm but fall back to npm for unsupported arch.
+@test "$SCRIPT_NAME: fedora arm64" {
+  should-use-rpm "fedora" "arm64"
+}
+@test "$SCRIPT_NAME: fedora amd64" {
+  should-use-rpm "fedora" "amd64"
+}
+@test "$SCRIPT_NAME: fedora i386" {
+  should-fallback-npm "fedora" "i386"
+}
+
+# These always use npm regardless of the arch.
+@test "$SCRIPT_NAME: alpine arm64" {
+  should-use-npm "alpine" "arm64"
+}
+@test "$SCRIPT_NAME: alpine amd64" {
+  should-use-npm "alpine" "amd64"
+}
+@test "$SCRIPT_NAME: alpine i386" {
+  should-use-npm "alpine" "i386"
+}
+
+@test "$SCRIPT_NAME: freebsd arm64" {
+  should-use-npm "freebsd" "arm64"
+}
+@test "$SCRIPT_NAME: freebsd amd64" {
+  should-use-npm "freebsd" "amd64"
+}
+@test "$SCRIPT_NAME: freebsd i386" {
+  should-use-npm "freebsd" "i386"
+}
+
+# Arch Linux uses AUR but falls back to npm for unsuppported arch.
+@test "$SCRIPT_NAME: arch arm64" {
+  should-use-aur "arch" "arm64"
+}
+@test "$SCRIPT_NAME: arch amd64" {
+  should-use-aur "arch" "amd64"
+}
+@test "$SCRIPT_NAME: arch i386" {
+  should-fallback-npm "arch" "i386"
+}
+
+# macOS use homebrew but falls back to standalone when brew is unavailable and
+# to npm for unsupported arch.
+@test "$SCRIPT_NAME: macos arm64 (no brew)" {
+  should-fallback-npm-brew "arm64"
+}
+@test "$SCRIPT_NAME: macos amd64 (no brew)" {
+  BREW_PATH= OS=macos ARCH=amd64 run "$SCRIPT" --dry-run
+  [ "$status" -eq 0 ]
+  [ "${lines[1]}" = "Homebrew not installed." ]
+  [ "${lines[2]}" = "Falling back to standalone installation." ]
+  [[ "${lines[3]}" = "Installing v"*" of the amd64 release from GitHub." ]]
+}
+@test "$SCRIPT_NAME: macos i386 (no brew)" {
+  should-fallback-npm-brew "i386"
+}
+
+@test "$SCRIPT_NAME: macos arm64 (brew)" {
+  should-use-brew "arm64"
+}
+@test "$SCRIPT_NAME: macos amd64 (brew)" {
+  should-use-brew "amd64"
+}
+@test "$SCRIPT_NAME: macos i386 (brew)" {
+  should-use-brew "i386"
+}