laurus 0.6.0

Unified search library for lexical, vector, and semantic retrieval
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Cross-platform time utilities.
//!
//! Provides [`now_secs`] and [`now_millis`] which return the current time
//! since the Unix epoch, working on both native and `wasm32-unknown-unknown`
//! targets.
//!
//! On native targets, this uses [`std::time::SystemTime`]. On WASM, it
//! falls back to a constant value of `0` since `SystemTime::now()` is
//! not available in `wasm32-unknown-unknown`.

/// Return the current time as seconds since the Unix epoch.
///
/// On `wasm32-unknown-unknown`, returns `0` because `SystemTime::now()`
/// is not available. This is acceptable because timestamps in WASM are
/// used only for metadata (not for correctness).
///
/// # Returns
///
/// Seconds since 1970-01-01T00:00:00Z.
pub fn now_secs() -> u64 {
    #[cfg(not(target_arch = "wasm32"))]
    {
        std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .unwrap_or_default()
            .as_secs()
    }
    #[cfg(target_arch = "wasm32")]
    {
        0
    }
}

/// Return the current time as milliseconds since the Unix epoch.
///
/// On `wasm32-unknown-unknown`, returns `0` because `SystemTime::now()`
/// is not available. This is acceptable because timestamps in WASM are
/// used only for metadata (not for correctness).
///
/// # Returns
///
/// Milliseconds since 1970-01-01T00:00:00Z.
pub fn now_millis() -> u64 {
    #[cfg(not(target_arch = "wasm32"))]
    {
        std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .unwrap_or_default()
            .as_millis() as u64
    }
    #[cfg(target_arch = "wasm32")]
    {
        0
    }
}

/// A cross-platform monotonic timer for measuring elapsed durations.
///
/// On native targets, wraps [`std::time::Instant`]. On WASM, elapsed
/// time is always reported as zero since `Instant::now()` is not
/// available in `wasm32-unknown-unknown`.
///
/// # Example
///
/// ```
/// use laurus::util::time::Timer;
///
/// let timer = Timer::now();
/// // ... do work ...
/// let elapsed = timer.elapsed_ms();
/// ```
#[derive(Debug, Clone, Copy)]
pub struct Timer {
    #[cfg(not(target_arch = "wasm32"))]
    start: std::time::Instant,
}

impl Timer {
    /// Start a new timer.
    pub fn now() -> Self {
        Self {
            #[cfg(not(target_arch = "wasm32"))]
            start: std::time::Instant::now(),
        }
    }

    /// Return elapsed time in milliseconds since this timer was created.
    ///
    /// Returns `0` on WASM targets.
    pub fn elapsed_ms(&self) -> u64 {
        #[cfg(not(target_arch = "wasm32"))]
        {
            self.start.elapsed().as_millis() as u64
        }
        #[cfg(target_arch = "wasm32")]
        {
            0
        }
    }

    /// Return elapsed time as a [`std::time::Duration`].
    ///
    /// Returns `Duration::ZERO` on WASM targets.
    pub fn elapsed(&self) -> std::time::Duration {
        #[cfg(not(target_arch = "wasm32"))]
        {
            self.start.elapsed()
        }
        #[cfg(target_arch = "wasm32")]
        {
            std::time::Duration::ZERO
        }
    }
}