Skip to content

Architecture decision records

Each record states one decision, with the options considered and the consequences. An accepted record is not rewritten; a later record supersedes it.

ADR Decision Status Date
ADR-0001 Use optimised reference counting with selective cycle collection Accepted 2026-11-05
ADR-0002 Accept only standard Python, with the meaning CPython gives it Superseded by ADR-0008 2026-11-05
ADR-0003 Implement Python independently, with no names of its own Accepted 2026-11-05
ADR-0004 Compile exceptions as error values returned to the caller Accepted 2026-11-05
ADR-0005 Write the compiler in Rust, with Ruff's parser and LLVM 23 Accepted 2026-11-05
ADR-0006 Write the runtime in Rust without the standard library Accepted 2026-11-06
ADR-0007 Write standard library modules in Python, compiled by TyPy Accepted 2026-11-06
ADR-0008 Judge each program by CPython from its own Python floor Accepted 2026-11-06
ADR-0009 Hold the built-in collections in the runtime, and measure the runtime a program links Accepted 2026-11-08
ADR-0010 Hash and order sets and dicts as CPython does Accepted 2026-11-09
ADR-0011 Hold None in a value each type never takes Accepted 2026-11-09
ADR-0012 Root every type at object, with a type object for each Accepted 2026-11-10
ADR-0013 Make exceptions objects of exception classes Accepted 2026-11-10
ADR-0014 Iterate with runtime iterator objects and the iterator protocol Accepted 2026-11-11
ADR-0015 Compile modules into one program, with module objects Accepted 2026-11-11
ADR-0016 Compile each module separately and verify interfaces at link time Proposed 2026-11-11
ADR-0017 Warn where CPython warns while compiling Superseded by ADR-0033 2026-11-12
ADR-0018 Provide math and sys as checker tables over runtime functions Accepted 2026-11-12
ADR-0019 Open text files over buffered descriptors with CPython's errors Accepted 2026-11-12
ADR-0020 Bound nesting as CPython does and compile on a large stack Accepted 2026-11-13
ADR-0021 Extend the base layout and call overrides through a method table Accepted 2026-11-13
ADR-0022 Hold a union of objects as a pointer and others as a tag and value Superseded by ADR-0027 2026-11-13
ADR-0023 Compile generics and protocol parameters to one copy per concrete type Accepted 2026-11-13
ADR-0024 Keep class variables in globals and defaults in each instance Accepted 2026-11-13
ADR-0025 Compile a class method once for each class that has it Accepted 2026-11-13
ADR-0026 Call operator methods directly and from the type object slots Accepted 2026-11-13
ADR-0027 Hold a union as its object, or as a tuple of a tag and a slot per member Accepted 2026-11-13
ADR-0028 Make each copy of a generic class answer as the generic class Accepted 2026-11-14
ADR-0029 Report CPython 3.15 as the Python version of a built program Accepted 2026-11-14
ADR-0030 Read exception args and exit codes where a program uses them Accepted 2026-11-14
ADR-0031 Type a file by its literal mode, and a mode value as text Accepted 2026-11-14
ADR-0032 Export a module as a C library described by its own annotations Accepted 2026-11-15
ADR-0033 Warn about a match that leaves members of its subject unmatched Accepted 2026-11-15
ADR-0034 Type exception args by the raises that create them Accepted 2026-11-15
ADR-0035 Type OSError attributes by the raises that create them Accepted 2026-11-15
ADR-0036 Call the function the last-run import bound Accepted 2026-11-15
ADR-0037 Reach class methods and class variables through the instance's class Accepted 2026-11-15
ADR-0038 Give way to the next operator method on NotImplemented Accepted 2026-11-16
ADR-0039 Keep a slot method's exception until the runtime call returns Accepted 2026-11-16
ADR-0040 Derive each copy of a generic class from the copy of its base Accepted 2026-11-16
ADR-0041 Hold a protocol value as an object and call it through a dispatcher Accepted 2026-11-16
ADR-0042 Allocate an instance that does not escape in its function's frame Accepted 2026-11-17
ADR-0043 Name the allocator in typy.toml and call it through program hooks Accepted 2026-11-17
ADR-0044 Run a library's module when it loads and guard each export Accepted 2026-11-17
ADR-0045 Name a library's files by its release as Linux names libraries Accepted 2026-11-17
ADR-0046 Write a library's binding as a typed function for each export Accepted 2026-11-17
ADR-0047 Compile ctypes declarations into direct calls linked at build time Accepted 2026-11-17
ADR-0048 Hold a ctypes object as a counted object over a C buffer Accepted 2026-11-17
ADR-0049 Lay out a ctypes structure as C and pass it as System V does Accepted 2026-11-17
ADR-0050 Build the documentation with Zensical and publish it on GitHub Pages Accepted 2026-11-17