Projet Agenda CLI (3/6) — modèle métier et classes
Classe Event, validation des dates avec datetime, service AgendaService ; séparation storage ; 12 exercices.
Débuter
Home Assistant
ESP32
Acheter
Outils
⚡ Configurateur Domotique🔧 Codes erreursPièces détachées & SAVQuel robot éducatif choisir ?Configurateur kit classeCalculateur budget classeCompatibilité Makeblock mBotRéglages capteurs mBot2Dépannage mBlock & codes mBotClasse Event, validation des dates avec datetime, service AgendaService ; séparation storage ; 12 exercices.


Illustration générée par IA
Le model décrit la forme des événements et les conversions dict ↔ objet ; le service applique les règles : ajouter un événement avec nouvel id, filtrer par dates, supprimer. Garder storage ignorant des classes métier (il ne manipule que dict JSON) ou fournir des méthodes Event.to_dict() / Event.from_dict() — les deux approches sont valides si tu restes cohérent.
Parse les chaînes ISO avec datetime.fromisoformat (Python 3.7+) pour comparer des instants. Normalise en timezone si tu en ajoutes plus tard ; en v1, reste en naïf UTC local mais documente le choix.
Exercice 1 — Classe Event avec title, start: datetime, id. Simple
from dataclasses import dataclass from datetime import datetime
@dataclass class Event: id: str title: str start: datetime duration_minutes: int | None note: str
Exercice 2 — Méthode Event.from_dict(d: dict) -> Event avec validation minimale. Intermédiaire
@staticmethod
def from_dict(d):
return Event(
id=str(d["id"]),
title=d["title"],
start=datetime.fromisoformat(d["start"]),
duration_minutes=d.get("duration_minutes"),
note=d.get("note", ""),
)
Exercice 3 — AgendaService.add_event génère un uuid4 pour id. Simple
import uuid
e.id = str(uuid.uuid4())
Exercice 4 — Filtre les événements start dans [d1, d2] avec comparaison d1 <= e.start <= d2. Intermédiaire
return [e for e in events if d1 <= e.start <= d2]
Exercice 5 — Lève ValueError si title vide à l’ajout. Simple
if not title.strip():
raise ValueError("titre vide")
Exercice 6 — Pourquoi dataclasses réduit le boilerplate ici ? Simple
# Génère __init__, repr, égalité — utile pour objets données.
Exercice 7 — Méthode to_dict symétrique de from_dict pour la sérialisation. Intermédiaire
def to_dict(self):
return {
"id": self.id,
"title": self.title,
"start": self.start.isoformat(timespec="seconds"),
"duration_minutes": self.duration_minutes,
"note": self.note,
}
Exercice 8 — remove_event(id) : si absent, KeyError ou False — choisis et documente. Intermédiaire
# Option API : raise KeyError("id inconnu") — la CLI convertit en message + code 1.
Exercice 9 — Tri des événements affichés par start croissant. Simple
sorted(events, key=lambda e: e.start)
Exercice 10 — Séparation SRP : une phrase sur le rôle de service vs storage. Difficile
storage : persistance brute ; service : règles métier et orchestration.
Exercice 11 — Test unitaire : add_event deux fois produit deux IDs distincts. Intermédiaire
def test_ids_distincts(service):
a = service.add_event(...)
b = service.add_event(...)
assert a.id != b.id
Exercice 12 — Cas limite : duration_minutes négatif — rejet. Difficile
if duration is not None and duration < 0:
raise ValueError("durée invalide")
Cette page vous a-t-elle été utile ?
Merci !
Que devons-nous améliorer ?
Vous hésitez entre deux modèles ou vous avez besoin d'aide sur un montage ? Écrivez-nous, nous vous répondons rapidement par e-mail.
Cookies et mesure d'audience
Nous utilisons Google Analytics 4 pour comprendre comment le site est utilisé (pages vues, navigation). Ces données sont activées uniquement si vous acceptez. Refuser n'empêche pas la consultation du site. En savoir plus :gestion des cookies etpolitique de confidentialité.