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

Architecture

Layers

Deptrac enforces three layers: contracts (Contract), exceptions (Exception) and implementations; dependencies point inwards only — implementations know contracts, contracts know nothing about implementations.

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

Contracts

• ClockInterface — PSR-20 plus cheap timestamp()/microtime(), timezone(), freeze(), withTimezone();
• AdjustableClockInterface — managed time (setTo/modify/advance/rewind) for tests;
• SleepableClockInterface — sleep()/sleepUntil(): real sleep in SystemClock, virtual in MockClock.

Principles

• immutable readings and value objects;
• errors are typed package exceptions, no false/warnings;
• lightweight dependencies: psr/clock and cloud-castle/inflector.

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