Upgrade minimum Python requirement to 3.10 (#8)

* Upgrade minimum Python requirement to 3.10

- Update pyproject.toml and pixi.toml to require Python 3.10+
- Modernize type hints to use built-in generics (list[T], dict[K,V], X | None)
- Replace Optional, List, Dict, Tuple, Union imports with modern syntax
- Implement pattern matching in file handling and action mapping
- Update GitHub Actions to test only Python 3.10, 3.11, 3.12
- Remove unused typing imports
- All tests pass and code quality checks pass

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

* Fix code formatting

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

---------

Co-authored-by: Claude <[email protected]>

Author: msch-nutrient

.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.10', '3.11', '3.12']
 
     steps:
     - uses: actions/checkout@v4
@@ -35,7 +35,7 @@ jobs:
         pip install -e ".[dev]"
 
     - name: Run linting with ruff
-      if: matrix.python-version == '3.8'
+      if: matrix.python-version == '3.10'
       run: |
         python -m ruff check .
         python -m ruff format --check .
@@ -103,7 +103,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.11'
+        python-version: '3.12'
 
     - name: Install build dependencies
       run: |

.github/workflows/release.yml

@@ -14,7 +14,7 @@ jobs:
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.11'
+        python-version: '3.12'
 
     - name: Install dependencies
       run: |

pixi.toml

@@ -4,7 +4,7 @@ channels = ["conda-forge"]
 platforms = ["osx-arm64", "osx-64", "linux-64", "win-64"]
 
 [dependencies]
-python = ">=3.8,<3.13"
+python = ">=3.10,<3.13"
 requests = ">=2.25.0,<3.0.0"
 
 [feature.dev.dependencies]

pyproject.toml

@@ -13,7 +13,7 @@ name = "nutrient-dws"
 version = "1.0.0"
 description = "Python client library for Nutrient Document Web Services API"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 license = {text = "MIT"}
 authors = [
     {name = "Nutrient", email = "[email protected]"},
@@ -25,8 +25,6 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -62,7 +60,7 @@ Repository = "https://github.com/jdrhyne/nutrient-dws-client-python"
 nutrient_dws = ["py.typed"]
 
 [tool.ruff]
-target-version = "py38"
+target-version = "py310"
 line-length = 100
 
 [tool.ruff.lint]
@@ -93,7 +91,7 @@ convention = "google"
 "tests/*" = ["D", "S101"]  # Don't require docstrings in tests, allow asserts
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.10"
 strict = true
 warn_return_any = true
 warn_unused_ignores = false

scripts/generate_api_methods.py

@@ -3,7 +3,7 @@
 
 import re
 from pathlib import Path
-from typing import Any, Dict, List
+from typing import Any
 
 
 def to_snake_case(name: str) -> str:
@@ -15,7 +15,7 @@ def to_snake_case(name: str) -> str:
     return name
 
 
-def get_python_type(schema: Dict[str, Any]) -> str:
+def get_python_type(schema: dict[str, Any]) -> str:
     """Convert OpenAPI schema type to Python type hint."""
     if not schema:
         return "Any"
@@ -33,7 +33,7 @@ def get_python_type(schema: Dict[str, Any]) -> str:
     return type_mapping.get(schema_type, "Any")
 
 
-def create_manual_tools() -> List[Dict[str, Any]]:
+def create_manual_tools() -> list[dict[str, Any]]:
     """Create tool definitions based on the specification documentation.
 
     Since the Nutrient API uses a build endpoint with actions rather than
@@ -218,7 +218,7 @@ def create_manual_tools() -> List[Dict[str, Any]]:
     return tools
 
 
-def generate_method_code(tool_info: Dict[str, Any]) -> str:
+def generate_method_code(tool_info: dict[str, Any]) -> str:
     """Generate Python method code for a tool."""
     method_name = tool_info["method_name"]
     tool_name = tool_info["tool_name"]

src/nutrient_dws/api/direct.py

@@ -4,7 +4,7 @@
 for supported document processing operations.
 """
 
-from typing import TYPE_CHECKING, Any, Dict, List, Optional, Protocol
+from typing import TYPE_CHECKING, Any, Protocol
 
 from nutrient_dws.file_handler import FileInput
 
@@ -40,17 +40,17 @@ def _process_file(
         self,
         tool: str,
         input_file: FileInput,
-        output_path: Optional[str] = None,
+        output_path: str | None = None,
         **options: Any,
-    ) -> Optional[bytes]:
+    ) -> bytes | None:
         """Process file method that will be provided by NutrientClient."""
         raise NotImplementedError("This method is provided by NutrientClient")
 
     def convert_to_pdf(
         self,
         input_file: FileInput,
-        output_path: Optional[str] = None,
-    ) -> Optional[bytes]:
+        output_path: str | None = None,
+    ) -> bytes | None:
         """Convert a document to PDF.
 
         Converts Office documents (DOCX, XLSX, PPTX) to PDF format.
@@ -76,8 +76,8 @@ def convert_to_pdf(
         return self.build(input_file).execute(output_path)  # type: ignore[attr-defined,no-any-return]
 
     def flatten_annotations(
-        self, input_file: FileInput, output_path: Optional[str] = None
-    ) -> Optional[bytes]:
+        self, input_file: FileInput, output_path: str | None = None
+    ) -> bytes | None:
         """Flatten annotations and form fields in a PDF.
 
         Converts all annotations and form fields into static page content.
@@ -99,10 +99,10 @@ def flatten_annotations(
     def rotate_pages(
         self,
         input_file: FileInput,
-        output_path: Optional[str] = None,
+        output_path: str | None = None,
         degrees: int = 0,
-        page_indexes: Optional[List[int]] = None,
-    ) -> Optional[bytes]:
+        page_indexes: list[int] | None = None,
+    ) -> bytes | None:
         """Rotate pages in a PDF.
 
         Rotate all pages or specific pages by the specified degrees.
@@ -129,9 +129,9 @@ def rotate_pages(
     def ocr_pdf(
         self,
         input_file: FileInput,
-        output_path: Optional[str] = None,
+        output_path: str | None = None,
         language: str = "english",
-    ) -> Optional[bytes]:
+    ) -> bytes | None:
         """Apply OCR to a PDF to make it searchable.
 
         Performs optical character recognition on the PDF to extract text
@@ -156,14 +156,14 @@ def ocr_pdf(
     def watermark_pdf(
         self,
         input_file: FileInput,
-        output_path: Optional[str] = None,
-        text: Optional[str] = None,
-        image_url: Optional[str] = None,
+        output_path: str | None = None,
+        text: str | None = None,
+        image_url: str | None = None,
         width: int = 200,
         height: int = 100,
         opacity: float = 1.0,
         position: str = "center",
-    ) -> Optional[bytes]:
+    ) -> bytes | None:
         """Add a watermark to a PDF.
 
         Adds a text or image watermark to all pages of the PDF.
@@ -209,8 +209,8 @@ def watermark_pdf(
     def apply_redactions(
         self,
         input_file: FileInput,
-        output_path: Optional[str] = None,
-    ) -> Optional[bytes]:
+        output_path: str | None = None,
+    ) -> bytes | None:
         """Apply redaction annotations to permanently remove content.
 
         Applies any redaction annotations in the PDF to permanently remove
@@ -233,9 +233,9 @@ def apply_redactions(
     def split_pdf(
         self,
         input_file: FileInput,
-        page_ranges: Optional[List[Dict[str, int]]] = None,
-        output_paths: Optional[List[str]] = None,
-    ) -> List[bytes]:
+        page_ranges: list[dict[str, int]] | None = None,
+        output_paths: list[str] | None = None,
+    ) -> list[bytes]:
         """Split a PDF into multiple documents by page ranges.
 
         Splits a PDF into multiple files based on specified page ranges.
@@ -320,9 +320,9 @@ def split_pdf(
     def duplicate_pdf_pages(
         self,
         input_file: FileInput,
-        page_indexes: List[int],
-        output_path: Optional[str] = None,
-    ) -> Optional[bytes]:
+        page_indexes: list[int],
+        output_path: str | None = None,
+    ) -> bytes | None:
         """Duplicate specific pages within a PDF document.
 
         Creates a new PDF containing the specified pages in the order provided.
@@ -404,9 +404,9 @@ def duplicate_pdf_pages(
     def delete_pdf_pages(
         self,
         input_file: FileInput,
-        page_indexes: List[int],
-        output_path: Optional[str] = None,
-    ) -> Optional[bytes]:
+        page_indexes: list[int],
+        output_path: str | None = None,
+    ) -> bytes | None:
         """Delete specific pages from a PDF document.
 
         Creates a new PDF with the specified pages removed. The API approach
@@ -544,9 +544,9 @@ def delete_pdf_pages(
 
     def merge_pdfs(
         self,
-        input_files: List[FileInput],
-        output_path: Optional[str] = None,
-    ) -> Optional[bytes]:
+        input_files: list[FileInput],
+        output_path: str | None = None,
+    ) -> bytes | None:
         """Merge multiple PDF files into one.
 
         Combines multiple files into a single PDF in the order provided.