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