docs: drop `pq.error_message()` function from public docs

There should be no need for this function to be used by end users.

docs: document the package to install in the "from psycopg2" page

See #1156.

chore: have a scrap directory where to put work scripts light on myoy

Merge pull request #1149 from psycopg/fix/binary-copy

Fix binary copy

fix(copy): avoid sending copy data if an error is set

It would result in a partial message. The server seems to do the right
thing anyway, but let's not waste its precious time.

fix(c): fix excessive buffer allocation in binary copy

Fix #1147

chore: bump mypy, remove a now unneeded ignore

test: fix tests with master version of crdb

The server version reported is 250300. Tests fail with the error:

    psycopg.errors.OperatorIntervention: this schema change is
    disallowed because table "execmany" is locked and this operation cannot
    automatically unlock the table

    DETAIL:  To unlock the table, execute `ALTER TABLE execmany SET (schema_locked = false);`

    After the schema change completes, we recommend setting it back to
    true with `ALTER TABLE execmany SET (schema_locked = true);`.

    HINT:  Locking the table improves changefeed performance; see
    https://www.cockroachlabs.com/docs/dev/changefeed-best-practices.html#lock-the-schema-on-changefeed-watched-tables

chore(ci): bump crdb test versions

ci: run lint/tests in any branches

The `*` results in branches with a `/` excluded.

Also exclude running tests if only docs change.

Merge pull request #1166 from psycopg/fix-builtin-dumper-loader

Don't raise a warning using a builtin for JSON dumps/loads

fix: drop warning for objects passed as JSON lods/dump function

Just optimistically assume that they are ok and will not cause leaks.
The possibility of there being something else which might cause a leak
is lower than the possibility that we didn't think about something else
and raise a warning, refusing to cache the loader, and really cause a
leak.

fix: don't raise a warning using a builtin for JSON dumps/loads

These types are stable so will not leak. However they have no
code/closure dunder attr so they will raise a warning.

Fix #1165.

docs: add simple example of identifier binding with t-strings

chore: bump psycopg package version to 3.3.0.dev2

docs: mention version 3.3.0.dev1 download link in template string page

fix: typo in notifications warning

Merge pull request #1054 from psycopg/template-strings

Add template strings support.

docs: add template strings query documentation

feat: implement template strings

feat: add typing support for template strings

refactor(query): add private method to convert to bytes

refactor: move PostgresRawQuery to _queries module

test: add module to test with template strings

Skip module collection on Python version which don't support the syntax.

chore: exclude linters run on tstring test module

Currently the tooling doesn't support the syntax yet.

ci: switch to windows-2025 runners

chore: bump psycopg package version to 3.2.10

chore: isort

Merge pull request #1139 from psycopg/gssencmode-disable

Set gssencmode default to disable in binary package builds

ci: use separate build caches between psycopg 3.2 and 3.3

Introduce a suffix to change the cache key arbitrarily, to keep libpq
builds on different branches separate and not pollute each other's
cache.

fix: change default gssencmode to disable in built libpq

Fix #1136

feat: raise a warning if a GSS connection is obtained using the libpq default

Suggest the user to specify a 'gssencmode' setting explicitly so that,
in the future, we will be able to change the setting default to 'disable'.

Note: the warning in psycopg 3.3 is a runtime warning; in 3.2.x was a
deprectation warning.

See #1136

chore: restrict flake8 ignore on generated file to lines length only

Merge branch 'pg18'

feat: add `ConnectionInfo.full_protocol_version`

Add matching Capabilities methods too to allow checking if supported.

feat: add PGconn.full_protocol_version attributes

Wrap libpq 18 PQfullProtocolVersion functions.

See #1079

docs: mention PostgreSQL v18 support

ci: add PostgreSQL 18 to the test grid

chore: add PostgreSQL 18 exceptions

fix: add ConnStatus.CONNECTION_AUTHENTICATING value

Introduced in PostgreSQL 18

Merge branch 'fix-notifies-leak'

docs: document the changes to notifies generator

fix: raise a warning when notifies generator and handlers are used together

fix: collect notifies only if no handler was registered

If someone is listening to notifications by using an handler, the
notifies backlog would fill without ever being emptied.

This change has the risk of breaking something if someone is relying on
notifies being received both via callback and via generator, but I don't
know how to satisfy it without creating a leak to users who don't use the
generator. Will ask around...

Fix #1091.

Merge branch 'fix-executemany-lock'

fix: keep a lock for the entire duration of executemany

Before this change we had the lock context inside the pipeline context,
because conn.pipepline() and Pipeline.__enter/exit__ take a lock. But
this created windows of opportunities for other threads to execute
concurrent operations on the connection, resulting in "another command
is already in progress" errors.

Fix #1130.

refactor: auto-generate sync pipeline object from async one

refactor: separate sync/async pipeline in their own modules

refactor: introduce ALock/Lock in acompat

fix: fix excessive buffer resizing on int16 dump

Fix #1160

Merge pull request #1053 from psycopg/py314

Add support for Python 3.14

docs: mention Python 3.14 support in news file

test: fix pproxy compatibility with Python 3.14

Work around the issue reported in https://github.com/qwj/python-proxy/issues/200

ci: test with Python 3.14 non-dev

chore(test): drop use of asyncio event loop policy

Deprecated since Python 3.14

ci(alpine): install missing libraris required to test and package wheels

Since some recent alpine version the krb5-libs package is not installed by
default anymore. When building the libpq the package got installed as a
side effect of installing krb5-dev, but, in case libpq build was cached,
the libraries would have been missing when packaging the wheel or
importing psycopg for test.

chore: bump cibuildwheel to 3.1.4

It should help with Python 3.14 builds.

chore: add Python 3.14 to supported version metadata and docs

ci: add Python 3.14 dev to package build

ci: add Python 3.14 version to test grid

chore(tests): drop deprecated unittest redefinitions

Not used anymore in legacy tests.

doc: fix formatting of SQL command in documentation

docs: fix reST typo

docs: add notes about how to add libpq wrapper functions

Merge pull request #1140 from psycopg/add-used-gssapi

Add `PGconn.used_gssapi` attribute

feat: expose used_gssapi attribute to the public API

Already implemented in 3.1.10, but kept as internal implementation.

Fix #1138

feat: add support for libpq PQconnectionUsedGSSAPI()

We will not advertise its presence as PGconn.used_gssapi until Psycopg
3.3. However we can use it internally to implement a warning to check
the implicit usage of gssencmode=prefer.

See #1136

docs: fix confusing comment from readme

docs: drop pip upgrade info from readme

Most systems will have the minimum required version 20.3 already.

fix: fix typo require version X and greater -> or greater

test: use current timezone name

chore: bump mypy to 1.17 in dev extra dependencies too

Merge branch 'fix-binary-version'

fix(binary): fix __version__

It was taken from the psycopg-c package, so it might have been wrong or,
more likely, reported as 0.0.0.0 because not installed.

test: verify the version is sane

chore: bump mypy to 1.17

Merge branch 'cursor-results'

test: more comprehensive results() tests

Test the records returned, not only the generator results.

chore(async-to-sync): handle generator expressions

test: fix results() test

Test a server-side cursor for real, drop unneeded parametrization.

docs: cleanup of `results()` documentation

docs: document Cursor.results() and add rease note

test: test Cursor.results() method

feat: add Cursor.results() method

Merge branch 'fix-cancelled-error-shadowing'

fix(c): avoid a TypeError shadowing CancelledError on task cancellation

Fix #1005.

Merge branch 'dependabot/github_actions/master/actions-d86b61c7bf'

chore: drop i686 images build

It has become opt-in in cibuildwheel, so it's a good moment to remove
these packages.

chore(deps): bump pypa/cibuildwheel in the actions group

Bumps the actions group with 1 update: [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel).

Updates `pypa/cibuildwheel` from 2.23.3 to 3.0.0
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/v2.23.3...v3.0.0)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-version: 3.0.0
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>

test: fix failure in test_connection_warn_close

Create all the connections beforehand otherwise some may reuse the same
address, resulting in a duplicated warning message, which would be
omitted and fail the test.

fix: don't call str(self) or imported objects in __del__

We easily end up trying to access resources already unavailable in the
objects representation. In Python 3.14 this seems to happen aggressively
(or maybe it's just more visible because testing a dev version).

fix: change signature of SQL.join() to allow a sequence of Any

We declared accepting a sequence of Composable, but, because we passed
the joined values to `Composite`, actually non-composable were
interpreted as `Literal`.

Make this behaviour explicit by testing it and fixing the signature.

chore: run isort before other hooks

It's quicker to fail than mypy.

Merge branch 'fix-jsonb-function-caching-master'

fix(json): don't leak when lambdas are used as dumps/loads function

Cache functions on the code, not on the function identity itself:
different lambdas or local functions are different objects but he
underlying code object is the same.

Avoid caching if the function is a closure because it then becomes a can
of worms (if the argument is not hashable etc). Throw a warning in that
case.

Fix #1108

fix(json): don't leak when lambdas are used as loads function

fix: add missing interface for PGconn.protocol_version

Merge branch 'fix-1088'

ci: cancel concurrent binary build jobs

docs: mention fix in version 3.2.9

Revert "ci: install win32 libpq from conda force"

This reverts commit a05131ded8f1ec1816528341c5453fd586e70a4b.

Fix #1088