feat: Add Python 3.13 runtime support

This commit introduces support for Python 3.13 as a runtime dependency.

The following changes were made:
- Updated `noxfile.py` to include Python 3.13 in unit and system test configurations, including necessary extras and confirming skip conditions for cpp protobuf implementation.
- Modified `setup.py` to update `python_requires` to include Python 3.13 (i.e., `<3.14`) and added the corresponding classifier.
- Updated `owlbot.py` to include Python 3.13 in the `unit_test_python_versions`, `system_test_python_versions`, and `extras_by_python` configurations.
- Created `testing/constraints-3.13.txt` by copying constraints from the 3.12 version.
- Updated `README.rst` and `docs/README.rst` to list Python 3.13 as a supported version.

Author: google-labs-jules[bot]

README.rst

@@ -51,7 +51,7 @@ dependencies.
 
 Supported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^
-Python >= 3.8
+Python >= 3.8, <3.14
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^

noxfile.py

@@ -41,7 +41,7 @@
 
 DEFAULT_PYTHON_VERSION = "3.8"
 
-UNIT_TEST_PYTHON_VERSIONS: List[str] = ["3.8", "3.9", "3.10", "3.11", "3.12"]
+UNIT_TEST_PYTHON_VERSIONS: List[str] = ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
 UNIT_TEST_STANDARD_DEPENDENCIES = [
     "mock",
     "asyncmock",
@@ -71,9 +71,14 @@
         "geography",
         "bqstorage",
     ],
+    "3.13": [
+        "tests",
+        "geography",
+        "bqstorage",
+    ],
 }
 
-SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.8", "3.11", "3.12"]
+SYSTEM_TEST_PYTHON_VERSIONS: List[str] = ["3.8", "3.11", "3.12", "3.13"]
 SYSTEM_TEST_STANDARD_DEPENDENCIES: List[str] = [
     "mock",
     "pytest",
@@ -101,6 +106,11 @@
         "geography",
         "bqstorage",
     ],
+    "3.13": [
+        "tests",
+        "geography",
+        "bqstorage",
+    ],
 }
 
 CURRENT_DIRECTORY = pathlib.Path(__file__).parent.absolute()
@@ -219,7 +229,7 @@ def unit(session, protobuf_implementation, install_extras=True):
     )
     install_unittest_dependencies(session, "-c", constraints_path)
 
-    if install_extras and session.python in ["3.11", "3.12"]:
+    if install_extras and session.python in ["3.11", "3.12", "3.13"]:
         install_target = ".[geography,alembic,tests,bqstorage]"
     elif install_extras:
         install_target = ".[all]"
@@ -395,7 +405,7 @@ def compliance(session):
     )
     if session.python == "3.8":
         extras = "[tests,alembic]"
-    elif session.python in ["3.11", "3.12"]:
+    elif session.python in ["3.11", "3.12", "3.13"]:
         extras = "[tests,geography]"
     else:
         extras = "[tests]"

owlbot.py

@@ -33,10 +33,11 @@
     "3.8": ["tests", "alembic", "bqstorage"],
     "3.11": ["tests", "geography", "bqstorage"],
     "3.12": ["tests", "geography", "bqstorage"],
+    "3.13": ["tests", "geography", "bqstorage"],
 }
 templated_files = common.py_library(
-    unit_test_python_versions=["3.8", "3.9", "3.10", "3.11", "3.12"],
-    system_test_python_versions=["3.8", "3.11", "3.12"],
+    unit_test_python_versions=["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"],
+    system_test_python_versions=["3.8", "3.11", "3.12", "3.13"],
     cov_level=100,
     unit_test_extras=extras,
     unit_test_extras_by_python=extras_by_python,

setup.py

@@ -104,6 +104,7 @@ def readme():
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
         "Operating System :: OS Independent",
         "Topic :: Database :: Front-Ends",
     ],
@@ -119,7 +120,7 @@ def readme():
         "sqlalchemy>=1.4.16,<3.0.0",
     ],
     extras_require=extras,
-    python_requires=">=3.8, <3.13",
+    python_requires=">=3.8, <3.14",
     tests_require=["packaging", "pytz"],
     entry_points={
         "sqlalchemy.dialects": ["bigquery = sqlalchemy_bigquery:BigQueryDialect"]

testing/constraints-3.13.txt

@@ -1,13 +1 @@
-# This constraints file is used to check that lower bounds
-# are correct in setup.py
-# List all library dependencies and extras in this file.
-# Pin the version to the lower bound.
-# e.g., if setup.py has "google-cloud-foo >= 1.14.0, < 2.0.0dev",
-# Then this file should have google-cloud-foo==1.14.0
-google-api-core == 1.31.5
-google-auth==1.25.0
-google-cloud-bigquery==3.3.6
-google-cloud-bigquery-storage == 2.0.0
-grpcio == 1.47.0
-pyarrow == 3.0.0
-sqlalchemy==1.4.16
+numpy>=1.23