ci-tests.yml

# reference:
#   - https://github.com/actions/cache
#   - https://github.com/actions/checkout
#   - https://github.com/marketplace/actions/setup-miniconda

name: ci-tests

on:
  push:
    branches:
      - "main"
      - "v*x"
    tags:
      - "v*"
  pull_request:
    branches:
      - "*"
  workflow_dispatch:

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  tests:
    name: "${{ matrix.session }} (py${{ matrix.python-version }} ${{ matrix.os }}) [${{ matrix.iris-source }}]"

    runs-on: ${{ matrix.os }}

    defaults:
      run:
        shell: bash -l {0}

    strategy:
      fail-fast: false
      matrix:
        os: ["ubuntu-latest"]
        python-version: ["3.11"]
        session: ["doctest", "linkcheck"]
        iris-source : ["conda-forge"]
        include:
          - os: "ubuntu-latest"
            python-version: "3.11"
            session: "tests"
            iris-source: "conda-forge"
            coverage: "--coverage"
          - os: "ubuntu-latest"
            python-version: "3.11"
            session: "tests"
            iris-source: "source"
          - os: "ubuntu-latest"
            python-version: "3.10"
            session: "tests"
            iris-source: "conda-forge"
          - os: "ubuntu-latest"
            python-version: "3.9"
            session: "tests"
            iris-source: "conda-forge"

    env:
      IRIS_TEST_DATA_VERSION: "2.24"
      ENV_NAME: "ci-tests"

    steps:
      - name: "checkout"
        uses: actions/checkout@v4

      - name: "environment configure"
        env:
          # Maximum cache period (in weeks) before forcing a cache refresh.
          CACHE_WEEKS: 2
        run: |
          echo "CACHE_PERIOD=$(date +%Y).$(expr $(date +%U) / ${CACHE_WEEKS})" >> ${GITHUB_ENV}
          echo "LOCK_FILE=requirements/locks/py$(echo ${{ matrix.python-version }} | tr -d '.')-linux-64.lock" >> ${GITHUB_ENV}

      - name: "data cache"
        uses: ./.github/workflows/composite/iris-data-cache
        with:
          cache_build: 0
          env_name: ${{ env.ENV_NAME }}
          version: ${{ env.IRIS_TEST_DATA_VERSION }}

      - name: "conda package cache"
        uses: ./.github/workflows/composite/conda-pkg-cache
        with:
          cache_build: 0
          cache_period: ${{ env.CACHE_PERIOD }}
          env_name: ${{ env.ENV_NAME }}

      - name: "conda install"
        uses: conda-incubator/setup-miniconda@v3
        with:
          miniforge-version: latest
          channels: conda-forge,defaults
          activate-environment: ${{ env.ENV_NAME }}
          auto-update-conda: false
          use-only-tar-bz2: true

      - name: "conda environment cache"
        uses: ./.github/workflows/composite/conda-env-cache
        with:
          cache_build: 0
          cache_period: ${{ env.CACHE_PERIOD }}
          env_name: ${{ env.ENV_NAME }}
          install_packages: "cartopy nox pip"

      - name: "conda info"
        run: |
          conda info
          conda list

      - name: "cartopy cache"
        uses: ./.github/workflows/composite/cartopy-cache
        with:
          cache_build: 0
          cache_period: ${{ env.CACHE_PERIOD }}
          env_name: ${{ env.ENV_NAME }}

      - name: "nox cache"
        uses: ./.github/workflows/composite/nox-cache
        with:
          cache_build: 0
          env_name: ${{ env.ENV_NAME }}
          lock_file: ${{ env.LOCK_FILE }}

      - name: "iris ${{ matrix.session }}"
        env:
          IRIS_SOURCE: ${{ matrix.iris-source }}
          PY_COLORS: 1
          PY_VER: ${{ matrix.python-version }}
        run: |
          nox --session ${{ matrix.session }} -- --test-data-dir ${HOME}/iris-test-data/test_data

      - name: "Upload coverage report"
        uses: codecov/codecov-action@v4
        if: ${{ matrix.coverage }}