Awesome
python-manylinux-demo
Demo project for building Python wheels for Linux with Travis-CI
This is an example of how to use Travis-CI to build PEP 513-compatible wheels for Python. It supports
- manylinux1 for both Python 2 and 3 on 32 and 64 bit linux architectures.
- manylinux2010 for Python 2 and 3 on 64 bit linux architectures.
Because these wheels need to be compiled with a specific toolchain and support libraries , this example uses Docker running on Travis-CI to compile (you don't need to use docker at all to use these wheels, it's just to compile them). The docker-based build environment images are:
- 64-bit image for manylinux1 (x86-64):
quay.io/pypa/manylinux1_x86_64
- 32-bit image for manylinux1 (i686):
quay.io/pypa/manylinux1_i686
- 64-bit image for manylinux2010 (x86-64):
quay.io/pypa/manylinux2010_x86_64
This sample project contains a very simple C compile extension module that links
to an external library (ATLAS, a linear algebra library). The build is
configured via the setup.py
file.
Continuous integration setup with Travis + Docker
The .travis.yml
file in this repository sets up the build environment. The
resulting build logs can be found at
https://travis-ci.org/pypa/python-manylinux-demo
The .travis.yml
file instructs Travis to run the script
travis/build-wheels.sh
inside of the various docker build environments. This
script builds the package using pip
. But these wheels link against an
external library. So to create self-contained wheels, the build script runs the
wheels through auditwheel
, which
copies the external library into the wheel itself, so that users won't need to
install any extra non-PyPI dependencies.
Code of Conduct
Everyone interacting in the python-manylinux-demo project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PSF Code of Conduct.