test.python.yml

##
# Run pytest in a working directory.
# Currently, only `uv` is supported
##
name: Test Python project

on:
  workflow_call:
    inputs:
      python-version:
        required: false
        type: string
        description: "What Python version to use."
        default: "3.13"
      working-directory:
        required: false
        type: string
        default: "."
      runs-on:
        required: false
        type: string
        default: "ubuntu-latest"
        description: "The GitHub runner to run this on. Defaults to ubuntu-latest, which is the recommended choice. Larger runners are faster but cost significantly more per minute, so only use them when the workload clearly needs it."
      uv-operations:
        required: false
        type: string
        default: "pytest"
        description: "UV operations passed to uv run: uv run <operations>"

jobs:
  test:
    name: Test Python
    runs-on: ${{ inputs.runs-on }}

    steps:
      - uses: actions/checkout@v6

      - name: Install uv
        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
        with:
          enable-cache: true
          cache-dependency-glob: "${{ inputs.working-directory }}/uv.lock"

      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
        with:
          python-version: ${{ inputs.python-version }}

      - name: Run tests
        working-directory: ${{ inputs.working-directory }}
        run: uv run ${{ inputs.uv-operations }}