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