How astral-sh/python-build-standalone works
Python Build Standalone builds portable CPython distributions for supported versions, platforms, architectures, and build variants. The principal workflow is a platform-specific build driver coordinating CPython configuration, dependencies, and build environments to produce archives; distribution tests and a Rust CLI for validation and release handling support those artifacts. The graph follows README capabilities and SOURCE INDEX references. Some runtime dispatch details and unsampled subsystems are not shown, so their links are omitted rather than inferred.
Main entry points: cpython-unix/build.py Unix builds · main.rs Artifact CLI · cpython-windows/build.py Windows builds · cpython.py CPython configuration
Components 20
Distribution builds
- Unix builds
cpython-unix/build.py - Windows builds
cpython-windows/build.py - Unix build orchestration
cpython-unix/build-main.py - Python distributions
cpython-unix/build.py
Build support
- CPython configuration
pythonbuild/cpython.py - Build environments
pythonbuild/buildenv.py - Docker images
pythonbuild/docker.py - Dependency catalog
pythonbuild/downloads.py - Build utilities
pythonbuild/utils.py
Artifact quality
- Distribution tests
pythonbuild/testdist.py
Validation and release
- Artifact CLI
src/main.rs - Artifact validation
src/validation.rs - Mach-O inspection
src/macho.rs - Metadata JSON
src/json.rs - Release packaging
src/release.rs - GitHub operations
src/github.rs - GitHub API tester
src/github_api_tester.py
Other components
- Build operator
- uv users
- GitHub Releases
Connections 27
- Build operator → Unix builds: starts build
README.md - Build operator → Windows builds: starts build
README.md - Unix builds → Unix build orchestration: delegates to
cpython-unix/build.py - Unix builds → CPython configuration: uses
cpython-unix/build.py - Unix builds → Build environments: creates
cpython-unix/build.py - Unix builds → Docker images: uses
cpython-unix/build.py - Unix builds → Dependency catalog: uses
cpython-unix/build.py - Windows builds → CPython configuration: uses
cpython-windows/build.py - Windows builds → Dependency catalog: uses
cpython-windows/build.py - Unix build orchestration → CPython configuration: uses
cpython-unix/build-main.py - Unix build orchestration → Dependency catalog: uses
cpython-unix/build-main.py - Build environments → Docker images: uses
pythonbuild/buildenv.py - Unix builds → Python distributions: produces
README.md - Windows builds → Python distributions: produces
README.md - Distribution tests → CPython configuration: uses
pythonbuild/testdist.py - Build operator → Artifact CLI: runs commands
src/main.rs - Artifact CLI → Artifact validation: uses
src/main.rs - Artifact CLI → Mach-O inspection: uses
src/main.rs - Artifact CLI → Metadata JSON: uses
src/main.rs - Artifact CLI → Release packaging: uses
src/main.rs - Artifact CLI → GitHub operations: uses
src/main.rs - Artifact validation → Metadata JSON: uses
src/validation.rs - Artifact validation → Mach-O inspection: uses
src/validation.rs - Release packaging → Metadata JSON: uses
src/release.rs - GitHub operations → Release packaging: uses
src/github.rs - Artifact CLI → GitHub Releases: uploads artifacts
src/main.rs - uv users → Python distributions: installs
README.md