From: Daniele Varrazzo Date: Sat, 21 Sep 2024 18:29:58 +0000 (+0200) Subject: doc: explain better that binary packages are on a best-effort basis X-Git-Tag: 3.2.3~9 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1c540ab862f3eed7c681f1bdc6cd150b59e2c1ea;p=thirdparty%2Fpsycopg.git doc: explain better that binary packages are on a best-effort basis Close #912. --- diff --git a/docs/basic/install.rst b/docs/basic/install.rst index f1d664381..9f915fbfc 100644 --- a/docs/basic/install.rst +++ b/docs/basic/install.rst @@ -66,11 +66,21 @@ to update it beforehand. Binary packages are produced on a best-effort basis; the supported platforms depend on the CI runners available to build the - packages. You can check the `psycopg-binary PyPI files`__ to verify - that your platform is supported. + packages. This means that: + + - binary packages for a new version of Python will be made available once + the runners used for the build support it; you can check the + `psycopg-binary PyPI files`__ to verify whether your platform is + supported. + + - the libpq version included in the binary package depend on the version + available on the runners. You can use the `psycopg.pq.version()` + function and the `psycopg.pq.__build_version__` constant to infer the + features available. .. __: https://pypi.org/project/psycopg-binary/#files + .. warning:: Starting from Psycopg 3.1.20, ARM64 macOS binary packages (i.e. for @@ -79,9 +89,9 @@ to update it beforehand. ` or a :ref:`Python ` installation. -If your platform is not supported you should proceed to a :ref:`local -installation ` or a :ref:`pure Python installation -`. +If your platform is not supported, or if the libpq packaged is not suitable, +you should proceed to a :ref:`local installation ` or a +:ref:`pure Python installation `. .. seealso::