base-console 0.1.0

Automatic terminal and JSON diagnostics for tracing
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

// Released under the MIT License.
// Copyright, 2026, by Samuel Williams.

use std::{error::Error, fmt};
use tracing::subscriber::SetGlobalDefaultError;
use tracing_subscriber::filter::FromEnvError;

/// Console setup failed before normal application logging began.
#[derive(Debug)]
pub enum ConsoleInitError {
    /// `RUST_LOG` could not be read or parsed.
    Filter(FromEnvError),
    /// A global subscriber could not be installed.
    Subscriber(SetGlobalDefaultError),
}

impl fmt::Display for ConsoleInitError {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::Filter(_) => formatter.write_str("could not configure the console filter"),
            Self::Subscriber(_) => formatter.write_str("could not install the console subscriber"),
        }
    }
}

impl Error for ConsoleInitError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        Some(match self {
            Self::Filter(error) => error,
            Self::Subscriber(error) => error,
        })
    }
}

impl From<FromEnvError> for ConsoleInitError {
    fn from(error: FromEnvError) -> Self {
        Self::Filter(error)
    }
}

impl From<SetGlobalDefaultError> for ConsoleInitError {
    fn from(error: SetGlobalDefaultError) -> Self {
        Self::Subscriber(error)
    }
}