This section gives an overview of CPython's code structure and provides a summary of file locations for modules and built-ins.
For a Python :term:`module`, the typical layout is:
- :file:`Lib/{<module>}.py`
- :file:`Modules/_{<module>}.c` (if there's also a C accelerator module)
- :file:`Lib/test/test_{<module>}.py`
- :file:`Doc/library/{<module>}.rst`
For an :term:`extension module`, the typical layout is:
- :file:`Modules/{<module>}module.c`
- :file:`Lib/test/test_{<module>}.py`
- :file:`Doc/library/{<module>}.rst`
For :ref:`bltin-types`, the typical layout is:
- :file:`Objects/{<builtin>}object.c`
- :file:`Lib/test/test_{<builtin>}.py`
- :cpy-file:`Doc/library/stdtypes.rst`
For :ref:`built-in-funcs`, the typical layout is:
- :cpy-file:`Python/bltinmodule.c`
- :cpy-file:`Lib/test/test_builtin.py`
- :cpy-file:`Doc/library/functions.rst`
Some exceptions to these layouts are:
- built-in type
intis at :cpy-file:`Objects/longobject.c` - built-in type
stris at :cpy-file:`Objects/unicodeobject.c` - built-in module
sysis at :cpy-file:`Python/sysmodule.c` - built-in module
marshalis at :cpy-file:`Python/marshal.c` - Windows-only module
winregis at :cpy-file:`PC/winreg.c`
The CPython code base is constantly changing and evolving. Here's a sample of references about CPython's architecture aimed at building your understanding of CPython internals and its evolution:
| Title | Brief | Author | Version |
|---|---|---|---|
| A guide from parser to objects, observed using GDB | Code walk from Parser, AST, Sym Table and Objects | Louie Lu | 3.7.a0 |
| Green Tree Snakes | The missing Python AST docs | Thomas Kluyver | 3.6 |
| Yet another guided tour of CPython | A guide for how CPython REPL works | Guido van Rossum | 3.5 |
| Python Asynchronous I/O Walkthrough | How CPython async I/O, generator and coroutine works | Philip Guo | 3.5 |
| Coding Patterns for Python Extensions | Reliable patterns of coding Python Extensions in C | Paul Ross | 3.4 |
| Your Guide to the CPython Source Code | Your Guide to the CPython Source Code | Anthony Shaw | 3.8 |
| Title | Brief | Author | Version |
|---|---|---|---|
| Python's Innards Series | ceval, objects, pystate and miscellaneous topics | Yaniv Aknin | 3.1 |
| Eli Bendersky's Python Internals | Objects, Symbol tables and miscellaneous topics | Eli Bendersky | 3.x |
| A guide from parser to objects, observed using Eclipse | Code walk from Parser, AST, Sym Table and Objects | Prashanth Raghu | 2.7.12 |
| CPython internals: A ten-hour codewalk through the Python interpreter source code | Code walk from source code to generators | Philip Guo | 2.7.8 |