Aller au contenu
Accueil

Les cours

Ce site regroupe des cours courts. Chacun explique une notion générale, puis la montre à l'œuvre dans le code d'un vrai projet.

Le projet fil rouge

Les exemples viennent de BestGameOfTheYear, un jeu de stratégie au tour par tour sur grille hexagonale, écrit en Python avec Pygame. Quand un cours parle du « jeu » ou du « projet », c'est de lui qu'il s'agit.

Ce jeu a sa propre documentation, dans le dossier docs/ de son dépôt : concept, audit du code, architecture actuelle et cible, flows, algorithmes. Les cours y renvoient par la mention « documentation du jeu ».

Le principe

Un cours n'est pas une page de documentation du jeu. C'est une notion qu'on pourra réutiliser dans n'importe quel projet. Le jeu sert d'exemple, parce qu'on retient mieux une règle quand on a vu le problème qu'elle évite.

Chaque cours suit le même plan :

  1. Le problème, tel qu'il apparaît dans le jeu.
  2. La notion, expliquée simplement, une page par idée.
  3. L'application, sur un extrait du code.
  4. À retenir, en quelques lignes.
  5. Exercices, à faire sur le projet.

Un cours tient en quelques pages courtes : une vue d'ensemble qui pose le problème, une page par notion, puis une page « À retenir et exercices ». Chaque thème a aussi sa présentation, un jeu de diapositives pour le découvrir ou le réviser en vingt minutes : elles sont réunies sur la page Les présentations.

Les cours disponibles

Chaque titre de thème mène à sa page d'accueil, avec sa présentation.

Python : bonnes pratiques

CoursCe qu'on y apprendProblème du jeu associé
Nommer les chosesChoisir des noms qui disent ce que fait le codetile_with_prio, coo, page == 5
Fonctions et effets de bordÉcrire des fonctions dont on peut prévoir le résultatFonctions qui modifient des variables partout
Classes et responsabilitésDécouper une classe trop grosseMap, ButtonHandler
Modules et importsOrganiser les fichiers et leurs dépendancesfrom units import *, self.game

Python : données et tests

CoursCe qu'on y apprendProblème du jeu associé
Choisir sa structure de donnéesListe, tuple, dictionnaire, ensembleVoisins introuvables après un chargement
Premiers tests avec pytestVérifier son code automatiquementAucun test dans le projet

Algorithmes

CoursCe qu'on y apprendProblème du jeu associé
La complexitéEstimer le coût d'un code avant de l'optimiserLe jeu ralentit sur les grandes cartes
Parcours de grapheLargeur, Dijkstra, A*Déplacement sur plusieurs cases

Documentation

CoursCe qu'on y apprendProblème du jeu associé
Les schémas MermaidChoisir et écrire le bon type de schémaAvoir une vue d'ensemble
Écrire une documentationDocstrings, README, pages de ce siteOublier comment marche son propre code

Terminal et outils

CoursCe qu'on y apprendProblème du jeu associé
La ligne de commandeSe déplacer, lancer un programme, enchaîner des commandesLe jeu ne se lance que depuis la racine du projet
brew, apt, npmInstaller des outils et figer les versions d'un projetUn README de deux lignes, dont une fausse
GitCommits utiles, branches, revenir en arrièreTrois commits pour tout le projet, du code commenté par prudence
SSHOuvrir un terminal sur une autre machine, avec des clésAdministrer un serveur pour le jeu

Serveur et API

CoursCe qu'on y apprendProblème du jeu associé
Le serveurClient, serveur, adresse IP, port, localhostLe jeu est entièrement local
Les APIRequêtes HTTP, JSON, codes de statut, FastAPIUn classement en ligne

Virtualisation

CoursCe qu'on y apprendProblème du jeu associé
VirtualBoxCréer un serveur Linux jetable sur son posteS'entraîner sans rien louer ni rien casser
DockerImage, conteneur, Dockerfile« Chez moi, ça marche »
Docker ComposePlusieurs conteneurs reliés, données dans un volumeLes scores disparaissent au redémarrage

Web

CoursCe qu'on y apprendProblème du jeu associé
HTMLDécrire le contenu d'une page avec des balises qui ont un sensLe classement n'est lisible que par un programme
CSSSélecteurs, cascade, modèle de boîte, flexbox et gridMettre en forme sans toucher au contenu
ReactComposants, props, état, effetsAfficher les scores de l'API, garder l'écran fidèle aux données

Les cours Serveur et API, Virtualisation et Web partagent un fil rouge : un classement en ligne pour le jeu. On écrit son API, on la met dans un conteneur, on lui ajoute une base de données, puis on lui construit une page web en HTML, CSS et React.

Un parcours conseillé

Les cours sont indépendants, mais cet ordre suit les prochaines étapes du projet, listées dans la documentation du jeu.

Du terminal au conteneur et au web

Ces cours se suivent : chacun réutilise le précédent.

Les thèmes à venir

La section est faite pour grandir. Des thèmes sont prévus et seront ajoutés au fil du cours :

ThèmeExemples de sujets
Python avancédataclass, Enum, annotations de type
Mise en ligneLouer un serveur, nom de domaine, HTTPS
JavaScriptLes bases du langage, avant React
Bases de donnéesTables, requêtes SQL, SQLite

Pour ajouter un cours ou un thème, voir Ajouter un cours.