Crate rotation_logger 

Simple file rotation logger.

This logger safe to use with threads as argument, or as macros.

Example:

use std::{
    thread::{self, sleep},
    time::Duration,
};

use rotation_logger::{FileSize, Logger, OutputChannel, MessageFormatter, Settings, log};

fn main() {
    let formatter = MessageFormatter::new(
        "::",
        "{timestamp:-6:30:right}{splitter}{modules:_:_:left}{splitter}{message}",
        "%Y-%m-%d %H:%M:%S.%f",
    );

    let output = OutputChannel::file(
        "./logs".into(),
        10,
        FileSize::from_kilobytes(1),
        "new_logger".into(),
        "log".into(),
    );

    let settings = Settings::new(true, 5, output, formatter);

    let logger = Logger::new(settings);
    let joiner = logger.run_async();

    let logger_logger_01 = logger.clone();
    let logger_logger_02 = logger.clone();
    let _ = thread::spawn(move || {
        logger_logger_01.log(&vec!["THREAD1".into(), "MAIN".into()], "Starting...");

        let mut counter = 0;
        loop {
            logger_logger_01.log(
                &vec!["THREAD1".into(), "WORKER".into()],
                format!("Processing Job: {counter}").as_str(),
            );
            counter += 1;
            sleep(Duration::from_secs(1));
        }
    });

    let _ = thread::spawn(move || {
        logger_logger_02.log(&vec!["THREAD2".into(), "MAIN".into()], "Starting...");

        let mut counter = 0;
        loop {
            logger_logger_02.log(
                &vec!["THREAD2".into(), "WORKER".into()],
                format!("Processing Job: {counter}").as_str(),
            );
            counter += 2;
            sleep(Duration::from_millis(400));
        }
    });

    let _ = thread::spawn(move || {
        log!("Starting...");

        let mut counter = 0;
        loop {
            log!(format!("Try Process Job: {counter}").as_str());

            // Log as text
            log!(
                ["THREAD3", "MODULE1"],
                format!("Try Process Job: {counter}").as_str()
            );
            let module_str = "RAW_MODULE";
            let thread3_str = "THREAD3";

            // Log from vars
            log!(
                [thread3_str, module_str],
                format!("Try Process Job: {counter}").as_str()
            );

            // Log as ident
            log!((RAW_MODULE, RAW_MODULE2, RAW_MODULE3), "some");
            counter += 2;
            sleep(Duration::from_millis(400));
        }
    });

    match joiner {
        Some(j) => {
            let _ = j.join();
        }
        None => {}
    };
}

Macros

log

Thread safe macros to log messages.

Structs

FileSettings

Settings for logs files and rotation.

FileSize

File Size wrapper for easier declaration Store bits size. Inner data stored as Bits value.

Message

Message that must be shared across logger senders.

MessageFormatter

Formatted for Log Message.

Settings

Settings for data format and output of Logger. All Settings must be set before Logger start and cant be changed during work. Enabled or Disabled Logger can be used to log data, but in case of Disabled Logger nothing will happen.

Enums

Logger

Logger builder based on settings. Initialize logger from this data structure.

OutputChannel

Output Types for Logger.

Statics

LOG_SENDER