PyO3/maturin
Maturin
Maturin is a build tool that compiles Rust crates into Python wheel packages, supporting multiple binding systems such as PyO3, CFFI, and UniFFI to create native extension modules. It manages the full build pipeline from Rust compilation to wheel assembly, including cross-compilation for different operating systems and architectures without requiring native hardware.
The tool integrates development-mode installation with automatic rebuilds: when a Python import hook detects source changes, it triggers recompilation before the module loads. Editable installs link the compiled module into site-packages so Python edits take effect instantly. For supply chain compliance, maturin generates and embeds a software bill of materials from the Rust dependency graph and external libraries into the wheel metadata.
Beyond building, maturin offers project scaffolding for hybrid Rust/Python projects, CI workflow generation for automated publishing, and type stub generation for static type checking. It can also distribute CLI binaries bundled with the wheel and bundle arbitrary data files. Publishing to PyPI is supported, including with OpenID Connect authentication for tokenless releases.
Maturin is available as a command-line tool that can be installed via pip or cargo and integrates with existing Rust and Python development workflows.
Features
- Rust Python Extension Developers - Builds fast Python extension modules from Rust using PyO3, CFFI, or C bindings.
- Wheel Compilation - Compiles Rust crates into platform-specific Python wheels with native extensions for multiple Python versions.
- Target Registries - Provides preconfigured toolchain profiles and target triples for building Python wheels across many platforms.
- Editable Installations - Installs packages in editable mode so Python changes reflect instantly without rebuilding the extension.
- Source Distribution Builders - Generates Python source distributions from Rust crates, enabling native compilation during installation.
- Native Module Rebuild Triggers - Installs Rust-based Python modules so edits trigger automatic rebuild on import.
- Import-Hook Rebuild Triggers - Detects Rust source changes via a Python import hook and triggers automatic recompilation before module loading.
- Multi-Binding - Provides a uniform build pipeline supporting PyO3, CFFI, uniffi, and binary scripts for Rust-to-Python wheel generation.
- PyO3 Extension Builders - Builds native Python extension modules from Rust code using the PyO3 binding system.
- Development Module Installers - Compiles and installs Rust crates as Python modules into the active virtual environment.
- Python Bindings - Generates native Python extension modules from Rust code using PyO3, CFFI, and UniFFI binding systems.
- CFFI Binding Generators - Generates C header files from Rust code and builds Python packages via the C Foreign Function Interface.
- Automatic Rust Module Builders - Automatically builds Rust source files into Python modules when imported.
- Portability Validators - Validates Linux wheels against manylinux rules and bundles missing shared libraries for broad distribution compatibility.
- Rust Cross-Platform Wheel Compilers - Compiles Rust crates into platform-specific Python wheels with cross-compilation support.
- Python Runtime Compatibility - Builds extensions compatible with CPython, PyPy, and GraalPy across multiple Python versions.
- Python Wheel - Cross-compiles Rust-based Python wheels for alternative architectures without needing native hardware.
- UniFFI - Generates Python bindings from an interface definition file using UniFFI for cross-platform compatibility.
- Pure Rust Wheel Packagers - Builds a Python wheel from a pure Rust crate, automatically generating an initialization module.
- Rust Compilation Configurations - Lets developers specify Rust build profiles, features, and flags to control compilation before packaging.
- SBOM Generators - Generates and embeds a software bill of materials from the Rust dependency graph into wheel metadata.
- Hybrid Language Scaffolders - Creates new projects mixing Rust and Python with automatic build configuration for native extensions.
- Rust Python Extension Scaffolders - Scaffolds new Rust projects with build configuration for Python extensions.
- Type Stub Generators - Generates and bundles Python type stub files into the wheel for static type checking support.
- CI Workflow Generators - Generates CI workflow files for GitHub Actions to automate building and publishing wheels.
- CLI Binary Distributions - Wraps compiled Rust binaries as Python scripts, making them command-line tools after installation.
- Package Metadata - Merges Python package metadata from pyproject.toml with Rust project configuration for full control.
- PyPI Uploaders - Uploads built Python packages to the Python Package Index for public distribution.
- Portability Compliance Validators - Validates Linux wheels against portability rules and tags them for broad distribution compatibility.
- Cross-Compilation Tools - Enables building Python wheels for multiple OS and CPU architectures from a single host without native hardware.
- Mixed-Source Project Organizations - Organizes projects with both Rust and Python source files, placing the native extension alongside Python code.
