Add PEP 0 generator and authors override

Author: AA-Turner

AUTHORS.csv

@@ -0,0 +1,12 @@
+Full Name, Surname First, Name Reference
+Ernest W. Durbin III, "Durbin, Ernest W., III", Durbin
+Inada Naoki, "Inada, Naoki", Inada
+Guido van Rossum, "van Rossum, Guido (GvR)", GvR
+Just van Rossum, "van Rossum, Just (JvR)", JvR
+The Python core team and community, The Python core team and community, python-dev
+P.J. Eby, "Eby, Phillip J.", Eby
+Greg Ewing,  "Ewing, Gregory", Ewing
+Jim Jewett, "Jewett, Jim J.", Jewett
+Nathaniel Smith, "Smith, Nathaniel J.", Smith
+Martin v. Löwis, "von Löwis, Martin", von Löwis
+

pep_sphinx_extensions/pep_zero_generator/pep_index_generator.py

@@ -0,0 +1,70 @@
+"""Automatically create PEP 0 (the PEP index),
+
+This file generates and writes the PEP index to disk, ready for later
+processing by Sphinx. Firstly, we parse the individual PEP files, getting the
+RFC2822 header, and parsing and then validating that metadata.
+
+After collecting and validating all the PEP data, the creation of the index
+itself is in three steps:
+
+    1. Output static text.
+    2. Format an entry for the PEP.
+    3. Output the PEP (both by the category and numerical index).
+
+We then add the newly created PEP 0 file to two Sphinx environment variables
+to allow it to be processed as normal.
+
+"""
+from __future__ import annotations
+
+import csv
+import re
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from pep_sphinx_extensions.pep_zero_generator import pep_0_parser
+from pep_sphinx_extensions.pep_zero_generator import pep_0_writer
+
+if TYPE_CHECKING:
+    from sphinx.application import Sphinx
+    from sphinx.environment import BuildEnvironment
+
+
+def create_pep_zero(_: Sphinx, env: BuildEnvironment, docnames: list[str]) -> None:
+    # Sphinx app object is unneeded by this function
+
+    # Read from root directory
+    path = Path(".")
+
+    pep_zero_filename = "pep-0000"
+    peps: list[pep_0_parser.PEP] = []
+    pep_pat = re.compile(r"pep-\d{4}")  # Path.match() doesn't support regular expressions
+    title_length = pep_0_writer.title_length
+
+    # AUTHORS.csv is an exception file for PEP0 name parsing
+    with open("AUTHORS.csv", "r", encoding="utf-8") as f:
+        read = csv.DictReader(f, quotechar='"', skipinitialspace=True)
+        author_exception_data = {}
+        for line in read:
+            full_name = line.pop("Full Name").strip()
+            details = {k.strip(): v.strip() for k, v in line.items()}
+            author_exception_data[full_name] = details
+
+    for file_path in path.iterdir():
+        if not file_path.is_file():
+            continue  # Skip directories etc.
+        if file_path.match("pep-0000*"):
+            continue  # Skip pre-existing PEP 0 files
+        if pep_pat.match(str(file_path)) and file_path.suffix in {".txt", ".rst"}:
+            pep = pep_0_parser.PEP(path.joinpath(file_path).absolute(), author_exception_data, title_length)
+            peps.append(pep)
+    peps.sort(key=lambda pep: pep.number)
+
+    pep_writer = pep_0_writer.PEPZeroWriter()
+    pep0_text = pep_writer.write_pep0(peps)
+    Path(f"{pep_zero_filename}.rst").write_text(pep0_text, encoding="utf-8")
+
+    # Add to files for builder
+    docnames.insert(1, pep_zero_filename)
+    # Add to files for writer
+    env.found_docs.add(pep_zero_filename)