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

//! AST types for OBJECT IDENTIFIER value assignments and their components.
//!
//! An [`OidAssignment`] represents the `::= { ... }` portion of an OID
//! definition, containing a sequence of [`OidComponent`]s that form the
//! path from a well-known root to the assigned node.

use super::common::Ident;
use crate::source::SourceRange;

/// Parsed components of an OBJECT IDENTIFIER value,
/// e.g. `{ iso org(3) dod(6) 1 }`.
#[derive(Debug, PartialEq, Eq)]
pub struct OidAssignment {
    /// The ordered list of components forming the OID path.
    pub components: Vec<OidComponent>,
    /// Source-qualified range covering the entire `{ ... }` assignment.
    pub span: SourceRange,
}

/// A single element in an OID value assignment.
///
/// OID values are written as a sequence of these components between
/// braces, mixing named references and numeric sub-identifiers.
/// Overflowing numeric sub-identifiers are retained as zero and accompanied
/// by an `invalid-u32` parser diagnostic over the literal.
#[derive(Debug, PartialEq, Eq)]
pub enum OidComponent {
    /// Named reference, e.g. `internet`, `ifEntry`.
    Name(Ident),
    /// Numeric sub-identifier, e.g. `1`, `31`.
    Number {
        value: u32,
        /// Source-qualified range covering the numeric literal.
        span: SourceRange,
    },
    /// Name with number, e.g. `iso(1)`, `org(3)`.
    NamedNumber {
        name: Ident,
        num: u32,
        /// Source-qualified range covering `name(number)`.
        span: SourceRange,
    },
    /// Module-qualified reference, e.g. `SNMPv2-SMI.enterprises`.
    QualifiedName {
        module_name: Ident,
        name: Ident,
        /// Source-qualified range covering `module.name`.
        span: SourceRange,
    },
    /// Module-qualified name with number, e.g. `SNMPv2-SMI.enterprises(1)`.
    QualifiedNamedNumber {
        module_name: Ident,
        name: Ident,
        num: u32,
        /// Source-qualified range covering `module.name(number)`.
        span: SourceRange,
    },
}

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