PEP 12: Allow Pending as Post-History (#4670)

hugovk · web-flow · commit c444db043c93 · 2025-10-23T20:02:38.000+03:00
diff --git a/check-peps.py b/check-peps.py
@@ -401,7 +401,7 @@ def _validate_python_version(line_num: int, line: str) -> MessageIterator:
 def _validate_post_history(line_num: int, body: str) -> MessageIterator:
     """'Post-History' must be '`DD-mmm-YYYY <Thread URL>`__, …' or `DD-mmm-YYYY`"""
 
-    if body == "":
+    if body in ("", "Pending"):
         return
 
     for offset, line in enumerate(body.removesuffix(",").split("\n"), start=line_num):
@@ -414,7 +414,7 @@ def _validate_post_history(line_num: int, body: str) -> MessageIterator:
                 yield from _date(offset, post_date, "Post-History")
                 yield from _thread(offset, post_url, "Post-History")
             else:
-                yield offset, "post line must be a date or both start with “`” and end with “>`__”"
+                yield offset, "post line must be a date or both start with “`” and end with “>`__”, or 'Pending'"
 
 
 def _validate_resolution(line_num: int, line: str) -> MessageIterator:
diff --git a/pep_sphinx_extensions/tests/pep_lint/test_post_url.py b/pep_sphinx_extensions/tests/pep_lint/test_post_url.py
@@ -61,6 +61,7 @@ def test_validate_discussions_to_invalid_list_domain(line: str):
     "body",
     [
         "",
+        "Pending",
         (
             "01-Jan-2001, 02-Feb-2002,\n              "
             "03-Mar-2003, 04-Apr-2004,\n              "
@@ -90,7 +91,7 @@ def test_validate_post_history_valid(body: str):
 def test_validate_post_history_unbalanced_link(body: str):
     warnings = [warning for (_, warning) in check_peps._validate_post_history(1, body)]
     assert warnings == [
-        "post line must be a date or both start with “`” and end with “>`__”"
+        "post line must be a date or both start with “`” and end with “>`__”, or 'Pending'"
     ], warnings
 
 
diff --git a/peps/pep-0012.rst b/peps/pep-0012.rst
@@ -119,7 +119,7 @@ directions below.
 - Add a Topic header if the PEP belongs under one shown at the :ref:`topic-index`.
   Most PEPs don't.
 
-- Leave Post-History alone for now; you'll add dates and corresponding links
+- Post-History can be 'Pending' for now; you'll add dates and corresponding links
   to this header each time you post your PEP to the designated discussion forum
   (and update the Discussions-To header with said link, as above).
   For each thread, use the date (in the ``dd-mmm-yyy`` format) as the
diff --git a/peps/pep-0012/pep-NNNN.rst b/peps/pep-0012/pep-NNNN.rst
@@ -10,7 +10,7 @@ Topic: <Governance | Packaging | Release | Typing>
 Requires: <pep numbers>
 Created: <date created on, in dd-mmm-yyyy format>
 Python-Version: <version number>
-Post-History: <REQUIRED: dates, in dd-mmm-yyyy format, and corresponding links to PEP discussion threads>
+Post-History: Pending
 Replaces: <pep number>
 Superseded-By: <pep number>
 Resolution: <url>

Original file line number	Diff line number	Diff line change
`@@ -61,6 +61,7 @@ def test_validate_discussions_to_invalid_list_domain(line: str):`
`61`	`61`	`"body",`
`62`	`62`	`[`
`63`	`63`	`"",`
	`64`	`+ "Pending",`
`64`	`65`	`(`
`65`	`66`	`"01-Jan-2001, 02-Feb-2002,\n "`
`66`	`67`	`"03-Mar-2003, 04-Apr-2004,\n "`
`@@ -90,7 +91,7 @@ def test_validate_post_history_valid(body: str):`
`90`	`91`	`def test_validate_post_history_unbalanced_link(body: str):`
`91`	`92`	`warnings = [warning for (_, warning) in check_peps._validate_post_history(1, body)]`
`92`	`93`	`assert warnings == [`
`93`		- "post line must be a date or both start with “`” and end with “>`__”"
	`94`	+ "post line must be a date or both start with “`” and end with “>`__”, or 'Pending'"
`94`	`95`	`], warnings`
`95`	`96`
`96`	`97`