Enregistrer

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.

Illustration : presse et moule produisant des cartes d'événement identiques sur un établi sombre, image des classes en programmation objet

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.

Datetime

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.

Exercices (12)

Exercice 1 — Classe Event avec title, start: datetime, id. Simple

Afficher la solution
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

Afficher la solution
@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

Afficher la solution
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

Afficher la solution
return [e for e in events if d1 <= e.start <= d2]

Exercice 5 — Lève ValueError si title vide à l’ajout. Simple

Afficher la solution
if not title.strip():
    raise ValueError("titre vide")

Exercice 6 — Pourquoi dataclasses réduit le boilerplate ici ? Simple

Afficher la solution
# 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

Afficher la solution
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

Afficher la solution
# 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

Afficher la solution
sorted(events, key=lambda e: e.start)

Exercice 10 — Séparation SRP : une phrase sur le rôle de service vs storage. Difficile

Afficher la solution
storage : persistance brute ; service : règles métier et orchestration.

Exercice 11 — Test unitaire : add_event deux fois produit deux IDs distincts. Intermédiaire

Afficher la solution
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

Afficher la solution
if duration is not None and duration < 0:
    raise ValueError("durée invalide")

Suite

Tests avec pytest

Amazon (partenaire)

À lire aussi

Cette page vous a-t-elle été utile ?

Une question sur cet article ou besoin d'un conseil ? Posez-la ici

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.