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

Architektur

Schichten

Deptrac erzwingt drei Schichten: Verträge (Contract), Ausnahmen (Exception) und Implementierungen; die Abhängigkeit zeigt nur nach innen — Implementierungen kennen die Verträge, die Verträge wissen nichts über die Implementierungen.

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

Verträge

• ClockInterface — PSR-20 plus günstige timestamp()/microtime(), timezone(), freeze(), withTimezone();
• AdjustableClockInterface — gesteuerte Zeit (setTo/modify/advance/rewind) für Tests;
• SleepableClockInterface — sleep()/sleepUntil(): echter Schlaf bei SystemClock, virtueller bei MockClock.

Prinzipien

• unveränderliche Messwerte und Value Objects;
• Fehler sind typisierte Paket-Ausnahmen, kein false/keine Warnungen;
• leichtgewichtige Abhängigkeiten: psr/clock und cloud-castle/inflector.

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