| commit | author | age | ||
| 66fcbf | 1 | Releasing Pyramid |
| CM | 2 | ================= |
| 3 | ||
| 4 | - Make sure all unit tests pass and statement coverage is at 100%:: | |
| 5 | ||
| 6 | $ python setup.py nosetests --with-coverage | |
| 7 | ||
| e85fd7 | 8 | - Make sure all scaffold tests pass: |
| d6cc11 | 9 | |
| e85fd7 | 10 | $ python pyramid/scaffolds/tests.py |
| d6cc11 | 11 | |
| 66fcbf | 12 | - Ensure all features of the release are documented (audit CHANGES.txt or |
| CM | 13 | communicate with contributors). |
| 14 | ||
| 15 | - Copy relevant changes (delta bug fixes) from CHANGES.txt to | |
| cc85e7 | 16 | docs/whatsnew-X.X (if it's a major release). |
| 66fcbf | 17 | |
| CM | 18 | - Make sure docs render OK:: |
| 19 | ||
| 20 | $ cd docs | |
| 21 | $ make clean html | |
| 22 | ||
| 23 | There should be no meaningful errors or warnings. | |
| 24 | ||
| 142f9a | 25 | - Change setup.py version to the new version number. |
| 66fcbf | 26 | |
| CM | 27 | - Change docs/conf.py version to the new version number. |
| 28 | ||
| 29 | - Change CHANGES.txt heading to reflect the new version number. | |
| 30 | ||
| 31 | - Make sure PyPI long description renders (requires ``collective.dist`` | |
| 32 | installed into your Python):: | |
| 33 | ||
| 34 | $ python setup.py check --restructuredtext | |
| 35 | ||
| 36 | - Create a release tag. | |
| 37 | ||
| 38 | - Release to PyPI:: | |
| 39 | ||
| 40 | $ python setup.py sdist register upload | |
| 41 | ||
| 42 | - Edit `http://wiki.python.org/moin/WebFrameworks | |
| 43 | <http://wiki.python.org/moin/WebFrameworks>`_. | |
| 44 | ||
| 45 | - Publish new version of docs. | |
| 46 | ||
| 47 | - Announce to maillist. | |
| 48 | ||
| 49 | - Announce to Twitter. | |
| 50 | ||
| 5aeb91 | 51 | Announcement template |
| CM | 52 | ---------------------- |
| 66fcbf | 53 | |
| 5aeb91 | 54 | Pyramid 1.1.X has been released. |
| CM | 55 | |
| 56 | Here are the changes: | |
| 57 | ||
| 58 | <<changes>> | |
| 59 | ||
| 60 | A "What's New In Pyramid 1.1" document exists at | |
| 61 | http://docs.pylonsproject.org/projects/pyramid/1.1/whatsnew-1.1.html . | |
| 62 | ||
| 63 | You will be able to see the 1.1 release documentation (across all | |
| 64 | alphas and betas, as well as when it eventually gets to final release) | |
| 65 | at http://docs.pylonsproject.org/projects/pyramid/1.1/ . | |
| 66 | ||
| 67 | You can install it via PyPI: | |
| 68 | ||
| 69 | easy_install Pyramid==1.1a4 | |
| 70 | ||
| 71 | Enjoy, and please report any issues you find to the issue tracker at | |
| 72 | https://github.com/Pylons/pyramid/issues | |
| 73 | ||
| 74 | Thanks! | |
| 75 | ||
| 76 | - C | |
