Lint: Add check-peps.py (#3275)

``check-peps`` codifies the rules in PEP 1 and PEP 12 into a single
place containing all of the PEP-specific checks. These are primarily
header and metadata validation, and ensuring that direct links to
RFCs and PEPs aren't used.

Reviewed-by: Hugo van Kemenade <[email protected]>
Reviewed-by: C.A.M. Gerlach <[email protected]>

.github/CODEOWNERS

@@ -20,6 +20,7 @@ contents.rst            @AA-Turner
 .codespell/             @CAM-Gerlach @hugovk
 .codespellrc            @CAM-Gerlach @hugovk
 .pre-commit-config.yaml @CAM-Gerlach @hugovk
+check-peps.py           @AA-Turner @CAM-Gerlach @hugovk
 
 # Git infrastructure
 .gitattributes          @CAM-Gerlach

.github/workflows/lint.yml

@@ -35,3 +35,17 @@ jobs:
         uses: pre-commit/[email protected]
         with:
           extra_args: --all-files --hook-stage manual codespell || true
+
+  check-peps:
+    name: Run check-peps
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python 3
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3"
+
+      - name: Run check-peps
+        run: python check-peps.py --detailed

.pre-commit-config.yaml

@@ -101,6 +101,14 @@ repos:
   # Local checks for PEP headers and more
   - repo: local
     hooks:
+#      # Hook to run "check-peps.py"
+#      - id: "check-peps"
+#        name: "Check PEPs for metadata and content enforcement"
+#        entry: "python check-peps.py"
+#        language: "system"
+#        files: "^pep-\d{4}\.(rst|txt)$"
+#        require_serial: true
+
       - id: check-no-tabs
         name: "Check tabs not used in PEPs"
         language: pygrep