Skip to content

Python HandbookModern Python, rebuilt around Python 3.14

A bilingual handbook for Pythonic design, typing, CPython internals, asyncio, FastAPI, Pydantic, and SQLAlchemy 2.0

What This Handbook Is

Core idea: this is not a release-note archive. It is a topic-driven handbook that uses Python 3.14 as the baseline and connects language design, runtime behavior, and backend engineering.

1. Rebuild Pythonic intuition

Start with the data model, descriptors, decorators, context managers, and metaclasses before touching framework internals.

2. Use typing as design

Treat modern typing as a way to shape APIs and boundaries, not as decorative syntax.

3. See runtime behavior

Frames, bytecode, specialization, the GIL, and GC explain many performance and architecture tradeoffs.

4. Apply it to services

FastAPI, Pydantic, and SQLAlchemy make more sense once the language and runtime pieces are clear.

Recommended Entry Points

  1. Intro for the map of the handbook.
  2. Execution Model for how Python code actually runs.
  3. Metaclasses for class creation hooks and alternatives.
  4. FastAPI Project Structure for a pragmatic service layout.

How Chapters Are Written

  • Quick takeaway: one sentence you should remember after reading.
  • Diagram: a visual model before implementation details.
  • Code: practical examples you can run or adapt.
  • Checklist: when to use the technique and where it goes wrong.

Built with VitePress for a Python 3.14 handbook.