Source code layout¶

For a Pythonmodule, the typical layout is:

• Lib/<module>.py

• Modules/_<module>.c (if there’s also a C accelerator module)

• Lib/test/test_<module>.py

• Doc/library/<module>.rst

For anextension module, the typical layout is:

• Modules/<module>module.c

• Lib/test/test_<module>.py

• Doc/library/<module>.rst

ForBuilt-in Types, the typical layout is:

• Objects/<builtin>object.c

• Lib/test/test_<builtin>.py

• Doc/library/stdtypes.rst

ForBuilt-in Functions, the typical layout is:

• Python/bltinmodule.c

• Lib/test/test_builtin.py

• Doc/library/functions.rst

Some exceptions to these layouts are:

• built-in typeint is atObjects/longobject.c

• built-in typestr is atObjects/unicodeobject.c

• built-in modulesys is atPython/sysmodule.c

• built-in modulemarshal is atPython/marshal.c

• Windows-only modulewinreg is atPC/winreg.c

Additional references¶

The CPython code base is constantly changing and evolving.Here’s a sample of references about CPython’s architecture aimed atbuilding your understanding of CPython internals and its evolution: