Skip to main content

Module dst

Module dst 

Source
Expand description

Deterministic simulation testing (DST) seam for network async primitives.

Routes time primitives, owned WebSocket tasks, and supported HTTP/WebSocket byte streams through a network-local boundary. With simulation and cfg(madsim), clocks, tasks, and streams use Madsim. Normal builds use Tokio clocks and tasks and the existing crate::net streams.

Instant is routed the same way so that now() reads and sleep/timeout waits share a single clock base. Using tokio::time::Instant on normal builds keeps the seam compatible with #[tokio::test(start_paused = true)] tests that drive time via tokio::time::advance.

nautilus-network sits below nautilus-common in the dependency graph and cannot import from nautilus_common::live::dst, which is why this module lives in the network crate.

Modulesยง

net
Network byte streams selected for deterministic simulation.
task
Owned tasks selected for deterministic simulation.
time
Clock and timeout primitives selected for deterministic simulation.