Skip "planned" branches such as 3.16 (#330)

Author: hugovk

build_docs.py

@@ -109,6 +109,9 @@ def from_json(cls, data: dict) -> Versions:
         for name, release in data.items():
             branch = release["branch"]
             status = release["status"]
+            if status in Version.SKIP_STATUSES:
+                logging.info("Skipping %s with status %r", name, status)
+                continue
             status = Version.SYNONYMS.get(status, status)
             if status not in Version.STATUSES:
                 logging.warning(
@@ -152,7 +155,6 @@ class Version:
 
     name: str
     status: Literal[
-        "planned",
         "in development",
         "pre-release",
         "stable",
@@ -162,14 +164,16 @@ class Version:
     branch_or_tag: str
 
     STATUSES = {
-        "planned",
         "in development",
         "pre-release",
         "stable",
         "security-fixes",
         "EOL",
     }
 
+    # Statuses for versions we don't build docs for at all.
+    SKIP_STATUSES = {"planned"}
+
     # Those synonyms map branch status vocabulary found in the devguide
     # with our vocabulary.
     SYNONYMS = {

tests/test_build_docs_versions.py

@@ -66,21 +66,21 @@ def test_from_json_warning(caplog) -> None:
         "3.16": {
             "branch": "",
             "pep": 826,
-            "status": "",
+            "status": "planned",
             "first_release": "2027-10-06",
             "end_of_life": "2032-10",
             "release_manager": "Savannah Ostrowski",
         },
     }
 
     # Act
-    with caplog.at_level(logging.WARNING):
+    with caplog.at_level(logging.INFO):
         versions = list(Versions.from_json(json_data))
 
     # Assert: both should be skipped
     assert versions == []
     assert "Saw invalid version status 'ex-release'" in caplog.text
-    assert "Saw invalid version status ''" in caplog.text
+    assert "Skipping 3.16 with status 'planned'" in caplog.text
 
 
 def test_current_stable(versions) -> None: