Many PEPs: Rename to .rst

.gitignore

@@ -1,4 +1,3 @@
-pep-0000.txt
 pep-0000.rst
 pep-????.html
 peps.rss

.pre-commit-config.yaml

@@ -74,11 +74,11 @@ repos:
         name: "Check RST: No single backticks"
       - id: rst-inline-touching-normal
         name: "Check RST: No backticks touching text"
-        files: '^pep-\d+\.txt|\.rst$'
+        files: '^pep-\d+\.rst$'
         types: [text]
       - id: rst-directive-colons
         name: "Check RST: 2 colons after directives"
-        files: '^pep-\d+\.txt|\.rst$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
   # Manual codespell check
@@ -96,32 +96,32 @@ repos:
         name: "Check tabs not used in PEPs"
         language: pygrep
         entry: '\t'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: check-required-fields
         name: "Check PEPs 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)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-pep-number
         name: "'PEP' header must be a number 1-9999"
         language: pygrep
         entry: '(?-m:^PEP:(?:(?! +(0|[1-9][0-9]{0,3})\n)))'
         args: ['--multiline']
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-title
         name: "'Title' must be 1-79 characters"
         language: pygrep
         entry: '(?<=\n)Title:(?:(?! +\S.{1,78}\n(?=[A-Z])))'
         args: ['--multiline']
-        files: '^pep-\d+\.(rst|txt)$'
-        exclude: '^pep-(0499)\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
+        exclude: '^pep-(0499)\.rst$'
         types: [text]
 
       - id: validate-author
@@ -137,107 +137,107 @@ repos:
         language: pygrep
         entry: '(?<=\n)Author:(?:(?!((((( +|\n {1,8})[^!#$%&()*+,/:;<=>?@\[\\\]\^_`{|}~]+( <[\w!#$%&''*+\-/=?^_{|}~.]+(@| at )[\w\-.]+\.[A-Za-z0-9]+>)?)(,|(?=\n[^ ])))+)|(((( +|\n {1,8})[\w!#$%&''*+\-/=?^_{|}~.]+(@| at )[\w\-.]+\.[A-Za-z0-9]+) \(([^!#$%&()*+,/:;<=>?@\[\\\]\^_`{|}~]+)\)(,|(?=\n[^ ])))+))\n(?=[A-Z])))'
         args: [--multiline]
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-sponsor
         name: "'Sponsor' must have format 'Name <[email protected]>'"
         language: pygrep
         entry: '^Sponsor:(?: (?! *[^!#$%&()*+,/:;<=>?@\[\\\]\^_`{|}~]+( <[\w!#$%&''*+\-/=?^_{|}~.]+(@| at )[\w\-.]+\.[A-Za-z0-9]+>)?$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-delegate
         name: "'Delegate' must have format 'Name <[email protected]>'"
         language: pygrep
         entry: '^(PEP|BDFL)-Delegate: (?:(?! *[^!#$%&()*+,/:;<=>?@\[\\\]\^_`{|}~]+( <[\w!#$%&''*+\-/=?^_{|}~.]+(@| at )[\w\-.]+\.[A-Za-z0-9]+>)?$))'
-        files: '^pep-\d+\.(rst|txt)$'
-        exclude: '^pep-(0451)\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
+        exclude: '^pep-(0451)\.rst$'
         types: [text]
 
       - id: validate-discussions-to
         name: "'Discussions-To' must be a thread URL"
         language: pygrep
         entry: '^Discussions-To: (?:(?!([\w\-]+@(python\.org|googlegroups\.com))|https://((discuss\.python\.org/t/([\w\-]+/)?\d+/?)|(mail\.python\.org/pipermail/[\w\-]+/\d{4}-[A-Za-z]+/[A-Za-z0-9]+\.html)|(mail\.python\.org/archives/list/[\w\-]+@python\.org/thread/[A-Za-z0-9]+/?))$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-status
         name: "'Status' must be a valid PEP status"
         language: pygrep
         entry: '^Status:(?:(?! +(Draft|Withdrawn|Rejected|Accepted|Final|Active|Provisional|Deferred|Superseded|April Fool!)$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-type
         name: "'Type' must be a valid PEP type"
         language: pygrep
         entry: '^Type:(?:(?! +(Standards Track|Informational|Process)$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-topic
         name: "'Topic' must be for a valid sub-index"
         language: pygrep
         entry: '^Topic:(?:(?! +(Packaging|Typing|Packaging, Typing)$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-content-type
         name: "'Content-Type' must be 'text/x-rst'"
         language: pygrep
         entry: '^Content-Type:(?:(?! +text/x-rst$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-pep-references
         name: "`Requires`/`Replaces`/`Superseded-By` must be 'NNN' PEP IDs"
         language: pygrep
         entry: '^(Requires|Replaces|Superseded-By):(?:(?! *( (0|[1-9][0-9]{0,3})(,|$))+$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-created
         name: "'Created' must be a 'DD-mmm-YYYY' date"
         language: pygrep
         entry: '^Created:(?:(?! +([0-2][0-9]|(3[01]))-(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)-(199[0-9]|20[0-9][0-9])$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-python-version
         name: "'Python-Version' must be a 'X.Y[.Z]` version"
         language: pygrep
         entry: '^Python-Version:(?:(?! *( [1-9]\.([0-9][0-9]?|x)(\.[1-9][0-9]?)?(,|$))+$))'
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-post-history
         name: "'Post-History' must be '`DD-mmm-YYYY <Thread URL>`__, ...'"
         language: pygrep
         entry: '(?<=\n)Post-History:(?:(?! ?\n|((( +|\n {1,14})(([0-2][0-9]|(3[01]))-(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)-(199[0-9]|20[0-9][0-9])|`([0-2][0-9]|(3[01]))-(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)-(199[0-9]|20[0-9][0-9]) <https://((discuss\.python\.org/t/([\w\-]+/)?\d+/?)|(mail\.python\.org/pipermail/[\w\-]+/\d{4}-[A-Za-z]+/[A-Za-z0-9]+\.html)|(mail\.python\.org/archives/list/[\w\-]+@python\.org/thread/[A-Za-z0-9]+/?(#[A-Za-z0-9]+)?))>`__)(,|(?=\n[^ ])))+\n(?=[A-Z\n]))))'
         args: [--multiline]
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: validate-resolution
         name: "'Resolution' must be a direct thread/message URL"
         language: pygrep
         entry: '(?<!\n\n)(?<=\n)Resolution: (?:(?!https://((discuss\.python\.org/t/([\w\-]+/)?\d+(/\d+)?/?)|(mail\.python\.org/pipermail/[\w\-]+/\d{4}-[A-Za-z]+/[A-Za-z0-9]+\.html)|(mail\.python\.org/archives/list/[\w\-]+@python\.org/(message|thread)/[A-Za-z0-9]+/?(#[A-Za-z0-9]+)?))\n(?=\n)))'
         args: ['--multiline']
-        files: '^pep-\d+\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
         types: [text]
 
       - id: check-direct-pep-links
         name: "Check that PEPs aren't linked directly"
         language: pygrep
         entry: '(dev/peps|peps\.python\.org)/pep-\d+'
-        files: '^pep-\d+\.(rst|txt)$'
-        exclude: '^pep-(0009|0287|0676|8001)\.(rst|txt)$'
+        files: '^pep-\d+\.rst$'
+        exclude: '^pep-(0009|0287|0676|8001)\.rst$'
         types: [text]
 
       - id: check-direct-rfc-links
         name: "Check that RFCs aren't linked directly"
         language: pygrep
         entry: '(rfc-editor\.org|ietf\.org)/[\.\-_\?\&\#\w/]*[Rr][Ff][Cc][\-_]?\d+'
-        files: '\.(rst|txt)$'
+        files: '\.rst$'
         types: [text]

conf.py

@@ -26,7 +26,6 @@
 # The file extensions of source files. Sphinx uses these suffixes as sources.
 source_suffix = {
     ".rst": "pep",
-    ".txt": "pep",
 }
 
 # List of patterns (relative to source dir) to ignore when looking for source files.
@@ -35,7 +34,6 @@
     "contents.rst",
     # PEP files
     "pep-????.rst",
-    "pep-????.txt",
     # PEP ancillary files
     "pep-????/*.rst",
     # Documentation

docs/rendering_system.rst

@@ -24,7 +24,7 @@ Configuration is stored in three files:
 The configuration:
 
 - registers the custom Sphinx extension
-- sets both ``.txt`` and ``.rst`` suffixes to be parsed as PEPs
+- sets the ``.rst`` suffix to be parsed as PEPs
 - tells Sphinx which source files to use
 - registers the PEP theme, maths renderer, and template
 - disables some default settings that are covered in the extension