Add tooling utils

.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish
+on:
+  workflow_dispatch:
+concurrency:
+  group: publish
+  cancel-in-progress: true
+permissions: write-all
+jobs:
+  publish-ghcr:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - run: tools/prebuild.sh
+      - uses: devcontainers/action@v1
+        with:
+          publish-features: true
+          base-path-to-features: src
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  update-docs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      packages: write
+    steps:
+      - uses: actions/checkout@v3
+      - uses: devcontainers/action@v1
+        with:
+          base-path-to-features: src
+          generate-docs: true
+      - uses: stefanzweifel/git-auto-commit-action@v4

.github/workflows/test.yml

@@ -0,0 +1,28 @@
+name: Test
+on:
+  push:
+    branches: [main]
+    paths:
+      - src/**
+      - "!src/**.md"
+      - test/**
+      - .github/workflows/test.yml
+  pull_request:
+    branches: [main]
+    paths:
+      - src/**
+      - "!src/**.md"
+      - test/**
+      - .github/workflows/test.yml
+  workflow_dispatch:
+concurrency:
+  group: test-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - run: npm install -g @devcontainers/cli
+      # TODO: When features grow too numerous, test ONLY CHANGED features
+      - run: tools/test.sh

.gitignore

@@ -0,0 +1,4 @@
+src/*/utils
+
+logs
+*.log

tools/prebuild.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+set -e
+
+for id in src/*; do
+  id=$(basename "$id")
+  if [[ ! -d src/$id ]]; then
+    echo "🟨 Skipping $id..."
+    continue
+  fi
+  echo "🟪 Copying utils/ to src/$id/utils/..."
+  rsync -a utils/ "src/$id/utils/"
+  echo "🟩 Copied utils/ to src/$id/utils/"
+done

tools/test.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+set -e
+
+tools/prebuild.sh
+devcontainer features test "$@"

utils/clear_local_apt_index.sh

@@ -0,0 +1,8 @@
+# shellcheck shell=bash
+
+clear_local_apt_index() (
+  set -e
+
+  rm -rf /var/lib/apt/lists/*
+  echo '🟩 Cleared local apt index'
+)

utils/ensure_apt_packages.sh

@@ -0,0 +1,19 @@
+# shellcheck shell=bash
+
+ensure_apt_packages() (
+  set -e
+
+  export DEBIAN_FRONTEND=noninteractive
+  if dpkg -s "$@" &>/dev/null; then
+    echo "🟦 $@ is already installed"
+  else
+    if [[ $(find /var/lib/apt/lists/* | wc -l) == 0 ]]; then
+      echo '🟪 Updating local apt index...'
+      apt-get update -y
+      echo '🟩 Updated local apt index'
+    fi
+    echo "🟪 Installing $@..."
+    apt-get install -y --no-install-recommends "$@"
+    echo "🟩 Installed $@"
+  fi
+)