Crate maturin[−][src]
Expand description
Builds wheels from a crate that exposes python bindings through pyo3
The high-level api is BuildOptions, which can be converted into the BuildContext, which then uses compile() and builds the appropriate wheels.
Cargo features
Default features: auditwheel, log, upload, rustls
-
auditwheel: Reimplements the more important part of the auditwheel package in rust. A wheel is checked by default, unless deactivated by cli arguments
-
log: Configures pretty-env-logger, even though maturin doesn’t use logging itself.
-
upload: Uses reqwest to add the upload command.
-
rustls: Makes reqwest use the rustls stack so that we can build maturin in a CentOS 6 docker container and which maturin itself manylinux compliant.
-
human-panic: Adds https://github.com/rust-clique/human-panic
-
password-storage (off by default): Uses the keyring package to store the password. keyring pulls in a lot of shared libraries and outdated dependencies, so this is off by default, except for the build on the github releases page. (https://github.com/hwchen/secret-service-rs/issues/9)
Structs
Contains all the metadata required to build the crate
High level API for building wheels from a crate which is also used for the CLI
Extract of the Cargo.toml that can be reused for the python metadata
Python Package Metadata 2.1 as specified in https://packaging.python.org/specifications/core-metadata/
A ModuleWriter that adds the module somewhere in the filesystem, e.g. in a virtualenv
A pyproject.toml as specified in PEP 517
The location and version of an interpreter
A pip registry such as pypi or testpypi with associated credentials, used for uploading wheels
Creates a .tar.gz archive containing the source distribution
The part of the current platform that is relevant when building wheels and is supported
The metadata required to generate the .dist-info directory
A glorified zip builder, mostly useful for writing the record file of a wheel
Enums
Error raised during auditing an elf file for manylinux/musllinux compatibility
The way the rust code is used in the wheel
Decides how to handle manylinux and musllinux compliance
Error type for different types of errors that can happen when uploading a wheel.
Traits
Allows writing the module to a wheel or add it directly to the virtualenv
Functions
An reimplementation of auditwheel, which checks elf files for manylinux/musllinux compliance.
Builds the rust crate into a native module (i.e. an .so or .dll) for a specific python version. Returns a mapping from crate type (e.g. cdylib) to artifact location.
Installs a crate by compiling it and copying the shared library to site-packages. Also adds the dist-info directory to make sure pip and other tools detect the library
Creates aif source distribution, packing the root crate and all local dependencies
Uploads a single wheel to the registry
Creates the .dist-info directory and fills it with all metadata files except RECORD
Type Definitions
The wheel file location and its Python version tag (e.g. py3
).