Release

.github/workflows/ci.yml

@@ -27,7 +27,7 @@ jobs:
           enable-cache: true
 
       - name: Install system libraries
-        run: bash scripts/linux/build/dependencies.sh
+        run: python3 scripts/system_dependencies.py
 
       - name: Install the development environment
         run: uv sync --group dev
@@ -52,6 +52,8 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
         python: ["3.12", "3.13"]
+    env:
+      PYTHON: ${{ matrix.os == 'windows-latest' && 'python' || 'python3' }}
     steps:
       - uses: actions/checkout@v7
 
@@ -63,19 +65,57 @@ jobs:
 
       - name: Install system libraries (Linux)
         if: runner.os == 'Linux'
-        run: bash scripts/linux/build/dependencies.sh
+        run: python3 scripts/system_dependencies.py
 
       - name: Install system libraries (macOS)
         if: runner.os == 'macOS'
         run: |
-          bash scripts/macos/build/dependencies.sh
-          bash scripts/macos/build/build_env.sh >> "$GITHUB_ENV"
+          python3 scripts/system_dependencies.py
+          python3 scripts/build_environment.py >> "$GITHUB_ENV"
 
       - name: Install the development environment
+        id: environment
         run: uv sync --group dev
 
-      - name: Run doctests
-        run: uv run python -m pytest src/ --doctest-modules --no-cov
+      - name: Run the doctests
+        shell: bash
+        run: $PYTHON scripts/run_tests.py doctests
 
-      - name: Run the unit and integration suites with coverage
-        run: uv run python -m pytest -n auto --cov
+      - name: Run the test suite with coverage
+        if: ${{ !cancelled() && steps.environment.outcome == 'success' }}
+        shell: bash
+        run: $PYTHON scripts/run_tests.py suite --workers auto
+
+  screens:
+    name: Screen scenarios (part ${{ matrix.shard }} of 3, py${{ matrix.python }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.12", "3.13"]
+        shard: [1, 2, 3]
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v9.0.0
+        with:
+          python-version: ${{ matrix.python }}
+          enable-cache: true
+
+      - name: Install system libraries
+        run: python3 scripts/system_dependencies.py
+
+      - name: Install the development environment
+        run: uv sync --group dev
+
+      - name: Run this part of the screen scenarios
+        id: screens
+        run: python3 scripts/run_tests.py screens --screen-workers 2 --shard ${{ matrix.shard }}/3
+
+      - name: Keep what the failed screen scenarios left
+        if: ${{ failure() && steps.screens.outcome == 'failure' }}
+        uses: actions/upload-artifact@v7
+        with:
+          name: screens-py${{ matrix.python }}-part-${{ matrix.shard }}
+          path: build/screens/

.github/workflows/workflow.yml

@@ -32,10 +32,7 @@ jobs:
 
       - name: Verify tag matches project version
         if: startsWith(github.ref, 'refs/tags/v')
-        run: |
-          python3 scripts/ci/checks/version_tag.py \
-            --tag "$GITHUB_REF_NAME" \
-            --project-version "$(uv version --short)"
+        run: python3 scripts/verify_version_tag.py --tag "$GITHUB_REF_NAME"
 
       - name: Build sdist and wheel
         run: uv build
@@ -78,19 +75,28 @@ jobs:
       - name: Install PortAudio (macOS)
         if: runner.os == 'macOS'
         run: |
-          bash repository/scripts/macos/build/dependencies.sh
-          bash repository/scripts/macos/build/build_env.sh >> "$GITHUB_ENV"
+          python3 repository/scripts/system_dependencies.py
+          python3 repository/scripts/build_environment.py >> "$GITHUB_ENV"
 
       - name: Install the wheel and check the entry point
         shell: bash
         run: |
           python -m pip install --upgrade pip
           python -m pip install dist/*.whl
           sampletones --version
+          sampletones --help
 
       - name: Check the wheel carries every resource it needs at startup
         shell: bash
-        run: sampletones --self-check
+        run: sampletones self-check
+
+      - name: Check a developer command refuses to run outside a checkout
+        shell: bash
+        run: |
+          if refusal=$(sampletones check import-boundary --all 2>&1); then
+            exit 1
+          fi
+          grep "runs from a checkout" <<< "$refusal"
 
   bundle:
     name: Standalone bundle (${{ matrix.platform }})
@@ -114,38 +120,19 @@ jobs:
 
       - name: Install system libraries (Linux)
         if: runner.os == 'Linux'
-        run: bash scripts/linux/build/dependencies.sh
+        run: python scripts/system_dependencies.py
 
-      - name: Create the build environment the bundle scripts expect
+      - name: Build the bundle
         shell: bash
-        run: |
-          python -m venv .venv-build
-          if [ "$RUNNER_OS" = "Windows" ]; then
-            venv_python=.venv-build/Scripts/python.exe
-          else
-            venv_python=.venv-build/bin/python
-          fi
-          "$venv_python" -m pip install --upgrade pip
-          "$venv_python" -m pip install ".[build]" --group assets
-
-      - name: Build the bundle (Linux)
-        if: runner.os == 'Linux'
-        run: bash scripts/linux/build/build.sh --release
-
-      - name: Build the bundle (Windows)
-        if: runner.os == 'Windows'
-        shell: cmd
-        run: scripts\windows\build\build.bat --release
+        run: python scripts/bundle.py --release
 
       - name: Check the bundle runs and carries its notices
         shell: bash
-        run: python scripts/ci/checks/bundle.py bin/sampletones
+        run: python scripts/verify_bundle.py
 
       - name: Zip the bundle
         shell: bash
-        run: |
-          name="sampletones-${GITHUB_REF_NAME}-${{ matrix.platform }}"
-          python scripts/ci/zip_bundle.py bin/sampletones "bundles/${name}.zip" --root "${name}"
+        run: python scripts/archive_bundle.py --label "${{ matrix.platform }}"
 
       - uses: actions/upload-artifact@v7
         with:

.gitignore

@@ -8,15 +8,17 @@ __pycache__/
 .venv/
 .venv-build/
 .vscode/
+.worktrees/
 
 dist/
 wheels/
 /bin/
 /build/
+/bundles/
 
 sampletones
 !src/sampletones
-!tests/sampletones
+!tests/unit/sampletones
 
 *.pyc
 *.pyo
@@ -49,3 +51,6 @@ sampletones
 *.exe
 *.dll
 *.so
+
+!tests/data/compatibility/**/*.ins
+!tests/data/compatibility/**/*.stn

.pre-commit-config.yaml

@@ -33,80 +33,86 @@ repos:
 
   - repo: local
     hooks:
+      - id: mypy
+        name: mypy
+        entry: uv run mypy
+        language: system
+        types: [python]
+        verbose: True
+        require_serial: true
+        exclude: ^(tests/)
+
+      - id: pylint
+        name: pylint
+        entry: uv run pylint
+        language: system
+        types: [python]
+        verbose: True
+        require_serial: true
+        exclude: ^(tests/)
+
       - id: import-boundary
         name: import boundary
-        entry: uv run scripts/checks/import_boundary.py --all
+        entry: uv run sampletones check import-boundary --all
         language: system
         types: [python]
         pass_filenames: false
         verbose: true
 
       - id: unused-tags
         name: unused tags
-        entry: uv run scripts/checks/unused_tags.py
+        entry: uv run sampletones check unused-tags
         language: system
         types: [python]
         pass_filenames: false
         verbose: true
 
+      - id: rendered-literals
+        name: rendered literals
+        entry: uv run sampletones check rendered-literals
+        language: system
+        files: ^tests/.*\.py$
+        pass_filenames: false
+        verbose: true
+
       - id: tag-names
         name: tag names
-        entry: uv run scripts/checks/tag_names.py --all
+        entry: uv run sampletones check tag-names --all
         language: system
         types: [python]
         pass_filenames: false
         verbose: true
 
       - id: palette-colors
         name: palette colors
-        entry: uv run scripts/checks/palette_colors.py
+        entry: uv run sampletones check palette-colors
         language: system
         files: (^src/sampletones_application/.*\.py|^src/sampletones_config/.*\.yaml)$
         pass_filenames: false
         verbose: true
 
       - id: language-keys
         name: language keys
-        entry: uv run scripts/checks/language_keys.py
+        entry: uv run sampletones check language-keys
         language: system
         files: (\.py|^src/sampletones_config/lang/.*\.yaml)$
         pass_filenames: false
         verbose: true
 
-      - id: mypy
-        name: mypy
-        entry: uv run mypy
-        language: system
-        types: [python]
-        verbose: True
-        require_serial: true
-        exclude: ^(tests/)
-
-      - id: pylint
-        name: pylint
-        entry: uv run pylint
+      - id: shortcut-actions
+        name: shortcut actions
+        entry: uv run sampletones check shortcut-actions
         language: system
-        types: [python]
-        verbose: True
-        require_serial: true
-        exclude: ^(tests/)
+        files: (\.py|^src/sampletones_config/keybindings/.*\.yaml)$
+        pass_filenames: false
+        verbose: true
 
       - id: icons
         name: icons
-        entry: uv run python scripts/assets/icons.py
+        entry: uv run python -m assets.icons
         language: system
-        files: ^src/sampletones_assets/(icons|mark)/
+        files: ^(src/sampletones_assets/icons|assets/icons)/
         pass_filenames: false
         verbose: true
         stages:
           - pre-push
-
-      - id: pytest
-        name: pytest
-        entry: make test
-        language: system
-        types:
-          - python
-        stages:
-          - pre-push
-        pass_filenames: false