oxc-yaml-parser 0.0.1

A YAML 1.2 parser that produces a comment-preserving typed AST.
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

/// Span represents a range of a piece of source code.
/// It counts by byte offset, so it's 0-based.
///
/// Offsets are `u32` (matching oxc convention); sources larger than 4 GiB are
/// rejected by the parser up front.
#[derive(Clone, Copy, Debug, Hash, PartialEq, Eq)]
pub struct Span {
    /// Start offset. (Inclusive)
    pub start: u32,
    /// End offset. (Exclusive)
    pub end: u32,
}

impl Span {
    pub fn new(start: u32, end: u32) -> Self {
        Self { start, end }
    }

    /// A zero-width span at the given offset. Covers no characters, but its
    /// position may still be meaningful (e.g. a marker between two tokens).
    pub fn empty(at: u32) -> Self {
        Self { start: at, end: at }
    }

    /// The source text this span covers.
    pub fn slice(self, source: &str) -> &str {
        &source[self.start as usize..self.end as usize]
    }

    /// Whether the span covers no characters. An empty span's position may
    /// still be meaningful (e.g. a synthesized token).
    pub fn is_empty(self) -> bool {
        self.start == self.end
    }
}