Cette section apprend à intervenir sur un outil Python existant sans le casser : le lire, le déboguer, le tester, relire la modification d'un collègue, fixer ses dépendances, puis le livrer. Elle s'adresse à une personne d'exploitation qui doit reprendre du code qu'elle n'a pas écrit, sans viser à devenir développeuse : les premières pages posent les gestes, et la syntaxe de Python s'apprend dans les leçons qui les précèdent. Les neuf pages forment la partie pratique de la formation « Développer pour les Ops ».
Pourquoi commencer par lire du code qu'on n'a pas écrit ?
Section intitulée « Pourquoi commencer par lire du code qu'on n'a pas écrit ? »Le premier réflexe d'un Ops n'est pas d'écrire un programme, c'est de reprendre un script hérité qui tourne déjà en production. La page Lire et modifier un script Python qu'on n'a pas écrit donne la méthode : retrouver le rôle du script, son point d'entrée, ses options et son code de sortie, puis le lancer sans risque et faire une première modification vérifiée.
Quand le script grossit et que d'autres le lancent, il devient un outil. Comprendre puis modifier un projet Python déjà structuré décrit ce passage : l'organisation du projet, le contrat de la commande, les erreurs sur stderr et la configuration par variable d'environnement.
Comment sécuriser une modification avant de l'envoyer ?
Section intitulée « Comment sécuriser une modification avant de l'envoyer ? »Une fois le code lu, il faut pouvoir le changer sans deviner. Deux pages
outillent ce geste. Premiers tests Python avec pytest
apprend à lancer une suite, à lire une ligne E assert et à décider s'il faut
corriger le code ou le test. Déboguer un programme Python pas à pas
propose la méthode complémentaire : reproduire un bogue par un test, observer
avec print ou logging, lire une trace d'appels, puis corriger la cause.
Vient ensuite le regard d'un autre. Relire une pull request laisse le linter et le formateur (ruff) au mécanique, applique une checklist courte, apprend à écrire un commentaire actionnable et à rendre un verdict clair.
Comment faire installer l'outil ailleurs ?
Section intitulée « Comment faire installer l'outil ailleurs ? »Un outil qui marche sur votre poste et pas sur celui d'un collègue n'est pas fini. Dépendances Python : déclarer, épingler, installer ailleurs explique où déclarer les dépendances, pourquoi épingler leurs versions, comment fixer la version de Python et comment prouver que l'installation fonctionne dans un environnement neuf. Le guide plus général Maintenir ses dépendances Python dans le temps couvre leur mise à jour, et cette page se limite au geste de base.
Le dernier maillon est la livraison. Livrer un outil Python traite le numéro de version (SemVer), le CHANGELOG, l'étiquette Git et la vérification de l'installation. C'est une page facultative du parcours : elle sert quand l'outil doit réellement partir chez d'autres utilisateurs.
Que prouve la pipeline, et que prouve l'épreuve ?
Section intitulée « Que prouve la pipeline, et que prouve l'épreuve ? »Tout ce qui précède se vérifie mécaniquement dans une pipeline CI. La page
La CI de certcheck suit un petit
outil, certcheck, à travers six étapes, lit un run rouge, rejoue
l'étape fautive sur votre poste et la corrige. C'est le moment où les gestes
précédents se rejoignent.
L'épreuve finale en tire la preuve : lire un outil et un run de CI rouge, corriger le défaut et tout remettre au vert, sans indice. Elle ne demande rien qui n'ait été enseigné dans les pages ci-dessus, et sa note se calcule sur des critères observables plutôt que sur une impression.
Dans quel ordre suivre ces pages ?
Section intitulée « Dans quel ordre suivre ces pages ? »Dans la formation, l'ordre est celui du plan de cours : on lit d'abord un script, puis on découvre sa structure d'outil et ses dépendances déclarées, avant les tests et le débogage. La relecture d'une pull request, la pipeline et l'épreuve viennent après, et la livraison reste facultative. Ces pages sont réparties entre plusieurs modules : les flèches de pied de page vous guident d'une leçon à l'autre. Un lecteur qui connaît déjà un sujet peut ouvrir directement la page qui l'intéresse, car chacune annonce ses prérequis.