build.yml

# -----------------------------------------------------------------------------
#   - invoked on push, pull_request, or manual trigger
#   - tests under multiple versions of python
#   - only quick tests are run here
#
#   NOTE: We do not run tests marked as slow nor do we schedule runs here.
#   Slow tests and scheduled runs are handled via Jenkins because that has 
#   access to the cluster which is required for some tests.
# -----------------------------------------------------------------------------
name: build
on: [push, pull_request, workflow_dispatch]

jobs:
  get-python-versions:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2
      - name: Install jq
        run: sudo apt-get install jq
      - name: Get Python versions
        id: set-matrix
        run: |
          echo "MATRIX_RESULT=$(jq -c . python_versions.json)" >> $GITHUB_ENV
    outputs:
      matrix: ${{ env.MATRIX_RESULT }}
  build:
    needs: get-python-versions
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ${{ fromJSON(needs.get-python-versions.outputs.matrix) }}
    steps:
      - uses: actions/checkout@v3
      - name: Set up Python ${{ matrix.python-version }}
        uses: actions/setup-python@v4
        with:
          python-version: ${{ matrix.python-version }}
      - name: Print environment values
        run: |
          python --version
          cat $GITHUB_ENV
      - name: Update pip
        run: |
          python -m pip install --upgrade pip
      - name: Lint
        run: |
          pip install black==22.3.0 isort
          black . --check --diff
          isort . --check --verbose --only-modified --diff
      - name: Install dependencies
        run: |
          pip install .[dev]
      - name: Test
        run: |
          pytest ./tests
      - name: Build Docs
        run: |
          make html -C docs/ SPHINXOPTS="-W --keep-going -n"