mib-rs 0.8.0

SNMP MIB parser and resolver
Documentation
//! 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::types::Span;

/// 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 span covering the entire `{ ... }` assignment.
    pub span: Span,
}

/// A single element of an OID assignment.
#[derive(Debug, Clone)]
pub enum OidComponent {
    /// Symbolic name reference, e.g. `internet`.
    Name { name: String, span: Span },
    /// Numeric arc, e.g. `1` or `31`.
    Number { value: u32, span: Span },
    /// Name with number, e.g. `org(3)`.
    NamedNumber {
        name: String,
        number: u32,
        span: Span,
    },
    /// Module-qualified reference, e.g. `SNMPv2-SMI.enterprises`.
    QualifiedName {
        module: String,
        name: String,
        span: Span,
    },
    /// Module-qualified name with number, e.g. `SNMPv2-SMI.enterprises(1)`.
    QualifiedNamedNumber {
        module: String,
        name: String,
        number: u32,
        span: Span,
    },
}

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