Lint: Add a new check for consistent PEP header order (#2835)

* Lint: Clarify name/ID of required header check

* PEP 440: Fix header ordering

* PEP 441: Fix header ordering

* PEP 523: Fix header ordering

* PEP 612: Fix spurious top-level title section heading

* Lint: Add new check for consistant PEP header order

.pre-commit-config.yaml

@@ -108,14 +108,22 @@ repos:
         files: '^pep-\d+\.(rst|txt)$'
         types: [text]
 
-      - id: check-required-fields
-        name: "Check PEPs have all required headers"
+      - id: check-required-headers
+        name: "PEPs must have all required headers"
         language: pygrep
         entry: '(?-m:^PEP:(?=[\s\S]*\nTitle:)(?=[\s\S]*\nAuthor:)(?=[\s\S]*\nStatus:)(?=[\s\S]*\nType:)(?=[\s\S]*\nContent-Type:)(?=[\s\S]*\nCreated:))'
         args: ['--negate', '--multiline']
         files: '^pep-\d+\.(rst|txt)$'
         types: [text]
 
+      - id: check-header-order
+        name: "PEP header order must follow PEP 12"
+        language: pygrep
+        entry: '^PEP:[^\n]+\nTitle:[^\n]+\n(Version:[^\n]+\n)?(Last-Modified:[^\n]+\n)?Author:[^\n]+\n( +\S[^\n]+\n)*(Sponsor:[^\n]+\n)?((PEP|BDFL)-Delegate:[^\n]*\n)?(Discussions-To:[^\n]*\n)?Status:[^\n]+\nType:[^\n]+\n(Topic:[^\n]+\n)?Content-Type:[^\n]+\n(Requires:[^\n]+\n)?Created:[^\n]+\n(Python-Version:[^\n]*\n)?(Post-History:[^\n]*\n( +\S[^\n]*\n)*)?(Replaces:[^\n]+\n)?(Superseded-By:[^\n]+\n)?(Resolution:[^\n]*\n)?\n'
+        args: ['--negate', '--multiline']
+        files: '^pep-\d+\.(rst|txt)$'
+        types: [text]
+
       - id: validate-pep-number
         name: "'PEP' header must be a number 1-9999"
         language: pygrep

pep-0440.txt

@@ -1,14 +1,12 @@
 PEP: 440
 Title: Version Identification and Dependency Specification
-Version: $Revision$
-Last-Modified: $Date$
 Author: Nick Coghlan <ncoghlan@gmail.com>,
         Donald Stufft <donald@stufft.io>
 BDFL-Delegate: Nick Coghlan <ncoghlan@gmail.com>
 Discussions-To: distutils-sig@python.org
 Status: Final
-Topic: Packaging
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 18-Mar-2013
 Post-History: 30-Mar-2013, 27-May-2013, 20-Jun-2013,

pep-0441.txt

@@ -1,7 +1,5 @@
 PEP: 441
 Title: Improving Python ZIP Application Support
-Version: $Revision$
-Last-Modified: $Date$
 Author: Daniel Holth <dholth@gmail.com>,
         Paul Moore <p.f.moore@gmail.com>
 Discussions-To: https://mail.python.org/pipermail/python-dev/2015-February/138277.html
@@ -9,8 +7,8 @@ Status: Final
 Type: Standards Track
 Content-Type: text/x-rst
 Created: 30-Mar-2013
-Post-History: 30-Mar-2013, 01-Apr-2013, 16-Feb-2015
 Python-Version: 3.5
+Post-History: 30-Mar-2013, 01-Apr-2013, 16-Feb-2015
 Resolution: https://mail.python.org/pipermail/python-dev/2015-February/138578.html
 
 Improving Python ZIP Application Support
@@ -349,14 +347,3 @@ Copyright
 =========
 
 This document has been placed into the public domain.
-
-
-
-..
-   Local Variables:
-   mode: indented-text
-   indent-tabs-mode: nil
-   sentence-end-double-space: t
-   fill-column: 70
-   coding: utf-8
-   End:

pep-0523.txt

@@ -1,15 +1,13 @@
 PEP: 523
 Title: Adding a frame evaluation API to CPython
-Version: $Revision$
-Last-Modified: $Date$
 Author: Brett Cannon <brett@python.org>,
         Dino Viehland <dinov@microsoft.com>
 Status: Final
 Type: Standards Track
 Content-Type: text/x-rst
 Created: 16-May-2016
-Post-History: 16-May-2016
 Python-Version: 3.6
+Post-History: 16-May-2016
 Resolution: https://mail.python.org/pipermail/python-dev/2016-August/145937.html
 
 
@@ -390,14 +388,3 @@ Copyright
 =========
 
 This document has been placed in the public domain.
-
-
-
-..
-   Local Variables:
-   mode: indented-text
-   indent-tabs-mode: nil
-   sentence-end-double-space: t
-   fill-column: 70
-   coding: utf-8
-   End:

pep-0612.rst

@@ -12,8 +12,6 @@ Created: 18-Dec-2019
 Python-Version: 3.10
 Post-History: 18-Dec-2019, 13-Jul-2020
 
-Parameter Specification Variables
-=================================
 
 Abstract
 --------