- Notifications
You must be signed in to change notification settings - Fork45
GitHub Action to install and run a custom maturin command with built-in support for cross compilation
License
PyO3/maturin-action
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
GitHub Action to install and run a custommaturin command with built-in support for cross compilation.
-uses:PyO3/maturin-action@v1with:command:buildargs:--release
To generate a GitHub Actions workflow for your project, try thematurin generate-ci github command.
mkdir -p .github/workflowsmaturin generate-ci github> .github/workflows/CI.ymlIf you want to build and publish a Python extension module for common Python versions, operating systems, and CPU architectures,take a look at the following examples:
- messense/crfs-rs: PyO3 abi3 wheel example
- messense/rjmespath-rs: PyO3 abi3 wheel with Rust nightly toolchain example
- milesgranger/pyrus-cramjam: PyO3 non-abi3 wheel example
- messense/auditwheel-symbols:
binbinding example using MUSL libc - adriangb/graphlib2: PyO3 abi3 wheel
- pydantic/pydantic-core: PyO3 non-abi3 wheel with PyPy support example
- messense/py-dissimilar: PyO3 non-abi3 wheel with PyPy support example
| Name | Required | Description | Type | Default |
|---|---|---|---|---|
| command | No | maturin command to run | string | build |
| args | No | Arguments to pass tomaturin subcommand | string | |
| maturin-version | No | The version ofmaturin to use. Must match atagged release | string | latest |
| manylinux | No | Control the manylinux platform tag on linux, ignored on other platforms, useauto to build for lowest compatible | string | Defaults toauto for thepublish command |
| target | No | The--target option for Cargo | string | |
| container | No | manylinux docker container image name | string | Default depends ontarget andmanylinux options, Set tooff to disable manylinux docker build and build on the host instead. |
| docker-options | No | Additional Docker run options, for passing environment variables and etc. | string | |
| rust-toolchain | No | Rust toolchain name. | string | Defaults tostable for Docker build. To use the latest available version for the host build, the user must specify this in the CI config or repo config. |
| rustup-components | No | Rustup components | string | Defaults to empty |
| working-directory | No | The working directory to run the command in | string | Defaults to the root of the repository |
| sccache | No | Enable sccache for faster builds | boolean | Defaults tofalse |
| before-script-linux | No | Script to run before the maturin command on Linux | string |
By default, this action uses the following containers for supported architectures and manylinux versions.
| Architecture | Manylinux version | Default container | Note |
|---|---|---|---|
| x86_64 | 2010/2_12 | quay.io/pypa/manylinux2010_x86_64:latest | |
| x86_64 | 2014/2_17 | quay.io/pypa/manylinux2014_x86_64:latest | |
| x86_64 | 2_24 | quay.io/pypa/manylinux_2_24_x86_64:latest | Deprecated |
| x86_64 | 2_28 | quay.io/pypa/manylinux_2_28_x86_64:latest | |
| i686 | 2010/2_12 | quay.io/pypa/manylinux2010_i686:latest | |
| i686 | 2014/2_17 | quay.io/pypa/manylinux2014_i686:latest | |
| i686 | 2_24 | quay.io/pypa/manylinux_2_24_i686:latest | Deprecated |
| aarch64 | 2014/2_17 | ghcr.io/rust-cross/manylinux2014-cross:aarch64 | |
| aarch64 | 2_24 | messense/manylinux_2_24-cross:aarch64 | Deprecated |
| aarch64 | 2_28 | ghcr.io/rust-cross/manylinux_2_28-cross:aarch64 | |
| armv7l | 2014/2_17 | ghcr.io/rust-cross/manylinux2014-cross:armv7 | |
| armv7l | 2_24 | messense/manylinux_2_24-cross:armv7 | Deprecated |
| armv7l | 2_28 | ghcr.io/rust-cross/manylinux_2_28-cross:armv7 | |
| ppc64le | 2014/2_17 | ghcr.io/rust-cross/manylinux2014-cross:ppc64le | |
| ppc64le | 2_24 | messense/manylinux_2_24-cross:ppc64le | Deprecated |
| ppc64le | 2_28 | ghcr.io/rust-cross/manylinux_2_28-cross:ppc64le | |
| ppc64 | 2014/2_17 | ghcr.io/rust-cross/manylinux2014-cross:ppc64 | |
| s390x | 2014/2_17 | ghcr.io/rust-cross/manylinux2014-cross:s390x | |
| s390x | 2_24 | messense/manylinux_2_24-cross:s390x | Deprecated |
| s390x | 2_28 | ghcr.io/rust-cross/manylinux_2_28-cross:s390x |
You can override it by supplying thecontainer input.Note that if use official manylinux docker images for platforms other thanx86_64 andi686,you will need to setup QEMU before using this action, for example
-name:Setup QEMUuses:docker/setup-qemu-action@v1-uses:PyO3/maturin-action@v1with:command:buildargs:--release
Note that theactions/setup-python action won't affect manylinux build since it's containerized,so if you want to build for certain Python version for Linux, use-i pythonX.Y in theargs option inPyO3/maturin-action instead, for example
-uses:PyO3/maturin-action@v1with:args:--release -i python3.10
To build after code changes:
npm run all
This work is released under the MIT license. A copy of the license is provided in theLICENSE file.
About
GitHub Action to install and run a custom maturin command with built-in support for cross compilation