chompy 0.2.0

A series of utilities used to create parsers
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

use super::*;
use static_assertions::assert_obj_safe;
use std::fmt::Debug;

assert_obj_safe!(Diag);
/// The core trait used to create user-facing diagnostics in chompy. The macros
/// [crate::define_error], [crate::define_warning], and [crate::define_bug] can be utilized to
/// implement this to your types.
pub trait Diag: Debug + Send + Sync {
    /// Returns the [Severity] of this Diag.
    fn severity(&self) -> Severity;
    /// Returns the [Builder] used to assemble the information presented to the user.
    fn build(&self, builder: Builder) -> Builder;
}

/// Alias for a Result that returns DiagBox's.
pub type Result<T> = std::result::Result<T, DiagBox>;

/// Container for dynamically dispatched implementers of [Diag].
pub struct DiagBox(Box<dyn Diag + Send + Sync>);

impl std::fmt::Debug for DiagBox {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        self.0.fmt(f)
    }
}

impl<E> From<E> for DiagBox
where
    E: Diag + 'static,
{
    fn from(value: E) -> Self {
        DiagBox(Box::new(value))
    }
}

impl std::ops::Deref for DiagBox {
    type Target = Box<dyn Diag + Send + Sync>;

    fn deref(&self) -> &Self::Target {
        &self.0
    }
}