https://github.com/nanlabs/nan-python-engineering-labs
Self-guided learning system for professional Python engineering — typing, testing, async, FastAPI, performance. NaNLABS Lab Charter v1.
https://github.com/nanlabs/nan-python-engineering-labs
async charter-v1 fastapi learning-labs nanlabs packaging python testing typing
Last synced: 13 days ago
JSON representation
Self-guided learning system for professional Python engineering — typing, testing, async, FastAPI, performance. NaNLABS Lab Charter v1.
- Host: GitHub
- URL: https://github.com/nanlabs/nan-python-engineering-labs
- Owner: nanlabs
- License: mit
- Created: 2026-04-13T14:59:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-22T04:44:26.000Z (about 1 month ago)
- Last Synced: 2026-05-22T09:46:28.168Z (about 1 month ago)
- Topics: async, charter-v1, fastapi, learning-labs, nanlabs, packaging, python, testing, typing
- Language: Python
- Size: 1.54 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Python Engineering Labs
> Modular advanced Python learning system updated to the most modern technologies of 2026
______________________________________________________________________
## Quick Navigation Guide
This README serves two purposes:
1. **Entry hub** (to quickly understand how the training is structured), and
1. **Detail document** (all original technical content, further below).
If this is your first time here, follow this order:
- Learning Roadmap (Hub)
- Program Structure (Hub)
- Module Summary (Hub)
- Quick Start (Hub)
- Full Documentation (Hub)
______________________________________________________________________
## Learning Roadmap (Hub)
```text
PHASE 1: Foundation (4-6 weeks)
01_python_fundamentals → 02_intermediate_python → 03_basic_intermediate_oop
PHASE 2: Technical Core (6-8 weeks)
04_cpython_internals_advanced → 05_modern_concurrency → 06_typing_metaprogramming
PHASE 3: Software Engineering (8-10 weeks)
07_design_patterns → 08_application_architecture → 09_testing_qa → 10_performance_optimization
PHASE 4: Modern Stack 2026 (8-12 weeks)
11_modern_tooling_2026 → 12_fastapi_complete → 13_backend_ecosystem → 14_advanced_python_2026 → 15_basic_data_science → 16_modern_security
```
**Total estimated time:** 7-10 months, adaptable to your own pace.
______________________________________________________________________
## Program Structure (Hub)
```text
nan-python-engineering-labs/
├── 01...16_*/ → curriculum modules
├── scripts/ → automation tools (includes progress tracking)
├── GETTING_STARTED.md → step-by-step setup
├── STATUS.md → global program status
├── pyproject.toml → tooling/dependencies
└── README.md → general map + full detail
```
Suggested flow per topic:
```text
topic README → examples → exercise → tests → reflection
```
______________________________________________________________________
## Module Summary (Hub)
| Module | What you learn |
| --------------------------------------------------------------- | ---------------------------------------------- |
| [01_python_fundamentals](modules/01_python_fundamentals/) | Solid language foundation |
| [02_intermediate_python](modules/02_intermediate_python/) | Flow, files, exceptions, generators |
| [03_basic_intermediate_oop](modules/03_basic_intermediate_oop/) | Applicable object-oriented design |
| [04_cpython_internals_advanced](modules/04_cpython_internals_advanced/) | Internals, GIL/free-threading, subinterpreters |
| [05_modern_concurrency](modules/05_modern_concurrency/) | Threading, multiprocessing, modern asyncio |
| [06_typing_metaprogramming](modules/06_typing_metaprogramming/) | Advanced typing and metaprogramming |
| [07_design_patterns](modules/07_design_patterns/) | Patterns for robust design |
| [08_application_architecture](modules/08_application_architecture/) | Modular and scalable architecture |
| [09_testing_qa](modules/09_testing_qa/) | Professional testing and quality |
| [10_performance_optimization](modules/10_performance_optimization/) | Practical profiling and optimization |
| [11_modern_tooling_2026](modules/11_modern_tooling_2026/) | uv, Ruff, modern type checking |
| [12_fastapi_complete](modules/12_fastapi_complete/) | Modern production-ready APIs |
| [13_backend_ecosystem](modules/13_backend_ecosystem/) | Backend and infrastructure integration |
| [14_advanced_python_2026](modules/14_advanced_python_2026/) | PyO3 and AI-assisted development |
| [15_basic_data_science](modules/15_basic_data_science/) | Python data science fundamentals |
| [16_modern_security](modules/16_modern_security/) | Modern software and supply chain security |
______________________________________________________________________
## Quick Start (Hub)
### 1) Essential documentation
- [GETTING_STARTED.md](GETTING_STARTED.md)
- [STATUS.md](STATUS.md)
- [README.md](README.md)
### 2) Quick setup
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate # Linux/Mac
# .venv\Scripts\activate # Windows
uv pip install -e ".[dev,profiling,ai,pyo3,security,data]"
pre-commit install
uv run scripts/progress.py
```
### 3) First module
```bash
cd 01_python_fundamentals
cat README.md
```
______________________________________________________________________
## Full Documentation (Hub)
- [GETTING_STARTED.md](GETTING_STARTED.md): installation and setup
- [STATUS.md](STATUS.md): progress tracking
- [scripts/progress.py](scripts/progress.py): automatic progress report
- [scripts/run_topic_tests.py](scripts/run_topic_tests.py): sequential pytest runner for exercise-based topic tests
- [pyproject.toml](pyproject.toml): environment and tooling configuration
______________________________________________________________________
## Sibling Labs
This repository is part of the NaNLABS learning lab ecosystem:
- [nan-ai-engineering-labs](https://github.com/nanlabs/nan-ai-engineering-labs) — AI/ML engineering fundamentals and applied techniques
- [nan-data-engineering-labs](https://github.com/nanlabs/nan-data-engineering-labs) — Data engineering pipelines, warehousing, and orchestration
- [nan-ai-native-engineering-labs](https://github.com/nanlabs/nan-ai-native-engineering-labs) — AI-native development with prompt engineering and agents
______________________________________________________________________
## Full Program Details
## Description
**Python Engineering Labs** is a structured self-learning project covering Python from fundamentals to advanced topics, including the latest 2026 innovations: free-threading without GIL (PEP 703), Rust-based tooling (uv, Ruff), PyO3 extensions, AI-assisted development, and modern security architecture.
### Features
- **200+ topics organized in 16 thematic modules** — independent and self-contained
- **No fixed calendar**: learn at your own pace
- **Pre-populated templates** with curated content
- **Progressive exercises** (basic → intermediate → advanced) with tests
- **88 design patterns** fully documented
- **Modern infrastructure**: DevContainers, pre-commit hooks, automatic tracking
- **Rust ecosystem**: uv, Ruff, PyO3
- **Python 3.13+**: free-threading, subinterpreters
## My Learning Progress
| Module | Completed | Total | Progress | Percentage |
|--------|-----------|-------|----------|------------|
| Python Fundamentals | 0 | 12 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Intermediate Python | 0 | 15 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Basic Intermediate Oop | 0 | 12 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Cpython Internals Advanced | 0 | 27 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Modern Concurrency | 0 | 25 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Typing Metaprogramming | 0 | 22 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Design Patterns | 0 | 88 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Application Architecture | 0 | 18 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Testing Qa | 0 | 16 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Performance Optimization | 0 | 14 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Modern Tooling 2026 | 0 | 36 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Fastapi Complete | 0 | 28 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Backend Ecosystem | 0 | 20 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Advanced Python 2026 | 0 | 45 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Basic Data Science | 0 | 10 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
| Modern Security | 0 | 40 | ░░░░░░░░░░░░░░░░░░░░ | 0.0% |
|--------|-----------|-------|----------|------------|
| **TOTAL** | **0** | **428** | ░░░░░░░░░░░░░░░░░░░░ | **0.0%** |
*Last updated: nan-python-engineering-labs*
## Module Structure
### Basic Level (Optional for those who already know Python)
#### [01 - Python Fundamentals](modules/01_python_fundamentals/)
Variables, data types, control structures, built-in data structures, basic functions, comprehensions. Topics marked as `(optional)` for experienced programmers.
**Topics**: 12 | **Estimated time**: 15-20 hours
#### [02 - Intermediate Python](modules/02_intermediate_python/)
Basic decorators, file handling, exceptions, iterators, generators, important standard modules.
**Topics**: 15 | **Estimated time**: 20-25 hours
#### [03 - Basic and Intermediate OOP](modules/03_basic_intermediate_oop/)
Classes, inheritance, polymorphism, special methods, properties, descriptors, composition vs inheritance.
**Topics**: 12 | **Estimated time**: 18-22 hours
______________________________________________________________________
### Intermediate-Advanced Level
#### [04 - CPython Internals Advanced](modules/04_cpython_internals_advanced/)
History of the GIL, **PEP 703 free-threading**, **PEP 684 subinterpreters**, thread-safety without GIL, object model, reference counting, migration strategies.
**Topics**: 27 | **Estimated time**: 40-50 hours
**Highlighted topics**:
- Free-threading Python 3.13+ (`--disable-gil` mode)
- Subinterpreters with per-interpreter GIL
- Thread-safety in modern Python code
- Biased reference counting
- Immortal objects (PEP 683)
#### [05 - Modern Concurrency and Parallelism](modules/05_modern_concurrency/)
Threading with/without GIL, subinterpreters for isolation, multiprocessing with shared memory, advanced asyncio, concurrency patterns, concurrent testing.
**Topics**: 25 | **Estimated time**: 35-50 hours
#### [06 - Typing and Metaprogramming](modules/06_typing_metaprogramming/)
Advanced type hints, Protocols, TypeVar, ParamSpec, metaclasses, descriptors, AST manipulation, import hooks.
**Topics**: 22 | **Estimated time**: 30-40 hours
______________________________________________________________________
### Patterns and Architecture
#### [07 - Design Patterns](modules/07_design_patterns/)
88 design patterns organized in 8 subcategories: GoF basics, Pythonic, advanced GoF, architectural, distributed systems, concurrency, messaging, object management.
**Patterns**: 88 | **Estimated time**: 60-80 hours
#### [08 - Application Architecture](modules/08_application_architecture/)
SOLID, DDD, hexagonal architecture, CQRS, Event-Driven, clean architecture with practical Python examples.
**Topics**: 18 | **Estimated time**: 25-35 hours
#### [09 - Testing and QA](modules/09_testing_qa/)
pytest advanced, fixtures, mocking, hypothesis (property-based testing), mutation testing, performance testing.
**Topics**: 16 | **Estimated time**: 20-30 hours
#### [10 - Performance and Optimization](modules/10_performance_optimization/)
Profiling (py-spy, memray, viztracer), algorithmic optimization, Cython, NumPy vectorization, strategic caching.
**Topics**: 14 | **Estimated time**: 20-28 hours
______________________________________________________________________
### Modern Stack 2026
#### [11 - Modern Tooling 2026](modules/11_modern_tooling_2026/)
uv (Rust-based package manager), Ruff (linter/formatter), BasedPyright/Pylyzer, pre-commit automation, advanced pytest configuration.
**Topics**: 35 | **Estimated time**: 25-35 hours
#### [12 - FastAPI Complete](modules/12_fastapi_complete/)
Complete FastAPI framework, JWT authentication, WebSockets, background tasks, deployment on Railway/Fly.io.
**Topics**: 28 | **Estimated time**: 40-56 hours
#### [13 - Backend Ecosystem](modules/13_backend_ecosystem/)
SQLAlchemy 2.0, Redis, RabbitMQ, Kafka, gRPC, distributed observability, service mesh.
**Topics**: 20 | **Estimated time**: 28-40 hours
#### [14 - Advanced Python 2026](modules/14_advanced_python_2026/)
PyO3 (Rust extensions) — 22 topics. AI-Assisted Development — 23 topics. LangChain, LangGraph, autonomous agents.
**Topics**: 45 | **Estimated time**: 45-60 hours
#### [15 - Basic Data Science](modules/15_basic_data_science/)
NumPy, Pandas, Matplotlib, Polars, practical statistics for data engineering.
**Topics**: 10 | **Estimated time**: 15-20 hours
#### [16 - Modern Security](modules/16_modern_security/)
Supply chain security, SBOM, Sigstore (keyless signing), SOPS/Vault (secrets management), runtime hardening.
**Topics**: 40 | **Estimated time**: 30-45 hours
______________________________________________________________________
## License
This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.