Crate base_console 

Automatic terminal and JSON output for ordinary tracing events.

Applications call init once. Libraries continue using tracing directly. For existing subscribers and isolated captures, compose Console::layer instead.

base_console::init();
tracing::info!(connections = 3_u64, "Server started");

Composition

Console configures the format, colour, writer, and filter, then builds a composable Console::layer, an isolated Console::subscriber, or a global installation with Console::init or Console::try_init. A console’s filter applies only to its own output.

use base_console::{Console, OutputFormat};
use tracing_subscriber::{layer::SubscriberExt, EnvFilter};

let console = Console::default()
    .with_format(OutputFormat::Text)
    .with_ansi(false)
    .with_filter(EnvFilter::new("info,base_http=debug"));

let subscriber = tracing_subscriber::registry().with(console.layer());
tracing::subscriber::with_default(subscriber, || {
    tracing::info!("Scoped output");
});

For asynchronous scopes, use tracing::Instrument and tracing::instrument::WithSubscriber to attach spans and subscribers to futures before spawning them. A thread-local default guard must not be held across .await.

Output

JSON includes timestamp (UTC), elapsed_seconds (process-local console uptime), level, target, name, location, fields, and a root-to-leaf spans array. Each enabled span has a name and its current fields; spans excluded by the console’s filter are omitted. Reserved metadata stays separate from user fields. Typed errors are objects containing message and an ordered causes array; cause traversal stops after 32 entries and sets truncated when more remain.

Integer fields remain JSON numbers, except that a 128-bit integer which does not fit in 64 bits is recorded as a decimal string, because most JSON consumers cannot represent it exactly and serde_json needs arbitrary_precision to write it as a number. The arbitrary-precision feature enables that serde_json feature and records such integers as numbers instead; it changes number handling for every serde_json user in the build, so enable it only in an application that already accepts that. Non-finite floating-point fields become JSON null; %value and ?value remain text representations. Backtraces and captured span traces are text fields. The initial output schema may evolve before a stable release.

Writing is synchronous. Each console serializes complete records through its writer and flushes the destination before logging returns; it starts no background threads and requires no runtime. Text output escapes control characters from messages and diagnostic text, while JSON uses standard string escaping.

Macros

failure

Emit a captured Failure as an error event at the caller’s target and source location.

Structs

Console

Configure console output without selecting a runtime or installing global state.

Failure

An error with diagnostics captured where it is wrapped, which can be retained and reported later.

Enums

ConsoleInitError

Console setup failed before normal application logging began.

OutputFormat

The representation written by the console.

Functions

init

Install a global console using RUST_LOG, defaulting to info.

try_init

Try to install a global console using RUST_LOG, defaulting to info.