We automate wheel building using this custom github repository that builds on the travis-ci OSX machines, travis-ci Linux machines, and the Appveyor VMs.
The travis-ci interface for the builds is https://travis-ci.org/MacPython/pyreadstat-wheels
Appveyor interface at https://ci.appveyor.com/project/matthew-brett/pyreadstat-wheels
The driving github repository is https://github.com/MacPython/pyreadstat-wheels
The wheel-building repository:
repair
(Manylinux1). delocate
and auditwheel
copy the required dynamic libraries into the wheel and relinks the extension modules against the copied libraries;The resulting wheels are therefore self-contained and do not need any external dynamic libraries apart from those provided as standard by OSX / Linux as defined by the manylinux1 standard.
The .travis.yml
file in this repository has a line containing the API key for the Rackspace container encrypted with an RSA key that is unique to the repository - see https://docs.travis-ci.com/user/encryption-keys. This encrypted key gives the travis build permission to upload to the Rackspace containers we use to house the uploads.
You will likely want to edit the .travis.yml
and appveyor.yml
files to specify the BUILD_COMMIT
before triggering a build - see below.
You will need write permission to the github repository to trigger new builds on the travis-ci interface. Contact us on the mailing list if you need this.
You can trigger a build by:
In general, it is better to trigger a build with a commit, because this makes a new set of build products and logs, keeping the old ones for reference. Keeping the old build logs helps us keep track of previous problems and successful builds.
Which pyreadstat commit does the repository build?The pyreadstat-wheels
repository will build the commit specified in the BUILD_COMMIT
at the top of the .travis.yml
and appveyor.yml
files. This can be any naming of a commit, including branch name, tag name or commit hash.
Note: when making a release, it's best to only push the commit (not the tag) of the release to the pyreadstat
repo, then change BUILD_COMMIT
to the commit hash, and only after all wheel builds completed successfully push the release tag to the repo. This avoids having to move or delete the tag in case of an unexpected build/test issue.
Be careful, these links point to containers on a distributed content delivery network. It can take up to 15 minutes for the new wheel file to get updated into the containers at the links above.
When the wheels are updated, you can download them to your machine manually, and then upload them manually to pypi, or by using twine. You can also use a script for doing this, housed at : https://github.com/MacPython/terryfy/blob/master/wheel-uploader When the wheels are updated, you can download them to your machine manually, and then upload them manually to pypi, or by using twine. You can also use a script for doing this, housed at : https://github.com/MacPython/terryfy/blob/master/wheel-uploader
For the wheel-uploader
script, you'll need twine and beautiful soup 4.
You will typically have a directory on your machine where you store wheels, called a wheelhouse. The typical call for wheel-uploader would then be something like:
VERSION=0.2.0 CDN_URL=https://3f23b170c54c2533c070-1c8a9b3114517dc5fe17b7c3f8c63a43.ssl.cf2.rackcdn.com wheel-uploader -u $CDN_URL -s -v -w ~/wheelhouse -t all pyreadstat $VERSION
where:
-u
gives the URL from which to fetch the wheels, here the https address, for some extra security;-s
causes twine to sign the wheels with your GPG key;-v
means give verbose messages;-w ~/wheelhouse
means download the wheels from to the local directory ~/wheelhouse
.pyreadstat
is the root name of the wheel(s) to download / upload, and 0.2.0
is the version to download / upload.
In order to upload the wheels, you will need something like this in your ~/.pypirc
file:
[distutils] index-servers = pypi [pypi] username:your_user_name password:your_password
So, in this case, wheel-uploader will download all wheels starting with pyreadstat-0.2.0- from the URL in $CDN_URL
above to ~/wheelhouse
, then upload them to PyPI.
Of course, you will need permissions to upload to PyPI, for this to work.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4