ready-set-sdk 0.1.0-alpha.1

Shared conventions and helpers for ready-set plugins.
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

//! `tracing` setup honoring the dispatcher env contract.

use std::sync::OnceLock;

use tracing_subscriber::{EnvFilter, fmt};

use crate::context::{ColorMode, Context, LogLevel};

static INSTALLED: OnceLock<()> = OnceLock::new();

/// Install a tracing subscriber configured from `ctx`.
///
/// Idempotent: subsequent calls are no-ops. Honors `--quiet` (errors only),
/// `--verbose` (debug), and the color preference. Also respects the
/// `RUST_LOG` env var if set, in which case it takes precedence over
/// `READY_SET_LOG`.
pub fn install(ctx: &Context) {
    INSTALLED.get_or_init(|| install_inner(ctx));
}

fn install_inner(ctx: &Context) {
    let env_filter = EnvFilter::try_from_default_env().unwrap_or_else(|_| {
        let level = match ctx.log_level() {
            LogLevel::Quiet => "error",
            LogLevel::Normal => "info",
            LogLevel::Verbose => "debug",
        };
        EnvFilter::new(level)
    });

    let want_color = match ctx.color() {
        ColorMode::Always => true,
        ColorMode::Never => false,
        ColorMode::Auto => is_terminal::IsTerminal::is_terminal(&std::io::stderr()),
    };

    let subscriber = fmt()
        .with_env_filter(env_filter)
        .with_writer(std::io::stderr)
        .with_ansi(want_color)
        .with_target(false)
        .finish();
    let _ = tracing::subscriber::set_global_default(subscriber);
}