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

Architettura

Livelli

Deptrac garantisce tre livelli: contratti (Contract), eccezioni (Exception) e implementazioni; la dipendenza punta solo verso l'interno — le implementazioni conoscono i contratti, i contratti non sanno nulla delle implementazioni.

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

Contratti

• ClockInterface — PSR-20 più i metodi economici timestamp()/microtime(), timezone(), freeze(), withTimezone();
• AdjustableClockInterface — tempo controllato (setTo/modify/advance/rewind) per i test;
• SleepableClockInterface — sleep()/sleepUntil(): sleep reale in SystemClock, virtuale in MockClock.

Principi

• immutabilità delle letture e dei value object;
• gli errori sono eccezioni tipizzate del pacchetto, senza false/warning;
• dipendenze leggere: psr/clock e cloud-castle/inflector.

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