feat: Add Python 3.13 support (#930)

* Add Python 3.13 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 versions.
- Created `testing/constraints-3.13.txt` (initially empty, copied from an empty constraints-3.12.txt).
- Updated `.github/workflows/unittest.yml` to include Python 3.13 in the test matrix.
- Updated `setup.py` to add the Python 3.13 classifier.
- Updated `CONTRIBUTING.rst` to list Python 3.13 as a supported version.
- Created `.kokoro/presubmit/system-3.13.cfg` for Kokoro system tests.
- Updated `.github/sync-repo-settings.yaml` to include Python 3.13 in required status checks.
- Updated `owlbot.py` to include Python 3.13 in unit and system test versions for templated files.

* feat: Add Python 3.13 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 versions.
- Created `testing/constraints-3.13.txt` (initially empty, copied from an empty constraints-3.12.txt).
- Updated `.github/workflows/unittest.yml` to include Python 3.13 in the test matrix.
- Updated `setup.py` to add the Python 3.13 classifier.
- Updated `CONTRIBUTING.rst` to list Python 3.13 as a supported version.
- Created `.kokoro/presubmit/system-3.13.cfg` for Kokoro system tests.
- Updated `.github/sync-repo-settings.yaml` to include Python 3.13 in required status checks.
- Updated `owlbot.py` to include Python 3.13 in unit and system test versions for templated files.

* removes presubmit task for 3.12 now that we have one for 3.13

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* Update CONTRIBUTING.rst

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: 3 people

.github/sync-repo-settings.yaml

@@ -16,6 +16,7 @@ branchProtectionRules:
     - 'unit (3.10)'
     - 'unit (3.11)'
     - 'unit (3.12)'
+    - 'unit (3.13)'
     - 'cover'
     - 'Kokoro'
     - 'Samples - Lint'
@@ -24,6 +25,7 @@ branchProtectionRules:
     - 'Samples - Python 3.10'
     - 'Samples - Python 3.11'
     - 'Samples - Python 3.12'
+    - 'Samples - Python 3.13'
 permissionRules:
   - team: actools-python
     permission: admin

.github/workflows/unittest.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        python: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        python: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13']
     steps:
     - name: Checkout
       uses: actions/checkout@v4

.kokoro/presubmit/system-3.12.cfg renamed to .kokoro/presubmit/system-3.13.cfg

@@ -3,5 +3,5 @@
 # Only run the following session(s)
 env_vars: {
   key: "NOX_SESSION"
-  value: "system-3.12"
-}
+  value: "system-3.13"
+}

CONTRIBUTING.rst

@@ -22,7 +22,7 @@ In order to add a feature:
   documentation.
 
 - The feature must work fully on the following CPython versions:
-  3.8, 3.9, 3.10, 3.11 and 3.12 on both UNIX and Windows.
+  3.8, 3.9, 3.10, 3.11, 3.12 and 3.13 on both UNIX and Windows.
 
 - The feature must not add unnecessary dependencies (where
   "unnecessary" is of course subjective, but new dependencies should
@@ -72,7 +72,7 @@ We use `nox <https://nox.readthedocs.io/en/latest/>`__ to instrument our tests.
 
 - To run a single unit test::
 
-    $ nox -s unit-3.12 -- -k <name of test>
+    $ nox -s unit-3.13 -- -k <name of test>
 
 
   .. note::
@@ -143,12 +143,12 @@ Running System Tests
    $ nox -s system
 
    # Run a single system test
-   $ nox -s system-3.12 -- -k <name of test>
+   $ nox -s system-3.13 -- -k <name of test>
 
 
   .. note::
 
-      System tests are only configured to run under Python 3.8, 3.9, 3.10, 3.11 and 3.12.
+      System tests are only configured to run under Python 3.8, 3.9, 3.10, 3.11, 3.12 and 3.13.
       For expediency, we do not run them in older versions of Python 3.
 
   This alone will not run the tests. You'll need to change some local
@@ -226,12 +226,14 @@ We support:
 -  `Python 3.10`_
 -  `Python 3.11`_
 -  `Python 3.12`_
+-  `Python 3.13`_
 
 .. _Python 3.8: https://docs.python.org/3.8/
 .. _Python 3.9: https://docs.python.org/3.9/
 .. _Python 3.10: https://docs.python.org/3.10/
 .. _Python 3.11: https://docs.python.org/3.11/
 .. _Python 3.12: https://docs.python.org/3.12/
+.. _Python 3.13: https://docs.python.org/3.13/
 
 
 Supported versions can be found in our ``noxfile.py`` `config`_.

noxfile.py

@@ -35,7 +35,7 @@
 DEFAULT_PYTHON_VERSION = "3.10"
 
 
-UNIT_TEST_PYTHON_VERSIONS = ["3.8", "3.9", "3.10", "3.11", "3.12"]
+UNIT_TEST_PYTHON_VERSIONS = ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
 UNIT_TEST_STANDARD_DEPENDENCIES = [
     "mock",
     "asyncmock",
@@ -57,7 +57,7 @@
     "3.9": [],
 }
 
-SYSTEM_TEST_PYTHON_VERSIONS = ["3.8", "3.9", "3.10", "3.11", "3.12"]
+SYSTEM_TEST_PYTHON_VERSIONS = ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
 SYSTEM_TEST_STANDARD_DEPENDENCIES = [
     "mock",
     "pytest",

owlbot.py

@@ -35,8 +35,8 @@
 extras = ["tqdm", "geopandas"]
 templated_files = common.py_library(
     default_python_version="3.10",
-    unit_test_python_versions=["3.8", "3.9", "3.10", "3.11", "3.12"],
-    system_test_python_versions=["3.8", "3.9", "3.10", "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.9", "3.10", "3.11", "3.12", "3.13"],
     cov_level=96,
     unit_test_external_dependencies=["freezegun"],
     unit_test_extras=extras,

setup.py

@@ -90,6 +90,7 @@
         "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 :: Internet",
         "Topic :: Scientific/Engineering",