feat(M4): hiérarchie d'erreurs, fixture iCal et correction TODO
- pronote_sync/errors.py : PronoteSyncError (base) + PipelineCriticalError - tests/fixtures/pronote-4e.ics : fixture anonymisée (3 VEVENTs : cours normal avec devoirs, cours annulé, événement scolaire) - TODO.md ligne 82 : normalize_uid → normalize_pronote_uid (alignement sur le code existant dans utils/uid.py) Co-authored-by: opencode/coder <coder@agents.invalid> Co-authored-by: opencode/test-engineer <test-engineer@agents.invalid>
This commit is contained in:
2
TODO.md
2
TODO.md
@@ -79,7 +79,7 @@ Récupérer et normaliser l'agenda, les devoirs et les messages Pronote, avec re
|
|||||||
- [ ] Créer `sources/pronote/client.py` : client `pronotepy` (messages, informations, discussions, sondages, et devoirs en repli) avec masquage des erreurs.
|
- [ ] Créer `sources/pronote/client.py` : client `pronotepy` (messages, informations, discussions, sondages, et devoirs en repli) avec masquage des erreurs.
|
||||||
- [ ] Créer `sources/pronote/fallback.py` : sélection de source selon `PRONOTE_*_SOURCE` (auto/ical/pronotepy) et `PronoteFetcher` unifiant `fetch_agenda`/`fetch_homework`/`fetch_messages`.
|
- [ ] Créer `sources/pronote/fallback.py` : sélection de source selon `PRONOTE_*_SOURCE` (auto/ical/pronotepy) et `PronoteFetcher` unifiant `fetch_agenda`/`fetch_homework`/`fetch_messages`.
|
||||||
- [ ] Implémenter le repli : iCal échoue → pronotepy ; pronotepy échoue → iCal ; les deux échouent → `PipelineCriticalError`.
|
- [ ] Implémenter le repli : iCal échoue → pronotepy ; pronotepy échoue → iCal ; les deux échouent → `PipelineCriticalError`.
|
||||||
- [ ] Normaliser les UID via `utils/uid.normalize_uid` pour la stabilité des événements.
|
- [ ] Normaliser les UID via `utils/uid.normalize_pronote_uid` pour la stabilité des événements.
|
||||||
|
|
||||||
### Critères d'acceptation
|
### Critères d'acceptation
|
||||||
- `fetch_ical` parse `tests/fixtures/pronote-4e.ics` en leçons/devoirs/événements corrects (cours annulé détecté).
|
- `fetch_ical` parse `tests/fixtures/pronote-4e.ics` en leçons/devoirs/événements corrects (cours annulé détecté).
|
||||||
|
|||||||
33
pronote_sync/errors.py
Normal file
33
pronote_sync/errors.py
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
"""Hiérarchie d'erreurs transversale du projet pronote-sync."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
|
||||||
|
class PronoteSyncError(Exception):
|
||||||
|
"""Erreur de base pour toutes les exceptions du projet pronote-sync.
|
||||||
|
|
||||||
|
Toutes les exceptions métier héritent de cette classe pour permettre
|
||||||
|
une interception unifiée des erreurs applicatives.
|
||||||
|
"""
|
||||||
|
|
||||||
|
def __init__(self, message: str) -> None:
|
||||||
|
"""Initialise l'erreur avec un message descriptif.
|
||||||
|
|
||||||
|
:param message: Message décrivant la cause de l'erreur.
|
||||||
|
"""
|
||||||
|
super().__init__(message)
|
||||||
|
|
||||||
|
|
||||||
|
class PipelineCriticalError(PronoteSyncError):
|
||||||
|
"""Erreur critique du pipeline, levée quand aucune récupération n'est possible.
|
||||||
|
|
||||||
|
Par exemple : échec simultané des sources iCal et pronotepy,
|
||||||
|
rendant impossible toute synchronisation.
|
||||||
|
"""
|
||||||
|
|
||||||
|
def __init__(self, message: str) -> None:
|
||||||
|
"""Initialise l'erreur critique avec un message descriptif.
|
||||||
|
|
||||||
|
:param message: Message décrivant la cause de l'erreur critique.
|
||||||
|
"""
|
||||||
|
super().__init__(message)
|
||||||
57
tests/fixtures/pronote-4e.ics
vendored
Normal file
57
tests/fixtures/pronote-4e.ics
vendored
Normal file
@@ -0,0 +1,57 @@
|
|||||||
|
BEGIN:VCALENDAR
|
||||||
|
VERSION:2.0
|
||||||
|
PRODID:-//Index Education//Pronote//FR
|
||||||
|
X-WR-CALNAME:Classe de 4e
|
||||||
|
BEGIN:VEVENT
|
||||||
|
UID:Edt_12345@index-education.net-20260905T120000Z-Index-Education
|
||||||
|
DTSTAMP:20260905T120000Z
|
||||||
|
DTSTART:20260905T080000Z
|
||||||
|
DTEND:20260905T090000Z
|
||||||
|
SUMMARY:Mathématiques
|
||||||
|
CATEGORIES:Cours
|
||||||
|
DESCRIPTION:<div>
|
||||||
|
Matière : Mathématiques
|
||||||
|
Professeur : M. Dupont
|
||||||
|
Salle : 204
|
||||||
|
Groupe : Classe entière
|
||||||
|
|
||||||
|
<strong>Contenu pédagogique :
|
||||||
|
</strong>
|
||||||
|
Résoudre des équations du second degré.
|
||||||
|
<strong>Pour le 10/09/2026 :
|
||||||
|
</strong>
|
||||||
|
Exercices 1 à 5 page 42.
|
||||||
|
<strong>Donné le 05/09/2026 :
|
||||||
|
</strong>
|
||||||
|
Exercices 1 à 5 page 42.
|
||||||
|
</div>
|
||||||
|
END:VEVENT
|
||||||
|
BEGIN:VEVENT
|
||||||
|
UID:Edt_67890@index-education.net-20260905T120000Z-Index-Education
|
||||||
|
DTSTAMP:20260905T120000Z
|
||||||
|
DTSTART:20260905T090000Z
|
||||||
|
DTEND:20260905T100000Z
|
||||||
|
SUMMARY:Français
|
||||||
|
CATEGORIES:Cours - Cours annulé
|
||||||
|
STATUS:CANCELLED
|
||||||
|
DESCRIPTION:<div>
|
||||||
|
Matière : Français
|
||||||
|
Professeur : Mme Martin
|
||||||
|
Salle : 205
|
||||||
|
Groupe : Classe entière
|
||||||
|
|
||||||
|
<strong>Contenu pédagogique :
|
||||||
|
</strong>
|
||||||
|
Étude d'un texte littéraire.
|
||||||
|
</div>
|
||||||
|
END:VEVENT
|
||||||
|
BEGIN:VEVENT
|
||||||
|
UID:Edt_11111@index-education.net-20260905T120000Z-Index-Education
|
||||||
|
DTSTAMP:20260905T120000Z
|
||||||
|
DTSTART;VALUE=DATE:20261020
|
||||||
|
DTEND;VALUE=DATE:20261021
|
||||||
|
SUMMARY:Vacances de la Toussaint
|
||||||
|
CATEGORIES:Congés
|
||||||
|
DESCRIPTION:Période de vacances scolaires.
|
||||||
|
END:VEVENT
|
||||||
|
END:VCALENDAR
|
||||||
Reference in New Issue
Block a user