debug_tree 0.4.0

Build a tree one element at a time and output it as a pretty string.
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

use crate::TreeBuilder;

/// A deferred function called with an argument, `TreeBuilder`
pub struct DeferredFn<F: Fn(TreeBuilder) -> ()> {
    tree: Option<TreeBuilder>,
    action: Option<F>,
}

impl<F> DeferredFn<F>
where
    F: Fn(TreeBuilder) -> (),
{
    /// Create a new deferred function based on `tree`
    pub fn new(tree: TreeBuilder, action: F) -> Self {
        DeferredFn {
            tree: Some(tree),
            action: Some(action),
        }
    }
    /// Create an empty deferred function
    /// This does nothing when scope ends
    pub fn none() -> Self {
        DeferredFn {
            tree: None,
            action: None,
        }
    }

    /// Disables the deferred function
    /// This prevents the function from executing when the scope ends
    pub fn cancel(&mut self) {
        self.tree = None;
        self.action = None;
    }
}

impl<F> Drop for DeferredFn<F>
where
    F: Fn(TreeBuilder) -> (),
{
    fn drop(&mut self) {
        if let (Some(x), Some(action)) = (&self.tree, &self.action) {
            action(x.clone());
        }
    }
}