metered 0.9.0

Fast, ergonomic metrics for Rust!
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

//! A module for Time Sources.

/// A trait for any time source providing time measurements in milliseconds.
///
/// It is useful to let users provide an unsynchronized  (`!Send`/`!Sync`) time
/// source, unlike std's `Instant`.
pub trait Instant {
    /// Creates a new Instant representing the current time.
    fn now() -> Self;

    /// Returns the elapsed time since an Instant was created.
    ///
    /// The unit depends on the Instant's resolution, as defined by the
    /// `ONE_SEC` constant.
    fn elapsed_time(&self) -> u64;

    /// One second in the instant units.
    const ONE_SEC: u64;
}

/// A new-type wrapper for std Instants and Metered's
/// [Instant] trait that measures time in milliseconds.
#[derive(Debug, Clone)]
pub struct StdInstant(std::time::Instant);
impl Instant for StdInstant {
    const ONE_SEC: u64 = 1_000;

    fn now() -> Self {
        StdInstant(std::time::Instant::now())
    }

    fn elapsed_time(&self) -> u64 {
        let elapsed = self.0.elapsed();

        elapsed.as_secs() * Self::ONE_SEC + u64::from(elapsed.subsec_millis())
    }
}

/// A new-type wrapper for std Instants and Metered's
/// [Instant] trait that measures time in microseconds.
#[derive(Debug, Clone)]
pub struct StdInstantMicros(std::time::Instant);
impl Instant for StdInstantMicros {
    const ONE_SEC: u64 = 1_000_000;

    fn now() -> Self {
        StdInstantMicros(std::time::Instant::now())
    }

    fn elapsed_time(&self) -> u64 {
        let elapsed = self.0.elapsed();

        elapsed.as_secs() * Self::ONE_SEC + u64::from(elapsed.subsec_micros())
    }
}