libnewsboat 2.38.0

Utility libraries used by Newsboat reader
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

//! Measures time spent in a given scope, and writes it to the log.

use std::time::Instant;

use crate::{
    log,
    logger::{self, Level},
};

/// Measures time spent in an enclosing scope, and writes it to the log.
///
/// Upon construction, this struct remembers current (monotonic) time. Before being dropped, it
/// will write a debug message to the log mentioning: 1) the name of the enclosing scope (as
/// provided to the constructor); 2) the time that elapsed between constructing and dropping the
/// object.
///
/// Calling `stopover()` will write a debug message to the log mentioning: 1) the name of the
/// enclosing scope; 2) the name of the stopover; 3) the time that elapsed between constructing the
/// object and calling `stopover()`.
pub struct ScopeMeasure {
    start_time: Instant,
    scope_name: String,
}

impl ScopeMeasure {
    /// Construct an object that will measure time spent in the scope named `scope_name`.
    pub fn new(scope_name: String) -> ScopeMeasure {
        ScopeMeasure {
            start_time: Instant::now(),
            scope_name,
        }
    }

    /// Write a message to the log mentioning the scope name, `stopover_name`, and the time elapsed
    /// since the object was constructed.
    pub fn stopover(&self, stopover_name: &str) {
        log!(
            Level::Debug,
            &format!(
                "ScopeMeasure: function `{}' (stop over `{stopover_name}') took {:.6} s so far",
                self.scope_name,
                self.start_time.elapsed().as_secs_f64()
            )
        );
    }
}

impl Drop for ScopeMeasure {
    fn drop(&mut self) {
        log!(
            Level::Debug,
            &format!(
                "ScopeMeasure: function `{}' took {:.6} s",
                self.scope_name,
                self.start_time.elapsed().as_secs_f64()
            )
        );
    }
}