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).