Merge tag 'v0.31.0' into non-blocking-conns-v4

asyncpg v0.31.0

Enable Python 3.14 with experimental subinterpreter/freethreading
support.

Improvements
============

* Add Python 3.14 support, experimental subinterpreter/freethreading support (MagicStack#1279)
  (by @elprans in 9e42642)

* Avoid performing type introspection on known types (MagicStack#1243)
  (by @elprans in 5c9986c)

* Make `prepare()` not use named statements by default when cache is disabled (MagicStack#1245)
  (by @elprans in 5b14653)

* Implement connection service file functionality (MagicStack#1223)
  (by @AndrewJackson2020 in 1d63bb1)

Fixes
=====

* Fix multi port connection string issue (MagicStack#1222)
  (by @AndrewJackson2020 in 01c0db7)

* Avoid leaking connections if _can_use_connection fails (MagicStack#1269)
  (by @yuliy-openai in e94302d)

Other
=====

* Drop support for EOL Python 3.8 (MagicStack#1281)
  (by @elprans in 6c2c490)

# -----BEGIN PGP SIGNATURE-----
#
# iQIzBAABCAAdFiEES/rQWfT9RAppNY3YXEaHeAYth78FAmkk6UMACgkQXEaHeAYt
# h7+LBw//fX/3/nHrEUctYR7A/WQqg2oj3nvk10b3OQjzHUGyHq0DhkSC7/H9P0FI
# vl0j2n+BfKcKxOw4OgbxDq5fff/a4ScsejVwsKqQEEDH9tiXAL2cIId1yvNWC9hJ
# 8WxmkJzbFHdrl1D3/pxUv15UoaMSZD1DtPXaYEupRyEKXVOfQ/ush5GU5M3vA19R
# aWrAFtbMd3MMfaBYEO1TQtZNCV3n3Dv8fmIwv8qPbqJt2lsk4HOE8F3Be/RGiaPZ
# dI9eGnZ+qmlYC/mZYKNywaBlm4v/hHhuGwSh8WdkY6h4lFkBl8HipuPpoNeWO/fd
# k5wl1Q2HA8i2qEokz7EzYPRYjOPZwXphxscRXJQbdlCNyfJ+lPTu3uAQ08RTnoGU
# +JROauwgtQknnZEGtRWNerRcbZE1D+SgkLhGkEk6+tcIJ0G2XoCsn7A/u9LMmZuN
# 7lcFnLEdDnUSaLx7SZgcbOKP1Acg1W2Vk375JxXrymGqq5FPss8cdg+KOFMNuljT
# v/RtKvAP3yXpR448uPQ6M4BNVJ5my3UwdPrHwpGNkSxaqKBGGtryBG4LLw43yPCg
# FPFO9P//z+59RsmAvilaOhT/pLhqRvOJTkaUt5bt6Fw+5SzCfNfciNkl4rBC+9EQ
# LC/NQmO9cFYlpnO7s3uF0M+JTLV1u0CJp5G5USiQiEU+tVlaH6E=
# =bEvL
# -----END PGP SIGNATURE-----
# gpg: Signature made Tue 25 Nov 2025 12:24:51 AM CET
# gpg:                using RSA key 4BFAD059F4FD440A69358DD85C468778062D87BF
# gpg: Can't check signature: No public key

Author: Andrei K

.clang-format

@@ -0,0 +1,17 @@
+# A clang-format style that approximates Python's PEP 7
+BasedOnStyle: Google
+AlwaysBreakAfterReturnType: All
+AllowShortIfStatementsOnASingleLine: false
+AlignAfterOpenBracket: Align
+BreakBeforeBraces: Stroustrup
+ColumnLimit: 95
+DerivePointerAlignment: false
+IndentWidth: 4
+Language: Cpp
+PointerAlignment: Right
+ReflowComments: true
+SpaceBeforeParens: ControlStatements
+SpacesInParentheses: false
+TabWidth: 4
+UseTab: Never
+SortIncludes: false

.clangd

@@ -0,0 +1,4 @@
+Diagnostics:
+  Includes:
+    IgnoreHeader:
+      - "pythoncapi_compat.*\\.h"

.github/workflows/release.yml

@@ -50,13 +50,14 @@ jobs:
       PIP_DISABLE_PIP_VERSION_CHECK: 1
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         fetch-depth: 50
         submodules: true
+        persist-credentials: false
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.x"
 
@@ -76,18 +77,20 @@ jobs:
     outputs:
       include: ${{ steps.set-matrix.outputs.include }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+      - uses: actions/checkout@v5
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.x"
-      - run: pip install cibuildwheel==2.21.3
+      - run: pip install cibuildwheel==3.3.0
       - id: set-matrix
         run: |
           MATRIX_INCLUDE=$(
             {
-              cibuildwheel --print-build-identifiers --platform linux --arch x86_64,aarch64 | grep cp |  jq -nRc '{"only": inputs, "os": "ubuntu-latest"}' \
-              && cibuildwheel --print-build-identifiers --platform macos --arch x86_64,arm64 | grep cp |  jq -nRc '{"only": inputs, "os": "macos-latest"}' \
-              && cibuildwheel --print-build-identifiers --platform windows --arch x86,AMD64 | grep cp |  jq -nRc '{"only": inputs, "os": "windows-latest"}'
+              cibuildwheel --print-build-identifiers --platform linux --archs x86_64,aarch64 | grep cp |  jq -nRc '{"only": inputs, "os": "ubuntu-latest"}' \
+              && cibuildwheel --print-build-identifiers --platform macos --archs x86_64,arm64 | grep cp |  jq -nRc '{"only": inputs, "os": "macos-latest"}' \
+              && cibuildwheel --print-build-identifiers --platform windows --archs x86,AMD64 | grep cp |  jq -nRc '{"only": inputs, "os": "windows-latest"}'
             } | jq -sc
           )
           echo "include=$MATRIX_INCLUDE" >> $GITHUB_OUTPUT
@@ -110,16 +113,17 @@ jobs:
       PIP_DISABLE_PIP_VERSION_CHECK: 1
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         fetch-depth: 50
         submodules: true
+        persist-credentials: false
 
     - name: Set up QEMU
       if: runner.os == 'Linux'
-      uses: docker/setup-qemu-action@v2
+      uses: docker/setup-qemu-action@29109295f81e9208d7d86ff1c6c12d2833863392  # v3.6.0
 
-    - uses: pypa/cibuildwheel@7940a4c0e76eb2030e473a5f864f291f63ee879b  # v2.21.3
+    - uses: pypa/cibuildwheel@63fd63b352a9a8bdcc24791c9dbee952ee9a8abc  # v3.3.0
       with:
         only: ${{ matrix.only }}
       env:
@@ -149,27 +153,30 @@ jobs:
 
     steps:
     - name: Checkout source
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
       with:
         fetch-depth: 5
         submodules: true
+        persist-credentials: false
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.x"
 
     - name: Build docs
       run: |
-        pip install -e .[docs]
+        pip install --group docs
+        pip install -e .
         make htmldocs
 
     - name: Checkout gh-pages
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
       with:
         fetch-depth: 5
         ref: gh-pages
         path: docs/gh-pages
+        persist-credentials: false
 
     - name: Sync docs
       run: |
@@ -200,10 +207,11 @@ jobs:
       deployments: write
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         fetch-depth: 5
         submodules: false
+        persist-credentials: false
 
     - uses: actions/download-artifact@v4
       with:

.github/workflows/tests.yml

@@ -17,7 +17,7 @@ jobs:
     # job.
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14", "3.14t"]
         os: [ubuntu-latest, macos-latest, windows-latest]
         loop: [asyncio, uvloop]
         exclude:
@@ -27,6 +27,8 @@ jobs:
 
     runs-on: ${{ matrix.os }}
 
+    permissions: {}
+
     defaults:
       run:
         shell: bash
@@ -35,10 +37,11 @@ jobs:
       PIP_DISABLE_PIP_VERSION_CHECK: 1
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         fetch-depth: 50
         submodules: true
+        persist-credentials: false
 
     - name: Check if release PR.
       uses: edgedb/action-release/validate-pr@master
@@ -53,10 +56,12 @@ jobs:
     - name: Setup PostgreSQL
       if: "!steps.release.outputs.is_release && matrix.os == 'macos-latest'"
       run: |
-        brew install postgresql
+        POSTGRES_FORMULA="postgresql@18"
+        brew install "$POSTGRES_FORMULA"
+        echo "$(brew --prefix "$POSTGRES_FORMULA")/bin" >> $GITHUB_PATH
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       if: "!steps.release.outputs.is_release"
       with:
         python-version: ${{ matrix.python-version }}
@@ -66,7 +71,8 @@ jobs:
       run: |
         [ "$RUNNER_OS" = "Linux" ] && .github/workflows/install-krb5.sh
         python -m pip install -U pip setuptools wheel
-        python -m pip install -e .[test]
+        python -m pip install --group test
+        python -m pip install -e .
 
     - name: Test
       if: "!steps.release.outputs.is_release"
@@ -82,18 +88,21 @@ jobs:
   test-postgres:
     strategy:
       matrix:
-        postgres-version: ["9.5", "9.6", "10", "11", "12", "13", "14", "15", "16", "17"]
+        postgres-version: ["9.5", "9.6", "10", "11", "12", "13", "14", "15", "16", "17", "18"]
 
     runs-on: ubuntu-latest
 
+    permissions: {}
+
     env:
       PIP_DISABLE_PIP_VERSION_CHECK: 1
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         fetch-depth: 50
         submodules: true
+        persist-credentials: false
 
     - name: Check if release PR.
       uses: edgedb/action-release/validate-pr@master
@@ -117,7 +126,7 @@ jobs:
           >> "${GITHUB_ENV}"
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       if: "!steps.release.outputs.is_release"
       with:
         python-version: "3.x"
@@ -127,7 +136,8 @@ jobs:
       run: |
         [ "$RUNNER_OS" = "Linux" ] && .github/workflows/install-krb5.sh
         python -m pip install -U pip setuptools wheel
-        python -m pip install -e .[test]
+        python -m pip install --group test
+        python -m pip install -e .
 
     - name: Test
       if: "!steps.release.outputs.is_release"
@@ -142,6 +152,7 @@ jobs:
     name: "Regression Tests"
     needs: [test-platforms, test-postgres]
     runs-on: ubuntu-latest
+    permissions: {}
 
     steps:
       - run: echo OK

.gitignore

@@ -33,6 +33,8 @@ docs/_build
 /.pytest_cache/
 /.eggs
 /.vscode
+/.zed
 /.mypy_cache
 /.venv*
 /.tox
+/compile_commands.json

README.rst

@@ -13,8 +13,8 @@ of PostgreSQL server binary protocol for use with Python's ``asyncio``
 framework.  You can read more about asyncpg in an introductory
 `blog post <http://magic.io/blog/asyncpg-1m-rows-from-postgres-to-python/>`_.
 
-asyncpg requires Python 3.8 or later and is supported for PostgreSQL
-versions 9.5 to 17.  Other PostgreSQL versions or other databases
+asyncpg requires Python 3.9 or later and is supported for PostgreSQL
+versions 9.5 to 18.  Other PostgreSQL versions or other databases
 implementing the PostgreSQL protocol *may* work, but are not being
 actively tested.
 

asyncpg/_version.py

@@ -14,4 +14,4 @@
 
 import typing
 
-__version__: typing.Final = '0.30.0'
+__version__: typing.Final = '0.31.0'