| 1 |
# Platform Support |
| 2 |
|
| 3 |
Being built on cargo and rustc, maturin is limited by [rust's platform support](https://doc.rust-lang.org/nightly/rustc/platform-support.html). |
| 4 |
|
| 5 |
## Automated tests |
| 6 |
|
| 7 |
On GitHub actions, windows, macOS and linux are tested, all |
| 8 |
on 64-bit x86. FreeBSD is also tested though Cirrus CI, but might get removed at |
| 9 |
some point. Since CI is very time intensive to maintain, I'd like to stick to |
| 10 |
GitHub action and these three platforms. |
| 11 |
|
| 12 |
## Releases |
| 13 |
|
| 14 |
The following targets are built into wheels and downloadable binaries: |
| 15 |
|
| 16 |
* Windows: 32-bit and 64-bit x86 as well as arm64 |
| 17 |
* Linux: x86, x86_64, armv7, aarch64 and ppc64le (musl), as well as s390x (gnu) |
| 18 |
* macOS: x86_64 and aarch64 |
| 19 |
|
| 20 |
## Other Operating Systems |
| 21 |
|
| 22 |
It should be possible to build maturin and for maturin to build wheels on other platforms supported by rust. |
| 23 |
To add a new os, add it in target.rs and, if it doesn't behave like the other unixes, in |
| 24 |
`PythonInterpreter::get_tag`. Please also submit the output of `python -m sysconfig` as a file in the `sysconfig` folder. |
| 25 |
It's ok to edit setup.py to deactivate default features so `pip install` works, but new platforms should not |
| 26 |
require complex workaround in `compile.rs`. |
| 27 |
|
| 28 |
## Architectures |
| 29 |
|
| 30 |
All architectures included in manylinux (aarch64, armv7l, ppc64le, ppc64, i686, x86_64, s390x) are supported. |
| 31 |
I'm not sure whether it makes sense to allow architectures that aren't even |
| 32 |
supported by [manylinux](https://github.com/pypa/manylinux). |
| 33 |
|
| 34 |
## Python Support |
| 35 |
|
| 36 |
CPython 3.8 to 3.10 are supported and tested on CI, though the entire 3.x series should work. |
| 37 |
This will be changed as new python versions are released and others have their end of life. |
| 38 |
|
| 39 |
PyPy 3.6 and later also works, as does GraalPy 23.0 and later. |
| 40 |
|
| 41 |
## Manylinux/Musllinux |
| 42 |
|
| 43 |
`manylinux2014` and its newer versions as well as `musllinux_1_1` and its newer versions |
| 44 |
are supported. |
| 45 |
|
| 46 |
Since Rust and the manylinux project drop support for old manylinux/musllinux versions sometimes, |
| 47 |
after maturin 1.0 manylinux version bumps will be minor versions rather than major versions. |