Add support for Python 3.14 (#1340)

Author: sirosen

.github/workflows/test.yaml

@@ -42,6 +42,7 @@ jobs:
               - "3.11"
               - "3.12"
               - "3.13"
+              - "3.14"
             tox-post-environments:
               - "py3.8-mindeps"
               - "py3.11-sphinxext"
@@ -69,7 +70,7 @@ jobs:
             runner: "ubuntu-latest"
             cpythons:
               - "3.8"
-              - "3.13"
+              - "3.14"
             tox-environments:
               - "check-min-python-is-tested"
               - "mypy-py3.13"

changelog.d/20251114_163254_sirosen_add_py314.rst

@@ -0,0 +1,4 @@
+Python Support
+--------------
+
+- Add support for Python 3.14. (:pr:`NUMBER`)

requirements/py3.14/test.txt

@@ -0,0 +1,45 @@
+#
+# This file is autogenerated by pip-compile with Python 3.14
+# by the following command:
+#
+#    tox p -m freezedeps
+#
+certifi==2025.11.12
+    # via requests
+charset-normalizer==3.4.4
+    # via requests
+coverage==7.11.3
+    # via -r .test.in
+execnet==2.1.2
+    # via pytest-xdist
+flaky==3.8.1
+    # via -r .test.in
+idna==3.11
+    # via requests
+iniconfig==2.3.0
+    # via pytest
+packaging==25.0
+    # via pytest
+pluggy==1.6.0
+    # via pytest
+pygments==2.19.2
+    # via pytest
+pytest==9.0.1
+    # via
+    #   -r .test.in
+    #   pytest-randomly
+    #   pytest-xdist
+pytest-randomly==4.0.1
+    # via -r .test.in
+pytest-xdist==3.8.0
+    # via -r .test.in
+pyyaml==6.0.3
+    # via responses
+requests==2.32.5
+    # via responses
+responses==0.25.8
+    # via -r .test.in
+urllib3==2.5.0
+    # via
+    #   requests
+    #   responses

requirements/py3.14/typing.txt

@@ -0,0 +1,77 @@
+#
+# This file is autogenerated by pip-compile with Python 3.14
+# by the following command:
+#
+#    tox p -m freezedeps
+#
+alabaster==1.0.0
+    # via sphinx
+babel==2.17.0
+    # via sphinx
+certifi==2025.11.12
+    # via requests
+charset-normalizer==3.4.4
+    # via requests
+docutils==0.21.2
+    # via sphinx
+idna==3.11
+    # via requests
+imagesize==1.4.1
+    # via sphinx
+jinja2==3.1.6
+    # via sphinx
+markupsafe==3.0.3
+    # via jinja2
+mypy==1.18.2
+    # via -r .typing.in
+mypy-extensions==1.1.0
+    # via mypy
+packaging==25.0
+    # via sphinx
+pathspec==0.12.1
+    # via mypy
+pygments==2.19.2
+    # via sphinx
+pyyaml==6.0.3
+    # via responses
+requests==2.32.5
+    # via
+    #   responses
+    #   sphinx
+responses==0.25.8
+    # via -r .typing.in
+roman-numerals-py==3.1.0
+    # via sphinx
+snowballstemmer==3.0.1
+    # via sphinx
+sphinx==8.2.3
+    # via -r .typing.in
+sphinxcontrib-applehelp==2.0.0
+    # via sphinx
+sphinxcontrib-devhelp==2.0.0
+    # via sphinx
+sphinxcontrib-htmlhelp==2.1.0
+    # via sphinx
+sphinxcontrib-jsmath==1.0.1
+    # via sphinx
+sphinxcontrib-qthelp==2.0.0
+    # via sphinx
+sphinxcontrib-serializinghtml==2.0.0
+    # via sphinx
+types-cryptography==3.3.23.2
+    # via types-jwt
+types-docutils==0.22.2.20251006
+    # via -r .typing.in
+types-jwt==0.1.3
+    # via -r .typing.in
+types-requests==2.32.4.20250913
+    # via -r .typing.in
+typing-extensions==4.15.0
+    # via
+    #   -r .typing.in
+    #   mypy
+urllib3==2.5.0
+    # via
+    #   requests
+    #   responses
+    #   types-requests

tests/unit/helpers/gcs/test_collections.py

@@ -1,4 +1,6 @@
 import inspect
+import sys
+import types
 import typing as t
 import uuid
 
@@ -15,6 +17,11 @@
 from globus_sdk._missing import MISSING, MissingType, filter_missing
 from globus_sdk.transport import JSONRequestEncoder
 
+if sys.version_info >= (3, 10):
+    UnionTypes = (t.Union, types.UnionType)
+else:
+    UnionTypes = (t.Union,)
+
 STUB_SG_ID = uuid.uuid1()  # storage gateway
 STUB_MC_ID = uuid.uuid1()  # mapped collection
 STUB_UC_ID = uuid.uuid1()  # user credential
@@ -307,7 +314,8 @@ def _gen_value(_type):
         return ["STRING"]
     if _type is bool:
         return [True, False]
-    if _type is t.Union[uuid.UUID, str]:
+    # Union[UUID, str] | (UUID | str)
+    if t.get_origin(_type) in UnionTypes and set(t.get_args(_type)) == {uuid.UUID, str}:
         return [str(uuid.uuid1()), uuid.uuid1()]
     if _type is t.Iterable[str]:
         return [[], ["a", "b", "c"]]

tox.ini

@@ -5,14 +5,14 @@ envlist =
     pylint
     test-lazy-imports
     coverage_clean
-    py{3.13,3.12,3.11,3.10,3.9,3.8}
+    py{3.14,3.13,3.12,3.11,3.10,3.9,3.8}
     py3.8-mindeps
     py3.11-sphinxext
     coverage_report
     docs
 minversion = 4.22.0
 labels =
-    freezedeps = freezedeps-print,freezedeps-py{3.13,3.12,3.11,3.10,3.9,3.8}
+    freezedeps = freezedeps-print,freezedeps-py{3.14,3.13,3.12,3.11,3.10,3.9,3.8}
 
 [testenv]
 # build a wheel, not a tarball, and use a common env to do it (so that the wheel is shared)
@@ -25,8 +25,8 @@ deps =
     sphinxext: -r requirements/py{py_dot_ver}/docs.txt
 commands = coverage run -m pytest {posargs}
 depends =
-    py{3.13,3.12,3.11,3.10,3.9,3.8}{-mindeps,-sphinxext,}: coverage_clean, lint
-    coverage_report: py{3.13,3.12,3.11,3.10,3.9,3.8}{-mindeps,-sphinxext,}
+    py{3.14,3.13,3.12,3.11,3.10,3.9,3.8}{-mindeps,-sphinxext,}: coverage_clean, lint
+    coverage_report: py{3.14,3.13,3.12,3.11,3.10,3.9,3.8}{-mindeps,-sphinxext,}
 
 [testenv:coverage_clean]
 dependency_groups = coverage
@@ -44,7 +44,7 @@ deps = pre-commit
 skip_install = true
 commands = pre-commit run --all-files
 
-[testenv:mypy,mypy-{py3.8,py3.13}]
+[testenv:mypy,mypy-{py3.8,py3.14}]
 deps = -r requirements/py{py_dot_ver}/typing.txt
 commands = mypy src/ {posargs}
 
@@ -64,7 +64,7 @@ deps =
     pytest-benchmark
 commands = pytest tests/benchmark/ {posargs}
 
-[testenv:pylint,pylint-{py3.8,py3.9,py3.10,py3.11,py3.12,py3.13}]
+[testenv:pylint,pylint-{py3.8,py3.9,py3.10,py3.11,py3.12,py3.13,py3.14}]
 deps = pylint
 commands = pylint {posargs:src/}
 
@@ -109,7 +109,7 @@ commands =
     python -m dependency_groups typing -o requirements/.typing.in
     python -m dependency_groups test-mindeps -o requirements/.test-mindeps.in
     python -m dependency_groups docs -o requirements/.docs.in
-[testenv:freezedeps-py{3.13,3.12,3.11,3.10,3.9,3.8}]
+[testenv:freezedeps-py{3.14,3.13,3.12,3.11,3.10,3.9,3.8}]
 description = freeze development dependencies using pip-compile
 skip_install = true
 setenv =