use std::io;
use tracing_subscriber::EnvFilter;
use tracing_subscriber::layer::SubscriberExt;
use tracing_subscriber::util::SubscriberInitExt;
use crate::cli::Cli;
pub fn init_tracing(cli: &Cli) {
let default_level = default_directive(cli);
let filter =
EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new(default_level));
let filter_display = filter.to_string();
let ansi = crate::platform::ansi_colors_enabled(cli.no_color);
let fmt_layer = tracing_subscriber::fmt::layer()
.with_writer(io::stderr)
.with_ansi(ansi)
.with_target(true)
.with_level(true)
.with_thread_ids(false)
.with_thread_names(false);
let result = tracing_subscriber::registry()
.with(filter)
.with(fmt_layer)
.try_init();
match result {
Ok(()) => {
tracing::debug!(
target: "docsrs_cli::telemetry",
filter = %filter_display,
default_level,
ansi,
"tracing subscriber installed (stderr diagnostics)"
);
}
Err(_) => {
}
}
}
pub(crate) fn default_directive(cli: &Cli) -> &'static str {
if cli.quiet {
"error"
} else if cli.verbose >= 2 {
"trace"
} else if cli.verbose == 1 {
"debug"
} else {
"error"
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::cli::{Cli, Commands};
use clap::Parser;
fn cli_with(args: &[&str]) -> Cli {
Cli::try_parse_from(args).expect("parse test argv")
}
#[test]
fn default_directive_agent_first_is_error() {
let cli = cli_with(&["docsrs-cli", "version"]);
assert_eq!(default_directive(&cli), "error");
}
#[test]
fn default_directive_verbose_debug_and_trace() {
let v1 = cli_with(&["docsrs-cli", "-v", "version"]);
assert_eq!(default_directive(&v1), "debug");
let v2 = cli_with(&["docsrs-cli", "-vv", "version"]);
assert_eq!(default_directive(&v2), "trace");
}
#[test]
fn default_directive_quiet_wins_over_verbose() {
let cli = cli_with(&["docsrs-cli", "-q", "-vv", "version"]);
assert_eq!(default_directive(&cli), "error");
let _ = cli.command;
}
#[test]
fn init_tracing_is_idempotent() {
let cli = cli_with(&["docsrs-cli", "version"]);
init_tracing(&cli);
init_tracing(&cli);
assert!(matches!(cli.command, Commands::Version));
}
}