encukou · Dec 5, 2022 · Nov 20, 2022 · Nov 21, 2022 · Nov 21, 2022 · Nov 22, 2022
diff --git a/Makefile b/Makefile
@@ -38,6 +38,7 @@ help:
 	@echo "  linkcheck  to check all external links for integrity"
 	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
 	@echo "  check      to run a check for frequent markup errors"
+	@echo "  versions   to update release cycle after changing release-cycle.json"
 
 .PHONY: clean
 clean: clean-venv
@@ -66,7 +67,7 @@ ensure-venv:
 	fi
 
 .PHONY: html
-html: ensure-venv
+html: ensure-venv versions
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
@@ -186,3 +187,17 @@ check: ensure-venv
 serve:
 	@echo "The 'serve' target was removed, use 'htmlview' instead" \
 	      "(see https://github.com/python/cpython/issues/80510)"
+
+# TODO make.bat
+include/branches.csv: include/release-cycle.json
+	$(PYTHON) generate-release-cycle.py
+
+include/end-of-life.csv: include/release-cycle.json
+	$(PYTHON) generate-release-cycle.py
+
+include/release-cycle.mmd: include/release-cycle.json
+	$(PYTHON) generate-release-cycle.py
+
+.PHONY: versions
+versions: include/branches.csv include/end-of-life.csv include/release-cycle.mmd
+	@echo Release cycle data generated.
diff --git a/_static/devguide_overrides.css b/_static/devguide_overrides.css
@@ -5,3 +5,68 @@
     width: 111px;
     height: 110px;
 }
+
+/* Release cycle chart */
+#python-release-cycle .mermaid .active0,
+#python-release-cycle .mermaid .active1,
+#python-release-cycle .mermaid .active2,
+#python-release-cycle .mermaid .active3 {
+    fill: #00dd00;
+    stroke: darkgreen;
+}
+
+#python-release-cycle .mermaid .done0,
+#python-release-cycle .mermaid .done1,
+#python-release-cycle .mermaid .done2,
+#python-release-cycle .mermaid .done3 {
+    fill: orange;
+    stroke: darkorange;
+}
+
+#python-release-cycle .mermaid .task0,
+#python-release-cycle .mermaid .task1,
+#python-release-cycle .mermaid .task2,
+#python-release-cycle .mermaid .task3 {
+    fill: #007acc;
+    stroke: #004455;
+}
+
+#python-release-cycle .mermaid .section0,
+#python-release-cycle .mermaid .section2 {
+    fill: darkgrey;
+}
+
+/* Set master colours */
+:root {
+    --mermaid-section1-3: white;
+    --mermaid-text-color: black;
+}
+
+@media (prefers-color-scheme: dark) {
+    body[data-theme=auto] {
+        --mermaid-section1-3: black;
+        --mermaid-text-color: #ffffffcc;
+    }
+}
+body[data-theme=dark] {
+    --mermaid-section1-3: black;
+    --mermaid-text-color: #ffffffcc;
+}
+
+#python-release-cycle .mermaid .section1,
+#python-release-cycle .mermaid .section3 {
+    fill: var(--mermaid-section1-3);
+}
+
+#python-release-cycle .mermaid .grid .tick text,
+#python-release-cycle .mermaid .sectionTitle0,
+#python-release-cycle .mermaid .sectionTitle1,
+#python-release-cycle .mermaid .sectionTitle2,
+#python-release-cycle .mermaid .sectionTitle3,
+#python-release-cycle .mermaid .taskTextOutside0,
+#python-release-cycle .mermaid .taskTextOutside1,
+#python-release-cycle .mermaid .taskTextOutside2,
+#python-release-cycle .mermaid .taskTextOutside3,
+#python-release-cycle .mermaid .titleText {
+    fill: var(--mermaid-text-color);
+}
diff --git a/conf.py b/conf.py
@@ -10,6 +10,7 @@
     'sphinx.ext.intersphinx',
     'sphinx.ext.todo',
     'sphinx_copybutton',
+    'sphinxcontrib.mermaid',
     'sphinxext.rediraffe',
 ]
 

diff --git a/generate-release-cycle.py b/generate-release-cycle.py
@@ -0,0 +1,141 @@
+"""
+Read in a JSON and generate two CSVs and a Mermaid file
+"""
+from __future__ import annotations
+
+import csv
+import datetime as dt
+import json
+
+MERMAID_HEADER = """
+gantt
+    dateFormat  YYYY-MM-DD
+    title       Python release cycle
+    axisFormat  %Y
+""".lstrip()
+
+MERMAID_SECTION = """
+    section Python {cycle}
+    {release_status}               :{mermaid_status}   python{cycle}, {release_date},{eol}
+"""  # noqa: E501
+
+MERMAID_STATUS_MAPPING = {
+    "features": "",
+    "bugfix": "active,",
+    "security": "done,",
+    "end-of-life": "crit,",
+}
+
+CSV_HEADER = (
+    "Branch",
+    "Schedule",
+    "Status",
+    "First release",
+    "End-of-life",
+    "Release manager",
+)
+
+
+def cycle(branch: str) -> str:
+    """Convert branch name to version number"""
+    return "3.12" if branch == "main" else branch
+
+
+def pep(number: int) -> str:
+    """Format PEP number with Sphinx role"""
+    return f":pep:`{number}`"
+
+
+def csv_date(date_str: str, now_str: str) -> str:
+    """Format a date for CSV"""
+    if date_str > now_str:
+        # Future, add italics
+        return f"*{date_str}*"
+    return date_str
+
+
+def mermaid_date(date_str: str) -> str:
+    """Format a date for Mermaid"""
+    if len(date_str) == len("yyyy-mm"):
+        # Mermaid needs a full yyyy-mm-dd, so let's approximate
+        date_str = f"{date_str}-01"
+    return date_str
+
+
+class Versions:
+    """For converting JSON to CSV and Mermaid"""
+
+    def __init__(self) -> None:
+        with open("include/release-cycle.json") as f:
+            self.versions = json.load(f)
+
+    def save_csv(self) -> None:
+        """Output CSV files"""
+        now_str = str(dt.datetime.utcnow())
+
+        with (
+            open(
+                "include/branches.csv", "w", encoding="UTF-8", newline=""
+            ) as file_branches,
+            open(
+                "include/end-of-life.csv", "w", encoding="UTF-8", newline=""
+            ) as file_eol,
+        ):
+            csv_branches = csv.writer(
+                file_branches, quoting=csv.QUOTE_MINIMAL, lineterminator="\n"
+            )
+            csv_eol = csv.writer(
+                file_eol, quoting=csv.QUOTE_MINIMAL, lineterminator="\n"
+            )
+
+            csv_branches.writerow(CSV_HEADER)
+            csv_eol.writerow(CSV_HEADER)
+
+            sorted_versions = sorted(
+                self.versions,
+                key=lambda d: int(cycle(d["cycle"]).replace(".", "")),
+                reverse=True,
+            )
+            for version in sorted_versions:
+                row = (
+                    version["cycle"],
+                    pep(version["pep"]),
+                    version["status"],
+                    csv_date(version["releaseDate"], now_str),
+                    csv_date(version["eol"], now_str),
+                    version["releaseManager"],
+                )
+
+                if version["status"] == "end-of-life":
+                    csv_eol.writerow(row)
+                else:
+                    csv_branches.writerow(row)
+
+    def save_mermaid(self) -> None:
+        """Output Mermaid file"""
+        out = [MERMAID_HEADER]
+
+        for version in reversed(self.versions):
+            v = MERMAID_SECTION.format(
+                cycle=cycle(version["cycle"]),
+                release_date=version["releaseDate"],
+                eol=mermaid_date(version["eol"]),
+                release_status=version["status"],
+                mermaid_status=MERMAID_STATUS_MAPPING[version["status"]],
+            )
+            out.append(v)
+
+        with open(
+            "include/release-cycle.mmd", "w", encoding="UTF-8", newline="\n"
+        ) as f:
+            f.writelines(out)
+
+
+def main() -> None:
+    versions = Versions()
+    versions.save_csv()
+    versions.save_mermaid()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/include/release-cycle.json b/include/release-cycle.json
@@ -0,0 +1,122 @@
+[
+  {
+    "cycle": "main",
+    "pep": 693,
+    "status": "features",
+    "releaseManager": "Thomas Wouters",
+    "releaseDate": "2023-10-02",
+    "eol": "2028-10"
+  },
+  {
+    "cycle": "3.11",
+    "pep": 664,
+    "status": "bugfix",
+    "releaseManager": "Pablo Galindo Salgado",
+    "releaseDate": "2022-10-24",
+    "eol": "2027-10"
+  },
+  {
+    "cycle": "3.10",
+    "pep": 619,
+    "status": "bugfix",
+    "releaseManager": "Pablo Galindo Salgado",
+    "releaseDate": "2021-10-04",
+    "eol": "2026-10"
+  },
+  {
+    "cycle": "3.9",
+    "pep": 596,
+    "status": "security",
+    "releaseManager": "Łukasz Langa",
+    "releaseDate": "2020-10-05",
+    "eol": "2025-10"
+  },
+  {
+    "cycle": "3.8",
+    "pep": 569,
+    "status": "security",
+    "releaseManager": "Łukasz Langa",
+    "releaseDate": "2019-10-14",
+    "eol": "2024-10"
+  },
+  {
+    "cycle": "3.7",
+    "pep": 537,
+    "status": "security",
+    "releaseManager": "Ned Deily",
+    "releaseDate": "2018-06-27",
+    "eol": "2023-06-27"
+  },
+  {
+    "cycle": "3.6",
+    "pep": 494,
+    "status": "end-of-life",
+    "releaseManager": "Ned Deily",
+    "releaseDate": "2016-12-23",
+    "eol": "2021-12-23"
+  },
+  {
+    "cycle": "3.5",
+    "pep": 478,
+    "status": "end-of-life",
+    "releaseManager": "Larry Hastings",
+    "releaseDate": "2015-09-13",
+    "eol": "2020-09-30"
+  },
+  {
+    "cycle": "3.4",
+    "pep": 429,
+    "status": "end-of-life",
+    "releaseManager": "Larry Hastings",
+    "releaseDate": "2014-03-16",
+    "eol": "2019-03-18"
+  },
+  {
+    "cycle": "3.3",
+    "pep": 398,
+    "status": "end-of-life",
+    "releaseManager": "Georg Brandl, Ned Deily (3.3.7+)",
+    "releaseDate": "2012-09-29",
+    "eol": "2017-09-29"
+  },
+  {
+    "cycle": "3.2",
+    "pep": 392,
+    "status": "end-of-life",
+    "releaseManager": "Georg Brandl",
+    "releaseDate": "2011-02-20",
+    "eol": "2016-02-20"
+  },
+  {
+    "cycle": "2.7",
+    "pep": 373,
+    "status": "end-of-life",
+    "releaseManager": "Benjamin Peterson",
+    "releaseDate": "2010-07-03",
+    "eol": "2020-01-01"
+  },
+  {
+    "cycle": "3.1",
+    "pep": 375,
+    "status": "end-of-life",
+    "releaseManager": "Benjamin Peterson",
+    "releaseDate": "2009-06-27",
+    "eol": "2012-04-09"
+  },
+  {
+    "cycle": "3.0",
+    "pep": 361,
+    "status": "end-of-life",
+    "releaseManager": "Barry Warsaw",
+    "releaseDate": "2008-12-03",
+    "eol": "2009-06-27"
+  },
+  {
+    "cycle": "2.6",
+    "pep": 361,
+    "status": "end-of-life",
+    "releaseManager": "Barry Warsaw",
+    "releaseDate": "2008-10-01",
+    "eol": "2013-10-29"
+  }
+]