mirrors/pycapnp
1
0
Fork 0
mirror of https://github.com/capnproto/pycapnp.git synced 2025-03-04 08:24:43 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
pycapnp/DEPLOY.md
Jason Paryani cb3f190b95 Add deploy notes about tags
2019-02-01 15:11:53 -08:00

1.9 KiB
Raw Blame History

Deployment instructions for PyPi

This file is meant for maintainers of pycapnp, and documents the process for uploading to PyPI.

Pre-requisites

pip install pypandoc cython

Run tests

I typically sanity check by running the tests once again locally, but as long as Travis is green, you're probably fine.

Add a commit that bumps the version

Bump the version in setup.py, and add descriptions of all the changes to CHANGELOG.md (see 19e1b189ca for an example commit).

Run the build and upload

Run the following command to clean up old artifacts, run the build, and then upload the result to PyPI

rm -rf bundled/ capnp/version.py capnp/lib/capnp.{h,cpp} build; python setup.py build && python setup.py sdist upload -r PyPI

Test the PyPI release

I manually test the PyPI release after it's been uploaded. I have a few virtualenvs that I manually run the following command in (run this from the pycapnp directory since it runs the tests at the end):

yes | pip uninstall pycapnp; pip install pycapnp && py.test test

I usually test the following configurations:

  • Python 2.7 with and without cython installed
  • Python 3.6 with and without cython installed

This step could probably benefit greatly from some automation. Perhaps even Travis could handle it, but I'm not sure how best to trigger Travis from a PyPI release.

Tag the github release

Tag the release on the develop branch (not the master branch). Sadly, I've stopped using git-flow, and at this point it might be worth moving back to using just master, but that would take some amount of work and I worry that it would break open PRs. Definitely worth considering if development picks back up.

Version numbers roughly follow semver, although I try to loosely follow upstream Cap'n Proto C++ versions as well. So when pycapnp officially starts using v0.7.0 of the C++ library, pycapnp's version should be bumped to v0.7.0 as well.