mtlog 0.1.0

Extract type safe structured data from environment variables with procedural derive macros
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# mtlog
Multi-threaded logger with support for progress bars and log files.
//!
## Usage
```toml
// Cargo.toml
...
[dependencies]
mtlog = "0.1.0"
```

```rust
use mtlog::logger_config;

logger_config()
   .init_global();
log::info!("Hello, world!");
std::thread::sleep(std::time::Duration::from_millis(1)); // wait for log to flush
```

## Multi-threaded logging
```rust
use mtlog::logger_config;

logger_config()
    .with_name("main")
    .init_global();

log::info!("Hello, world from main thread!");

for i in 0..5 {
    std::thread::spawn(move || {
       logger_config()
            .with_name(&format!("thread {i}"))
            .init_local();
    log::warn!("Hello, world from thread {i}!")
   });
}
std::thread::sleep(std::time::Duration::from_millis(1)); // wait for log to flush
```

## Logging to files
Files can be used to log messages. The log file is created if it does not exist and appended to if it does.
Threads can log to different files. If no file is specified in local config, the global file is used.

```rust
use mtlog::logger_config;

logger_config()
    .with_log_file("/tmp/app.log")
    .expect("Unable to create log file")
    .no_stdout() // disable stdout logging if needed   
    .init_global();

log::info!("Hello, world!");
std::thread::sleep(std::time::Duration::from_millis(1)); // wait for log to flush
assert!(std::fs::read_to_string("/tmp/app.log").unwrap().ends_with("Hello, world!\n"));
```

## Progress bar
A progress bar implementation is provided. Multiple progress bars can be created and updated concurrently without interfering with each other and regular logs

```rust
use mtlog::{logger_config,LogProgressBar};

logger_config()
    .init_global();

let pb = LogProgressBar::new(100, "My Progress Bar");
for i in 0..100 {
    pb.inc(1);
    if i == 50 {
       log::info!("Halfway there!");
    }
}
pb.finish();
```