packaging.md

Packaging

Pre-requisites

1. Pandoc - To convert Markdown to Restructured Text (PyPI does not support Markdown for package descriptions)
2. pypandoc - Python wrapper for Pandoc
3. twine - For interacting with PyPI

pip install pypandoc
pip install twine

Building

Commands are run using Make.
Note: Be sure to update the version number in the setup.py file.

Tag the commit for the release. This will cause Github to generate a tarball of the code. Substitue the current version for `1.0.01 below.

git tag 1.0.0 -m "Initial release for PyPI"
git tags
git push --tags origin master

Build the package and upload it to the test version of PyPI

make package
make test-upload

If everything looks OK, upload to the production PyPI feed

make upload