From: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Date: Thu, 26 Dec 2024 16:58:16 +0000 (+0100)
Subject: docs: restore some lost comments in pyproject.toml files
X-Git-Tag: 3.3.0.dev1~137
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8f3b2b270b3fe8a21f0dcfe377cccc1c684231f5;p=thirdparty%2Fpsycopg.git

docs: restore some lost comments in pyproject.toml files
---

diff --git a/psycopg/pyproject.toml b/psycopg/pyproject.toml
index 9550c1a2e..594a3af8c 100644
--- a/psycopg/pyproject.toml
+++ b/psycopg/pyproject.toml
@@ -5,7 +5,16 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "psycopg"
 description = "PostgreSQL database adapter for Python"
+
+# STOP AND READ! if you change:
 version = "3.3.0.dev1"
+# also change:
+# - `docs/news.rst` to declare this as the current version or an unreleased one;
+# - `psycopg_c/pyproject.toml` to the same version;
+# - the `c ` and `binary` "optional-dependencies" below to the same version.
+#
+# NOTE: you can use `tools/bump_version.py` to maintain versions.
+
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
diff --git a/psycopg_c/pyproject.toml b/psycopg_c/pyproject.toml
index aa24b989e..da8c48866 100644
--- a/psycopg_c/pyproject.toml
+++ b/psycopg_c/pyproject.toml
@@ -78,6 +78,9 @@ license-files = ["LICENSE.txt"]
 include-package-data = true
 
 [tool.setuptools.package-data]
+# NOTE: do not include .pyx files: they shouldn't be in the sdist
+# package, so that build is only performed from the .c files (which are
+# distributed instead).
 psycopg_c = [
     "py.typed",
     "*.pyi",
@@ -91,7 +94,7 @@ psycopg_binary = [
 ]
 
 # Note: these ext modules lack details such as libraries and directories.
-# They are added by the psycopg_build_ext build module.
+# They are added by the 'psycopg_build_ext' build module.
 [[tool.setuptools.ext-modules]]
 name = "psycopg_c._psycopg"
 sources = ["psycopg_c/_psycopg.c", "psycopg_c/types/numutils.c"]
diff --git a/psycopg_pool/pyproject.toml b/psycopg_pool/pyproject.toml
index a1c83857d..4a0879e83 100644
--- a/psycopg_pool/pyproject.toml
+++ b/psycopg_pool/pyproject.toml
@@ -5,7 +5,12 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "psycopg-pool"
 description = "Connection Pool for Psycopg"
+
+# STOP AND READ! if you change:
 version = "3.3.0.dev1"
+# also change:
+# - `docs/news_pool.rst` to declare this version current or unreleased
+
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",