selene-db-gql 1.3.0

ISO/IEC 39075:2024 GQL parser, planner, optimizer, and executor for selene-db.
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

//! Source-carrying parser diagnostic wrapper.

use std::sync::Arc;

use miette::NamedSource;

use crate::ParserError;

/// Parser error plus the source text needed for terminal caret rendering.
#[derive(Debug, thiserror::Error, miette::Diagnostic)]
#[error("{inner}")]
#[diagnostic(forward(inner))]
pub struct DiagnosticReport {
    #[source_code]
    source_code: Arc<NamedSource<Arc<str>>>,
    inner: ParserError,
}

impl DiagnosticReport {
    /// Construct a source-carrying diagnostic.
    #[must_use]
    pub fn new(error: ParserError, source: Arc<str>, label: impl Into<String>) -> Self {
        Self {
            source_code: Arc::new(NamedSource::new(label.into(), source)),
            inner: error,
        }
    }

    /// Return the wrapped parser error.
    #[must_use]
    pub const fn error(&self) -> &ParserError {
        &self.inner
    }

    /// Return the source text attached to this diagnostic.
    #[must_use]
    pub fn source(&self) -> &str {
        self.source_code.inner().as_ref()
    }

    /// Return the named source attached to this diagnostic.
    #[must_use]
    pub fn named_source(&self) -> &NamedSource<Arc<str>> {
        &self.source_code
    }
}