maturin

The pyo3-abi3t crate is a specialized test crate used to verify maturin's support for the free-threaded stable ABI (abi3t).

To use this test crate, you must use a specific version of PyO3 that supports these features. Specifically, it requires the opaque-pyobject branch of the ngoldbaum/pyo3 repository, which implements the abi3t and abi3t-py3XY features that maturin's testing suite detects.

Maturin supports a wide range of platforms and architectures for building wheels and downloadable binaries:

• Windows: 32-bit x86, 64-bit x86, and arm64
• Linux: x86, x86_64, armv7, aarch64, ppc64le (musl), and s390x (gnu)
• macOS: x86_64 and aarch64

All architectures included in manylinux (aarch64, armv7l, ppc64le, ppc64, i686, x86_64, s390x) are supported.

To install the cffi-mixed-include-exclude package, which exercises a mixed CFFI/Python package with explicit include/exclude rules, run the following command from the package directory:

pip install .

If your Rust module has the same name as your Python package, IDEs may struggle with type completion. You can rename the internal Rust module (e.g., to _my_project) to distinguish it.

1. In pyproject.toml, set module-name = "<package>.<rust_module_name>".
2. In your Rust code, either rename the function in lib.rs or use the #[pyo3(name = "...")] attribute on the #[pymodule] declaration.

[tool.maturin]
module-name = "my_project._my_project"

#[pymodule]
#[pyo3(name = "_my_project")]
fn my_project(...) 

To run the test suite for this package, you must have tox installed. The tests are defined in test_pyo3_mixed_include_exclude.py and the environment configuration is managed via tox.ini.

pip install tox
tox

To install the cffi-mixed-py-subdir package, which is a mixed CFFI/Python package containing a Python source subdirectory, run the following command from the package directory:

pip install .

Install the package locally using pip.

pip install .

To run the test suite for cffi-pure, use tox. The tests are located in test_cffi_pure.py and the environment configuration is defined in tox.ini.

pip install tox
tox

On macOS, you can install maturin using Homebrew.

Warning: Installing via Homebrew will also install Rust as a dependency. If you already have Rust installed via rustup, this may result in two separate Rust installations, which can cause conflicts. If you use rustup, consider installing maturin from source with cargo instead.

brew install maturin

You can download precompiled binaries directly from the GitHub Releases page. Alternatively, you can use cargo-binstall to automate the installation from GitHub Releases.

# Run `cargo install cargo-binstall` first if you don't have cargo-binstall installed.
cargo binstall maturin