Prepare 0.8.0 release #715
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Test | |
| on: | |
| pull_request: | |
| branches: | |
| - "**" | |
| paths: | |
| # Run for changes to *this* workflow file, but not for other workflows | |
| - ".github/workflows/test.yml" | |
| # Trigger off all top level files by default | |
| - "*" | |
| # Trigger off source and test changes | |
| - "src/**" | |
| - "tests/**" | |
| # Python scripts under misc still need linting & typechecks | |
| - "misc/**.py" | |
| # Skip running the source code checks when only documentation has been updated | |
| - "!**.md" | |
| - "!**.rst" | |
| - "!**.txt" # Any requirements file changes will also involve changing other files | |
| push: | |
| branches: | |
| - main | |
| # Require explicit job permissions | |
| permissions: {} | |
| defaults: | |
| run: | |
| # Use the Git for Windows bash shell, rather than supporting Powershell | |
| # This also implies `set -eo pipefail` (rather than just `set -e`) | |
| shell: bash | |
| jobs: | |
| tests: | |
| runs-on: ${{ matrix.os }} | |
| strategy: | |
| fail-fast: false # Always report results for all targets | |
| max-parallel: 12 | |
| matrix: | |
| # To avoid excessive CI runs, test the oldest supported version, | |
| # the newest supported version, and one intermediate version | |
| # Currently, 3.12 is skipped, as that is tested when generating the | |
| # expected output updates, and is also the default local test target | |
| python-version: [3.11, 3.13, 3.14] | |
| # Note: while venvstacks nominally supports x86-64 macOS, the actual demand | |
| # for that is unclear, so skip macos-12 testing until it is requested | |
| # Linux and Windows aarch64 testing is more gated on runner availability | |
| os: [ubuntu-22.04, windows-2022, macos-14] | |
| # Check https://github.com/actions/action-versions/tree/main/config/actions | |
| # for latest versions if the standard actions start emitting warnings | |
| steps: | |
| - uses: actions/checkout@v4 | |
| with: | |
| persist-credentials: false | |
| - name: Capture timestamp for debugging artifacts | |
| id: timestamp | |
| run: | | |
| echo "minutes=$(date '+%Y%m%d-%H%M')" >> $GITHUB_OUTPUT | |
| # Python setup shenanigans to ensure we don't get 3.13.4 | |
| # (avoids https://github.com/python/cpython/issues/135151) | |
| - name: Set up Python ${{ matrix.python-version }} | |
| if: matrix.python-version != '3.13' | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: ${{ matrix.python-version }} | |
| # Allow for pre-release testing of the next Python version | |
| allow-prereleases: ${{ matrix.python-version == '3.15' }} | |
| - name: Set up Python ${{ matrix.python-version }} | |
| if: matrix.python-version == '3.13' | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: "~=3.13.5" | |
| - name: Get pip cache dir | |
| id: pip-cache | |
| run: | | |
| echo "dir=$(python -m pip cache dir)" >> $GITHUB_OUTPUT | |
| - name: Cache bootstrapping dependencies | |
| uses: actions/cache@v4 | |
| with: | |
| path: ${{ steps.pip-cache.outputs.dir }} | |
| key: | |
| pip-${{ matrix.os }}-${{ matrix.python-version }}-v1-${{ hashFiles('pdm.lock') }} | |
| restore-keys: | | |
| pip-${{ matrix.os }}-${{ matrix.python-version }}-v1- | |
| - name: Install PDM | |
| run: | | |
| # Ensure `pdm` uses the same version as specified in `pdm.lock` | |
| # while avoiding the error raised by https://github.com/pypa/pip/issues/12889 | |
| python -m pip install --upgrade -r ci-bootstrap-requirements.txt | |
| - name: Create development virtual environment | |
| run: | | |
| python -m pdm sync --no-self --dev | |
| # Handle Windows vs non-Windows differences in .venv layout | |
| VIRTUAL_ENV_BIN_DIR="$PWD/.venv/bin" | |
| test -e "$VIRTUAL_ENV_BIN_DIR" || VIRTUAL_ENV_BIN_DIR="$PWD/.venv/Scripts" | |
| echo "VIRTUAL_ENV_BIN_DIR=$VIRTUAL_ENV_BIN_DIR" >> "$GITHUB_ENV" | |
| - name: Get uv cache dir | |
| id: uv-cache | |
| run: | | |
| source "$VIRTUAL_ENV_BIN_DIR/activate" | |
| echo "dir=$(python -m uv cache dir)" >> $GITHUB_OUTPUT | |
| - name: Cache test suite stack dependencies | |
| uses: actions/cache@v4 | |
| with: | |
| path: ${{ steps.uv-cache.outputs.dir }} | |
| key: | |
| uv-${{ matrix.os }}-${{ matrix.python-version }}-v1-${{ hashFiles('tests/sample_project/requirements/**') }} | |
| restore-keys: | | |
| uv-${{ matrix.os }}-${{ matrix.python-version }}-v1- | |
| - name: Static checks | |
| run: | | |
| source "$VIRTUAL_ENV_BIN_DIR/activate" | |
| python -m tox -v -m static | |
| - name: Fast tests | |
| run: | | |
| source "$VIRTUAL_ENV_BIN_DIR/activate" | |
| python -m tox -v -- -m 'not slow' | |
| # Only run the slow tests on the oldest and newest versions | |
| - name: Slow tests | |
| if: contains(fromJSON('["3.11", "3.14"]'), matrix.python-version) | |
| id: slow_tests | |
| run: | | |
| export VENVSTACKS_EXPORT_TEST_ARTIFACTS="$GITHUB_WORKSPACE/export/tests" | |
| mkdir -p "$VENVSTACKS_EXPORT_TEST_ARTIFACTS" | |
| source "$VIRTUAL_ENV_BIN_DIR/activate" | |
| python -m tox -v -- -m slow | |
| - name: Upload test failure debugging artifacts | |
| if: failure() && steps.slow_tests.conclusion == 'failure' | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| # ensure test artifact upload names are unique | |
| name: exported-test-artifacts-${{ steps.timestamp.outputs.minutes }}-${{ matrix.os }}-py${{ matrix.python-version }} | |
| path: | | |
| export/tests | |
| retention-days: 3 # Just for debugging, don't need to keep these long term | |
| - name: Upload coverage data | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: coverage-data-${{ matrix.os }}-py${{ matrix.python-version }} | |
| path: .coverage.* | |
| include-hidden-files: true | |
| if-no-files-found: ignore | |
| # Coverage check based on https://hynek.me/articles/ditch-codecov-python/ | |
| coverage: | |
| name: Combine & check coverage | |
| if: always() | |
| needs: tests | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v4 | |
| with: | |
| persist-credentials: false | |
| - uses: actions/setup-python@v5 | |
| with: | |
| # Use latest Python, so it understands all syntax. | |
| python-version: "3.13" | |
| # https://github.com/hynek/setup-cached-uv/releases/tag/v2.3.0 | |
| - uses: hynek/setup-cached-uv@757bedc3f972eb7227a1aa657651f15a8527c817 | |
| - uses: actions/download-artifact@v4 | |
| with: | |
| pattern: coverage-data-* | |
| merge-multiple: true | |
| - name: Combine coverage & fail if it goes down | |
| run: | | |
| uv tool install 'coverage[toml]' | |
| coverage combine | |
| coverage html --skip-covered --skip-empty | |
| # Report and write to summary. | |
| coverage report --format=markdown >> $GITHUB_STEP_SUMMARY | |
| # Report again and fail if under 91%. | |
| # Highest historical coverage: 92% | |
| # Subsequent proportional coverage reductions: | |
| # - de-duplicated the deployment checking code | |
| coverage report --fail-under=91 | |
| - name: Upload HTML report if check failed | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: html-report | |
| path: htmlcov | |
| if: ${{ failure() }} |