intermediate
13 min read
Modern Python Type Hints: What Annotations Do—and Do Not Do
Here is a function that lies to every tool you own and still runs in production:
Read tutorialintermediate-to-advanced
Python Programming
Advanced Python for reliable AI and software systems.
Tutorials
Articles in Python Programming
Explore the mechanisms, tradeoffs, and implementation patterns within this AI engineering track.
advanced
14 min read
Advanced Python Typing: TypedDict, Literal, Protocol, Generics, and Callable Types
A dict payload that passes every test until someone renames a key. A callback whose signature drifts by one argument. A duck-typed object that satisfies…
Read tutorial
intermediate
11 min read
Python Closures and `nonlocal`: How Functions Retain Enclosing State
A closure captures the binding, not the value. That distinction explains the loop bug, the counter that refuses to count, and why your factory returns…
Read tutorial
advanced
15 min read
Python Decorators Under the Hood: Wrappers, Closures, and Function Transformation
A decorator is not a wrapper. It is a rebinding that happens once, at import time — and most decorator bugs live in the gap between that fact and the…
Read tutorial
intermediate
12 min read
Functions as Values in Python: Higher-Order Functions, Callbacks, and Callable Objects
Six months after the pipeline shipped, nobody can tell what the handler actually takes.
Read tutorial
intermediate
19 min read
Python Iterators, Generators, and Lazy Evaluation: How Iteration Really Works
A generator is not a lazy list. It is a suspended function with a position, and once you can see that position, most "why did my pipeline eat 8 GB" bugs…
Read tutorial
intermediate
14 min read
Python Context Managers and the `with` Statement: Deterministic Resource Management
A leaked connection, a lock that never released, a transaction that committed on the wrong path. None of these are exotic failures. They are ordinary…
Read tutorial
intermediate
13 min read
Python Exceptions and Error Handling: `try`, `except`, `else`, `finally`, and `raise`
A try statement is not a safety net. It is a four-clause control-flow machine, and most production bugs come from putting logic in the wrong slot.
Read tutorial
advanced
9 min read
Designing Python Exception Boundaries: Custom Exceptions, Chaining, Re-Raising, and Exception Groups
A boundary that leaks sqlite3.OperationalError into your domain code has not failed loudly. It has failed quietly, by making every caller learn your…
Read tutorial
intermediate
14 min read
Python Dataclasses and Structured State: Designing Explicit Data Contracts
I have watched the same bug arrive in three different codebases. A configuration payload enters as a dictionary, gets copied into a queue message, gets…
Read tutorial
advanced
13 min read
Python `async`/`await` and the Event Loop: Coroutines, Tasks, Cancellation, and I/O
A coroutine that never runs is not a syntax error. It is an object you built and never drove.
Read tutorial
advanced
13 min read
Concurrency vs Parallelism in Python: Asyncio, Threads, Processes, and Interpreters
Someone adds concurrency to a slow service and the service gets slower. Throughput drops, latency climbs, and the incident channel fills with timeouts. The…
Read tutorial
advanced
11 min read
Python Threads, the GIL, and Free-Threaded CPython
A thread pool that scales on network calls and flatlines on arithmetic is not a mystery. It is the Global Interpreter Lock doing exactly what it was…
Read tutorial
advanced
13 min read
Python Multiprocessing and Process Pools: When Separate Processes Are Worth It
One core is pinned at 100%. Fifteen sit idle. You wrap the loop in a pool, run it again, and the wall clock barely moves — or gets worse. Nothing about the…
Read tutorial