Independent field notes / Vol. 01

Python,
below the surface.

Precise explanations of the machinery, patterns, and tradeoffs that make Python feel deceptively simple.

The index

Choose a rabbit hole.

29 notes, edited for signal.

Match queues, priorities, and sorted searches to the containers that make their dominant work cheap.

advanced31 minPython 3.10+ (3.14+ for max-heaps)

Follow exceptions through matching, unwinding, chaining, cleanup, exception groups, and CPython 3.14 exception tables.

advanced33 minPython 3.14

Design reliable cleanup around context managers, finalizers, cycles, resurrection, shutdown, async cancellation, and process exit.

advanced31 minPython 3.10+

Build a small import hook while learning how finders, module specs, loaders, caches, packages, and failure cleanup divide responsibility.

advanced34 minPython 3.14

Trace Python name resolution through live frames, fast locals, module globals, builtins, and the namespace rules around exec.

advanced32 minPython 3.14

Separate Python call semantics from CPython vectorcall, then design APIs that avoid needless argument and boundary overhead.

advanced31 minPython 3.14

Build a precise model of CPython object lifetime, cycles, finalizers, weak references, and the diagnostics that can accidentally keep objects alive.

advanced33 minPython 3.10+

Trace a class statement through namespace preparation, body execution, metaclass construction, descriptors, and subclass hooks.

advanced32 minPython 3.10+

Editorial policy

No listicles. No folklore. No just trust me abstractions.

Every note should leave you with a better model of the system, not just another snippet to paste.