Apprendre Python — méthode complète

Un parcours structuré, progressif et exigeant pour apprendre Python sérieusement : des bases absolues jusqu'à l'autonomie (projets complets, tests, APIs, bonnes pratiques).

Ce repo n'est pas un cours à lire passivement. C'est une méthode de travail : des leçons, des exercices corrigés, des mini-projets, une routine, un journal, une discipline Git, et un site permanent qui publie le tout.

Pourquoi Python

Langage lisible, adapté à l'apprentissage et utilisé en production partout (automatisation, données, web, scripts, IA, finance).
Écosystème immense : tout ce que tu voudras faire plus tard existe déjà en Python.
La syntaxe s'apprend vite ; penser comme un programmeur prend des mois. Cette méthode travaille les deux, dans cet ordre d'importance.

La philosophie

Comprendre avant de copier. Chaque ligne de code que tu écris, tu dois pouvoir l'expliquer à voix haute. Si tu ne peux pas, tu ne l'as pas apprise.
Taper le code soi-même. Jamais de copier-coller pendant l'apprentissage. La mémoire des doigts compte.
Les erreurs sont le programme. Un traceback n'est pas un échec, c'est la leçon. Chaque leçon inclut « comment lire les erreurs de cette notion ».
Petit et régulier bat long et rare. 30 minutes par jour > 4 heures le dimanche.
Tout est versionné. Chaque exercice terminé = un commit. Chaque fin de journée = un push. Git fait partie du métier, on l'apprend dès le jour 1.

Structure du repo

/lessons        Les leçons, par niveau (00 → 10). Chaque niveau contient
                ses leçons, ses exercices et ses solutions.
/projects       Les mini-projets progressifs et les projets finaux.
/docs           La méthode : routines, plannings, erreurs fréquentes,
                ressources, guide de déploiement.
/journal        Ton journal d'apprentissage (une entrée par session).
/notes          Tes notes personnelles par notion.
/skills         Les rôles que Claude applique pour maintenir ce projet.
/website        Le générateur du site statique (build.py) publié sur
                Cloudflare Pages.

Fichiers de pilotage à la racine :

Fichier	Rôle
`ROADMAP.md`	La progression complète, niveau par niveau
`PROGRESS.md`	Où tu en es (à cocher au fil de l'eau)
`CLAUDE.md`	Instructions pour Claude : comment maintenir ce projet
`MEMORY.md`	Mémoire du projet : décisions, conventions, historique
`PROJECT_STATE.md`	État exact : dernière session, prochaines étapes
`GIT_WORKFLOW.md`	La discipline Git complète
`PROMPTS.md`	Prompts réutilisables pour travailler avec Claude

Comment démarrer

Lis docs/methode.md (15 min) — c'est la routine de travail.
Ouvre lessons/level-00-environnement/README.md et fais la leçon 00-1.
À la fin de chaque leçon : fais le commit indiqué en bas de la leçon.
À la fin de chaque session : remplis une entrée de journal/ et pousse (git push).
Coche ta progression dans PROGRESS.md.

La progression (résumé)

Niveau	Thème	Durée indicative
0	Environnement : Python, VS Code, terminal, Git	3–5 jours
1	Bases : variables, types, entrées/sorties	1 semaine
2	Conditions, boucles, logique	1 semaine
3	Structures de données : listes, dicts, sets, tuples	1–2 semaines
4	Fonctions : découper un problème	1–2 semaines
5	Fichiers, exceptions, modules	1 semaine
6	Programmation orientée objet	2 semaines
7	Projets pratiques	2 semaines
8	Tests, bonnes pratiques, architecture	1–2 semaines
9	Automatisation, APIs, web, données	2 semaines
10	Autonomie : projet complet de bout en bout	2–4 semaines

Détail complet dans ROADMAP.md. Plannings réalistes (4, 8, 12 semaines, ou rythme lent) dans docs/plannings.md.

Le site

Le contenu est publié sur Cloudflare Pages : https://learnpython-5xq.pages.dev

Chaque page embarque le Tuteur Python (bouton « Poser une question », en bas à droite) : il répond en suivant la pédagogie de la méthode — indices d'abord, solution complète seulement sur demande. Il tourne sur Workers AI (Llama), pas sur Claude : bon pour débloquer, moins fiable qu'une vraie session — en cas de doute, vérifie dans la leçon ou demande à Claude.

Build local : website/README.md. Déploiement : docs/deploiement-cloudflare.md (redéploiement : python website/build.py puis NODE_OPTIONS=--use-system-ca npx wrangler pages deploy).

Honnêteté

Cette méthode ne promet pas « Python en 7 jours ». Certaines notions sont réellement difficiles (scope, mutabilité, POO, exceptions) : les leçons le disent et prévoient plus de temps et plus d'exercices à ces endroits-là. Si tu bloques, c'est normal — c'est prévu dans la méthode (voir docs/methode.md, section « transformer une erreur en apprentissage »).