test_ok2/HOWTORELEASE.rst

How to release pytest
--------------------------------------------

Note: this assumes you have already registered on pypi.

1. Bump version numbers in _pytest/__init__.py (setup.py reads it)

2. Check and finalize CHANGELOG

3. Write doc/en/announce/release-VERSION.txt and include
   it in doc/en/announce/index.txt

4. Use devpi for uploading a release tarball to a staging area::

     devpi use https://devpi.net/USER/dev
     devpi upload --formats sdist,bdist_wheel

5. Run from multiple machines::

     devpi use https://devpi.net/USER/dev
     devpi test pytest==VERSION

6. Check that tests pass for relevant combinations with::

       devpi list pytest

   or look at failures with "devpi list -f pytest".
   There will be some failed environments like e.g. the py33-trial 
   or py27-pexpect tox environments on Win32 platforms
   which is ok (tox does not support skipping on
   per-platform basis yet).

7. Regenerate the docs examples using tox, and check for regressions::

      tox -e regen
      git diff


8. Build the docs, you need a virtualenv with py and sphinx
   installed::

      cd doc/en
      python plugins_index/plugins_index.py
      make html

   Commit any changes before tagging the release.

9. Tag the release::

      git tag VERSION
      git push

10. Upload the docs using doc/en/Makefile::

      cd doc/en
      make install  # or "installall" if you have LaTeX installed for PDF

   This requires ssh-login permission on pytest.org because it uses
   rsync.
   Note that the ``install`` target of ``doc/en/Makefile`` defines where the
   rsync goes to, typically to the "latest" section of pytest.org.

   If you are making a minor release (e.g. 5.4), you also need to manually
   create a symlink for "latest"::

     ssh pytest-dev@pytest.org
     ln -s 5.4 latest

   Browse to pytest.org to verify.

11. Publish to pypi::

      devpi push pytest-VERSION pypi:NAME

   where NAME is the name of pypi.python.org as configured in your ``~/.pypirc``
   file `for devpi <http://doc.devpi.net/latest/quickstart-releaseprocess.html?highlight=pypirc#devpi-push-releasing-to-an-external-index>`_.


12. Send release announcement to mailing lists:

    - pytest-dev
    - testing-in-python
    - python-announce-list@python.org


13. **after the release** Bump the version number in ``_pytest/__init__.py``,
   to the next Minor release version (i.e. if you released ``pytest-2.8.0``,
   set it to ``pytest-2.9.0.dev1``).