🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano

Architecture

Couches

Deptrac impose trois couches : les contrats (Contract), les exceptions (Exception) et les implémentations ; les dépendances ne pointent que vers l’intérieur — les implémentations connaissent les contrats, les contrats ne savent rien des implémentations.

flowchart TD
    subgraph Contract
        CI[ClockInterface]
        ACI[AdjustableClockInterface]
        SCI[SleepableClockInterface]
    end
    subgraph Exception
        EX[InvalidClockValueException]
    end
    subgraph Implementations
        SYS[SystemClock] --> SCI
        FRZ[FrozenClock] --> ACI
        MCK[MockClock] --> ACI
        MCK --> SCI
        MON[MonotonicClock] --> CI
        OFF[OffsetClock] --> CI
        SCL[ScaledClock] --> CI
        TRC[TruncatingClock] --> CI
        STP[StepClock] --> CI
        QUE[QueueClock] --> CI
        CBK[CallbackClock] --> CI
        ADP[PsrClockAdapter] --> CI
    end
    ACI --> CI
    SCI --> CI
    CI --> PSR[Psr\\Clock\\ClockInterface]
    Implementations --> EX
    VAL[TimeSpan / Deadline / Stopwatch / DatePoint] --> CI

Contrats

• ClockInterface — PSR-20 plus les méthodes économiques timestamp()/microtime(), timezone(), freeze(), withTimezone() ;
• AdjustableClockInterface — temps piloté (setTo/modify/advance/rewind) pour les tests ;
• SleepableClockInterface — sleep()/sleepUntil() : sommeil réel dans SystemClock, virtuel dans MockClock.

Principes

• lectures et objets-valeurs immuables ;
• les erreurs sont des exceptions typées du paquet, sans false/avertissements ;
• dépendances légères : psr/clock et cloud-castle/inflector.

🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano