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

Arquitectura

Capas

Deptrac impone tres capas: contratos (Contract), excepciones (Exception) e implementaciones; las dependencias apuntan solo hacia adentro — las implementaciones conocen los contratos, los contratos no saben nada de las implementaciones.

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

Contratos

• ClockInterface — PSR-20 más timestamp()/microtime() económicos, timezone(), freeze(), withTimezone();
• AdjustableClockInterface — tiempo controlado (setTo/modify/advance/rewind) para pruebas;
• SleepableClockInterface — sleep()/sleepUntil(): sueño real en SystemClock, virtual en MockClock.

Principios

• lecturas y objetos de valor inmutables;
• los errores son excepciones tipadas del paquete, sin false/advertencias;
• dependencias ligeras: psr/clock y cloud-castle/inflector.

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