Release Packaging

This is more of a "note-to-self" document, but heck it might be or become generally useful.

Steps for release:

1. Ensure that setup.py references the version that you are releasing.

2. Make sure that the docs/news.txt is updated for your new version.

3. Tag the release. For example, for tagging version 0.1:

shell$ hg tag v0.1
shell$ hg push
[etc.]

4. Create an unversioned archive from the tag.

shell$ hg archive -r v0.1 ../CoilMQ-0.1

5. Create tgz of archive:

shell$ cd ..
shell$ tar zcvf CoilMQ-0.1.tar.gz CoilMQ-0.1

6. Register the new release w/ PyPI:

shell$ cd CoilMQ-0.1
shell$ python setup.py register

7. Build source dist and upload to newly-created PyPI release:

shell$ python setup.py sdist

8. Build and push out the pydoc documentation to packages site.

shell$ epydoc --config=docs/epydoc.cfg
shell$ mkdir -p build/docs
shell$ mv docs/api/* build/docs/
shell$ python setup.py upload_docs