cu29-clock 1.1.0

Copper Robot Clock implementation. It is a monotonic high precision clock for real time applications. It has a mock feature for testing time dependent behaviors. It is part of the Copper project but can be used independently.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

use std::sync::OnceLock;

// Source: `web_time::Instant` elapsed from a process-local start instant.
// Guarantee: monotonic elapsed time within the current WASM instance. Values are
// already nanoseconds, so calibration should converge to a 1:1 rate.
static START: OnceLock<web_time::Instant> = OnceLock::new();

#[inline(always)]
fn start_instant() -> web_time::Instant {
    *START.get_or_init(web_time::Instant::now)
}

pub fn initialize() {
    let _ = start_instant();
}

#[inline(always)]
pub fn read_raw_counter() -> u64 {
    let elapsed = web_time::Instant::now().duration_since(start_instant());
    u64::try_from(elapsed.as_nanos()).unwrap_or(u64::MAX)
}