From: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Date: Fri, 22 Sep 2023 21:44:42 +0000 (+0200)
Subject: docs: Document what to do when a new major version of Postgres is released
X-Git-Tag: pool-3.1.8~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=be04fc1cdcfa4bc3b3b6cb947df22e77a3327eaf;p=thirdparty%2Fpsycopg.git

docs: Document what to do when a new major version of Postgres is released
---

diff --git a/docs/release.rst b/docs/release.rst
index d5f9bb816..dcbb789da 100644
--- a/docs/release.rst
+++ b/docs/release.rst
@@ -12,21 +12,25 @@ How to make a psycopg release
     .. _OpenSSL: https://www.openssl.org/source/
 
 - Check if there is a new `cibuildwheel release`__; if so, upgrade it in
-``.github/workflows/packages-bin.yml``.
+  ``.github/workflows/packages-bin.yml``.
 
   .. __: https://github.com/pypa/cibuildwheel/releases
 
 - Use ``tools/bump_version.py`` to upgrade package version numbers.
 
-- Change ``docs/news.rst`` to drop the "unreleased" mark from the version
-
 - Push to GitHub to run `the tests workflow`__.
 
   .. __: https://github.com/psycopg/psycopg/actions/workflows/tests.yml
 
-- Build the packages by triggering manually the `Build packages workflow`__.
+- Build the packages by triggering manually the ones requested among:
+
+  - `Source packages`__
+  - `Binary packages`__
+  - `Pool packages`__
 
-  .. __: https://github.com/psycopg/psycopg/actions/workflows/packages.yml
+  .. __: https://github.com/psycopg/psycopg/actions/workflows/packages-src.yml
+  .. __: https://github.com/psycopg/psycopg/actions/workflows/packages-bin.yml
+  .. __: https://github.com/psycopg/psycopg/actions/workflows/packages-pool.yml
 
 - Delete the ``wheelhouse`` directory there is one.
 
@@ -52,3 +56,22 @@ How to make a psycopg release
 - If the package is stable, omit ``-r testpypi``::
 
     $ twine upload *
+
+- Run ``tools/bump_version.py -l dev`` to bump to the next dev version.
+
+
+When a new PostgreSQL major version is released
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- Add the new version to ``tools/update_errors.py`` and run the script to add
+  new error classes.
+
+- Run the script ``tools/update_oids.py`` to add new oids. Use ``-h`` to get
+  an example docker command line to run a server locally.
+
+- Bump ``PG_VERSION`` in the ``macos`` job of
+  ``.github/workflows/packages-bin.yml``.
+
+- Bump ``pg_version`` in ``tools/build/build_macos_arm64.sh``.
+
+- Bump the version in ``tools/build/wheel_win32_before_build.bat``.
diff --git a/psycopg/psycopg/postgres.py b/psycopg/psycopg/postgres.py
index 976533a16..33143bcc6 100644
--- a/psycopg/psycopg/postgres.py
+++ b/psycopg/psycopg/postgres.py
@@ -18,7 +18,7 @@ adapters = AdaptersMap(types=types)
 for t in [
     TypeInfo('"char"', 18, 1002),
     # autogenerated: start
-    # Generated from PostgreSQL 15.0
+    # Generated from PostgreSQL 16.0
     TypeInfo("aclitem", 1033, 1034),
     TypeInfo("bit", 1560, 1561),
     TypeInfo("bool", 16, 1000, regtype="boolean"),
diff --git a/psycopg_c/psycopg_c/_psycopg/oids.pxd b/psycopg_c/psycopg_c/_psycopg/oids.pxd
index 2a864c4a1..095256347 100644
--- a/psycopg_c/psycopg_c/_psycopg/oids.pxd
+++ b/psycopg_c/psycopg_c/_psycopg/oids.pxd
@@ -11,7 +11,7 @@ cdef enum:
 
     # autogenerated: start
 
-    # Generated from PostgreSQL 15.0
+    # Generated from PostgreSQL 16.0
 
     ACLITEM_OID = 1033
     BIT_OID = 1560
diff --git a/tools/build/scaleway_m1.sh b/tools/build/scaleway_m1.sh
index 3fe288e43..a80374681 100755
--- a/tools/build/scaleway_m1.sh
+++ b/tools/build/scaleway_m1.sh
@@ -66,7 +66,7 @@ function delete {
 }
 
 function server_id {
-    # Return the id of the first server available, else the emtpy string
+    # Return the id of the first server available, else the empty string
     servers=$(get $servers_url || error "failed to request servers list")
     server_ids=$(echo "$servers" | jq -r ".servers[].id")
     for id in $server_ids; do
diff --git a/tools/build/wheel_win32_before_build.bat b/tools/build/wheel_win32_before_build.bat
index 7c18fe3b7..1d24ab8db 100644
--- a/tools/build/wheel_win32_before_build.bat
+++ b/tools/build/wheel_win32_before_build.bat
@@ -21,3 +21,6 @@ REM On https://community.chocolatey.org/packages/postgresql15/15.0.1#discussion
 REM I found the following command in a comment:
 choco install postgresql15 --version 15.0.1
 REM which I'm going to randomly try.
+
+REM See https://community.chocolatey.org/packages/postgresql15#install
+REM for the last package available (bump the version number in the url).