Upgrade to 3.10 syntax (#1341)

Co-authored-by: Dylan Anthony <dbanty@users.noreply.github.com>

Author: dbanty

.changeset/drop_support_for_python_39.md

@@ -0,0 +1,7 @@
+---
+default: major
+---
+
+# Drop support for Python 3.9
+
+Both `openapi-python-client` itself and any generated clients no longer support Python 3.9.

.changeset/generated_models_now_use_from_future_import_annotations.md

@@ -0,0 +1,7 @@
+---
+default: major
+---
+
+# Generated models now use `from __future__ import annotations`
+
+This simplifies using forward references with the newer union syntax.

.changeset/minimum_typer_version_is_now_016.md

@@ -0,0 +1,5 @@
+---
+default: note
+---
+
+# Minimum Typer version is now 0.16

.changeset/upgrade_generated_clients_to_310_union_syntax.md

@@ -0,0 +1,7 @@
+---
+default: minor
+---
+
+# Upgrade generated clients to 3.10 union syntax
+
+All generated types now use the `A | B` syntax instead of `Union[A, B]` or `Optional[A]`.

.github/workflows/checks.yml

@@ -11,7 +11,7 @@ jobs:
   test:
     strategy:
       matrix:
-        python: [ "3.9", "3.10", "3.11", "3.12", "3.13" ]
+        python: [ "3.10", "3.11", "3.12", "3.13", "3.14" ]
         os: [ ubuntu-latest, macos-latest, windows-latest ]
     runs-on: ${{ matrix.os }}
     steps:
@@ -78,7 +78,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6.0.0
         with:
-          python-version: "3.9"
+          python-version: "3.10"
 
       - name: Get Python Version
         id: get_python_version
@@ -128,15 +128,15 @@ jobs:
 
           # Find all of the downloaded coverage reports and combine them
           .venv/bin/python -m coverage combine
-          
+
           # Create html report
           .venv/bin/python -m coverage html --skip-covered --skip-empty
-          
+
           # Report in Markdown and write to summary.
           .venv/bin/python -m coverage report --format=markdown >> $GITHUB_STEP_SUMMARY
-          
+
           # Report again and fail if under 100%.
-          .venv/bin/python -m coverage report --fail-under=100          
+          .venv/bin/python -m coverage report --fail-under=100
 
       - name: Upload HTML report if check failed.
         uses: actions/upload-artifact@v4.6.2
@@ -163,7 +163,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6.0.0
         with:
-          python-version: "3.9"
+          python-version: "3.10"
       - name: Get Python Version
         id: get_python_version
         run: echo "python_version=$(python --version)" >> $GITHUB_OUTPUT

end_to_end_tests/__snapshots__/test_end_to_end.ambr

@@ -2,8 +2,8 @@
 # name: test_documents_with_errors[bad-status-code]
   '''
   Generating /test-documents-with-errors
-  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
 
+  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
   WARNING parsing GET / within default.
 
   Invalid response status code pattern: abcdef, response will be omitted from generated client
@@ -16,8 +16,8 @@
 # name: test_documents_with_errors[circular-body-ref]
   '''
   Generating /test-documents-with-errors
-  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
 
+  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
   WARNING parsing POST / within default. Endpoint will not be generated.
 
   Circular $ref in request body
@@ -30,8 +30,8 @@
 # name: test_documents_with_errors[invalid-uuid-defaults]
   '''
   Generating /test-documents-with-errors
-  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
 
+  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
   WARNING parsing PUT / within default. Endpoint will not be generated.
 
   cannot parse parameter of endpoint put_: Invalid UUID value: 3
@@ -49,8 +49,8 @@
 # name: test_documents_with_errors[missing-body-ref]
   '''
   Generating /test-documents-with-errors
-  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
 
+  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
   WARNING parsing POST / within default. Endpoint will not be generated.
 
   Could not resolve $ref #/components/requestBodies/body in request body
@@ -63,8 +63,8 @@
 # name: test_documents_with_errors[optional-path-param]
   '''
   Generating /test-documents-with-errors
-  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
 
+  Warning(s) encountered while generating. Client was generated, but some pieces may be missing
   WARNING parsing GET /{optional} within default. Endpoint will not be generated.
 
   Path parameter must be required

end_to_end_tests/docstrings-on-attributes-golden-record/my_test_api_client/client.py

@@ -1,5 +1,5 @@
 import ssl
-from typing import Any, Optional, Union
+from typing import Any
 
 import httpx
 from attrs import define, evolve, field
@@ -34,12 +34,12 @@ class Client:
     _base_url: str = field(alias="base_url")
     _cookies: dict[str, str] = field(factory=dict, kw_only=True, alias="cookies")
     _headers: dict[str, str] = field(factory=dict, kw_only=True, alias="headers")
-    _timeout: Optional[httpx.Timeout] = field(default=None, kw_only=True, alias="timeout")
-    _verify_ssl: Union[str, bool, ssl.SSLContext] = field(default=True, kw_only=True, alias="verify_ssl")
+    _timeout: httpx.Timeout | None = field(default=None, kw_only=True, alias="timeout")
+    _verify_ssl: str | bool | ssl.SSLContext = field(default=True, kw_only=True, alias="verify_ssl")
     _follow_redirects: bool = field(default=False, kw_only=True, alias="follow_redirects")
     _httpx_args: dict[str, Any] = field(factory=dict, kw_only=True, alias="httpx_args")
-    _client: Optional[httpx.Client] = field(default=None, init=False)
-    _async_client: Optional[httpx.AsyncClient] = field(default=None, init=False)
+    _client: httpx.Client | None = field(default=None, init=False)
+    _async_client: httpx.AsyncClient | None = field(default=None, init=False)
 
     def with_headers(self, headers: dict[str, str]) -> "Client":
         """Get a new client matching this one with additional headers"""
@@ -157,12 +157,12 @@ class AuthenticatedClient:
     _base_url: str = field(alias="base_url")
     _cookies: dict[str, str] = field(factory=dict, kw_only=True, alias="cookies")
     _headers: dict[str, str] = field(factory=dict, kw_only=True, alias="headers")
-    _timeout: Optional[httpx.Timeout] = field(default=None, kw_only=True, alias="timeout")
-    _verify_ssl: Union[str, bool, ssl.SSLContext] = field(default=True, kw_only=True, alias="verify_ssl")
+    _timeout: httpx.Timeout | None = field(default=None, kw_only=True, alias="timeout")
+    _verify_ssl: str | bool | ssl.SSLContext = field(default=True, kw_only=True, alias="verify_ssl")
     _follow_redirects: bool = field(default=False, kw_only=True, alias="follow_redirects")
     _httpx_args: dict[str, Any] = field(factory=dict, kw_only=True, alias="httpx_args")
-    _client: Optional[httpx.Client] = field(default=None, init=False)
-    _async_client: Optional[httpx.AsyncClient] = field(default=None, init=False)
+    _client: httpx.Client | None = field(default=None, init=False)
+    _async_client: httpx.AsyncClient | None = field(default=None, init=False)
 
     token: str
     """The token to use for authentication"""

end_to_end_tests/docstrings-on-attributes-golden-record/my_test_api_client/models/model_with_description.py

@@ -1,5 +1,7 @@
+from __future__ import annotations
+
 from collections.abc import Mapping
-from typing import Any, TypeVar, Union
+from typing import Any, TypeVar
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
@@ -13,10 +15,10 @@
 class ModelWithDescription:
     """This is a nice model."""
 
-    prop_with_no_desc: Union[Unset, str] = UNSET
-    prop_with_desc: Union[Unset, str] = UNSET
+    prop_with_no_desc: str | Unset = UNSET
+    prop_with_desc: str | Unset = UNSET
     """ This is a nice property. """
-    prop_with_long_desc: Union[Unset, str] = UNSET
+    prop_with_long_desc: str | Unset = UNSET
     """ It was the best of times, it was the worst of times, it was the age of wisdom, it was the age of
     foolishness,
     it was the epoch of belief, it was the epoch of incredulity, it was the season of light, it was the season of

end_to_end_tests/docstrings-on-attributes-golden-record/my_test_api_client/models/model_with_no_description.py

@@ -1,5 +1,7 @@
+from __future__ import annotations
+
 from collections.abc import Mapping
-from typing import Any, TypeVar, Union
+from typing import Any, TypeVar
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
@@ -11,8 +13,8 @@
 
 @_attrs_define
 class ModelWithNoDescription:
-    prop_with_no_desc: Union[Unset, str] = UNSET
-    prop_with_desc: Union[Unset, str] = UNSET
+    prop_with_no_desc: str | Unset = UNSET
+    prop_with_desc: str | Unset = UNSET
     """ This is a nice property. """
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 

end_to_end_tests/docstrings-on-attributes-golden-record/my_test_api_client/types.py

@@ -2,7 +2,7 @@
 
 from collections.abc import Mapping, MutableMapping
 from http import HTTPStatus
-from typing import IO, BinaryIO, Generic, Literal, Optional, TypeVar, Union
+from typing import IO, BinaryIO, Generic, Literal, TypeVar
 
 from attrs import define
 
@@ -15,13 +15,13 @@ def __bool__(self) -> Literal[False]:
 UNSET: Unset = Unset()
 
 # The types that `httpx.Client(files=)` can accept, copied from that library.
-FileContent = Union[IO[bytes], bytes, str]
-FileTypes = Union[
+FileContent = IO[bytes] | bytes | str
+FileTypes = (
     # (filename, file (or bytes), content_type)
-    tuple[Optional[str], FileContent, Optional[str]],
+    tuple[str | None, FileContent, str | None]
     # (filename, file (or bytes), content_type, headers)
-    tuple[Optional[str], FileContent, Optional[str], Mapping[str, str]],
-]
+    | tuple[str | None, FileContent, str | None, Mapping[str, str]]
+)
 RequestFiles = list[tuple[str, FileTypes]]
 
 
@@ -30,8 +30,8 @@ class File:
     """Contains information for file uploads"""
 
     payload: BinaryIO
-    file_name: Optional[str] = None
-    mime_type: Optional[str] = None
+    file_name: str | None = None
+    mime_type: str | None = None
 
     def to_tuple(self) -> FileTypes:
         """Return a tuple representation that httpx will accept for multipart/form-data"""
@@ -48,7 +48,7 @@ class Response(Generic[T]):
     status_code: HTTPStatus
     content: bytes
     headers: MutableMapping[str, str]
-    parsed: Optional[T]
+    parsed: T | None
 
 
 __all__ = ["UNSET", "File", "FileTypes", "RequestFiles", "Response", "Unset"]