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.

49 notes, edited for signal.

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

Model pytest setup as a scoped dependency graph with explicit ownership, caching, and teardown edges.

intermediate32 minPython 3.10+

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+

Test import-time behavior without confusing module caching, finder caches, reload, and process isolation.

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.