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 manylinux1 wheels for Python. It supports both Python 2 and 3 on 32 and 64 bit linux architectures.
Because these wheels need to be compiled on CentOS 5, 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 (x86-64):
quay.io/pypa/manylinux1_x86_64
- 32-bit image (i686):
quay.io/pypa/manylinux1_i686
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.
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 32-bit and 64-bit manylinux1 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.
Everyone interacting in the python-manylinux-demo project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PyPA Code of Conduct.
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.