astral-sh/python-build-standalone
Python Build Standalone
python-build-standalone is a toolchain designed to produce redistributable Python executables across multiple operating systems and hardware architectures. It generates standalone Python binaries that can be distributed to users without requiring a pre-installed system interpreter.
The project manages the end-to-end process of cross-platform compilation using target triples and containerized environments to ensure consistent binary output. It includes a distribution pipeline that automates the generation of build matrices and the uploading of compiled artifacts to public release pages and mirror buckets.
The toolset also provides binary release analysis capabilities, allowing for the comparison of two compiled binaries through visual reports to identify unexpected changes between versions. This encompasses a full lifecycle of build toolchain standardization, release management, and artifact mirroring.
Features
- Standalone Python Distribution - Produces redistributable Python executables that include their own runtime, removing the need for a pre-installed system interpreter.
- Cross-Compilation Toolchains - Integrates various compiler suites to generate standalone binaries for diverse architectures from a single host.
- Cross-Platform Toolchains - Provides a toolchain for managing target triples and containerized environments to ensure consistent cross-platform output.
- Build Toolchains - Standardizes build toolchains using containerized environments and target triples for compatible binary output.
- CI Environment Standardization - Standardizes build runner images to maintain consistency between local and CI compilation environments.
- Containerized Build Environments - Uses isolated container images to ensure consistent toolchains and reproducible binary compilation.
- Release Automation - Manages the end-to-end automated lifecycle of compiling, testing, and publishing Python artifacts.
- Cross-Platform Python Compilation - Implements a standardized process for building Python binaries across multiple operating systems and architectures.
- Binary Analysis Tools - Provides a utility to inspect and compare compiled binaries to identify release regressions.
- Multi-Target Release Distribution - Distributes compiled binaries simultaneously to public release pages and multiple mirror storage providers.
- Release Lifecycle Managers - Automates the progression of software versions through draft releases and formal version tags.
- Package Distribution Pipelines - Provides an automated CI workflow for generating build matrices and distributing compiled packages.
- Binary Difference Analysis - Identifies unexpected changes between releases by comparing binary contents via visual reports.
- Target Compiler Mappings - Maps target hardware and operating systems to specific platform strings to determine compiler flags.
- Visual Binary Diff Tools - Includes tools for visual comparison of binary contents to detect unexpected changes between versions.
- Build Matrix Generation - Programmatically calculates the matrix of target architectures and OS versions for CI build generation.
