📖 Fluent Python Journey

A chapter-by-chapter study of Fluent Python (2nd Ed.) by Luciano Ramalho.
An exploratory notebook focused on Python's internals, design patterns, and performance characteristics.

📚 Chapters · ⚡ Benchmarks · 🧠 Learning Journal · 🤝 Contributing

---

🎯 Goals

This repository is a structured engineering notebook built in public.

Every chapter contains:

• Code examples — runnable implementations of the book's concepts
• Benchmarks — practical performance measurements using timeit and perf_counter
• Architecture notes — observations on CPython design decisions
• Concept summaries — structured explanations of language features
• Mini-projects — small scripts applying the chapter concepts

This repository tracks my progress in understanding Python at a more systems-oriented level — focusing on how the language works under the hood.

---

🏗️ Repository Architecture

fluent-python-journey/
│
├── chapter_XX_<topic>/
│   ├── README.md              # Deep concept breakdown with diagrams
│   ├── examples.py            # Annotated, runnable original implementations
│   ├── exercises.py           # Original exercises extending book concepts
│   ├── mini_project.py        # Standalone project applying chapter concepts
│   ├── benchmarks.py          # Performance measurements with analysis
│   ├── notes.md               # Structured learning notes
│   ├── pitfalls.md            # Common mistakes + fixes
│   ├── interview_questions.md # Concept review Q&A
│   └── architecture_notes.md  # Design decisions and Python internals
│
├── scripts/
│   ├── scaffold_chapter.py    # Auto-generate new chapter structure
│   ├── check_structure.py     # Validate all chapters are complete
│   └── generate_commit_plan.py # Generate realistic commit message plan
│
├── LEARNING_JOURNAL.md        # Weekly reflections and insights
├── CONTRIBUTING.md            # How to navigate and contribute
├── requirements.txt           # Project dependencies
└── pyproject.toml             # Ruff, mypy, black configuration

---

📚 Chapter Index

#	Chapter	Status	Key Concepts
01	The Python Data Model	✅ Complete	__dunder__, protocols, special methods
02	An Array of Sequences	✅ Complete	listcomp, memoryview, slicing, deque, bisect
03	Dicts and Sets	✅ Complete	hash tables, dict internals, `
04	Unicode Text vs Bytes	✅ Complete	encoding, codec, NFC/NFD, Unicode sandwich
05	Data Class Builders	✅ Complete	namedtuple, NamedTuple, @dataclass, field()
06	Object References	✅ Complete	identity, equality, shallow/deep copy, del, GC
07	Functions as First Class	✅ Complete	closures, HOF, functools, operator
08	Type Hints in Functions	✅ Complete	annotations, mypy, Protocol
09	Decorators and Closures	✅ Complete	@wraps, parametrized decorators
10	Design Patterns with FP	✅ Complete	Strategy, Command via functions
11	A Pythonic Object	✅ Complete	__repr__, __str__, __format__, __slots__
12	Special Methods for Sequences	✅ Complete	vector class, slicing, dynamic attributes
13	Interfaces, Protocols, and ABCs	✅ Complete	duck typing, goose typing, abc module
14	Inheritance: For Better or For Worse	✅ Complete	super(), multiple inheritance, MRO
15	More About Type Hints	✅ Complete	overloaded, TypedDict, cast
16	Operator Overloading	✅ Complete	infix operators, augmented assignment
17	Iterators, Generators, and Classic Coroutines	✅ Complete	yield, yield from, itertools
18	with, match, and else Blocks	✅ Complete	context managers, pattern matching
19	Concurrency Models in Python	✅ Complete	processes, threads, GIL, asyncio vs multiprocessing
20	Concurrent Executors	✅ Complete	concurrent.futures, ThreadPoolExecutor
21	Asynchronous Programming	✅ Complete	async def, await, event loop
22	Dynamic Attributes and Properties	✅ Complete	__getattr__, @property, JSON parsing
23	Attribute Descriptors	✅ Complete	__get__, __set__, property internals
24	Class Metaprogramming	✅ Complete	class decorators, __new__, type, metaclasses

Legend: ✅ Complete · 📋 Planned

---

⚡ Performance Highlights

Benchmark	Finding	Chapter
len(obj) vs obj.__len__()	Dunder dispatch via len() is ~15% faster (C shortcut)	Ch. 01
list vs tuple memory	Tuple uses ~30% less memory; list over-allocates	Ch. 02
memoryview slicing	Zero-copy slicing is 100x faster for large binary data	Ch. 02
Dict lookup vs list scan	Dict O(1) vs list O(n) — 50x faster at N=10,000	Ch. 03
namedtuple vs @dataclass memory	namedtuple uses ~3x less memory (no __dict__)	Ch. 05
is vs ==	is is ~2-3x faster — single integer compare, no __eq__	Ch. 06
copy vs deepcopy	deepcopy is 10-100x slower depending on nesting depth	Ch. 06

---

🚀 Getting Started

# Clone the repository
git clone https://github.com/Uttkarsh952005/fluent-python-journey.git
cd fluent-python-journey

# Create virtual environment
python -m venv .venv
.venv\Scripts\activate    # Windows
# source .venv/bin/activate  # macOS/Linux

# Install dependencies
pip install -r requirements.txt

# Run Chapter 1 benchmarks
python chapter_01_python_data_model/benchmarks.py

# Run Chapter 2 benchmarks
python chapter_02_sequences/benchmarks.py

# Validate repository structure
python scripts/check_structure.py

---

📊 Learning Outcomes

By working through this repository alongside the book, the goal is to:

• Understand Python's object model — how protocols and special methods work
• Observe CPython source patterns — seeing how operations map to C-level functions
• Measure performance — practicing benchmarking over guessing
• Think architecturally — choosing the right data structures for practical problems

---

📖 References

• Fluent Python, 2nd Edition — Luciano Ramalho (O'Reilly, 2022)
• CPython Source Code
• Python Data Model Documentation
• PEP 3107 — Function Annotations
• PEP 544 — Protocols

---

📄 License

MIT License — See LICENSE for details.

---

Learning and exploring Python internals.

Uttkarsh