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.
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.
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
# Render the PEPs
make render
# 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.