Script d'inventaire, journal et restauration

LABO-U6-S1-07

Contexte — Marc Oliveira, le trésorier de MaisonDesJeux, veut deux choses. Savoir chaque semaine ce que contient le dossier partagé de l'association. Et ne plus jamais perdre le fichier des adhérents.

Bruno Sanchez, bénévole, a écrit un début de script d'inventaire. Il marche, mais seulement sur un dossier écrit dans le code, et il ne dit jamais s'il a échoué. Vous le rendez prêt à tourner seul, vous le planifiez, puis vous prouvez qu'on sait restaurer la base.

À la fin de ce labo, vous saurez régler un script par ses arguments. Il écrira un journal et rendra un code de retour. Vous saurez aussi le planifier et prouver une restauration.

Comment ça se valide — à chaque point de contrôle, vous montrez votre résultat au formateur. Il valide, puis vous passez à la suite.

Les mots de la séance

Ce dont vous avez besoin

• Votre poste Windows, avec Python, VS Code et PowerShell.
• Annexe A1 : le dossier de travail et son mode d'emploi. Il se télécharge depuis l'annexe A1, dans le fichier A1_mdj_scripts.zip.
• Annexe A2 : un extrait de la documentation de Python.
• Annexe A3 : les règles d'exploitation des scripts de MaisonDesJeux.
• Annexe A4 : un extrait de la documentation du Planificateur de tâches.

En binôme — le pilote tape, le lecteur lit les consignes et les annexes à voix haute, et vérifie chaque résultat. On inverse à la partie C.

Le plan du labo

PARTIE A — Un script réglé par ses arguments

Étapes 1 à 6, environ 30 min. À la fin, le script fait l'inventaire du dossier que vous lui donnez sur la ligne de commande.

Besoin d'un rappel ? Revoir le cours : « Un script qu'on règle sans toucher au code ».

• Téléchargez A1_mdj_scripts.zip depuis l'annexe A1.
• Faites un clic droit sur le fichier, puis « Extraire tout ». Avec « Parcourir », choisissez votre dossier « Documents ».

Vous devez voir : un dossier mdj-scripts dans « Documents ». Il contient adherents.db, inventaire.py, restaurer.py, verifier_base.py et le dossier partage.

• Ouvrez VS Code. Menu « Fichier », puis « Ouvrir le dossier ». Choisissez Documents\mdj-scripts.
• Ouvrez un terminal : menu « Terminal », puis « Nouveau terminal ». Tapez :

ls

Vous devez voir : cinq éléments, dont inventaire.py et partage. Le terminal est déjà dans le dossier mdj-scripts : c'est votre dossier courant.

• Ouvrez inventaire.py et lisez-le. Son code est aussi dans l'annexe A1.
• Dans le terminal, tapez :

python inventaire.py

Vous devez voir : deux lignes. L'heure dans le nom du rapport sera la vôtre.

20 fichiers, 51600 octets
Rapport : rapports\inventaire_2026-10-07_140512.csv

Vous allez remplacer le dossier écrit dans le code par un argument. Le module qui lit les arguments s'appelle argparse.

• Ouvrez l'annexe A2, partie « Lire les arguments : argparse ».
• Trouvez le réglage qui rend un argument obligatoire. Notez-le ici :
• Trouvez le réglage qui donne une valeur quand l'argument est absent. Notez-le ici :

Vous devez avoir : deux mots écrits entre les parenthèses de add_argument. Vous les utilisez à l'étape suivante.

• Tout en haut de inventaire.py, ajoutez la ligne import argparse, au-dessus de import csv.
• Remplacez les deux lignes dossier = Path("partage") et sortie = Path("rapports") par ce bloc :

parser = argparse.ArgumentParser(description="Inventaire d'un dossier.")
parser.add_argument("--dossier", required=True, help="le dossier à inventorier")
parser.add_argument("--sortie", default="rapports", help="le dossier des rapports")
args = parser.parse_args()

dossier = Path(args.dossier)
sortie = Path(args.sortie)

• Enregistrez avec Ctrl+S.

Vous devez voir : aucun point rouge sur l'onglet de inventaire.py dans VS Code. Le fichier est enregistré.

• Tapez, une commande après l'autre :

python inventaire.py --dossier partage
python inventaire.py --dossier partage\animations
python inventaire.py --help

Vous devez voir : 20 fichiers et 51600 octets pour la première commande. 9 fichiers et 24300 octets pour la deuxième. Pour la troisième, le mode d'emploi :

usage: inventaire.py [-h] --dossier DOSSIER [--sortie SORTIE]

Inventaire d'un dossier.

options:
  -h, --help         show this help message and exit
  --dossier DOSSIER  le dossier à inventorier
  --sortie SORTIE    le dossier des rapports

PARTIE B — Un journal et des codes de retour

Étapes 7 à 12, environ 30 min. À la fin, le script rend un code qui dit s'il a réussi, et il note chaque lancement dans son journal.

Besoin d'un rappel ? Revoir le cours : « Dire si ça a marché : code de retour et journal ».

Après chaque commande, PowerShell range le code de retour dans la variable $LASTEXITCODE.

• Tapez ces deux lignes :

python inventaire.py --dossier partage
$LASTEXITCODE

Vous devez voir : l'inventaire, puis 0.

• Lancez le script sans argument, puis lisez le code :

python inventaire.py
$LASTEXITCODE

Vous devez voir :

usage: inventaire.py [-h] --dossier DOSSIER [--sortie SORTIE]
inventaire.py: error: the following arguments are required: --dossier
2

• Lancez l'inventaire d'un dossier qui n'existe pas. Attention au « s » en trop :

python inventaire.py --dossier partages
$LASTEXITCODE

Vous devez voir : 0 fichiers, 0 octets, un rapport vide, puis 0.

Le dossier n'existe pas, et pourtant le script dit « réussi ». Un Planificateur ne verrait aucun problème.

• Ouvrez l'annexe A3, partie « Les codes de retour ».
• Notez le code prévu quand le dossier à traiter est introuvable :

Vous devez voir : un tableau de six codes, de 0 à 5, avec pour chacun son sens et qui le rend.

• Tout en haut du fichier, ajoutez import sys.
• Juste sous la ligne sortie = Path(args.sortie), ajoutez ce bloc :

if not dossier.is_dir():
    print("Erreur : dossier introuvable :", dossier)
    sys.exit(3)

• Tout à la fin du fichier, ajoutez une dernière ligne, sans retrait : sys.exit(0).
• Enregistrez, puis relancez :

python inventaire.py --dossier partages
$LASTEXITCODE

Vous devez voir : Erreur : dossier introuvable : partages, puis 3. Aucun rapport n'est créé.

• Tout en haut du fichier, ajoutez import logging.
• Juste sous la ligne args = parser.parse_args(), ajoutez ce bloc :

logging.basicConfig(filename="inventaire.log", level=logging.INFO,
                    format="%(asctime)s %(levelname)s %(message)s", encoding="utf-8")
logging.info("Début de l'inventaire de %s", args.dossier)

• Dans le bloc if not dossier.is_dir():, ajoutez cette ligne juste avant le print :

    logging.error("Dossier introuvable : %s", dossier)

• Juste avant la ligne print(len(fichiers), ..., ajoutez :

logging.info("Inventaire terminé : %d fichiers, %d octets", len(fichiers), total)

• Enregistrez.

Vous devez voir : le code complet de cette étape est dans l'annexe A1, partie « Le script à la fin de l'étape 11 ». Comparez le vôtre avec lui, ligne par ligne.

• Lancez ces trois commandes. Après chacune, tapez $LASTEXITCODE et notez le code :

python inventaire.py --dossier partage
python inventaire.py
python inventaire.py --dossier partages

• Affichez le journal. L'option -Encoding UTF8 garde les accents :

Get-Content inventaire.log -Encoding UTF8

• Remplissez la grille. La première ligne est faite pour vous montrer.

Vous devez voir : trois codes différents dans votre grille, et une seule ligne ERROR dans le journal.

PARTIE C — Planifier le script

Étapes 13 à 18, environ 30 min. À la fin, Windows lance l'inventaire tout seul, et vous lisez le résultat de chaque exécution.

Besoin d'un rappel ? Revoir le cours : « Lancer le script à heure fixe ».

• Ouvrez l'annexe A4, partie « Lire le résultat d'une tâche ».
• Notez la commande qui affiche le résultat de la dernière exécution :
• Notez le nom de la colonne qui contient le code de retour :

Vous devez avoir : une commande qui commence par Get-, et un nom de colonne en anglais.

L'action dit quoi lancer : le programme, ses arguments, et le dossier de départ.

• Dans le terminal de VS Code, toujours dans mdj-scripts, tapez ces trois lignes :

$dossier = (Get-Location).Path
$python = (Get-Command python).Source
$action = New-ScheduledTaskAction -Execute $python -Argument "inventaire.py --dossier partage" -WorkingDirectory $dossier

• Vérifiez les deux chemins en tapant $dossier, puis $python.

Vous devez voir : le chemin de votre dossier mdj-scripts, puis un chemin qui finit par python.exe.

Ces variables vivent dans ce terminal. Si vous le fermez, retapez les trois lignes.

Le déclencheur dit quand lancer. Ici, dans une minute, puis toutes les deux minutes pendant deux heures.

• Tapez ces deux lignes :

$declencheur = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(1) -RepetitionInterval (New-TimeSpan -Minutes 2) -RepetitionDuration (New-TimeSpan -Hours 2)
Register-ScheduledTask -TaskName "MDJ-inventaire" -Action $action -Trigger $declencheur

Vous devez voir : un petit tableau avec MDJ-inventaire dans la colonne TaskName et Ready dans la colonne State.

• Lancez la tâche tout de suite, sans attendre le déclencheur :

Start-ScheduledTask -TaskName "MDJ-inventaire"

• Attendez dix secondes. Puis tapez :

Get-ScheduledTaskInfo -TaskName "MDJ-inventaire" | Select-Object LastRunTime, LastTaskResult, NextRunTime

Vous devez voir : l'heure de l'exécution dans LastRunTime, et 0 dans LastTaskResult.

• Affichez les dernières lignes du journal :

Get-Content inventaire.log -Encoding UTF8 -Tail 2

Vous devez voir : deux lignes INFO, à l'heure de LastRunTime.

• Notez l'heure de NextRunTime :
• Quand cette heure est passée, retapez la commande Get-ScheduledTaskInfo de l'étape 16.

Vous devez voir : LastRunTime a changé et vaut l'heure notée. LastTaskResult vaut 0. Personne n'a lancé le script : c'est Windows.

• Comptez les rapports produits :

(Get-ChildItem rapports).Count

Vous devez voir : un rapport de plus qu'à l'étape 16.

• Changez l'action : la tâche va chercher un dossier qui n'existe pas.

$action2 = New-ScheduledTaskAction -Execute $python -Argument "inventaire.py --dossier partages" -WorkingDirectory $dossier
Set-ScheduledTask -TaskName "MDJ-inventaire" -Action $action2
Start-ScheduledTask -TaskName "MDJ-inventaire"

• Attendez dix secondes, puis relisez le résultat avec la commande de l'étape 16.

Vous devez voir : 3 dans LastTaskResult. Le journal se termine par ERROR Dossier introuvable : partages.

• Supprimez la tâche :

Unregister-ScheduledTask -TaskName "MDJ-inventaire" -Confirm:$false

Vous devez voir : aucun message. La commande Get-ScheduledTask -TaskName "MDJ-inventaire" affiche maintenant une erreur : la tâche n'existe plus.

PARTIE D — Sauvegarder et restaurer la base

Étapes 19 à 24, environ 30 min. À la fin, vous avez prouvé qu'une sauvegarde de la base des adhérents se restaure à l'identique.

Besoin d'un rappel ? Revoir le cours : « Sauvegarder, et prouver qu'on sait restaurer ».

L'outil verifier_base.py compte les lignes de chaque table et calcule leur empreinte. Son mode d'emploi est dans l'annexe A1.

• Tapez :

python verifier_base.py adherents.db

Vous devez voir : Intégrité : ok, puis une ligne par table : adherent, jeu, emprunt.

• Recopiez les nombres de lignes et les empreintes dans la colonne « Avant » de la grille de l'étape 24.

• Dans VS Code, créez un fichier sauvegarde.py dans mdj-scripts. Écrivez :

"""Sauvegarde de la base des adhérents dans un fichier .sql daté."""
import sqlite3
from datetime import date

con = sqlite3.connect("adherents.db")
nom = "sauvegarde_" + date.today().isoformat() + ".sql"
with open(nom, "w", encoding="utf-8") as f:
    for ligne in con.iterdump():
        f.write(ligne + "\n")
con.close()
print("Sauvegarde écrite :", nom)

• Enregistrez, puis lancez python sauvegarde.py.

Vous devez voir : Sauvegarde écrite : sauvegarde_ suivi de la date du jour et de .sql.

• Affichez les trois premières lignes du fichier :

Get-Content sauvegarde_*.sql -Encoding UTF8 -TotalCount 3

Vous devez voir : BEGIN TRANSACTION;, puis CREATE TABLE adherent (. La sauvegarde est une suite de commandes SQL qui reconstruisent la base.

• Créez un dossier de sauvegardes, à côté de mdj-scripts, puis déplacez-y la copie :

New-Item -ItemType Directory ..\sauvegardes-mdj
Move-Item sauvegarde_*.sql ..\sauvegardes-mdj

Vous devez voir : ls ..\sauvegardes-mdj affiche votre fichier sauvegarde_….sql.

• Supprimez la base :

Remove-Item adherents.db

• Vérifiez qu'elle a disparu :

python verifier_base.py adherents.db
$LASTEXITCODE

Vous devez voir : Base introuvable : adherents.db, puis 3.

L'outil restaurer.py reconstruit une base à partir d'une sauvegarde. Il refuse de remplacer une base qui existe.

• Mettez le chemin de la copie dans une variable, puis restaurez :

$copie = Get-ChildItem ..\sauvegardes-mdj\sauvegarde_*.sql | Select-Object -First 1
python restaurer.py $copie.FullName adherents.db

Vous devez voir : Base restaurée : adherents.db.

• Relancez python verifier_base.py adherents.db.
• Remplissez la colonne « Après ». Comparez chaque ligne avec « Avant ».

Vous devez voir : les trois lignes identiques. Si une seule diffère, la restauration n'est pas prouvée.

POUR ALLER PLUS LOIN

15 min, si vous avez fini avant la fin de la séance.

1. Le code 5 : droits insuffisants. L'annexe A3 prévoit le code 5 quand le script ne peut pas écrire.

• Dans inventaire.py, entourez la création du dossier et l'écriture du rapport avec try: et except PermissionError:. Dans le except, écrivez une ligne ERROR dans le journal, puis sys.exit(5).
• Interdisez-vous l'écriture dans rapports, puis lancez l'inventaire :

icacls rapports /deny "${env:USERNAME}:(W)"
python inventaire.py --dossier partage
$LASTEXITCODE

Vous devez voir : 5, et une ligne ERROR dans le journal.

• Rendez-vous le droit d'écrire :

icacls rapports /remove:d "$env:USERNAME"

2. Le piège de la base absente. Créez un dossier vide essai, copiez-y sauvegarde.py, et lancez-le depuis ce dossier.

• Regardez ce que contient essai après le lancement, puis lancez python ..\verifier_base.py adherents.db dans essai.
• Notez ce que vous constatez :

CE QU'IL FAUT RETENIR

1. Un script se règle par ses arguments. Il se termine par sys.exit avec un code : 0 si tout va bien, le code prévu par l'équipe sinon.
2. Une tâche planifiée se vérifie sur une vraie exécution : LastTaskResult et la ligne du journal à la même heure.
3. Une restauration se prouve en comparant les lignes et les empreintes, avant et après, dans une base reconstruite.