1use std::collections::BTreeMap;
14use std::sync::{Mutex, OnceLock};
15use std::time::Instant;
16
17pub(crate) fn enabled() -> bool {
18 static ON: OnceLock<bool> = OnceLock::new();
19 *ON.get_or_init(|| docling_core::env::flag("DOCLING_RS_TIMING"))
20}
21
22fn store() -> &'static Mutex<BTreeMap<&'static str, (u128, u64)>> {
23 static S: OnceLock<Mutex<BTreeMap<&'static str, (u128, u64)>>> = OnceLock::new();
24 S.get_or_init(|| Mutex::new(BTreeMap::new()))
25}
26
27pub fn record(stage: &'static str, nanos: u128) {
29 if !enabled() {
30 return;
31 }
32 let mut g = store().lock().unwrap();
33 let e = g.entry(stage).or_insert((0, 0));
34 e.0 += nanos;
35 e.1 += 1;
36}
37
38pub fn timed<T>(stage: &'static str, f: impl FnOnce() -> T) -> T {
40 if !enabled() {
41 return f();
42 }
43 let t = Instant::now();
44 let out = f();
45 record(stage, t.elapsed().as_nanos());
46 out
47}
48
49pub fn report() {
52 if !enabled() {
53 return;
54 }
55 let g = store().lock().unwrap();
56 let mut rows: Vec<_> = g.iter().map(|(k, v)| (*k, v.0, v.1)).collect();
57 rows.sort_by_key(|r| std::cmp::Reverse(r.1));
58 let total: u128 = rows.iter().map(|r| r.1).sum();
59 eprintln!("=== DOCLING_RS timing (per stage, wall-clock) ===");
60 for (stage, nanos, calls) in &rows {
61 let ms = *nanos as f64 / 1e6;
62 let pct = if total > 0 {
63 *nanos as f64 / total as f64 * 100.0
64 } else {
65 0.0
66 };
67 eprintln!(" {stage:<22} {ms:>9.1} ms {pct:>5.1}% ({calls} calls)");
68 }
69 eprintln!(" {:<22} {:>9.1} ms", "TOTAL (summed)", total as f64 / 1e6);
70}
71
72#[derive(Debug, Clone, PartialEq, Eq)]
74pub struct StageTiming {
75 pub stage: &'static str,
77 pub total: std::time::Duration,
80 pub calls: u64,
82}
83
84pub fn snapshot() -> Vec<StageTiming> {
87 let g = store().lock().unwrap_or_else(|p| p.into_inner());
88 let mut rows: Vec<StageTiming> = g
89 .iter()
90 .map(|(stage, (nanos, calls))| StageTiming {
91 stage,
92 total: std::time::Duration::from_nanos(u64::try_from(*nanos).unwrap_or(u64::MAX)),
93 calls: *calls,
94 })
95 .collect();
96 rows.sort_by_key(|r| std::cmp::Reverse(r.total));
97 rows
98}
99
100pub fn reset() {
103 store().lock().unwrap_or_else(|p| p.into_inner()).clear();
104}
105
106#[cfg(test)]
107mod tests {
108 use super::*;
109
110 #[test]
111 fn snapshot_and_reset() {
112 reset();
115 record("test.stage", 2_000_000);
116 record("test.stage", 1_000_000);
117 let rows = snapshot();
118 if enabled() {
119 let row = rows.iter().find(|r| r.stage == "test.stage").unwrap();
120 assert_eq!((row.total.as_nanos(), row.calls), (3_000_000, 2));
121 } else {
122 assert!(rows.is_empty());
123 }
124 reset();
125 assert!(snapshot().iter().all(|r| r.stage != "test.stage"));
126 }
127}