chore(deps): bump the actions group with 2 updates

Bumps the actions group with 2 updates: [actions/checkout](https://github.com/actions/checkout) and [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel).

Updates `actions/checkout` from 5 to 6
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v5...v6)

Updates `pypa/cibuildwheel` from 3.2.1 to 3.3.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/v3.2.1...v3.3.0)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: pypa/cibuildwheel
  dependency-version: 3.3.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
...

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

chore: bump psycopg package version to 3.3.3.dev1

chore: bump psycopg package version to 3.3.2

Merge pull request #1231 from noirbee/fix/1230-adapter-get-dumper-race-condition

Avoid race condition when replacing class name with itself

fix(adapters): avoid race condition when replacing class name with itself

Another thread may be switched to between the dmap.pop(fqn) instruction
and the dmap[scls] one, typically at program startup when multiple
threads are making their "first" queries.

Close #1230

fix: mark external libpq C functions as noexcept nogil

Add noexcept nogil declarations to libpq bindings and endian conversion
functions. This improves things for when we start using critical
sections inside Cython-defines types. It's also more accurate this way,
instead of only marking the APIs that are explicitly used in a nogil
block.

docs: larger font for 3.3.0 release

chore: bump psycopg package version to 3.3.2.dev1

chore: bump psycopg package version to 3.3.1

Merge branch 'fix/server-cursor-iter'

fix: fix iteration on server-side cursor

Close #1226

fix: add test to verify iteration in server-side cursor broken

See #1226

chore: bump psycopg_pool package version to 3.3.1.dev1

chore: bump psycopg package version to 3.3.1.dev1

chore: bump psycopg_pool package version to 3.3.0

chore: bump psycopg package version to 3.3.0

fix: mark new register_composite() args as keyword only

Merge pull request #1222 from dvarrazzo/fix/composite-adapt-info

Pass the entire info object to composite adapters customization functions

fix(composite): pass the entire info object to the custom functions

Previously we were passing only the names, but it is conceivable that
types might be useful too.

Make the info object hashable in order to use it with the @cache
decorator.

fix)composite): rename make_instance to make_object

The name feels more idiomatic.

Also clean up the related documentation.

chore: bump Mypy min required version to 1.19

Avoid installing Mypy as part of the tests extra: installation fails
because a binary librt is not available. As a consequence, avoid running
Mypy-based tests in test CI jobs on PyPy.

docs: 3.3 release notes cleanup and other small fixes

test: add free-threading-specific tests

Add specific concurrency tests for the public interface of connections and
cursors

PR #1211, related to free-threading support (#1095).

Merge pull request #1220 from dvarrazzo/feat/add-as-string

Add sql.as_string() and as_bytes() function

docs: drop cautionary warnings about t-strings

docs: add documentation for sql.as_string() and as_bytes() functions

fix(c): make sure to return bytes from `Literal.as_bytes()`

In some case it might have returned a bytearray or a memoryview,
according to the dumper involved.

feat: allow sql.as_string() and as_bytes() to convert values as literals

feat: add sql.as_string(), sql.as_bytes() functions

The functions are exported by the psycopg.sql module but are primarily
useful for template strings support, to allow building SQL queries
dynamically using t-strings.

Merge pull request #1215 from dvarrazzo/pool-drain

Add ConnectionPool.drain() method

feat(pool): add `drain()` method

Add the creation timestamp to the connection to verify that it should be
immediately discarded on return.

Merge pull request #1219 from dvarrazzo/fix/copy-both

Don't fail on commands rturning COPY_BOTH results

fix: don't throw errors on COPY_BOTH results

This change only allows to execute a `START_REPLICATION` command on a
suitable configured database, i.e. the following commands would work:

    conn = psycopg.connect(DSN, replication="database", autocommit=True)
    conn.execute(
        """
        START_REPLICATION SLOT "my_replication_slot"
        LOGICAL 0/0 (proto_version '1',publication_names 'my_publication')
        """)
    <psycopg.Cursor [COPY_BOTH] [ACTIVE] at 0x...>

instead of gettgin an error such as  "COPY cannot be used with this method".

Please check https://github.com/psycopg/psycopg/issues/71#issuecomment-3393722855
for the description of the db configuration required to make this command work.

No further support for logical replication is planned at this moment, but this
change allows to play with replication without needing to go down at libpq
level to execute replication commands.

Merge pull request #1218 from dvarrazzo/feat/update-loaders

Allow to change loaders in results already returned

feat: allow to change loaders in results already returned

Close #884

Merge pull request #1184 from immortalcodes/feat-store-state-in-transaction

Added transaction attribute to record rollback/commit

docs: improvements to Transaction.status documentation

fix: make Transaction.Status a string enum

docs: add documentation for Transaction status

refactor: remove enter/exit attributes from transaction

feat: add Transaction attribute to record the transaction state

Merge pull request #1177 from adityatoshniwal/master

feat: add support for setting cursor result set position

fix: improve set_result() proposal:

- make it async on async cursors (consistently with `results()`,
  inconsistently with `nextset()`, but the latter being sync on async
  cursors was a design mistake);
- raise IndexError, consistently with sequences, better error message;
- fix test, which were simply broken and the OP didn't bother to fix
  them;
- documentation improved.

feat: add support for setting cursor result set position for multi-result queries

ci: add Python 3.14 tests on macOS, Windows

chore: bump psycopg_pool package version to 3.2.8

chore: bump psycopg package version to 3.2.13

Merge branch 'fix/pool-check-cancel-master'

fix(pool): trap CancelledError more consistently in the pool codebase

Include also places that were left out such as the rollback and the task
scheduling.

Note that we are relaxing the exception handler we had set up to fix the
problem with cancelled clients on wait (#509): we only had to trap
CancelledError additionally but we started managing the whole
BaseException. I don't think that trapping KeyboardException or
SystemExit without re-raising is a good idea (I think that, for
robustness, we should, but then things become very verbose and not
necessarily correct).

fix(pool): manage CancelledError in some exception handling path

If a CancelledError was raised during check the connection would have
been lost. The exception would have bubbled up but likely users are
using some framework swallowing it because nobody reporting the "lost
connections" issue actually reported the CancelledError.

Close #1123
Close #1208

refactor(pool): add _close_connection() method

Improves on the solution for #1124

docs: fix released version in news entry

ci: only run docs workflow on the main repo

https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#example-only-run-job-for-specific-repository

Merge pull request #1207 from deeshantk/fix/improve-dns-error-message

Fix/improve dns error message

docs: mention more informative hostname resolution error message in news

test: test that the host is in the error message on name resolution error

fix(conninfo): improve error message when host resolution fails

Merge pull request #1210

Fix copy concurrency

fix; keep the lock for the entire duration of copy

Avoid errors in concurrent operations on the same connection, from
different cursors.

Close #1210

Fix AsyncCursor.copy concurrency

Apply linter diff

Add test_copy_concurrency and update news

Update docs/news.rst

Co-authored-by: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Update tests/test_copy_async.py

Co-authored-by: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Update tests/test_copy_async.py

Co-authored-by: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Update tests/test_copy_async.py

Co-authored-by: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Simplify execution_log assertion

Revert unnecessary imports

chore(deps): bump the actions group with 2 updates

Bumps the actions group with 2 updates: [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) and [actions/upload-artifact](https://github.com/actions/upload-artifact).

Updates `pypa/cibuildwheel` from 3.2.0 to 3.2.1
- [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/v3.2.0...v3.2.1)

Updates `actions/upload-artifact` from 4 to 5
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v4...v5)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-version: 3.2.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: actions/upload-artifact
  dependency-version: '5'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
...

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

Merge pull request #1202 from dvarrazzo/feat/customize-composite-dumper

Customize composite dumper

docs: add generic object to composite adaptation docs

feat: add make_sequence parameter to register_dumper

Allow to customize the way to extract a sequence from an object to dump
it as composite type.

refactor(composite) mark private classes with leading underscore

fix(c): fix error revealed by Cython 3.2

The error was likely introduced in cec696609b334aa32f871bd342e39b431fc799db
but the Cython compiler didn't flag it as error.

Merge pull request #932 from seandstewart/sean/composite-keword-args

Support loading composite types with keyword arguments

docs: add docs for register_composite's make_instance param

refactor: use make_instance instead of use_keywords

This model is more similar to psycopg2 and allow more freedom to define
how to return a class. There could be a mix of positional and keyword
arguments for example.

feat: support loading composite types with keyword arguments

Changes:

1. Add `KeywordComposite*` classes to support loading composite types with keyword arguments.
2. Some optimizations for the `*BinaryLoader`.
    - Use a generator to unpack (oid, value) pairs.
    - Use a membership check instead of `KeyError` to optimize hot loops when looking up transformers.
3. Generics for the `*InstanceLoader` so mypy can better-track output results.

---

Co-authored by Daniele Varrazzo, mostly rebasing the feature on the
refactoring happening in the composite loading in #1175 and applying
some suggested PR changes.

refactor: cleaner inheritance in record/composite loaders

- Avoid a common base class to reuse the code, use module-level
  functions.
- Make the inheritance lines of text and binary loaders similar.
- Add documentation and notes.

This refactoring is in preparation of the implementation of these
loaders in C, to clarify and simplify things. See #1175.

Merge pull request #1167 from dsuhinin/dmitriy/change-connection-pool-creds

Introduce a way to update connection pool credentials

docs(pool): add API documentation for conninfo/kwargs as callable

feat(pool): allow conninfo/kwargs to be callable

Allow to change connection pool credentials dynamically without
requiring pool re-creation.

Merge pull request #1196 from dvarrazzo/refactor/fast-sequence

Refactor C API to use PyObject_Fast* functions

refactor: look up for the oid for None only if None is actually dumped

perf: use PySequence_Fast function instead of slower alternatives

fix(c): allow set_loader_types to be any sequence

Merge pull request #1199 from dvarrazzo/cython-lint

Add cython code linting

chore: add cython-lint to pre-commit hooks

style: clean up cython code with a pass of cython-lint

perf: use a C var for comparison instead of a Python var

chore: remove unneeded type-ignore comment

Problem solved with Cython 3.1.6 apparently.

Merge pull request #1197 from mliezun/riscv64-support

Add riscv64 support for linux builds

ci: extend CI configuration to include riscv64 architecture support on libpq

ci: update CI configuration to support riscv64 architecture and Rocky Linux

ci: fix proxy-based tests

Move pproxy_fix out of tests package and use it as a script. Importing
it fails in cibuildwheel otherwise

Exclude the proxy test on Win/macOS. They don't work there, but for all
other test they got skipped as side effects of other markers.

test(pool): consider another test flakey

test(pool): consider test flakey

It fails regularly in CI on Windows

docs: add install differences grid

chore: bump psycopg_pool package version to 3.2.7

chore: bump psycopg package version to 3.2.12

Merge pull request #1193 from jerch/fix/no-pinning-copy-text

docs: add note about fixing the copy pinning issue

test(copy): cover the Python implementation in copy pinning tests

fix(copy): restore selecting loader for each item

In the copy refactoring released in 3.2.11 we changed the behaviour to
choosing a dumper at the first non-null value per column and keeping it.

Turns out more people than expected rely on the more flexible behaviour
of passing strings or types and letting postgres do the conversion.

Restore the previous behaviour; however it's possible to use
`copy.set_types()` to set dumpers per column and gain something in
performance.

Fix #1192

ci: enable lint on pull requests

This now matches the tests workflow.

Merge pull request #1067 from psycopg/sqlalchemy-nullpool

Allow integration of psycopg pool with SQLAlchemy

fix(pool): more robust placement of reconnection attempts

The problem reported in #1176 is the close recursion already fixed.
However, because we try to reconnect before closing, we end up scheduling
a reconnection attempt for every recursion loop.

The recursion shouldn't happen anymore, but it seems more robust to
reconnect after the connection has been successfully closed, otherwise
we might end up requesting more connections than we ought (hopefully not
as dramatically as here anyway).

fix(pool): fix infinite loop with close_returns=True

Close #1124

docs(pool): a proto-only SQLAlchemy url suffices as we are passing a creator