ticklog 0.1.0

A fast, minimal logging library for Rust, designed for performance-critical applications, e.g. high-frequency trading.
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

//! Basic ticklog usage: build with a file sink, log at several levels, flush.
//!
//! Run it, then read the output:
//!
//! ```text
//! cargo run --example basic
//! cat logs/basic.log
//! ```

use std::fs;
use std::io;

use ticklog::{error, info, warn, FileSink, Level};

fn main() -> io::Result<()> {
    // Write to ./logs/basic.log
    fs::create_dir_all("logs")?;

    // FileSink buffers writes and truncates the file on open, so each run
    // starts with a fresh log.
    let guard = ticklog::builder()
        .sink(FileSink::truncate("logs/basic.log")?)
        .max_level(Level::Info)
        .build()
        .expect("ticklog builds once per process");

    info!("server listening on {}", 8080);
    warn!("retry {} of {}", 3, 10);
    error!("connection refused: {}", "127.0.0.1:9090");

    // Dropping the guard flushes the remaining records and joins the drain
    // thread, so the file is complete when this returns.
    drop(guard);

    println!("wrote logs/basic.log");
    Ok(())
}