bugstalker 0.4.5

BugStalker is a modern and lightweight debugger for rust applications.
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

use crate::debugger::debugee::dwarf::{
    NamespaceHierarchy,
    unit::die_ref::{FatDieRef, Hint},
};
use bytes::Bytes;
use std::fmt::{Display, Formatter};

pub mod dqe;
pub mod execute;
pub mod render;
pub mod value;
pub mod r#virtual;

/// Identifier of a query result.
/// Consists name and namespace of the variable or argument.
#[derive(Clone, Default, PartialEq)]
pub struct Identity {
    namespace: NamespaceHierarchy,
    pub name: Option<String>,
}

impl Identity {
    pub fn new(namespace: NamespaceHierarchy, name: Option<String>) -> Self {
        Self { namespace, name }
    }

    pub fn from_die<H: Hint>(die_ref: &FatDieRef<'_, H>) -> Self {
        let name = die_ref.deref_ensure().name();
        Self::new(die_ref.namespace(), name)
    }

    pub fn no_namespace(name: Option<String>) -> Self {
        Self {
            namespace: NamespaceHierarchy::default(),
            name,
        }
    }
}

impl Display for Identity {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        let namespaces = if self.namespace.is_empty() {
            String::default()
        } else {
            self.namespace.as_parts().join("::") + "::"
        };

        match self.name.as_deref() {
            None => Ok(()),
            Some(name) => f.write_fmt(format_args!("{namespaces}{name}")),
        }
    }
}

/// Object binary representation in debugee memory.
pub struct ObjectBinaryRepr {
    /// Binary representation.
    pub raw_data: Bytes,
    /// Possible address of object data in debugee memory.
    /// It may not exist if there is no debug information, or if an object is allocated in registers.
    pub address: Option<usize>,
    /// Binary size.
    pub size: usize,
}