# This workflow will install Python dependencies, run tests and lint with a variety of Python versions

# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions

name: Python package

on:

push:

branches: [main]

pull_request:

workflow_dispatch:

permissions:

contents: read

jobs:

test:

strategy:

matrix:

os-type: [ubuntu, macos, windows]

python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14", "3.14t", "3.15", "3.15t"]

exclude:

- os-type: macos

python-version: "3.7" # Not available for the ARM-based macOS runners.

- os-type: macos

python-version: "3.14t"

- os-type: macos

python-version: "3.15t"

- os-type: windows

python-version: "3.13" # FIXME: Fix and enable Python 3.13-3.15 on Windows (#1955).

- os-type: windows

python-version: "3.14"

- os-type: windows

python-version: "3.14t"

- os-type: windows

python-version: "3.15"

- os-type: windows

python-version: "3.15t"

include:

- os-ver: latest

- os-type: ubuntu

python-version: "3.7"

os-ver: "22.04"

- build-docs: true # We ensure documentation builds, except on very old interpreters.

- python-version: "3.7"

build-docs: false

- python-version: "3.8"

build-docs: false

- experimental: false

- python-version: "3.15"

experimental: true

- python-version: "3.15t"

experimental: true

fail-fast: false

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

defaults:

run:

shell: bash --noprofile --norc -exo pipefail {0}

steps:

- uses: actions/checkout@v7

with:

fetch-depth: 0

- name: Set up Python ${{ matrix.python-version }}

uses: actions/setup-python@v6

with:

python-version: ${{ matrix.python-version }}

allow-prereleases: ${{ matrix.experimental }}

- name: Set up WSL (Windows)

if: matrix.os-type == 'windows'

uses: Vampire/setup-wsl@v6.0.0

with:

wsl-version: 1

distribution: Debian

- name: Prepare this repo for tests

run: |

./init-tests-after-clone.sh

- name: Set git user identity and command aliases for the tests

run: |

git config --global user.email "travis@ci.com"

git config --global user.name "Travis Runner"

# If we rewrite the user's config by accident, we will mess it up

# and cause subsequent tests to fail

cat test/fixtures/.gitconfig >> ~/.gitconfig

- name: Update PyPA packages

run: |

python -m pip install -U pip 'setuptools; python_version<"3.12"' wheel

- name: Install project and test dependencies

run: |

pip install '.[test]'

- name: Show POSIX file ownership

# Linux and macOS only. On Windows, Git Bash's `ls -ld` reports a

# uniform uid+gid for every path regardless of NTFS Owner (MSYS2's

# SID-to-uid mapping doesn't have Cygwin's fidelity), so it would

# not be informative here. The NTFS Owner check below covers Windows.

if: matrix.os-type != 'windows'

run: |

ls -ld -- \

"$(pwd)" \

"$(pwd)/.git" \

"$(pwd)/git/ext/gitdb" \

"$(pwd)/git/ext/gitdb/.git" \

"$(pwd)/git/ext/gitdb/gitdb/ext/smmap" \

"$(pwd)/git/ext/gitdb/gitdb/ext/smmap/.git" \

"${HOME:?HOME is not set}/.gitconfig" \

2>&1 || true

- name: Show NTFS file ownership

# Windows only. Reads NTFS Owner directly via Get-Acl, which is the

# authoritative view for Windows-side ownership questions; the POSIX

# view via Git Bash's MSYS2 layer is not a reliable proxy here.

if: matrix.os-type == 'windows'

shell: pwsh

run: |

$paths = @(

"$pwd",

"$pwd\.git",

"$pwd\git\ext\gitdb",

"$pwd\git\ext\gitdb\.git",

"$pwd\git\ext\gitdb\gitdb\ext\smmap",

"$pwd\git\ext\gitdb\gitdb\ext\smmap\.git",

"$env:USERPROFILE\.gitconfig"

)

foreach ($p in $paths) {

if (Test-Path -LiteralPath $p) {

try {

$owner = (Get-Acl -LiteralPath $p).Owner

} catch {

$owner = "ERROR: $($_.Exception.Message)"

}

"{0,-44} {1}" -f $owner, $p

} else {

"(missing: $p)"

}

}

- name: Show safe.directory entries

# `actions/checkout`'s safe.directory add is only durable for the

# checkout itself (it writes under a throwaway HOME override and

# then discards it), so by the time this step runs the runner

# user's `~/.gitconfig` has no entries -- and git accepts the

# workspace's ownership anyway: Git for Windows via its

# Admins-group exemption on the windows matrix; on Linux/macOS

# the workspace is owned by the test user. Expected: `(none)`.

run: git config --global --get-all safe.directory || echo "(none)"

- name: Show version and platform information

run: |

uname -a

command -v git python

git version

python --version

python -c 'import os, sys; print(f"sys.platform={sys.platform!r}, os.name={os.name!r}")'

# For debugging hook tests on native Windows systems that may have WSL.

- name: Show bash.exe candidates (Windows)

if: matrix.os-type == 'windows'

run: |

set +e

bash.exe -c 'printenv WSL_DISTRO_NAME; uname -a'

python -c 'import subprocess; subprocess.run(["bash.exe", "-c", "printenv WSL_DISTRO_NAME; uname -a"])'

continue-on-error: true

- name: Check types with mypy

if: matrix.python-version != '3.7' && matrix.python-version != '3.8'

run: |

mypy --python-version="${PYTHON_VERSION%t}" # Version only, with no "t" for free-threaded.

env:

MYPY_FORCE_COLOR: "1"

TERM: "xterm-256color" # For color: https://github.com/python/mypy/issues/13817

PYTHON_VERSION: ${{ matrix.python-version }}

- name: Test with pytest

run: |

pytest --color=yes -p no:sugar --instafail -vv

continue-on-error: false

- name: Documentation

if: matrix.build-docs

run: |

pip install '.[doc]'

make -C doc html