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 |