piquel-log

Small, composable backend initialization for tracing.

piquel-log is a backend helper for applications that want:

• a simple Logger::new().init()? path
• optional file output behind a feature flag
• optional log crate interoperability behind a feature flag
• a single layer that can be attached to an existing tracing_subscriber stack

Features

• default: console output
• file: file output with latest.log plus one session file per initialization
• log: explicit log to tracing bridge during init
• full: enables file and log

Quick start

use piquel_log::Logger;

# fn main() -> Result<(), Box<dyn std::error::Error>> {
Logger::new().init()?;
tracing::info!("hello from tracing");
# Ok(())
# }

Custom subscriber stacks

use piquel_log::Logger;
use tracing_subscriber::{filter::LevelFilter, prelude::*, Registry};

# fn main() -> Result<(), Box<dyn std::error::Error>> {
let backend = Logger::new().build()?;
let subscriber = Registry::default().with(LevelFilter::INFO).with(backend);
let _guard = tracing::subscriber::set_default(subscriber);
tracing::info!("hello from a custom stack");
# Ok(())
# }

File output

# #[cfg(feature = "file")]
# fn main() -> Result<(), Box<dyn std::error::Error>> {
use piquel_log::{FileConfig, Logger};

let file = FileConfig::new("logs").with_session_file_prefix("app");
Logger::new().with_file(file).init()?;
# Ok(())
# }
# #[cfg(not(feature = "file"))]
# fn main() {}

log crate interoperability

# #[cfg(feature = "log")]
# fn main() -> Result<(), Box<dyn std::error::Error>> {
use piquel_log::Logger;

Logger::new().with_log_bridge(true).init()?;
log::warn!("bridged from log");
# Ok(())
# }
# #[cfg(not(feature = "log"))]
# fn main() {}