rust-ef 1.7.0

Rust Entity Framework - An EFCore-inspired ORM 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
56
57
58
59
60
61
62
63

use std::time::Duration;
#[cfg(feature = "tracing")]
use std::time::Instant;

/// Guards a query execution span, emitting timing events on drop.
///
/// When `tracing` is enabled, logs query start (`DEBUG`) and completion
/// (`DEBUG`, or `WARN` if slow). When disabled, it is a ZST no-op.
#[cfg(feature = "tracing")]
pub struct QueryGuard {
    sql: String,
    start: Instant,
    threshold: Option<Duration>,
}

#[cfg(feature = "tracing")]
impl QueryGuard {
    pub fn new(sql: &str, threshold: Option<Duration>) -> Self {
        tracing::debug!(target: "rust_ef::query", sql = %sql, "query started");
        Self {
            sql: sql.to_string(),
            start: Instant::now(),
            threshold,
        }
    }
}

#[cfg(feature = "tracing")]
impl Drop for QueryGuard {
    fn drop(&mut self) {
        let elapsed = self.start.elapsed();
        let elapsed_ms = elapsed.as_millis() as u64;
        if let Some(threshold) = self.threshold {
            if elapsed >= threshold {
                tracing::warn!(
                    target: "rust_ef::query",
                    sql = %self.sql,
                    elapsed_ms,
                    threshold_ms = threshold.as_millis() as u64,
                    "slow query detected"
                );
                return;
            }
        }
        tracing::debug!(
            target: "rust_ef::query",
            sql = %self.sql,
            elapsed_ms,
            "query completed"
        );
    }
}

/// No-op stub when tracing is disabled — zero-sized, eliminated by compiler.
#[cfg(not(feature = "tracing"))]
pub struct QueryGuard;

#[cfg(not(feature = "tracing"))]
impl QueryGuard {
    pub fn new(_sql: &str, _threshold: Option<Duration>) -> Self {
        Self
    }
}