macroonz-compiler 0.1.0

Deterministic Rust code generation for procedural macros: plan, render, close, explain, and bind one sealed expansion from declared input.
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

//! The host's invariant nucleus: every road that reaches the span custody's private seat.
//!
//! Declared inside `types.rs` as its own child, so the held spans are reachable here and nowhere else.
//! Handles are issued in reading order and never reused, which is the whole invariant: a handle answers about the token it was issued for, or the table says it does not reach.

use super::Spans;
use crate::token::{CaptureBuilder, SpanHandle};
use proc_macro::Span;

impl Spans {
    /// A table that has issued nothing.
    #[must_use]
    pub const fn empty() -> Self {
        Self {
            builder: CaptureBuilder::declared(),
        }
    }

    /// The checked builder that owns this table's handles and positions.
    pub(crate) const fn builder(&mut self) -> &mut CaptureBuilder<Span> {
        &mut self.builder
    }

    /// The compiler span one handle names, or the invocation where this table does not reach it.
    ///
    /// One lookup for every road that holds a handle, so a diagnostic the compiler composed and a capture this host refused point at their token the same way.
    /// Where the table does not reach, the invocation stands — never the declaration's first span, which is a real token the observation is not about and would read exactly like an answer.
    #[must_use]
    pub fn at(&self, handle: SpanHandle) -> Span {
        match usize::try_from(handle.index())
            .ok()
            .and_then(|index| self.builder.positions().get(index).copied())
        {
            Some(span) => span,
            None => Span::call_site(),
        }
    }
}