[proxy] web.archive.org← back | site home | direct (HTTPS) ↗ | proxy home | ◑ dark◐ light

Python Developer’s Guide — Python Developer's Guide

The Wayback Machine - https://web.archive.org/web/20121025045402/http://docs.python.org:80/devguide/

Quick Start

Here is a list of the basic steps necessary to get set up and make a patch:

  1. Get a clone of CPython with hg clone http://hg.python.org/cpython.

  2. On UNIX, run ./configure --with-pydebug && make -j2 to build Python.

    On Windows, load the project file PCbuild\pcbuild.sln in Visual Studio, select , and .

  3. Run the tests with ./python -m test -j3 (use ./python.exe on most Mac OS X systems and PCbuild\python_d.exe on Windows; replace test with test.regrtest for 2.7).

  4. Make the patch.

  5. Submit it to the issue tracker.

Proposing changes to Python itself

Improving Python’s code, documentation and tests are ongoing tasks that are never going to be “finished”, as Python operates as part of an ever-evolving system of technology. An even more challenging ongoing task than these necessary maintenance activities is finding ways to make Python, in the form of the standard library and the language definition, an even better tool in a developer’s toolkit.

While these kinds of change are much rarer than those described above, they do happen and that process is also described as part of this guide:

Also refer to Where should I suggest new features and language changes? in the FAQ.

Other Interpreter Implementations

This guide is specifically for contributing to the Python reference interpreter, also known as CPython (while most of the standard library is written in Python, the interpreter core is written in C and integrates most easily with the C and C++ ecosystems).

There are other Python implementations, each with a different focus. Like CPython, they always have more things they would like to do than they have developers to work on them. Some major example that may be of interest are:

  • PyPy: A Python interpreter focused on high speed (JIT-compiled) operation on major platforms
  • Jython: A Python interpreter focused on good integration with the Java Virtual Machine (JVM) environment
  • IronPython: A Python interpreter focused on good integration with the Common Language Runtime (CLR) provided by .NET and Mono
  • Stackless: A Python interpreter focused on providing lightweight microthreads while remaining largely compatible with CPython specific extension modules

Key Resources

Additional Resources