GTSAM Python Wheel Builder

How to Build on Linux

Run:

sudo docker run --rm -e PLAT=manylinux2014_x86_64 -v `pwd`:/io quay.io/pypa/manylinux2014_x86_64 /io/build-wheels.sh

You will need to rename the built files to a valid name:

mv gtsam-4.1.0-cp36-cp36m-manylinux2014_x86_64.none-manylinux2014_x86_64.whl gtsam-4.1.0-cp36-none-any.whl

Please consult build-macos.h.

2023-09-02

We are building for the 4.2 release.

For all OSs and architectures we support:

First check if the wheels you have built can actually install and run by:

Create a clean virtual environment
pip install {WHEEL}.whl to install the wheel
run the GTSAM unit tests to make sure the wheel works by going to gtsam_repo/python/gtsam/tests and python -m unittest discover

The most probable failures at this stage are:
- The wheel repair (auditwheel/delocate) programs have bugs and produced wrong binaries.
- Which needs manual patching, contact @ProfFan immediately

If you have confirmed that it works, you can then:

twine upload --repository testpypi {WHEEL_FILE_NAME}.whl

pip install --index-url https://test.pypi.org/simple {PACKAGE_NAME}

and test again with the unit tests

The most probable failures at this stage are:
- Inconsistent version tags between the METADATA and the file name of the wheel
- You did not test the wheel you uploaded in a fresh machine, so it's linking is not correct (only works for you)
If that still works, you can try upload to REAL PyPI (THIS IS IRREVERSIBLE!!!)

twine upload {WHEEL_FILE_NAME}.whl
# OR if you tested all 8 wheels on Test PyPI and possible users
twine upload {directory containing all wheels}