1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
|
Releasing WebOb
===============
- For clarity, we define releases as follows.
- Alpha, beta, dev and similar statuses do not qualify whether a release is
major or minor. The term "pre-release" means alpha, beta, or dev.
- A release is final when it is no longer pre-release.
- A *major* release is where the first number either before or after the
first dot increases. Examples: 1.6.0 to 1.7.0a1, or 1.8.0 to 2.0.0.
- A *minor* or *bug fix* release is where the number after the second dot
increases. Example: 1.6.0 to 1.6.1.
Releasing
---------
- First install the required pre-requisites::
$ pip install setuptools_git twine
- Edit ``CHANGES.txt`` to add a release number and data and then modify
``setup.py`` to update the version number as well.
- Run ``python setup.py sdist bdist_wheel``, then verify ``dist/*`` hasn't
increased dramatically compared to previous versions (for example,
accidentally including a large file in the release or pyc files).
- Upload the resulting package to PyPi: ``twine upload
dist/WebOb-<version>*{whl,tar.gz}``
Marketing and communications
----------------------------
- Announce to Twitter::
WebOb 1.x released.
PyPI
https://pypi.python.org/pypi/webob/1.x.y
Changes
http://docs.webob.org/en/1.x-branch/
Issues
https://github.com/Pylons/webob/issues
- Announce to maillist::
WebOb 1.x.y has been released.
Here are the changes:
<<changes>>
You can install it via PyPI:
pip install webob==1.x.y
Enjoy, and please report any issues you find to the issue tracker at
https://github.com/Pylons/webob/issues
Thanks!
- WebOb developers
|