razgad 0.1.0

A library for decoding, classifying, normalizing, and re-emitting mangled, decorated, and runtime symbol names across a wide spread of compiler, platform, and language ecosystems.
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use crate::{function_names, text, Confidence, Name, Scheme, Signature, Symbol, SymbolKind, Type};

pub fn decode(scheme: Scheme, input: &str) -> Option<Symbol> {
    let trimmed = input.trim();
    if trimmed.is_empty() {
        return None;
    }

    let parsed = function_names::parse_function_name(trimmed)?;
    let mut symbol = Symbol::new(
        scheme,
        parsed
            .callable_name
            .as_deref()
            .map(classify_plain_kind)
            .unwrap_or(SymbolKind::Function),
    );

    if let Some(callable) = parsed.callable_name.as_deref() {
        if callable.contains("::") {
            symbol.path = parsed
                .callable_path
                .iter()
                .map(|part| text::parse_name(part, "::"))
                .collect();
        } else {
            symbol.path = vec![text::parse_name(callable, "::")];
        }
    } else {
        symbol.path = vec![Name::identifier(parsed.normalized.clone())];
    }

    if parsed.has_signature() {
        symbol.signature = Some(Signature {
            calling_convention: parsed
                .calling_convention
                .as_deref()
                .and_then(map_calling_convention),
            parameters: parsed
                .arguments
                .iter()
                .map(|arg| parse_plain_type(&arg.type_text))
                .collect(),
            return_type: parsed.return_type.as_deref().map(parse_plain_type),
        });
    }

    Some(symbol.with_display(parsed.full).with_verbatim(trimmed))
}

pub fn detect(input: &str) -> Option<(Scheme, Confidence)> {
    let trimmed = input.trim();
    if trimmed.is_empty() {
        return None;
    }

    let confidence = if trimmed.contains("::") {
        Confidence::High
    } else {
        Confidence::Medium
    };

    Some((Scheme::Plain, confidence))
}

fn parse_plain_type(text: &str) -> Type {
    let trimmed = text.trim();
    if trimmed == "..." {
        Type::Other("...".to_string())
    } else {
        text::parse_type(trimmed, "::")
    }
}

fn classify_plain_kind(callable: &str) -> SymbolKind {
    let path = text::parse_names(callable, "::");
    if path.len() >= 2 {
        if let (Some(Name::Identifier(last)), Some(Name::Identifier(prev))) =
            (path.last(), path.get(path.len() - 2))
        {
            if last == prev {
                return SymbolKind::Constructor;
            }
            if last.starts_with('~') {
                return SymbolKind::Destructor;
            }
        }
    }
    if path.len() >= 2 {
        SymbolKind::Method
    } else {
        SymbolKind::Function
    }
}

fn map_calling_convention(value: &str) -> Option<crate::CallingConvention> {
    function_names::parse_calling_convention_token(value)
}