Prepare for v1.1.9

Author: RobertoPrevato

.github/workflows/build.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.9, "3.10", 3.11, 3.12, 3.13]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v4
@@ -49,7 +49,7 @@ jobs:
 
       - name: Check type hints
         run: mypy .
-        if: matrix.python-version == 3.12
+        if: matrix.python-version == 3.13
 
       - name: Upload pytest test results
         uses: actions/upload-artifact@master
@@ -64,18 +64,18 @@ jobs:
 
       - name: Install distribution dependencies
         run: pip install build
-        if: matrix.python-version == 3.12
+        if: matrix.python-version == 3.13
 
       - name: Create distribution package
         run: python -m build
-        if: matrix.python-version == 3.12
+        if: matrix.python-version == 3.13
 
       - name: Upload distribution package
         uses: actions/upload-artifact@master
         with:
           name: dist
           path: dist
-        if: matrix.python-version == 3.12
+        if: matrix.python-version == 3.13
 
   publish:
     runs-on: ubuntu-latest
@@ -88,10 +88,10 @@ jobs:
           name: dist
           path: dist
 
-      - name: Use Python 3.12
+      - name: Use Python 3.13
         uses: actions/setup-python@v1
         with:
-          python-version: '3.12'
+          python-version: '3.13'
 
       - name: Install dependencies
         run: |

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.9] - 2025-11-23
+
+- Remove support for Python 3.9 and add Python 3.14 to the build matrix.
+- Update type annotations to Python >= 3.10.
+
 ## [1.1.8] - 2025-10-03 :notes:
 
 - Improve the `Secret` class to always encode strings before comparing to `str`.

essentials/__init__.py

@@ -1 +1 @@
-__version__ = "1.1.8"
+__version__ = "1.1.9"

essentials/caching.py

@@ -1,7 +1,7 @@
 import functools
 import time
 from collections import OrderedDict
-from typing import TYPE_CHECKING, Any, Generic, Iterable, Iterator, Tuple, TypeVar
+from typing import TYPE_CHECKING, Any, Generic, Iterable, Iterator, TypeVar
 
 if TYPE_CHECKING:
     from typing import Callable, TypeVarTuple, Unpack
@@ -81,7 +81,7 @@ def __delitem__(self, key) -> None:
     def __contains__(self, key) -> bool:
         return key in self._bag
 
-    def __iter__(self) -> Iterator[Tuple[Any, T]]:
+    def __iter__(self) -> Iterator[tuple[Any, T]]:
         return iter(self._bag.items())
 
     def clear(self) -> None:
@@ -173,7 +173,7 @@ def __contains__(self, key) -> bool:
             return False
         return True
 
-    def __iter__(self) -> Iterator[Tuple[Any, T]]:
+    def __iter__(self) -> Iterator[tuple[Any, T]]:
         """Iterates through cached items, discarding and removing expired ones."""
         for key, item in list(self._bag.items()):
             if self.expired(item):

essentials/decorators/logs.py

@@ -2,7 +2,7 @@
 from functools import wraps
 from inspect import iscoroutinefunction
 from logging import Logger
-from typing import Callable, Optional, TypeVar
+from typing import Callable, TypeVar
 from uuid import uuid4
 
 from essentials.diagnostics import StopWatch
@@ -17,8 +17,8 @@ def _default_id_factory() -> str:
 
 
 def log(
-    logger: Optional[Logger] = None,
-    id_factory: Optional[IdFactory] = None,
+    logger: Logger | None = None,
+    id_factory: IdFactory | None = None,
     log_arguments: bool = False,
     log_return_value: bool = False,
     level=logging.INFO,

essentials/decorators/retry.py

@@ -2,12 +2,12 @@
 import time
 from functools import wraps
 from inspect import iscoroutinefunction
-from typing import Callable, Optional, Tuple, Type, TypeVar, Union
+from typing import Callable, Type, TypeVar
 
 T = TypeVar("T")
 FuncType = Callable[..., T]
-CatchException = Union[Tuple[Type[Exception]], Type[Exception], None]
-OnException = Optional[Callable[[Type[Exception], int], None]]
+CatchException = tuple[Type[Exception]] | Type[Exception] | None
+OnException = Callable[[Type[Exception], int], None] | None
 
 
 def _get_retry_async_wrapper(
@@ -44,7 +44,7 @@ async def async_wrapper(*args, **kwargs):
 
 def retry(
     times: int = 3,
-    delay: Optional[float] = 0.1,
+    delay: float | None = 0.1,
     catch_exceptions_types: CatchException = None,
     on_exception: OnException = None,
     loop=None,

essentials/folders.py

@@ -1,13 +1,12 @@
 import ntpath
 import os
-from typing import Tuple
 
 
 def ensure_folder(path) -> None:
     os.makedirs(path, exist_ok=True)
 
 
-def split_path(filepath) -> Tuple[str, str, str]:
+def split_path(filepath) -> tuple[str, str, str]:
     """Splits a file path into folder path, file name and extension"""
     head, tail = ntpath.split(filepath)
     filename, extension = os.path.splitext(tail)

essentials/meta.py

@@ -1,7 +1,7 @@
 import warnings
 from functools import wraps
 from inspect import iscoroutinefunction
-from typing import Callable, Optional, TypeVar
+from typing import Callable, TypeVar
 
 T = TypeVar("T")
 FuncType = Callable[..., T]
@@ -13,7 +13,7 @@ def __init__(self, param_name: str) -> None:
 
 
 def deprecated(
-    message: Optional[str] = None, raise_exception=False
+    message: str | None = None, raise_exception=False
 ) -> Callable[[FuncType], FuncType]:
     """
     This is a decorator which can be used to mark functions

essentials/registry.py

@@ -1,6 +1,6 @@
 import reprlib
 from abc import ABC
-from typing import List, Sequence, Type
+from typing import Sequence, Type
 
 from essentials.exceptions import InvalidArgument
 
@@ -83,7 +83,7 @@ def get_class_name(cls) -> str:
         return s[:length] if s[length:] == key else s
 
     @classmethod
-    def get_subclasses(cls, base_class=None) -> List[Type["Registry"]]:
+    def get_subclasses(cls, base_class=None) -> list[Type["Registry"]]:
         if base_class is None:
             base_class = cls.get_class()
 

pyproject.toml

@@ -14,11 +14,11 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Operating System :: OS Independent",
 ]
 urls = { homepage = "https://github.com/Neoteroi/essentials" }