index.md

layout	home
hero	name text tagline actions Python Handbook Modern Python, rebuilt around Python 3.14 A bilingual handbook for Pythonic design, typing, CPython internals, asyncio, FastAPI, Pydantic, and SQLAlchemy 2.0 theme text link brand Start with Intro /en/intro/ theme text link alt 한국어로 읽기 /
features	title details Bilingual Handbook Korean lives at the site root and English lives under `/en/`, so you can switch languages without leaving the handbook structure. title details Visual First Important chapters use quick takeaways, diagrams, and runnable code blocks instead of dense walls of prose. title details Language to Frameworks The path goes from Pythonic patterns and typing to runtime 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.