Restructuration de l'application

2026-08-22 13:39:20 +02:00
parent dc25b5fefa
commit b9e9d00e7d
44 changed files with 561 additions and 8675 deletions
@@ -11,7 +11,7 @@ les parcours alternatifs.

 * Étapes et Script

-Utiliser `python gui.py` ou `python gui.py Interro` pour lancer un GUI
+Utiliser `python -m copienator gui` ou `python -m copienator gui Interro` pour lancer un GUI
 qui suit automatiquement les étapes décrites ci-dessous.

 ** Prétraitement de l'énoncé
@@ -20,8 +20,8 @@ Dans le dossier de l'évaluation, mettre les fichiers suivants de l'évaluation

 `enonce.pdf`, `enonce.tex`, `correction.tex`.

- - `python gemini_for_enonce.py Interro` or
-   `python gemini_for_enonce.py Interro --restart`
+ - `python -m copienator statement Interro` or
+   `python -m copienator statement Interro --restart`

   À partir des trois fichiers précédents, se charge de détecter les
   labels des questions et leur contenu.
@@ -52,25 +52,25 @@ Dans le dossier de l'évaluation, mettre les fichiers suivants de l'évaluation

   Éventuellement : vérifier et modifier les barèmes dans `Persp`.

- - Alternative personnelle : `python enonce_info.py Interro`
+ - Alternative personnelle : `python -m copienator statement-personal Interro`

   Ces deux commandes suivent la convention des scripts standardisés.
   Leur import ne lance aucun traitement et les erreurs partielles sont
   distinguées des échecs. Les réponses d'extraction mises en cache par
-   =gemini_for_enonce.py= et le fichier =labels= sont publiés
+   =copienator statement= et le fichier =labels= sont publiés
   atomiquement.

 ** Prétraitement des copies

 Mettre les copies scannées au format pdf dans =Interro=.

- 1. =python copies_tools.py rotate Interro= (facultatif)
+ 1. =python -m copienator copies rotate Interro= (facultatif)

    Retourne tous les pdf de 180°, si la photocopie a été faite à
    l'envers.
- 2. =python copies_tools.py rename Interro=
+ 2. =python -m copienator copies rename Interro=
     change le nom des copies en =Copie{id}.pdf=
- 3. =python page_splitter.py Interro=
+ 3. =python -m copienator page-split Interro=

    Découpe des copies A3 en pages A4, en retirant les pages vides.

@@ -80,21 +80,21 @@ Mettre les copies scannées au format pdf dans =Interro=.
    + de jeter les deux pages
    + de déplacer la délimitation à droite/gauche

-    Fix issues with =python page_splitter.py Interro14/Copies/Copie01.pdf=
+    Fix issues with =python -m copienator page-split Interro14/Copies/Copie01.pdf=

    Le PDF transformé est construit dans un dossier temporaire. La
    copie produite et la sauvegarde dans =Copies Originales= sont
    ensuite installées avec rollback : une erreur conserve les deux
    versions précédentes. Une relance ciblée lit directement la
    sauvegarde originale sans la déplacer au préalable.
- 4. =python cutleft.py Interro=
+ 4. =python -m copienator crop-labels Interro=

    Découpe la partie gauche des copies, là où il devrait y avoir les
    labels des exercices/questions.

-    =python cutleft.py Interro --fullpage= to use the full page always.
+    =python -m copienator crop-labels Interro --fullpage= to use the full page always.

-    Rerun on a single file with =python cutleft.py Interro/Copies/Copie01.pdf=
+    Rerun on a single file with =python -m copienator crop-labels Interro/Copies/Copie01.pdf=

    Les images et le fichier =_schema.json= d'une copie sont remplacés
    ensemble. Fermer l'outil juste après la dernière validation ne peut
@@ -104,7 +104,7 @@ Mettre les copies scannées au format pdf dans =Interro=.

 Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~

- 1. =python gemini_for_labels.py Interro=, avec éventuellement =--overwrite=
+ 1. =python -m copienator labels Interro=, avec éventuellement =--overwrite=

    Fait des requêtes à Gemini pour identifier les labels des
    questions dans images générées à partir des parties gauches des copies.
@@ -116,7 +116,7 @@ Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~
    copies différentes sont traitées en parallèle. Chaque réponse JSON
    validée est écrite atomiquement. Une cible sans image correspondante
    produit le code de sortie 4.
- 2. =python plotting.py Interro=
+ 2. =python -m copienator review-labels Interro=

    Permet de vérifier visuellement les labels trouvés.
    + Sous linux, on peut faire =e= pour ouvrir le fichier .json et
@@ -128,7 +128,7 @@ Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~
      + `|…` n'est pas arrêté verticalement par son type opposé.
      + `…|` est stoppé horizontalement par le `|…` le plus proche.
    Pour modifier une seule copie :
-    =python plotting.py Interro/Copies/Copie01.pdf=
+    =python -m copienator review-labels Interro/Copies/Copie01.pdf=

    Les coordonnées agrégées sont écrites atomiquement dans le JSON de
    la copie. Fermer la fenêtre avant la fin d'une copie ne remplace pas
@@ -137,9 +137,9 @@ Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~
    It also generates les =Copie01.json=, à partir des =Copie01_01.json=
    En cas de soucis, (par exemple les pages ne sont pas dans le bon ordre)
     - Réordonner les pages du fichier pdf
-     - Rerun =python cutleft.py Interro/Copie{id}=
-     - Rerun =python gemini_for_labels.py Interro/Copie{id}=
- 3. =python splitting_int.py Interro=
+     - Rerun =python -m copienator crop-labels Interro/Copie{id}=
+     - Rerun =python -m copienator labels Interro/Copie{id}=
+ 3. =python -m copienator split-answers Interro=

    Découpe les copies suivant les exercices
    Peut-être appelé avec une seule copie.
@@ -148,11 +148,11 @@ Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~
    puis remplacent ensemble le dossier précédent. En cas d'erreur,
    l'ancienne version est conservée. Les réponses devenues obsolètes
    restent archivées dans le sous-dossier =Missing=.
- 4. =python grouping.py Interro=
+ 4. =python -m copienator group-answers Interro=

    Regroupe les mêmes questions de différentes copies en groupes de
    tailles raisonnables.
- 5. Facultatif : =python verify_groups.py Interro=
+ 5. Facultatif : =python -m copienator verify-groups Interro=

    Vérifie que chaque réponse PDF apparaît bien dans les métadonnées
    des groupes. La commande renvoie un code non nul si une réponse est
@@ -163,14 +163,14 @@ Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~
 Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~

 1. Il faut créer des persp, pour indication de comment corriger, et
-    relancer =enonce_info.py=
- 2. =python correction.py Interro --limit 240= OU
-    =python correction.py Interro/Par\ label/Ex\ 2/Group_1.jpg= OU
-    =python correction.py Interro --overwrite=
+    relancer =copienator statement-personal=
+ 2. =python -m copienator correct Interro --limit 240= OU
+    =python -m copienator correct Interro/Par\ label/Ex\ 2/Group_1.jpg= OU
+    =python -m copienator correct Interro --overwrite=

    Fais les requêtes de correction à Gemini.

-    =correction.py= peut être relancé sans supprimer son état. Les
+    =copienator correct= peut être relancé sans supprimer son état. Les
    fichiers =correction.json= et =correction_progress.json= sont mis à
    jour atomiquement. Avec =--overwrite=, leur version précédente reste
    en place jusqu'à la première écriture réussie de la nouvelle
@@ -183,23 +183,23 @@ Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~

    Pour diminuer le coût, il est possible de batch les requêtes, qui
    seront alors traitées sous au plus 24h.
-    + =python correction.py Interro --batch=
-    + OU =python correction.py Interro --batch-from 'Ex 4'=
-    + =python submit_batches.py Interro=
-    + =python batch_status.py=
-    + =python fetch_batched_results.py Interro=
-    + =python correction.py Interro --deal-with-batched=
+    + =python -m copienator correct Interro --batch=
+    + OU =python -m copienator correct Interro --batch-from 'Ex 4'=
+    + =python -m copienator batch-submit Interro=
+    + =python -m copienator batch-status=
+    + =python -m copienator batch-fetch Interro=
+    + =python -m copienator correct Interro --deal-with-batched=

    Les quatre commandes de ce flux suivent la convention des scripts
    standardisés. Les fichiers de requêtes et le résultat JSONL combiné
    sont publiés atomiquement : une interruption ne laisse pas de fichier
-    final partiellement écrit. =submit_batches.py= conserve aussi les
+    final partiellement écrit. =copienator batch-submit= conserve aussi les
    identifiants distants dans =batch_jobs.json= ; la récupération les
    utilise en priorité et garde la recherche par nom pour les anciens
-    batchs. =batch_status.py --download JOB --output
+    batchs. =python -m copienator batch-status --download JOB --output
    resultat.jsonl= permet aussi de télécharger atomiquement le résultat
    d'un job particulier.
- 3. =python post-correction.py Interro=
+ 3. =python -m copienator post-correction Interro=

    - Essaye de corriger des erreurs d'encodage/d'accents dans
      =correction.json=.
@@ -214,29 +214,29 @@ Optional : Set proxy with ~export HTTPS_PROXY="http://10.0.0.1:3128"~
    + `xx` : move to goal.
    + `xs` : remove old, keep goal.

-    Then call `python resolve_manual.py Interro`
- 5. Call `python correction.py Interro --refaire`.
+    Then call `python -m copienator resolve-manual Interro`
+ 5. Call `python -m copienator correct Interro --refaire`.


 ** Génération des copies annotées

- 1. =python annotating.py Interro= (facultatif)
+ 1. =python -m copienator annotate-simple Interro= (facultatif)

    Ajoute les annotations Gemini aux copies, enregistrées dans le dossier =Anot=.
    On peut passer l'argument =--overwrite=.
 OU
- 2. =python annotating_with_checks.py Interro=
+ 2. =python -m copienator annotate-checks Interro=

    Ajoute les annotations Gemini, et des checkboxes à cocher.
    Enregistrées dans le dossier =Bnot=,
    =--overwrite=

    Une seule copie peut être ciblée avec, par exemple,
-    =python annotating_with_checks.py Interro/Copies/Copie01.pdf=.
+    =python -m copienator annotate-checks Interro/Copies/Copie01.pdf=.
    Le mode =--refaire= exige un fichier =refaire.json= et écrit dans
    =BRnot=.
 OU
- 2. =python annotating_by_label.py Interro= dans =BGnot=
+ 2. =python -m copienator annotate-grouped Interro= dans =BGnot=

    Ajoute les annotations Gemini, et des checkboxes, et regroupe les
    réponses par question.
@@ -245,7 +245,7 @@ OU
    _Needs_ : label_groups file (made automatically by this function),
    qui dit quelles questions regrouper.

- 3. =python export.py Interro BGnot= (gestion perso)
+ 3. =python -m copienator export Interro BGnot= (gestion perso)
    Cela déplace les groupes dans le dossier configuré par =EXPORT_DIR=
    (par défaut =Export=).

@@ -263,7 +263,7 @@ tablette graphique.
 _Before_ : vider le dossier configuré par =IMPORT_DIR= (par défaut
 =Import=), puis y copier ou synchroniser les fichiers depuis la tablette.

- 1. =python import.py Interro BGnot=
+ 1. =python -m copienator import Interro BGnot=

    Une fois les corrections manuelles appliquées aux fichiers
    =Concat.pdf=, il faut enregistrer le fichier annoté au même endroit,
@@ -274,7 +274,7 @@ _Before_ : vider le dossier configuré par =IMPORT_DIR= (par défaut
    export. Pour =Anot=, l'image est importée sous le nom
    =Concat_annotated.jpg=.

- 2. =python reading_annotations.py Interro=
+ 2. =python -m copienator read-annotations Interro=

     Lit les =Concat_annotated= dans =Bnot=, regénère les copies avec
     les modifications. Les fichiers générés (=score.json=,
@@ -282,12 +282,12 @@ _Before_ : vider le dossier configuré par =IMPORT_DIR= (par défaut
     ensemble. Les entrées du dossier =Bnot= restent en place et une
     erreur de génération conserve les anciennes sorties.
 OU
- 2. =python reading_grouped_annotations.py Interro=
+ 2. =python -m copienator read-grouped Interro=

    Idem, mais pour =BGnot=. Les tâches parallèles remontent leurs
    erreurs au processus principal au lieu de les ignorer.

- 3. =python giving_names.py Interro BGnot=
+ 3. =python -m copienator giving-names Interro BGnot=

    Crée un dossier =A Rendre= avec des liens symboliques vers
    + La copie à rendre
@@ -297,17 +297,17 @@ OU
 4. Éventuellement, faire des modifications manuelles aux =score.json=.

    Puis
-    - `python reading_annotations.py --update-score Interro`
-    - `python reading_grouped_annotations.py --update-score Interro`
+    - `python -m copienator read-annotations --update-score Interro`
+    - `python -m copienator read-grouped --update-score Interro`
    pour mettre à jour les scores dans les images.
 4. (gestion perso)
    + =gestion_classe ne= pour créer l'interro puis
    + =gestion_classe we= (set barème here)
-    + =python update_ods.py Interro=
-      ou =python update_ods.py Interro --sum= (en l'absence de barème)
+    + =python -m copienator update-ods Interro=
+      ou =python -m copienator update-ods Interro --sum= (en l'absence de barème)
    + =gestion_classe re=
    + =gestion_classe wsent=
-    + =python add_final_score.py Interro21=
+    + =python -m copienator add-final-score Interro21=
      (this makes files in =Server/copies=)
 5. (gestion perso)
    + Deploy =miqmacs-copies-assets=, and
@@ -321,8 +321,8 @@ OU
 groupée into refaire !!

 1. Redécoupage
-    + =python plotting.py InterroTest/Copie01.pdf=
-    + =python splitting_int.py InterroTest/Copie20.pdf=
+    + =python -m copienator review-labels InterroTest/Copie01.pdf=
+    + =python -m copienator split-answers InterroTest/Copie20.pdf=
 2. Créer =refaire.json=, avec un contenu comme
    : [["Copie02", []],
    :  ["Copie01", ["Ex 1 : 1)"]]]
@@ -333,10 +333,10 @@ groupée into refaire !!
    Ou non, si tu veux le faire à la main.
 4. ?? Si je fais refaire, avant d'avoir créer les annotating with
    checks, que se passe-t-il ???
- 5. Appeler =annotating_with_checks.py --refaire --overwrite=
- 6. =python export.py --refaire Interro24=
- 6. =python import.py --refaire Interro24=
- 7. =python reading_grouped_annotations.py --refaire Interro24=
+ 5. Appeler =python -m copienator annotate-checks --refaire --overwrite=
+ 6. =python -m copienator export --refaire Interro24=
+ 6. =python -m copienator import --refaire Interro24=
+ 7. =python -m copienator read-grouped --refaire Interro24=

    Avec =--refaire=, =refaire.json= et le dossier =BRnot= sont des
    prérequis obligatoires ; leur absence produit le code de sortie 3.
@@ -344,11 +344,10 @@ groupée into refaire !!
 ** Exemple de replotting, refaire d'une copie

 1. replot it.
- 2. `python splitting_int.py DS09VA/Copies/Copie25.pdf`
+ 2. `python -m copienator split-answers DS09VA/Copies/Copie25.pdf`
    this will get rid of old/new.
    !! Attention, et si ça dégage un new : bad bad bad.
 3. Make `refaire.json`, avec la copie, et les labels à refaire.
- 4. `python correction.py DS09VA --refaire`
- 5. `python annotating_with_checks.py DS09VA --refaire`
- 6. `python import.py Interro24 --refaire`
-
+ 4. `python -m copienator correct DS09VA --refaire`
+ 5. `python -m copienator annotate-checks DS09VA --refaire`
+ 6. `python -m copienator import Interro24 --refaire`