build: Use Python 3.14 in Docker image and drop 3.9 support

Author: sdn4z

.github/workflows/test.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9", "3.13"]
+        python-version: ["3.10", "3.14"]
         runs-on: [ubuntu-latest]
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0

Dockerfile

@@ -1,4 +1,4 @@
-ARG PYTHON_IMAGE=3.13-slim@sha256:1020ca463dc51c26bbad49de85dbb2986d93b71050102f3fa2a7f0fc4c2ea81e
+ARG PYTHON_IMAGE=3.14-slim@sha256:4ed33101ee7ec299041cc41dd268dae17031184be94384b1ce7936dc4e5dead3
 
 # --------------- `base` stage --------------- 
 FROM python:${PYTHON_IMAGE} AS base

dependencies/scripts/download_packages.py

@@ -1,9 +1,10 @@
 import json
 import logging
+from collections.abc import Callable
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
-from typing import Any, Callable, Optional
+from typing import Any
 from zoneinfo import ZoneInfo
 
 import click
@@ -33,8 +34,8 @@ class ServerError(Exception):
 @dataclass(frozen=True)
 class Ecosystem:
     url: str
-    params: Optional[dict[str, Any]]
-    pages: Optional[int]
+    params: dict[str, Any] | None
+    pages: int | None
     parser: Callable[[dict[str, Any]], list[str]]
 
 
@@ -88,7 +89,7 @@ def download(
 
 
 def get_packages(
-    base_url: str, parser: Callable[[dict[str, Any]], list[str]], params: Optional[dict[str, Any]] = None
+    base_url: str, parser: Callable[[dict[str, Any]], list[str]], params: dict[str, Any] | None = None
 ) -> list[str]:
     for attempt in stamina.retry_context(
         on=(httpx.TransportError, httpx.TimeoutException, ServerError),

justfile

@@ -1,6 +1,6 @@
 # VARIABLE DEFINITIONS
 venv := ".venv"
-python_version :="3.13"
+python_version :="3.14"
 run := "uv run"
 
 venv-exists := path_exists(venv)

pyproject.toml

@@ -9,13 +9,12 @@ maintainers = [
     { name = "Daniel Sanz", email = "imsdn4z@gmail.com" },
     { name = "Sergio Castillo", email = "s.cast.lara@gmail.com" },
 ]
-requires-python = "<4,>=3.9"
+requires-python = "<4,>=3.10"
 dependencies = [
     "requests<3.0.0,>=2.32.4",
     "rapidfuzz<4.0.0,>=2.13.7",
     "pyparsing<4.0.0,>=3.2.3",
     "tomlkit<0.14.0,>=0.11.6",
-    "tomli<3.0.0,>=2.2.1; python_version < \"3.13\"",
     "pydantic>=2.11.7,<3.0.0",
     "pyyaml>=6.0.2",
 ]
@@ -70,7 +69,7 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.ruff]
-target-version = "py39"
+target-version = "py310"
 line-length = 120
 
 src = ["twyn", "tests"]
@@ -115,7 +114,7 @@ ignore = [
 convention = "pep257"
 
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.10"
 ignore_missing_imports = true
 namespace_packages = true
 explicit_package_bases = true

src/twyn/base/constants.py

@@ -1,8 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Literal
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Literal, TypeAlias
 
 from twyn import dependency_parser
 from twyn.trusted_packages import selectors

src/twyn/base/exceptions.py

@@ -1,5 +1,5 @@
 import logging
-from typing import IO, Any, Optional
+from typing import IO, Any
 
 logger = logging.getLogger("twyn")
 
@@ -28,7 +28,7 @@ class CliError(click.ClickException):
         def __init__(self, message: str = "") -> None:
             super().__init__(message)
 
-        def show(self, file: Optional[IO[Any]] = None) -> None:
+        def show(self, file: IO[Any] | None = None) -> None:
             """Display the error message."""
             logger.debug(self.format_message(), exc_info=True)
             logger.error(self.format_message(), exc_info=False)

src/twyn/cli.py

@@ -1,6 +1,5 @@
 import logging
 import sys
-from typing import Optional
 
 from twyn.__version__ import __version__
 from twyn.base.constants import (
@@ -129,13 +128,13 @@ def run(  # noqa: C901
     selector_method: str,
     v: bool,
     vv: bool,
-    no_cache: Optional[bool],
+    no_cache: bool | None,
     no_track: bool,
     json: bool,
-    package_ecosystem: Optional[str],
+    package_ecosystem: str | None,
     recursive: bool,
-    pypi_source: Optional[str],
-    npm_source: Optional[str],
+    pypi_source: str | None,
+    npm_source: str | None,
 ) -> int:
     if vv:
         logger.setLevel(logging.DEBUG)

src/twyn/config/config_handler.py

@@ -2,7 +2,7 @@
 from dataclasses import asdict, dataclass, field
 from enum import Enum
 from pathlib import Path
-from typing import Any, Optional, Union
+from typing import Any
 
 from tomlkit import TOMLDocument, dumps, load, table
 
@@ -38,55 +38,55 @@ class TwynConfiguration:
     """Method for selecting similar packages."""
     allowlist: set[str]
     """Set of package names to allow without checking."""
-    pypi_source: Optional[str]
+    pypi_source: str | None
     """Alternative PyPI source URL."""
-    npm_source: Optional[str]
+    npm_source: str | None
     """Alternative npm source URL."""
     use_cache: bool
     """Whether to use cached trusted packages."""
-    package_ecosystem: Optional[PackageEcosystems]
+    package_ecosystem: PackageEcosystems | None
     """Target package ecosystem for analysis."""
-    recursive: Optional[bool]
+    recursive: bool | None
     """Whether to recursively search for dependency files."""
 
 
 @dataclass
 class ReadTwynConfiguration:
     """Configuration for twyn as set by the user. It may have None values."""
 
-    dependency_files: Optional[set[str]] = field(default_factory=set)
+    dependency_files: set[str] | None = field(default_factory=set)
     """Optional set of dependency file paths to analyze."""
-    selector_method: Optional[str] = None
+    selector_method: str | None = None
     """Optional method for selecting similar packages."""
     allowlist: set[str] = field(default_factory=set)
     """Set of package names to allow without checking."""
-    pypi_source: Optional[str] = None
+    pypi_source: str | None = None
     """Optional alternative PyPI source URL."""
-    npm_source: Optional[str] = None
+    npm_source: str | None = None
     """Optional alternative npm source URL."""
-    use_cache: Optional[bool] = None
+    use_cache: bool | None = None
     """Optional setting for using cached trusted packages."""
-    package_ecosystem: Optional[PackageEcosystems] = None
+    package_ecosystem: PackageEcosystems | None = None
     """Optional target package ecosystem for analysis."""
-    recursive: Optional[bool] = None
+    recursive: bool | None = None
     """Optional setting for recursive dependency file search."""
 
 
 class ConfigHandler:
     """Manage reading and writing configurations for Twyn."""
 
-    def __init__(self, file_handler: Optional[FileHandler] = None) -> None:
+    def __init__(self, file_handler: FileHandler | None = None) -> None:
         self.file_handler = file_handler
 
     def resolve_config(  # noqa: C901, PLR0912
         self,
-        selector_method: Optional[str] = None,
-        dependency_files: Optional[set[str]] = None,
-        use_cache: Optional[bool] = None,
-        package_ecosystem: Optional[PackageEcosystems] = None,
-        recursive: Optional[bool] = None,
-        pypi_source: Optional[str] = None,
-        npm_source: Optional[str] = None,
+        selector_method: str | None = None,
+        dependency_files: set[str] | None = None,
+        use_cache: bool | None = None,
+        package_ecosystem: PackageEcosystems | None = None,
+        recursive: bool | None = None,
+        pypi_source: str | None = None,
+        npm_source: str | None = None,
     ) -> TwynConfiguration:
         """Resolve the configuration for Twyn.
 
@@ -244,10 +244,10 @@ def get_default_config_file_path() -> str:
         return DEFAULT_PROJECT_TOML_FILE
 
 
-def _serialize_config(x: Any) -> Union[Any, str, list[Any]]:
+def _serialize_config(x: Any) -> Any | str | list[Any]:
     """Serialize configuration values for TOML format."""
 
-    def _value_to_for_config(v: Any) -> Union[str, list[Any], Any]:
+    def _value_to_for_config(v: Any) -> str | list[Any] | Any:
         if isinstance(v, Enum):
             return v.name
         elif isinstance(v, set):

src/twyn/dependency_managers/managers/base.py

@@ -1,6 +1,5 @@
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Optional
 
 from twyn.trusted_packages.references.base import AbstractPackageReference
 
@@ -30,7 +29,7 @@ def matches_ecosystem_name(cls, name: str) -> bool:
         return cls.name == Path(name).name.lower()
 
     @classmethod
-    def get_alternative_source(cls, sources: dict[str, str]) -> Optional[str]:
+    def get_alternative_source(cls, sources: dict[str, str]) -> str | None:
         """Get alternative source URL for this ecosystem from sources dict."""
         match = [x for x in sources if x == cls.name]