Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

Python Enhancement Proposals

The PEPs in this repo are published automatically on the web at  To learn more about the purpose of
PEPs and how to go about writing a PEP, please start reading at PEP 1
(pep-0001.txt in this repo).  Note that PEP 0, the index PEP, is now
automatically generated, and not committed to the repo.

reStructuredText for PEPs

Original PEP source may be written using two standard formats, a
mildly idiomatic plaintext format and the reStructuredText format
(also, technically plaintext).  These two formats are described in
PEP 9 and PEP 12 respectively.  The processing and
installation script knows how to produce the HTML for either PEP

For processing reStructuredText format PEPs, you need the docutils
package, which is available from PyPI (
If you have pip, "pip install docutils" should install it.

Generating HTML

Do not commit changes with bad formatting.  To check the formatting of
a PEP, use the Makefile.  In particular, to generate HTML for PEP 999,
your source code should be in pep-0999.txt and the HTML will be
generated to pep-0999.html by the command "make pep-0999.html".  The
default Make target generates HTML for all PEPs.  If you don't have
Make, use the script.

Recent activity

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.