# Python Reference

A modern, from-scratch Python reference — the core language plus the tooling
you actually run in 2026. Split into short, focused docs so you can jump
straight to what you need.

## Contents

| #  | Doc | Covers |
|--- |-----|--------|
| 01 | [Basics](01-basics.md) | Variables, strings, f-strings, numbers, input |
| 02 | [Lists & Tuples](02-lists-and-tuples.md) | Lists, slicing, comprehensions, tuples |
| 03 | [Dicts & Sets](03-dicts-and-sets.md) | Dictionaries, sets, comprehensions |
| 04 | [Control Flow](04-control-flow.md) | if/elif/else, loops, match/case, walrus |
| 05 | [Functions](05-functions.md) | Arguments, defaults, *args/**kwargs, type hints, lambdas |
| 06 | [Classes & OOP](06-classes-and-oop.md) | Classes, inheritance, dataclasses |
| 07 | [Files & Exceptions](07-files-and-exceptions.md) | pathlib, reading/writing files, try/except |
| 08 | [Modern Tooling](08-modern-tooling.md) | uv, uvx, pyproject.toml, ruff, pytest |
| 09 | [Async Programming](09-async-programming.md) | async/await, tasks, queues, event loop |
| 10 | [Standard Library](10-standard-library.md) | itertools, functools, logging, datetime, json |
| 11 | [Type System](11-type-system.md) | Generics, Protocols, TypedDict, type guards |

## How to use this

Each doc is self-contained: a short intro, then runnable snippets grouped by
task, in the order you'd typically learn them. Nothing here assumes you've
read the others first, so it also works as a grab-and-go reference.

## Requirements

Examples target **Python 3.12+**. Anything version-specific (like `match`
statements or the newer type-hint syntax) is called out inline.

---

Built as an independent reference — not affiliated with, derived from, or
endorsed by any book, course, or publisher.