Python Learning Orchestrated

Architecture-first beginner Python learning app.

Prerequisites

• Python 3.12+
• uv

Setup

uv sync --group dev
uv run pre-commit install

Run

uv run python-learning

Run the practice session orchestrator:

uv run python-learning session

Run progress export/import commands for practice session data:

uv run python-learning export-progress --session-file .session.json --out .snapshot.json
uv run python-learning import-progress --session-file .session.json --in .snapshot.json

Test

uv run pytest

Lint

uv run ruff check .
uv run ruff format --check .

Typecheck

uv run mypy

Roadmap (stub)

• Phase 1: scaffold, quality gates, hello module, smoke tests.
• Phase 2: learning paths domain model.
• Phase 3: persistence and progress tracking.
• Phase 4: richer CLI/UX and packaging.