mirror of
https://github.com/psycopg/psycopg2.git
synced 2025-01-31 09:24:07 +03:00
69 lines
1.9 KiB
ReStructuredText
69 lines
1.9 KiB
ReStructuredText
How to make a psycopg2 release
|
|
==============================
|
|
|
|
- Edit ``setup.py`` and set a stable version release. Use PEP 440 to choose
|
|
version numbers, e.g.
|
|
|
|
- ``2.7``: a new major release, new features
|
|
- ``2.7.1``: a bugfix release
|
|
- ``2.7.1.1``: a release to fix packaging problems
|
|
- ``2.7.2.dev0``: version held during development, non-public test packages...
|
|
- ``2.8b1``: a beta for public tests
|
|
|
|
In the rest of this document we assume you have exported the version number
|
|
into an environment variable, e.g.::
|
|
|
|
$ export VERSION=2.8.4
|
|
|
|
- Push psycopg2 to master or to the maint branch. Make sure tests on `GitHub
|
|
Actions`__.
|
|
|
|
.. __: https://github.com/psycopg/psycopg2/actions/workflows/tests.yml
|
|
|
|
- Create a signed tag with the content of the relevant NEWS bit and push it.
|
|
E.g.::
|
|
|
|
# Tag name will be 2_8_4
|
|
$ git tag -a -s ${VERSION//\./_}
|
|
|
|
Psycopg 2.8.4 released
|
|
|
|
What's new in psycopg 2.8.4
|
|
---------------------------
|
|
|
|
New features:
|
|
|
|
- Fixed bug blah (:ticket:`#42`).
|
|
...
|
|
|
|
- Create the packages:
|
|
|
|
- On GitHub Actions run manually a `package build workflow`__.
|
|
|
|
.. __: https://github.com/psycopg/psycopg2/actions/workflows/packages.yml
|
|
|
|
- When the workflows have finished download the packages from the job
|
|
artifacts.
|
|
|
|
- Only for stable packages: upload the signed packages on PyPI::
|
|
|
|
$ twine upload -s wheelhouse/psycopg2-${VERSION}/*
|
|
|
|
- Create a release and release notes in the psycopg website, announce to
|
|
psycopg and pgsql-announce mailing lists.
|
|
|
|
- Edit ``setup.py`` changing the version again (e.g. go to ``2.8.5.dev0``).
|
|
|
|
|
|
Releasing test packages
|
|
-----------------------
|
|
|
|
Test packages may be uploaded on the `PyPI testing site`__ using::
|
|
|
|
$ twine upload -s -r testpypi wheelhouse/psycopg2-${VERSION}/*
|
|
|
|
assuming `proper configuration`__ of ``~/.pypirc``.
|
|
|
|
.. __: https://test.pypi.org/project/psycopg2/
|
|
.. __: https://wiki.python.org/moin/TestPyPI
|