tests.yml

name: Tests
on:
  push:
    branches:
      - master
  pull_request:
  # Run on manual triggers
  workflow_dispatch:
env:
  PYTHONIOENCODING: utf-8
jobs:
  build-packages:
    name: build-packages
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: 3.12
          cache: "pip"
      - name: Install uv
        run: |
          # https://github.com/astral-sh/uv/issues/1386#issuecomment-1947801083
          echo "VIRTUAL_ENV=${Python_ROOT_DIR}" >> $GITHUB_ENV
          pip install uv
      - name: Build packages
        run: |
          uv pip install hatch
          hatch build
      - name: Store packages
        uses: actions/upload-artifact@v4
        with:
          name: packages
          path: dist/
  examples:
    needs: build-packages
    name: examples-${{ matrix.os }}-py${{ matrix.python-version }}-qiskit${{ matrix.qiskit-version }}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        qiskit-version: ['0.46.0', '1.0.1']
        python-version: ['3.9', '3.10', '3.11', '3.12']
        os: ["ubuntu-latest"]
    steps:
      - name: Checkout examples  # FIXME: ship examples with source distribution
        uses: actions/checkout@v4
        with:
          sparse-checkout: |
            examples
          sparse-checkout-cone-mode: false
      - name: Set up Python ${{ matrix.python-version }}
        uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python-version }}
      - name: Install uv
        run: |
          pip install uv
          uv venv
          # FIXME: https://github.com/astral-sh/uv/issues/1386
          echo "VIRTUAL_ENV=.venv" >> $GITHUB_ENV
      - name: Restore packages
        uses: actions/download-artifact@v4
        with:
          name: packages
          path: dist
      - name: Install package wheel
        run: |
          # there is only one wheel in dist/
          echo "qiskit==${{ matrix.qiskit-version }}" > override.txt
          uv pip install --strict --override override.txt "qiskit-aqt-provider[examples] @ $(ls dist/*.whl)"
      - name: Run examples
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          ./examples/run_all.sh
  tests:
    name: tests-py${{ matrix.python-version }}-qiskit${{ matrix.qiskit-version }}-resolve-${{ matrix.resolution-strategy }}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        qiskit-version: ['0.46.0', '1.0.1']
        python-version: ['3.9', '3.10', '3.11', '3.12']
        os: ['ubuntu-latest']
        resolution-strategy: ['highest', 'lowest-direct']
    steps:
      - uses: actions/checkout@v4
      - name: Check shell scripts
        uses: ludeeus/action-shellcheck@2.0.0
      - name: Setup Python ${{ matrix.python-version }}
        uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python-version }}
          cache: "pip"
      - name: Install uv
        run: |
          pip install uv
          uv venv
          # https://github.com/astral-sh/uv/issues/1386
          echo "VIRTUAL_ENV=.venv" >> $GITHUB_ENV
      - name: Lock dependencies
        run: |
          echo "qiskit==${{ matrix.qiskit-version }}" > qiskit-override.txt
          # FIXME: https://github.com/Qiskit/qiskit_sphinx_theme/issues/567
          echo 'furo==2023.9.10' > furo-override.txt
          uv pip compile pyproject.toml --all-extras --override qiskit-override.txt --override furo-override.txt | tee requirements.txt
      - name: Install project
        run: |
          uv pip sync --strict requirements.txt
          uv pip install 'qiskit-aqt-provider @ .'  # for the plugins
      - name: Check version numbers consistency
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          poe version_check
      - name: Check formatting
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          poe format_check
      - name: Linting
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          poe lint
      - name: Type checking
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          poe typecheck
      - name: Run examples with coverage
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          ./examples/run_all.sh -c
      - name: Run tests with coverage
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          poe test --cov_opts="-a"  # add to examples coverage
      - name: Build docs
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          poe docs
      - name: Generate coverage report
        run: |
          # FIXME: https://github.com/astral-sh/uv/issues/1910
          source $VIRTUAL_ENV/bin/activate
          coverage lcov -o coverage.lcov
      - name: Upload coverage report
        uses: coverallsapp/github-action@v2
        with:
          file: coverage.lcov
          parallel: true
          flag-name: run ${{ join(matrix.*, ' - ') }}
  finish:
    needs: tests
    runs-on: ubuntu-latest
    steps:
      - name: Close parallel coverage build
        uses: coverallsapp/github-action@v2
        with:
          parallel-finished: true