Skip to content
/ peps Public

Python Enhancement Proposals

Notifications You must be signed in to change notification settings

python/peps

Folders and files

NameName
Last commit message
Last commit date

Latest commit

fdab484 · Mar 18, 2025
Aug 20, 2024
Mar 14, 2025
Nov 3, 2023
Feb 3, 2023
Mar 5, 2025
Mar 18, 2025
Aug 20, 2024
Sep 9, 2023
Oct 2, 2024
Feb 1, 2025
Dec 19, 2024
Feb 8, 2024
Dec 12, 2023
Jan 20, 2025
Dec 14, 2023
Sep 9, 2023
Feb 1, 2025
Sep 5, 2023
Dec 31, 2024
Feb 8, 2024

Repository files navigation

Python Enhancement Proposals

The PEPs in this repo are published automatically on the web at https://peps.python.org/. To learn more about the purpose of PEPs and how to go about writing one, please start reading at PEP 1. Note that the PEP Index (PEP 0) is automatically generated based on the metadata headers in other PEPs.

Canonical links

The canonical form of PEP links are zero-padded, such as https://peps.python.org/pep-0008/.

Shortcut redirects are also available. For example, https://peps.python.org/8 redirects to the canonical link.

Contributing to PEPs

See the Contributing Guidelines.

Checking PEP formatting and rendering

Please don't commit changes with reStructuredText syntax errors that cause PEP generation to fail, or result in major rendering defects relative to what you intend.

Browse the "Read the Docs" preview

For every PR, we automatically create a preview of the rendered PEPs using Read the Docs. You can find it in the merge box at the bottom of the PR page:

  1. Click "Show all checks" to expand the checks section
  2. Find the line for docs/readthedocs.org:pep-previews
  3. Click on "Details" to the right

Render PEPs locally

See the build documentation for full instructions on how to render PEPs locally. In summary, run the following in a fresh, activated virtual environment:

# Install requirements
python -m pip install -U -r requirements.txt

# Build the PEPs
make html

# Or, if you don't have 'make':
python build.py

The output HTML is found under the build directory.

Check and lint PEPs

You can check for and fix common linting and spelling issues, either on-demand or automatically as you commit, with our pre-commit suite. See the Contributing Guide for details.