python-build

Build Python code.

Guidance

Developers MUST run this action in a dedicated, unprivileged workflow job to limit the risk of a supply chain attack.

Build a Python distribution via GNU Make, and then upload the results to a GitHub Actions workflow artifact, an immutable archive, for use by subsequent publish actions. This installs Python via actions/setup-python. The makefile targets build-deps (which runs as the superuser) and dist handle any remaining build dependencies.

Inputs

file-that-does-not-exist:

(required; default value: "96AD5641-7C9D-4E65-81B4-F0889D389D76.does-not-exist")

Guidance

Developers MUST NOT create this file to avoid a false positive should Python distribution building fail.

This non-existent file forces actions/upload-artifact to preserve the directory structure of the workflow artifact containing the built Python Distribution; cf. actions/upload-artifact#174.

---

python-version:

(required, default value: "3.13")

Specify the version of Python with which to build the distribution.

---

artifact-name:

(default value: "build-artifacts")

This names the workflow artifact containing the built Python distribution. Disable artifact creation by setting a falsy value (false, 0, -0, "", '', null, ~).

---

skip-artifact-downloads:

Set this to true when managing the contents of the runner’s working directory outside of this action.

Deprecations

Important

The following inputs are no longer used and will be removed in a future release.

release:

This input will be removed after 2026-12-31. The action now downloads all available workflow artifacts by default. Use the skip-artifact-downloads input to change this behavior.

requirements:

This input will be removed after 2026-12-31. The action now downloads all available workflow artifacts by default. Use the skip-artifact-downloads input to change this behavior.