Version 101 (modified by atagar, 12 months ago) (diff)

Drop workaround section. Removed the only thing listed here, and this is infrequent enough we'll just use TODO comments.

Table of Contents

  1. Release Notes

Stem Development Wiki

If you're looking for... ... it can be found at...
Main site
Getting the code git clone
Browsing the codebase
Bug tracker
Automated Testing

Release Notes

Below is a checklist for releases...

  • Recache latest information ( and
  • Tag the release
    • Bump stem's version (in stem/ and docs/index.rst).
    • git commit -a -m "Stem release 1.0.0"
    • git tag -u 9ABBEEC6 -m "stem release 1.0.0" 1.0.0 d0bb81a
    • git push --tags
  • Dry-run release on PyPI
    • python sdist
    • gpg --detach-sig --armor dist/stem-dry-run-1.0.0.tar.gz
    • twine upload dist/*
    • Check that stem-dry-run looks correct, comparing it to stem's page.
  • Final release
    • rm dist/*
    • Change the's DRY_RUN flag to false.
    • python sdist
    • gpg --detach-sig --armor dist/stem-1.0.0.tar.gz
    • twine upload dist/*
  • Contact package maintainers
  • Announce the release (example)