lib/.github/workflows/tests.yml

name: Tests

on:
  push:
    branches: [main, features]
  pull_request:
    branches: [main, features]

jobs:
  doc-tests:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os:
          - ubuntu-18.04
          - ubuntu-20.04
          - macos-10.15
          - macos-11.0
          - windows-2019
        python_version:
          - '3.7'
          - '3.8'
          - '3.9'
          - '3.10'

    name: Doc tests (Python ${{ matrix.python_version }} on ${{ matrix.os }})
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ matrix.python_version }}
      uses: actions/setup-python@v2
      with:
        python-version: ${{ matrix.python_version }}
        architecture: x64

    - name: Prepare environment (non-Windows systems)
      if: ${{ matrix.os != 'windows-2019' }}
      run: |
        pip install --upgrade pip pipenv

    - name: Prepare environment (Windows)
      if: ${{ matrix.os == 'windows-2019' }}
      run: |
        python -mpip install --upgrade pip pipenv

    - name: Install dependencies (all systems)
      env:
        PIP_PREFER_BINARY: 1
      run: |
        pipenv lock --pre
        pipenv sync --dev
        pipenv install --dev

    - name: Install dependencies (Windows)
      if: ${{ matrix.os == 'windows-2019' }}
      run: |
        pipenv lock -r > requirements.txt
        python -mpip install -r requirements.txt

    - name: Run doc tests (with coverage)
      if: ${{ matrix.os == 'ubuntu-20.04' && matrix.python_version == '3.10' }}
      run: |
        make coverage-doctests

    - name: Run doc tests (without coverage)
      if: ${{ matrix.os != 'ubuntu-20.04' || matrix.python_version != '3.10' }}
      run: |
        make doctests

    - name: Push code coverage
      env:
        COVERALLS_PRO_TOKEN: ${{ secrets.COVERALLS_TOKEN }}
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      if: ${{ matrix.os == 'ubuntu-20.04' && matrix.python_version == '3.10' }}
      run: |
        pipenv run coveralls --service=github