test.yml

name: test

on:
  push:
    branches:
      - "main"
      - "test-me-*"

  pull_request:
    branches:
      - "main"

  workflow_dispatch:

# Cancel running jobs for the same workflow and branch.
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:

  package:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v7
    - name: Build and Check Package
      uses: hynek/build-and-inspect-python-package@v2.18

  test:

    needs: [package]

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

    strategy:
      fail-fast: false
      matrix:
        os: [ windows-latest, ubuntu-latest ]
        python: [ "3.10", "3.11", "3.12", "3.13", "3.14", "pypy-3.11" ]

    steps:
    - uses: actions/checkout@v7
      with:
        fetch-depth: 0

    - name: Download Package
      uses: actions/download-artifact@v8
      with:
        name: Packages
        path: dist

    - name: Set up Python
      uses: actions/setup-python@v7
      with:
        python-version: ${{ matrix.python }}

    - name: Install dependencies
      run: pip install tox twine

    - name: Check package
      shell: bash
      run: |
        twine check --strict dist/*

    - name: Test
      shell: bash
      run: |
        tox run -e py --installpkg `find dist/*.tar.gz`

  # pytest-xdist drives execnet's local parallel testing: popen gateways,
  # the main-thread worker profile, crashed-worker replacement, and the
  # report/warning serialization.  Our own suite runs xdist as a *tool*,
  # which does not exercise any of that -- so run xdist's own test suite
  # against the execnet built from this branch.
  #
  # Two targets:
  #
  # * `release` is a pinned combination known to be green against the last
  #   *released* execnet, so a failure there means we broke something.  It
  #   blocks.  Bump `ref`/`pytest` together, and only after checking the new
  #   pair is green against released execnet -- otherwise the signal is
  #   gone.  (xdist 3.8.0 needs pytest<9: with pytest 9 two of its tests
  #   fail against released execnet too.)
  # * `default-branch` is early warning for drift on both sides.  It is
  #   allowed to fail, because it can go red for reasons that are xdist's
  #   to fix.  An empty `ref` follows whatever xdist's default branch is
  #   (`master` today) rather than hardcoding a name that could change.
  #
  # To reproduce locally:
  #   git clone https://github.com/pytest-dev/pytest-xdist
  #   git -C pytest-xdist checkout v3.8.0     # or stay on the default branch
  #   python -m venv .xdist-venv
  #   .xdist-venv/bin/pip install ./pytest-xdist[testing] "pytest<9" .
  #   cd pytest-xdist && ../.xdist-venv/bin/python -m pytest
  xdist:

    needs: [package]

    runs-on: ubuntu-latest

    name: xdist (${{ matrix.name }})

    continue-on-error: ${{ matrix.experimental }}

    strategy:
      fail-fast: false
      matrix:
        include:
          - name: release
            ref: "v3.8.0"
            pytest: "pytest<9"
            experimental: false
          - name: default-branch
            ref: ""
            pytest: "pytest"
            experimental: true

    steps:
    - uses: actions/checkout@v7
      with:
        path: execnet

    - uses: actions/checkout@v7
      with:
        repository: pytest-dev/pytest-xdist
        ref: ${{ matrix.ref }}
        path: pytest-xdist

    - name: Download Package
      uses: actions/download-artifact@v8
      with:
        name: Packages
        path: dist

    - name: Set up Python
      uses: actions/setup-python@v7
      with:
        python-version: "3.13"

    - name: Install pytest-xdist and this execnet
      shell: bash
      run: |
        python -m pip install --upgrade pip
        python -m pip install "./pytest-xdist[testing]" "${{ matrix.pytest }}"
        # after xdist, so its execnet>=2.1 requirement does not win
        python -m pip install --force-reinstall `find dist/*.tar.gz`
        python -c "import execnet, xdist; print('execnet', execnet.__version__)"

    - name: Run the pytest-xdist test suite
      shell: bash
      working-directory: pytest-xdist
      run: |
        deselect=()
        # `|| [ -n "$line" ]` so a file without a trailing newline still
        # contributes its last entry
        while read -r line || [ -n "$line" ]; do
          line="${line%%#*}"
          line="$(echo "$line" | xargs)"
          [ -n "$line" ] && deselect+=(--deselect "$line")
        done < ../execnet/.github/xdist-known-failures.txt
        printf 'deselecting %d known failure(s)\n' $(( ${#deselect[@]} / 2 ))
        python -m pytest -ra "${deselect[@]}"