knaxuslearn · build · ship

Roadmaps / Python

Programming Languages · 16 study weeks · 4 phases

Python Roadmap Beta

Python is the easiest language to start in and one of the hardest to run well at scale. These 16 study weeks teach how the interpreter works, how to type and test a codebase, how to make Python fast where it matters and how to ship a Python service that other people can operate. You build one system, ingestd, an event ingestion service that validates, transforms and stores device events, and every phase adds a checkpoint to it. At 8 hours a week the core path is 128 hours and takes 16 weeks. At 12 hours a week it takes about 11 weeks, and at 16 hours a week about 8 weeks. At the end you can show, with numbers, where Python is fast enough, where it is not and what you did about it.

This roadmap is in beta and keeps improving over time. If you spot an error, please email your suggestions and corrections to [email protected].

Read first

  1. Phase 1 · Study weeks 1-4

    The interpreter and how to measure it

    This phase makes the first checkpoint possible: a baseline you can profile and a clear answer on threads, processes and free threading.

    • 3 repos
    • Milestone checkpoint
    1. Study week 1Objects and references8 h
    2. Study week 2The GIL and what it protects8 h
    3. Study week 3Profiling with cProfile and the sampling profiler8 h
    4. Study week 4Reading CPython source8 h
  2. Phase 2 · Study weeks 5-8

    Types, tests and data models

    This phase makes the second checkpoint possible: a core that the type checker, the tests and a property test all accept.

    • 5 repos
    • Milestone checkpoint
    1. Study week 5Type hints and mypy --strict8 h
    2. Study week 6Validation at the boundary with Pydantic8 h
    3. Study week 7pytest fixtures and parametrisation8 h
    4. Study week 8Ruff and the lint set8 h
  3. Phase 3 · Study weeks 9-12

    Async, performance and durability

    This phase makes the third checkpoint possible: a service that holds its latency target and loses no acknowledged event.

    • 5 repos
    • Milestone checkpoint
    1. Study week 9The event loop and asyncio8 h
    2. Study week 10Web layer with FastAPI8 h
    3. Study week 11Durability: acknowledge after commit8 h
    4. Study week 12Load testing8 h
  4. Phase 4 · Study weeks 13-16

    Packaging, supply chain and upgrades

    This phase makes the last checkpoint possible: a service you can ship, keep patched and defend to a team.

    • 3 repos
    • Milestone checkpoint
    1. Study week 13uv, lockfiles and workspaces8 h
    2. Study week 14Container images and a non-root user8 h
    3. Study week 15pip-audit and advisories8 h
    4. Study week 16Upgrade policy for an annual release8 h

Also in this roadmap