mib-rs 0.10.0

SNMP MIB parser and resolver
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

//! IR types for OID assignments and their components.
//!
//! These mirror [`crate::ast::oid`] but use `String` names instead of
//! [`Ident`](crate::ast::Ident) nodes.

use crate::source::SourceRange;

/// An unresolved OID assignment. Components remain as symbolic references
/// until the resolver phase.
#[derive(Debug, Clone)]
pub struct OidAssignment {
    /// Ordered list of OID components (symbolic or numeric).
    pub components: Vec<OidComponent>,
    /// Source-qualified range covering the entire `{ ... }` assignment.
    pub range: SourceRange,
}

/// A single element of an OID assignment.
#[derive(Debug, Clone)]
pub enum OidComponent {
    /// Symbolic name reference, e.g. `internet`.
    Name {
        name: String,
        /// Source-qualified range covering the symbolic name.
        range: SourceRange,
    },
    /// Numeric arc, e.g. `1` or `31`.
    Number {
        value: u32,
        /// Source-qualified range covering the numeric literal.
        range: SourceRange,
    },
    /// Name with number, e.g. `org(3)`.
    NamedNumber {
        name: String,
        number: u32,
        /// Source-qualified range covering `name` but not the numeric annotation.
        name_range: SourceRange,
        /// Source-qualified range covering `name(number)`.
        range: SourceRange,
    },
    /// Module-qualified reference, e.g. `SNMPv2-SMI.enterprises`.
    QualifiedName {
        module: String,
        name: String,
        /// Source-qualified range covering `module.name`.
        range: SourceRange,
    },
    /// Module-qualified name with number, e.g. `SNMPv2-SMI.enterprises(1)`.
    QualifiedNamedNumber {
        module: String,
        name: String,
        number: u32,
        /// Source-qualified range covering `module.name` but not the numeric annotation.
        name_range: SourceRange,
        /// Source-qualified range covering `module.name(number)`.
        range: SourceRange,
    },
}

impl OidComponent {
    /// Returns the source-qualified range covering this component.
    pub fn range(&self) -> SourceRange {
        match self {
            OidComponent::Name { range, .. }
            | OidComponent::Number { range, .. }
            | OidComponent::NamedNumber { range, .. }
            | OidComponent::QualifiedName { range, .. }
            | OidComponent::QualifiedNamedNumber { range, .. } => *range,
        }
    }
}