speed-cli 1.0.0

Comprehensive multi-protocol network performance testing CLI (TCP, UDP, QUIC, HTTP/1.1, HTTP/2, h2c, HTTP/3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

//! Warmup-aware sampling primitives shared by every protocol client.

use std::time::{Duration, Instant};

/// Effective measurement duration in microseconds: total elapsed minus the
/// warmup window, clamped so we never report a zero or negative duration that
/// would blow up throughput calculations.
///
/// NOTE: the 1ms floor masks the `warmup >= elapsed` case; CLI-level
/// validation (and a principled minimum window) is layered on top so this
/// clamp is only ever a last-resort guard.
pub fn measurement_duration_us(start: Instant, end: Instant, warmup: Duration) -> u64 {
    end.duration_since(start)
        .saturating_sub(warmup)
        .max(Duration::from_millis(1))
        .as_micros() as u64
}

/// Offset of `now` from the test start in microseconds — the sample's
/// position on the test's monotonic time axis (where 0 is the test start).
#[inline]
pub fn offset_us(start: Instant, now: Instant) -> u64 {
    now.duration_since(start).as_micros() as u64
}