Add GitHub Actions workflow for Python package publishing #2838

Workflow file for this run

.github/workflows/pythonpackage.yml at 4e96d87

	# 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"
	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@v7
	with:
	python-version: ${{ matrix.python-version }}
	allow-prereleases: ${{ matrix.experimental }}

	- name: Set up WSL (Windows)
	if: matrix.os-type == 'windows'
	uses: Vampire/setup-wsl@v7.0.0
	with:
	wsl-version: 1

	- 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 ./smmap ./gitdb '.[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" \
	"${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",
	"$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: Check types with basedpyright
	if: matrix.os-type == 'ubuntu' && matrix.python-version == '3.12'
	run: \|
	basedpyright --warnings

	- 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

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Uh oh!

Add GitHub Actions workflow for Python package publishing #2838

Workflow file

Add GitHub Actions workflow for Python package publishing #2838

Uh oh!

Workflow file for this run