Antoine Van Elstraete
2e7dfe6e46
Modèles créés : - models/agenda.py : Status, LessonStatus, HomeworkBlock, Lesson (frozen), SchoolEventKind, SchoolEvent (frozen), TheoreticalLesson (frozen) - models/homework.py : Homework (frozen) - models/message.py : MessageType, Message (frozen) - models/blog.py : BlogArticle (frozen), ExternalInfo (mutable) - models/diff.py : AgendaChangeType, AgendaChange (frozen), AgendaDiff (frozen) - models/pronote.py : PronoteData (mutable) - models/sync.py : CalDAVSyncStatus, CalDAVSyncPlan, CalDAVSyncResult (mutable) - models/synthesis.py : SynthesisInput, SynthesisResult (mutable) - models/xmpp.py : XmppMessage (frozen, external_info: ExternalInfo | None) - models/__init__.py : ré-export des 22 modèles via __all__ Conventions appliquées : - Pydantic v2 : model_config = ConfigDict(frozen=True), pas de json_encoders - StrEnum au lieu de (str, Enum) (ruff UP042) - Alias _date/_time pour éviter collision champ date/type date - Sphinx/reST docstrings sur toutes les classes - TODO.md : 11 items M3 cochés Validations (@verifier) : - ruff check : PASS (0 error) - ruff format --check : PASS (10 fichiers) - mypy strict : PASS (10 fichiers) - bandit : PASS (0 issue) - import 22 modèles : OK - sérialisation JSON (frozen + mutable) : OK - frozen immuable, PronoteData/CalDAVSyncResult mutable : OK - StrEnum isinstance str : OK - pytest : 0 test (infrastructure OK) Co-authored-by: OpenCode/orchestrator <opencode-orchestrator@agents.invalid>
43 lines
1.6 KiB
Python
43 lines
1.6 KiB
Python
"""Modèles de données pour le blog du collège (RSS) et les informations externes."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
from pronote_sync.models.message import Message
|
|
|
|
|
|
class BlogArticle(BaseModel):
|
|
"""Représente un article du blog du collège."""
|
|
|
|
model_config = ConfigDict(frozen=True)
|
|
|
|
id: str = Field(..., description="GUID de l'article (clé de déduplication)")
|
|
title: str = Field(..., description="Titre de l'article")
|
|
url: str = Field(..., description="URL canonique de l'article")
|
|
published_at: datetime = Field(..., description="Date de publication (UTC)")
|
|
updated_at: datetime | None = Field(None, description="Date de dernière mise à jour")
|
|
category: str | None = Field(None, description="Catégorie de l'article")
|
|
author: str | None = Field(None, description="Auteur (si disponible)")
|
|
content_html: str = Field(..., description="Contenu HTML complet")
|
|
content_text: str = Field(..., description="Contenu en texte brut (pour XMPP)")
|
|
|
|
|
|
class ExternalInfo(BaseModel):
|
|
"""Agrège les informations externes (blog, messages Pronote) pour le message XMPP."""
|
|
|
|
blog_articles: list[BlogArticle] = Field(
|
|
default_factory=list,
|
|
description="Liste des nouveaux articles du blog",
|
|
)
|
|
pronote_messages: list[Message] = Field(
|
|
default_factory=list,
|
|
description="Liste des messages Pronote",
|
|
)
|
|
other_info: list[str] = Field(
|
|
default_factory=list,
|
|
description="Autres informations (extensible)",
|
|
)
|