Course Map¶
Page Maps¶
graph LR
family["Python Programming"]
program["Python Meta-Programming"]
section["Orientation"]
page["Course Map"]
capstone["Capstone evidence"]
family --> program --> section --> page
page -.applies in.-> capstone
flowchart LR
orient["Orient on the page map"] --> read["Read the main claim and examples"]
read --> inspect["Inspect the related code, proof, or capstone surface"]
inspect --> verify["Run or review the verification path"]
verify --> apply["Apply the idea back to the module and capstone"]
Read the first diagram as a placement map: this page is one concept inside its parent module, not a detached essay, and the capstone is the pressure test for whether the idea holds. Read the second diagram as the working rhythm for the page: name the question, choose the right arc, then carry one review judgment into the executable system.
This page is the orientation hub for the whole course. The progression is deliberate: start with runtime objects and observation, move into wrappers and class customization, then into descriptors, metaclasses, and finally runtime governance.
How to use this map¶
- Use the staged maps below instead of trying to hold the whole ten-module sequence in memory at once.
- Treat each module as answering a different class of metaprogramming question.
- Keep the capstone open while reading so each mechanism stays attached to one executable surface.
- Use the course guides when you need route help and the reference shelf when you need review standards.
Staged maps¶
First-Contact Map¶
Use this when you are starting the course or refreshing the foundations.
- Modules 01 to 03
- runtime objects, safe observation, signatures, provenance, and evidence
- the minimum route for understanding why later runtime hooks should not feel magical
Mid-Course Map¶
Use this when the foundations are no longer the blocker but the control and ownership modules still need a clearer bridge.
- Modules 04 to 08
- wrapper honesty, class customization, descriptor ownership, and field architecture
- the route that keeps the climb toward higher-power hooks deliberate instead of blurry
Mastery Map¶
Use this when you are reviewing stronger runtime hooks or deciding whether the design is still honest.
- Modules 04 to 10
- wrappers, descriptors, metaclasses, dynamic execution boundaries, and review policy
- the route where mechanism knowledge becomes design judgment
Route by runtime question¶
| If your current question is... | Start with | Then |
|---|---|---|
| What is Python actually doing at runtime here? | first-contact foundations | Modules 01 to 03 |
| Where should this behavior live: wrapper, attribute, or class boundary? | control and ownership route | Modules 04 to 08 |
| Is a metaclass or other high-power hook truly justified? | class-creation and governance route | Modules 09 to 10 |
This keeps the course tied to human questions instead of forcing you to remember module numbers first.
Quick module summary¶
| Stage | Modules | Main runtime question |
|---|---|---|
| Foundations | 01 to 03 | What exists at runtime, and what can I inspect safely and truthfully? |
| Control | 04 to 08 | Which boundary should own this behavior: callable, attribute, or class family? |
| Governance | 09 to 10 | When is higher-power runtime control justified, and when should it be rejected? |
What to keep open while using this map¶
- Keep Module Promise Map and Module Checkpoints open so each stage has a clear contract and exit bar.
- Keep Proof Ladder open so proof stays proportional to the question.
- Keep Capstone Map open so the course remains attached to one executable system.
- Keep Mid-Course Map open whenever the jump from observation to ownership feels too abrupt.