Struct InitOptions 

pub struct InitOptions { /* private fields */ }

Configuration for init_with.

Constructed via InitOptions::default and the with_* builder methods. Each method consumes self and returns Self to support chaining:

use kamu_logging::{init_with, Format, InitOptions, Sink};

init_with(
    InitOptions::default()
        .with_service_name("my-service")
        .with_format(Format::Json)
        .with_sink(Sink::Stdout),
)?;

Implementations

impl InitOptions

pub fn with_service_name(self, name: impl Into<String>) -> Self

Attach a service.name field to every event. Used by log aggregators to route logs across services.

pub fn with_default_filter(self, filter: impl Into<String>) -> Self

Default filter directive when the env var is unset. Defaults to "debug" in debug builds and "info" in release builds.

pub fn with_env_var(self, var: impl Into<String>) -> Self

Environment variable read for the filter directive. Defaults to "RUST_LOG". Useful for per-binary triggers like "KKP_LOG" to avoid collisions with other tools’ RUST_LOG settings.

pub fn with_format(self, format: Format) -> Self

Output format. See Format.

pub fn with_sink(self, sink: Sink) -> Self

Output sink. See Sink.

pub fn idempotent(self, enabled: bool) -> Self

When true, a second init_with call returns Ok(()) instead of Error::TracingGlobal.

Default is false so library double-init surfaces as an error. Set true from test harnesses and embedded CLI runs where re-init is expected.

Trait Implementations

impl Clone for InitOptions

fn clone(&self) -> InitOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InitOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for InitOptions

fn default() -> InitOptions

Returns the “default value” for a type.