Release v2025.5.0

Author: sco1

.bumper.toml

@@ -1,5 +1,6 @@
 [tool.bumper]
-current_version = "0.1.0"
+current_version = "2025.5.0"
+versioning_type = "calver"
 
 [[tool.bumper.files]]
 file = "./pyproject.toml"

.github/workflows/pypi_release.yml renamed to .github/workflows/release.yml

@@ -33,4 +33,4 @@ jobs:
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run:
-        gh release upload ${{ github.event.release.tag_name }} ./dist/pre_commit_python_eol-*.whl
+        gh release upload ${{ github.event.release.tag_name }} ./dist/pre_commit_python_eol-*.whl

CHANGELOG.md

@@ -1,2 +1,5 @@
 # Changelog
-Versions follow [Calendar Versioning](https://calver.org/) (`<YYYY>`.`<0M>`.`<MICRO>`)
+Versions follow [Calendar Versioning](https://calver.org/) (`<YYYY>`.`<MM>`.`<MICRO>`)
+
+## [v2025.5.0]
+Initial release - yay!

README.md

@@ -11,13 +11,13 @@ Add this to your `.pre-commit-config.yaml`
 
 ```yaml
 -   repo: https://github.com/sco1/pre-commit-python-eol
-    rev: v0.1.0
+    rev: v2025.5.0
     hooks:
     - id: check-eol
 ```
 
 ## Hooks
-**NOTE:** Only pyproject.toml is currently inspected. It is assumed that project metadata is supported per [PyPA Guidance](https://packaging.python.org/en/latest/guides/writing-pyproject-toml/)
+**NOTE:** Only pyproject.toml is currently inspected. It is assumed that project metadata is specified per [PyPA Guidance](https://packaging.python.org/en/latest/guides/writing-pyproject-toml/)
 
 ### `check-eol`
 Check `requires-python` against the current Python lifecycle & fail if an EOL version is included.

cached_release_cycle.json

@@ -1,9 +1,17 @@
 {
-  "3.14": {
+  "3.15": {
     "branch": "main",
-    "pep": 745,
+    "pep": 790,
     "status": "feature",
-    "first_release": "2025-10-01",
+    "first_release": "2026-10-01",
+    "end_of_life": "2031-10",
+    "release_manager": "Hugo van Kemenade"
+  },
+  "3.14": {
+    "branch": "3.14",
+    "pep": 745,
+    "status": "prerelease",
+    "first_release": "2025-10-07",
     "end_of_life": "2030-10",
     "release_manager": "Hugo van Kemenade"
   },

pre_commit_python_eol/check_eol.py

@@ -9,6 +9,7 @@
 from collections import abc
 from dataclasses import dataclass
 from enum import StrEnum
+from operator import attrgetter
 from pathlib import Path
 
 from packaging import specifiers, version
@@ -58,25 +59,12 @@ def _parse_eol_date(date_str: str) -> dt.date:
 
 
 @dataclass(frozen=True)
-class PythonRelease:
-    """
-    Represent the relevant metadata information for a Python release.
-
-    For the purposes of this tool, instances of `PythonRelease` are considered equal if their
-    respective `python_ver` attributes are equal.
-    """
-
+class PythonRelease:  # noqa: D101
     python_ver: version.Version
     status: ReleasePhase
     end_of_life: dt.date
 
-    def __eq__(self, other: object) -> bool:
-        if not isinstance(other, PythonRelease):
-            return NotImplemented
-
-        return self.python_ver == other.python_ver
-
-    def __str__(self) -> str:
+    def __str__(self) -> str:  # pragma: no cover
         return f"Python {self.python_ver} - Status: {self.status}, EOL: {self.end_of_life}"
 
     @classmethod
@@ -94,15 +82,25 @@ def from_json(cls, ver: str, metadata: dict[str, t.Any]) -> PythonRelease:
         )
 
 
-def _get_cached_release_cycle(cache_json: Path = CACHED_RELEASE_CYCLE) -> set[PythonRelease]:
-    """Parse the locally cached Python release cycle into `PythonRelease` instance(s)."""
+def _get_cached_release_cycle(cache_json: Path) -> list[PythonRelease]:
+    """
+    Parse the locally cached Python release cycle into `PythonRelease` instance(s).
+
+    Results are sorted by Python version in descending order.
+    """
     with cache_json.open("r", encoding="utf-8") as f:
         contents = json.load(f)
 
-    return {PythonRelease.from_json(v, m) for v, m in contents.items()}
+    # The sorting is probably unnecessary since the JSON should already be sorted, but going to
+    # retain since it's expected downstream
+    return sorted(
+        (PythonRelease.from_json(v, m) for v, m in contents.items()),
+        key=attrgetter("python_ver"),
+        reverse=True,
+    )
 
 
-def check_python_support(toml_file: Path) -> None:
+def check_python_support(toml_file: Path, cache_json: Path = CACHED_RELEASE_CYCLE) -> None:
     with toml_file.open("rb") as f:
         contents = tomllib.load(f)
 
@@ -111,8 +109,24 @@ def check_python_support(toml_file: Path) -> None:
         raise RequiresPythonNotFoundError
 
     package_spec = specifiers.SpecifierSet(requires_python)
+    release_cycle = _get_cached_release_cycle(cache_json)
+    utc_today = dt.datetime.now(dt.timezone.utc).date()
+
+    eol_supported = []
+    for r in release_cycle:
+        if r.python_ver in package_spec:
+            if r.status == ReleasePhase.EOL:
+                eol_supported.append(r)
+                continue
+
+            if r.end_of_life <= utc_today:
+                eol_supported.append(r)
+                continue
 
-    raise NotImplementedError
+    if eol_supported:
+        eol_supported.sort(key=attrgetter("python_ver"))  # Sort ascending for error msg generation
+        joined_vers = ", ".join(str(r.python_ver) for r in eol_supported)
+        raise EOLPythonError(f"EOL Python support found: {joined_vers}")
 
 
 def main(argv: abc.Sequence[str] | None = None) -> int:  # noqa: D103
@@ -124,8 +138,8 @@ def main(argv: abc.Sequence[str] | None = None) -> int:  # noqa: D103
     for file in args.filenames:
         try:
             check_python_support(file)
-        except EOLPythonError:
-            print(f"{file}: Fail.")
+        except EOLPythonError as e:
+            print(f"{file}: {e}")
             ec = 1
         except RequiresPythonNotFoundError:
             print(f"{file} 'requires-python' could not be located, or it is empty.")

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pre-commit-python-eol"
-version = "0.1.0"
+version = "2025.5.0"
 description = "A pre-commit hook for enforcing supported Python EOL"
 license = "MIT"
 license-files = ["LICENSE"]
@@ -22,7 +22,7 @@ classifiers = [
 
 requires-python = ">=3.11"
 dependencies = [
-    "packaging~=24.2",
+    "packaging~=25.0",
 ]
 
 [project.urls]
@@ -47,7 +47,8 @@ dev-dependencies = [
     "pytest-cov~=6.0",
     "pytest-randomly~=3.16",
     "ruff~=0.9",
-    "sco1-bumper~=1.0",
+    "sco1-bumper~=2.0",
+    "time-machine~=2.16",
     "tox~=4.23",
     "tox-uv~=1.17",
 ]