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.

License

To the extent possible under law, Robert T. McGibbon has waived all copyright and related or neighboring rights to python-manylinux-demo. This work is published from: United States of America.