Only rebuild index files when PEP metadata changes, not on every build

Author: hugovk

pep_sphinx_extensions/pep_zero_generator/subindices.py

@@ -16,11 +16,17 @@
 
 def update_sphinx(filename: str, text: str, docnames: list[str], env: BuildEnvironment) -> Path:
     file_path = Path(env.srcdir, f"{filename}.rst")
-    file_path.write_text(text, encoding="utf-8")
-
-    # Add to files for builder
-    docnames.append(filename)
-    # Add to files for writer
+    # Only write and schedule for rebuild if content actually changed
+    try:
+        current = file_path.read_text(encoding="utf-8")
+    except FileNotFoundError:
+        current = None
+    if current != text:
+        file_path.write_text(text, encoding="utf-8")
+        if filename not in docnames:
+            docnames.append(filename)
+
+    # Always ensure Sphinx knows about the file
     env.found_docs.add(filename)
 
     return file_path

peps/conf.py

@@ -43,6 +43,9 @@
     "api/*.rst",
     # Documentation
     "docs/*.rst",
+    # Generated index files
+    "numerical.rst",
+    "topic/*.rst",
 ]
 # And to ignore when looking for source files.
 exclude_patterns = [