Prepare for v1.2.0 (#79)

Author: RobertoPrevato

.github/workflows/build.yml

@@ -26,7 +26,7 @@ jobs:
     strategy:
       fail-fast: false
       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@v1
@@ -43,14 +43,14 @@ jobs:
           cd dart-sass && chmod +x ./sass
           ./sass --no-source-map ../all.scss ../dist/neoteroi-mkdocs.css
           ./sass --no-source-map --style compressed ../all.scss ../dist/neoteroi-mkdocs.min.css
-        if: matrix.python-version == '3.10'
+        if: matrix.python-version == '3.13'
 
       - name: Publish CSS files
         uses: actions/upload-artifact@v4
         with:
           name: arts-package-css
           path: styles/dist
-        if: matrix.python-version == '3.10'
+        if: matrix.python-version == '3.13'
 
       - name: Use Python ${{ matrix.python-version }}
         uses: actions/setup-python@v4
@@ -80,24 +80,20 @@ jobs:
           path: junit/pytest-results-${{ matrix.python-version }}.xml
         if: always()
 
-      - name: Codecov
-        run: |
-          bash <(curl -s https://codecov.io/bash)
-
       - 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@v4
         with:
           name: dist-${{ matrix.os }}-${{ matrix.python-version }}
           path: dist
-        if: matrix.python-version == '3.12'
+        if: matrix.python-version == '3.13'
 
   publish:
     runs-on: ubuntu-latest
@@ -111,10 +107,10 @@ jobs:
           merge-multiple: true
           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,14 @@ 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.2.0] 2025-11-23
+
+- Add support for custom templates, by @sindrehan.
+- Remove support for Python 3.9.
+- Add Python 3.14 to the build matrix.
+- Remove Codecov from build and README.
+- Update type annotations to Python >= 3.10.
+
 ## [1.1.3] 2025-08-02
 
 - Improve `read_from_source()` to support an optional CWD parameter used to

README.md

@@ -2,7 +2,6 @@
 [![pypi](https://img.shields.io/pypi/v/neoteroi-mkdocs.svg)](https://pypi.python.org/pypi/neoteroi-mkdocs)
 [![versions](https://img.shields.io/pypi/pyversions/neoteroi-mkdocs.svg)](https://github.com/neoteroi/mkdocs-plugins)
 [![license](https://img.shields.io/github/license/neoteroi/mkdocs-plugins.svg)](https://github.com/neoteroi/mkdocs-plugins/blob/main/LICENSE)
-[![codecov](https://codecov.io/gh/Neoteroi/mkdocs-plugins/branch/main/graph/badge.svg)](https://codecov.io/gh/Neoteroi/mkdocs-plugins)
 [![documentation](https://img.shields.io/badge/📖-docs-purple)](https://www.neoteroi.dev/mkdocs-plugins/)
 
 

neoteroi/mkdocs/cards/domain.py

@@ -1,17 +1,16 @@
 from dataclasses import dataclass
-from typing import List, Optional
 
 from neoteroi.mkdocs.markdown.images import Image
 
 
 @dataclass
 class CardItem:
     title: str
-    url: Optional[str] = None
-    content: Optional[str] = None
-    icon: Optional[str] = None
-    key: Optional[str] = None
-    image: Optional[Image] = None
+    url: str | None = None
+    content: str | None = None
+    icon: str | None = None
+    key: str | None = None
+    image: Image | None = None
 
     def __post_init__(self):
         if self.image and not self.image.alt:
@@ -20,4 +19,4 @@ def __post_init__(self):
 
 @dataclass
 class Cards:
-    items: List[CardItem]
+    items: list[CardItem]

neoteroi/mkdocs/contribs/__init__.py

@@ -13,7 +13,6 @@
 from fnmatch import fnmatch
 from pathlib import Path
 from subprocess import CalledProcessError
-from typing import List
 
 from mkdocs.config import config_options as c
 from mkdocs.plugins import BasePlugin
@@ -38,7 +37,7 @@ def __init__(self) -> None:
         self._git_reader = GitContributionsReader()
         self._txt_reader = TXTContributionsReader()
 
-    def get_contributors(self, file_path: Path) -> List[Contributor]:
+    def get_contributors(self, file_path: Path) -> list[Contributor]:
         git_history_contributors = self._git_reader.get_contributors(file_path)
         configured_contributors = self._txt_reader.get_contributors(file_path)
         return list(
@@ -71,7 +70,7 @@ def __init__(self) -> None:
 
     def _merge_contributor_by_email(
         self,
-        contributors: List[Contributor],
+        contributors: list[Contributor],
         contributor: Contributor,
         contributor_info: dict,
     ) -> bool:
@@ -97,7 +96,7 @@ def _merge_contributor_by_email(
 
         return False
 
-    def _get_contributors(self, page_file: File) -> List[Contributor]:
+    def _get_contributors(self, page_file: File) -> list[Contributor]:
         results = []
         contributors = self._contribs_reader.get_contributors(
             Path("docs") / page_file.src_path

neoteroi/mkdocs/contribs/domain.py

@@ -2,21 +2,20 @@
 from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
-from typing import List, Optional
 
 
 @dataclass
 class Contributor:
     name: str
     email: str
     count: int = -1
-    image: Optional[str] = None
-    key: Optional[str] = None
+    image: str | None = None
+    key: str | None = None
 
 
 class ContributionsReader(ABC):
     @abstractmethod
-    def get_contributors(self, file_path: Path) -> List[Contributor]:
+    def get_contributors(self, file_path: Path) -> list[Contributor]:
         """Obtains the list of contributors for a file with the given path."""
 
     @abstractmethod

neoteroi/mkdocs/contribs/git.py

@@ -9,7 +9,7 @@
 import subprocess
 from datetime import datetime
 from pathlib import Path
-from typing import Iterable, List, Tuple
+from typing import Iterable
 
 from dateutil.parser import ParserError
 from dateutil.parser import parse as parse_date
@@ -26,7 +26,7 @@ def _decode(self, value: bytes) -> str:
         except UnicodeDecodeError:
             return value.decode("ISO-8859-1")
 
-    def _parse_name_and_email(self, name_and_email) -> Tuple[str, str]:
+    def _parse_name_and_email(self, name_and_email) -> tuple[str, str]:
         match = self._name_email_rx.search(name_and_email)
         if match:
             name = match.groupdict()["name"].strip()
@@ -41,7 +41,7 @@ def parse_committers(self, output: str) -> Iterable[Contributor]:
             name, email = self._parse_name_and_email(name_and_email)
             yield Contributor(name, email, int(count))
 
-    def get_contributors(self, file_path: Path) -> List[Contributor]:
+    def get_contributors(self, file_path: Path) -> list[Contributor]:
         """
         Obtains the list of contributors for a file with the given path,
         using the Git CLI.

neoteroi/mkdocs/contribs/html.py

@@ -5,7 +5,6 @@
 import xml.etree.ElementTree as etree
 from dataclasses import dataclass
 from datetime import datetime
-from typing import List
 from xml.etree.ElementTree import tostring as xml_to_str
 
 from neoteroi.mkdocs.contribs.domain import Contributor
@@ -25,7 +24,7 @@ class ContribsViewOptions:
 
 
 def contribution_stats_to_element(
-    contributors: List[Contributor],
+    contributors: list[Contributor],
     last_commit_date: datetime,
     options: ContribsViewOptions,
 ) -> etree.Element:
@@ -85,7 +84,7 @@ def contribution_stats_to_element(
 
 
 def render_contribution_stats(
-    contributors: List[Contributor],
+    contributors: list[Contributor],
     last_commit_date: datetime,
     options: ContribsViewOptions,
 ) -> str:

neoteroi/mkdocs/contribs/txt.py

@@ -2,7 +2,7 @@
 import re
 from datetime import datetime
 from pathlib import Path
-from typing import Iterable, List, Tuple
+from typing import Iterable
 
 from dateutil.parser import parse
 
@@ -30,7 +30,7 @@ class TXTContributionsReader(ContributionsReader):
         r"^\s*Last\smodified\stime:\s(?P<value>.+)$", re.IGNORECASE | re.MULTILINE
     )
 
-    def _parse_value(self, value: str) -> Tuple[str, str, int]:
+    def _parse_value(self, value: str) -> tuple[str, str, int]:
         match = self._contrib_rx.search(value)
         if match:
             values = match.groupdict()
@@ -51,7 +51,7 @@ def _get_contributors_from_txt_file(self, file_path: Path) -> Iterable[Contribut
             if name and email:
                 yield Contributor(name, email, count)
 
-    def get_contributors(self, file_path: Path) -> List[Contributor]:
+    def get_contributors(self, file_path: Path) -> list[Contributor]:
         """
         Obtains the list of contributors from a txt file with the given path.
         The file contents should look like:

neoteroi/mkdocs/markdown/__init__.py

@@ -4,7 +4,6 @@
 """
 
 import re
-from typing import Dict, Tuple
 
 _PROPS_RE = re.compile(
     r"""\s?((?P<name>[^\s\=]+)=(?P<quot>"|')(?P<value>[^\"\']+)(?P=quot))""",
@@ -14,7 +13,7 @@
 
 def parse_props(
     line: str, prefix: str = "", bool_attrs: bool = False
-) -> Dict[str, str]:
+) -> dict[str, str]:
     """
     Parses a line describing properties, in this form:
 
@@ -49,7 +48,7 @@ def parse_props(
     return props
 
 
-def extract_props(line: str, prefix: str = "") -> Tuple[str, Dict[str, str]]:
+def extract_props(line: str, prefix: str = "") -> tuple[str, dict[str, str]]:
     """
     Extracts properties like the `parse_props` function, but
     also returns the original line with properties removed.