chore: update Python version support to 3.12, 3.13, and 3.14 (#147)

Copilot · dougborg · web-flow · commit 7183e550f8ef · 2025-11-07T11:09:28.000-07:00
* chore: update Python version support to 3.12, 3.13, and 3.14

Co-authored-by: copilot-swe-agent[bot] &lt;198982749+Copilot@users.noreply.github.com&gt;
Co-authored-by: dougborg &lt;1261222+dougborg@users.noreply.github.com&gt;
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -34,7 +34,7 @@ jobs:
     strategy:
       fail-fast: false  # Don't cancel other matrix jobs if one fails
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.12", "3.13", "3.14"]
 
     steps:
       - name: Checkout code
@@ -76,7 +76,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: uv sync --all-extras
diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml
@@ -34,7 +34,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: |
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -35,7 +35,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: uv sync --all-extras
diff --git a/.github/workflows/release-mcp.yml b/.github/workflows/release-mcp.yml
@@ -24,7 +24,7 @@ jobs:
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: |
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -33,7 +33,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: uv sync --all-extras
@@ -65,7 +65,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: uv sync --all-extras
@@ -123,7 +123,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: uv sync --all-extras
diff --git a/.github/workflows/security.yml b/.github/workflows/security.yml
@@ -25,7 +25,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Install dependencies
         run: uv sync --all-extras
diff --git a/.github/workflows/update-mcp-dependency.yml b/.github/workflows/update-mcp-dependency.yml
@@ -76,7 +76,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: "uv.lock"
-          python-version: "3.13"
+          python-version: "3.14"
 
       - name: Update MCP dependency
         if: steps.check-current.outputs.needs_update == 'true'
diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@ A modern, pythonic Python client for the
 comprehensive OpenAPI 3.1.0 specification with 100% endpoint coverage and automatic
 resilience.
 
-[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
 [![uv](https://img.shields.io/badge/dependency--management-uv-blue.svg)](https://docs.astral.sh/uv/)
 [![OpenAPI 3.1.0](https://img.shields.io/badge/OpenAPI-3.1.0-green.svg)](https://spec.openapis.org/oas/v3.1.0)
 [![CI](https://github.com/dougborg/katana-openapi-client/actions/workflows/ci.yml/badge.svg)](https://github.com/dougborg/katana-openapi-client/actions/workflows/ci.yml)
diff --git a/docs/UV_USAGE.md b/docs/UV_USAGE.md
@@ -354,12 +354,12 @@ uv run --isolated python script.py
 
 ```bash
 # Use specific Python version
-uv run --python 3.11 python script.py
+uv run --python 3.12 python script.py
 
 # Install Python if needed (uv can manage Python installations)
-uv python install 3.11
 uv python install 3.12
 uv python install 3.13
+uv python install 3.14
 
 # List available Python versions
 uv python list
@@ -391,7 +391,7 @@ This project uses uv in GitHub Actions for fast, reliable CI/CD:
   with:
     enable-cache: true
     cache-dependency-glob: "uv.lock"
-    python-version: "3.13"
+    python-version: "3.14"
 
 - name: Install dependencies
   run: uv sync --all-extras
diff --git a/docs/adr/0009-migrate-from-poetry-to-uv.md b/docs/adr/0009-migrate-from-poetry-to-uv.md
@@ -18,7 +18,7 @@ modern Python package manager written in Rust.
 - **Build Backend**: poetry-core
 - **Task Runner**: poethepoet (poe)
 - **Dependencies**: 13 core + 30+ dev dependencies
-- **Python Versions**: 3.11, 3.12, 3.13
+- **Python Versions**: 3.12, 3.13, 3.14
 - **Configuration**: pyproject.toml with Poetry-specific sections
 
 ### Forces at Play
diff --git a/examples/client/error_handling.py b/examples/client/error_handling.py
@@ -18,7 +18,7 @@
 T = TypeVar("T")
 
 
-async def retry_with_backoff(
+async def retry_with_backoff[T](
     operation: Callable[[], Awaitable[T]],
     max_attempts: int = 3,
     backoff_factor: float = 2.0,
diff --git a/katana_mcp_server/pyproject.toml b/katana_mcp_server/pyproject.toml
@@ -10,7 +10,7 @@ maintainers = [
 ]
 license = {text = "MIT"}
 readme = "README.md"
-requires-python = ">=3.11,<3.14"
+requires-python = ">=3.12"
 keywords = [
   "katana",
   "manufacturing",
@@ -27,9 +27,9 @@ classifiers = [
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Topic :: Office/Business",
   "Typing :: Typed",
diff --git a/katana_public_api_client/client_types.py b/katana_public_api_client/client_types.py
@@ -2,7 +2,7 @@
 
 from collections.abc import Mapping, MutableMapping
 from http import HTTPStatus
-from typing import IO, BinaryIO, Generic, Literal, TypeVar
+from typing import IO, BinaryIO, Literal, TypeVar
 
 from attrs import define
 
@@ -43,7 +43,7 @@ def to_tuple(self) -> FileTypes:
 
 
 @define
-class Response(Generic[T]):
+class Response[T]:
     """A response from an endpoint"""
 
     status_code: HTTPStatus
diff --git a/katana_public_api_client/utils.py b/katana_public_api_client/utils.py
@@ -81,22 +81,22 @@ class ServerError(APIError):
 
 
 @overload
-def unwrap(
+def unwrap[T](
     response: Response[T],
     *,
     raise_on_error: bool = True,
 ) -> T: ...
 
 
 @overload
-def unwrap(
+def unwrap[T](
     response: Response[T],
     *,
     raise_on_error: bool = False,
 ) -> T | None: ...
 
 
-def unwrap(
+def unwrap[T](
     response: Response[T],
     *,
     raise_on_error: bool = True,
@@ -199,7 +199,7 @@ def unwrap(
 
 
 @overload
-def unwrap_data(
+def unwrap_data[T](
     response: Response[T],
     *,
     raise_on_error: bool = True,
@@ -208,7 +208,7 @@ def unwrap_data(
 
 
 @overload
-def unwrap_data(
+def unwrap_data[T](
     response: Response[T],
     *,
     raise_on_error: bool = False,
@@ -217,15 +217,15 @@ def unwrap_data(
 
 
 @overload
-def unwrap_data(
+def unwrap_data[T, DataT](
     response: Response[T],
     *,
     raise_on_error: bool = False,
     default: list[DataT],
 ) -> Any: ...
 
 
-def unwrap_data(
+def unwrap_data[T, DataT](
     response: Response[T],
     *,
     raise_on_error: bool = True,
@@ -320,7 +320,7 @@ def is_error(response: Response[Any]) -> bool:
     return response.status_code >= 400
 
 
-def get_error_message(response: Response[T]) -> str | None:
+def get_error_message[T](response: Response[T]) -> str | None:
     """Extract error message from an error response.
 
     Args:
diff --git a/pyproject.toml b/pyproject.toml
@@ -10,7 +10,7 @@ maintainers = [
 ]
 license = {text = "MIT"}
 readme = "README.md"
-requires-python = ">=3.11,<3.14"
+requires-python = ">=3.12"
 keywords = [
   "katana",
   "manufacturing",
@@ -29,9 +29,9 @@ classifiers = [
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Internet :: WWW/HTTP :: HTTP Servers",
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Topic :: Office/Business",
@@ -230,7 +230,7 @@ exclude_lines = [
 [tool.ruff]
 line-length = 88
 src = ["katana_public_api_client", "tests", "scripts"]
-target-version = "py311"  # Updated to reflect minimum Python version
+target-version = "py312"  # Updated to reflect minimum Python version
 fix = true
 show-fixes = true
 output-format = "grouped"
diff --git a/uv.lock b/uv.lock
