Packaging/remove-python-3_9-add-3_14 (#397)

Author: Guts

.github/workflows/lint-and-tests.yml

@@ -22,11 +22,11 @@ jobs:
       fail-fast: false
       matrix:
         python-version:
-          - "3.9"
           - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
 
     # Steps represent a sequence of tasks that will be executed as part of the job
     steps:

.pre-commit-config.yaml

@@ -32,15 +32,15 @@ repos:
     hooks:
       - id: pyupgrade
         args:
-          - "--py39-plus"
+          - "--py310-plus"
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: "v0.13.3"
     hooks:
       - id: ruff
         args:
           - --fix-only
-          - --target-version=py39
+          - --target-version=py310
 
   - repo: https://github.com/pycqa/isort
     rev: 6.1.0
@@ -56,7 +56,7 @@ repos:
     hooks:
       - id: black
         args:
-          - --target-version=py39
+          - --target-version=py310
 
   - repo: https://github.com/pycqa/flake8
     rev: 7.3.0

docs/configuration.md

@@ -399,9 +399,7 @@ At the end, into the RSS you will get:
 ```
 
 !!! note "Timezone dependencies"
-    The timezones data depends on the Python version used to build:
-        - for Python >= 3.9, it uses the standard library and ships [tzdata](https://pypi.org/project/tzdata/) only on Windows which do not provide such data
-        - for Python < 3.9, [pytz](https://pypi.org/project/pytz/) is shipped.
+    The timezones data relies on the standard library and ships [tzdata](https://pypi.org/project/tzdata/) only on Windows which do not provide such data.
 
 ----
 

mkdocs_rss_plugin/integrations/theme_material_base.py

@@ -4,9 +4,6 @@
 # ########## Libraries #############
 # ##################################
 
-# standard library
-from typing import Optional
-
 # 3rd party
 from mkdocs.config.defaults import MkDocsConfig
 from mkdocs.plugins import get_plugin_logger
@@ -36,7 +33,7 @@
 class IntegrationMaterialThemeBase:
     # attributes
     IS_THEME_MATERIAL: bool = False
-    IS_INSIDERS: Optional[bool] = False
+    IS_INSIDERS: bool | None = False
 
     def __init__(self, mkdocs_config: MkDocsConfig) -> None:
         """Integration instantiation.
@@ -51,7 +48,7 @@ def __init__(self, mkdocs_config: MkDocsConfig) -> None:
         self.IS_INSIDERS = self.is_mkdocs_theme_material_insiders()
 
     def is_mkdocs_theme_material(
-        self, mkdocs_config: Optional[MkDocsConfig] = None
+        self, mkdocs_config: MkDocsConfig | None = None
     ) -> bool:
         """Check if the theme set in mkdocs.yml is material or not.
 
@@ -67,7 +64,7 @@ def is_mkdocs_theme_material(
         self.IS_THEME_MATERIAL = mkdocs_config.theme.name == "material"
         return self.IS_THEME_MATERIAL
 
-    def is_mkdocs_theme_material_insiders(self) -> Optional[bool]:
+    def is_mkdocs_theme_material_insiders(self) -> bool | None:
         """Check if the material theme is community or insiders edition.
 
         Returns:

mkdocs_rss_plugin/integrations/theme_material_blog_plugin.py

@@ -7,7 +7,6 @@
 # standard library
 from functools import lru_cache
 from pathlib import Path
-from typing import Optional
 
 # 3rd party
 from mkdocs.config.defaults import MkDocsConfig
@@ -69,9 +68,7 @@ def __init__(self, mkdocs_config: MkDocsConfig, switch_force: bool = True) -> No
                 "disabled in plugin's option in Mkdocs configuration."
             )
 
-    def is_blog_plugin_enabled_mkdocs(
-        self, mkdocs_config: Optional[MkDocsConfig]
-    ) -> bool:
+    def is_blog_plugin_enabled_mkdocs(self, mkdocs_config: MkDocsConfig | None) -> bool:
         """Check if blog plugin is installed and enabled.
 
         Args:

mkdocs_rss_plugin/integrations/theme_material_social_plugin.py

@@ -8,7 +8,6 @@
 import json
 from hashlib import md5
 from pathlib import Path
-from typing import Optional
 
 # 3rd party
 from mkdocs.config.defaults import MkDocsConfig
@@ -48,7 +47,7 @@ class IntegrationMaterialSocialCards(IntegrationMaterialThemeBase):
     IS_ENABLED: bool = True
     IS_SOCIAL_PLUGIN_ENABLED: bool = True
     IS_SOCIAL_PLUGIN_CARDS_ENABLED: bool = True
-    CARDS_MANIFEST: Optional[dict] = None
+    CARDS_MANIFEST: dict | None = None
 
     def __init__(self, mkdocs_config: MkDocsConfig, switch_force: bool = True) -> None:
         """Integration instantiation.
@@ -107,7 +106,7 @@ def __init__(self, mkdocs_config: MkDocsConfig, switch_force: bool = True) -> No
             self.site_description = mkdocs_config.site_description or ""
 
     def is_social_plugin_enabled_mkdocs(
-        self, mkdocs_config: Optional[MkDocsConfig] = None
+        self, mkdocs_config: MkDocsConfig | None = None
     ) -> bool:
         """Check if social plugin is installed and enabled.
 
@@ -184,7 +183,7 @@ def is_social_plugin_enabled_page(
             "cards", fallback_value
         )
 
-    def load_cache_cards_manifest(self) -> Optional[dict]:
+    def load_cache_cards_manifest(self) -> dict | None:
         """Load social cards manifest if the file exists.
 
         Returns:
@@ -262,8 +261,8 @@ def get_social_cards_cache_dir(self, mkdocs_config: MkDocsConfig) -> Path:
         return self.social_cards_cache_dir
 
     def get_social_card_build_path_for_page(
-        self, mkdocs_page: MkdocsPageSubset, mkdocs_site_dir: Optional[str] = None
-    ) -> Optional[Path]:
+        self, mkdocs_page: MkdocsPageSubset, mkdocs_site_dir: str | None = None
+    ) -> Path | None:
         """Get social card path in Mkdocs build dir for a specific page.
 
         Args:
@@ -305,7 +304,7 @@ def get_social_card_build_path_for_page(
 
     def get_social_card_cache_path_for_page(
         self, mkdocs_page: MkdocsPageSubset
-    ) -> Optional[Path]:
+    ) -> Path | None:
         """Get social card path in social plugin cache folder for a specific page.
 
         Note:
@@ -377,7 +376,7 @@ def get_social_card_cache_path_for_page(
     def get_social_card_url_for_page(
         self,
         mkdocs_page: MkdocsPageSubset,
-        mkdocs_site_url: Optional[str] = None,
+        mkdocs_site_url: str | None = None,
     ) -> str:
         """Get social card URL for a specific page in documentation.
 

mkdocs_rss_plugin/plugin.py

@@ -12,7 +12,7 @@
 from email.utils import format_datetime, formatdate
 from pathlib import Path
 from re import compile as re_compile
-from typing import Literal, Optional
+from typing import Literal
 
 # 3rd party
 from jinja2 import Environment, FileSystemLoader, select_autoescape
@@ -265,7 +265,7 @@ def on_config(self, config: MkDocsConfig) -> MkDocsConfig:
     @event_priority(priority=-75)
     def on_page_content(
         self, html: str, page: Page, config: MkDocsConfig, files: Files
-    ) -> Optional[str]:
+    ) -> str | None:
         """The page_content event is called after the Markdown text is rendered to HTML
             (but before being passed to a template) and can be used to alter the HTML
             body of the page.

mkdocs_rss_plugin/util.py

@@ -11,7 +11,7 @@
 from functools import lru_cache
 from mimetypes import guess_type
 from pathlib import Path
-from typing import Any, Literal, Union
+from typing import Any, Literal
 from urllib.parse import urlencode, urlparse, urlunparse
 
 # 3rd party
@@ -172,7 +172,7 @@ def build_url(
             url_parts[4] = urlencode(args_dict)
         return urlunparse(url_parts)
 
-    def get_value_from_dot_key(self, data: dict, dot_key: Union[str, bool]) -> Any:
+    def get_value_from_dot_key(self, data: dict, dot_key: str | bool) -> Any:
         """Retrieves a value from a dictionary using a dot notation key.
 
         Args:

requirements/base.txt

@@ -5,4 +5,4 @@ cachecontrol[filecache] >=0.14,<1
 GitPython>=3.1.43,<3.2
 mkdocs>=1.6.1,<2
 requests>=2.31,<3
-tzdata==2024.* ; python_version >= "3.9" and sys_platform == "win32"
+tzdata==2024.* ; sys_platform == "win32"

setup.py

@@ -6,7 +6,6 @@
 
 # standard library
 from pathlib import Path
-from typing import Union
 
 # 3rd party
 from setuptools import find_packages, setup
@@ -26,7 +25,7 @@
 # ##################################
 
 
-def load_requirements(requirements_files: Union[Path, list[Path]]) -> list:
+def load_requirements(requirements_files: Path | list[Path]) -> list:
     """Helper to load requirements list from a path or a list of paths.
 
     Args:
@@ -79,7 +78,7 @@ def load_requirements(requirements_files: Union[Path, list[Path]]) -> list:
     # run
     entry_points={"mkdocs.plugins": ["rss = mkdocs_rss_plugin.plugin:GitRssPlugin"]},
     # dependencies
-    python_requires=">=3.9, <4",
+    python_requires=">=3.10, <4",
     extras_require={
         # tooling
         "dev": load_requirements(HERE / "requirements/development.txt"),
@@ -93,11 +92,11 @@ def load_requirements(requirements_files: Union[Path, list[Path]]) -> list:
         "Intended Audience :: Developers",
         "Intended Audience :: Information Technology",
         "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",
         "Programming Language :: Python :: Implementation :: CPython",
         "Development Status :: 5 - Production/Stable",
         "License :: OSI Approved :: MIT License",