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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

//! ## A modular pretty logger for Rust
//! Created with the philosophy to be minimum but extensible
//! everything (except core) is a feature, every configuration is defined
//! in compiler-level to minimal run-time overhead.
//! # Usage
//! Simplest as possible, works like a `std::println!` (more exatcly as a `std::eprintln!`):
//! ```rust
//! use plog::{info, ok};
//! use std::{thread, time::Duration};
//!
//! let threads: Vec<_> = (0..=10)
//!     .map(|id| {
//!         info!("Creating thread {id}");
//!         thread::spawn(move || {
//!             thread::sleep(Duration::from_millis(1000));
//!             ok!("Thread {id} terminated");
//!         })
//!     })
//!     .collect();
//!     
//! threads.into_iter().for_each(|thr| thr.join().unwrap());
//! ```
//! # Features
//! All the available features are listed [here](https://github.com/Defmc/plog/wiki/Features)

pub mod macros;
use std::io;

#[allow(unused_imports)]
#[cfg(feature = "colored")]
use crossterm::{
    execute,
    style::{Attribute, Color, Print, ResetColor, SetAttribute, SetForegroundColor},
};

#[cfg(feature = "persistent")]
pub mod persistent;

pub mod impls {
    pub mod option_log;
    pub use option_log::*;
    pub mod result_log;
    pub use result_log::*;
}

#[cfg(test)]
pub mod test;

/// Log handler
/// Checks the enabled features and write to specified streams
/// `persistent` enable write to a file
/// `colored` enable colored output to terminal
pub fn log<T: AsRef<str>>(
    #[cfg(feature = "colored")] _color: Color,
    _prefix: &str,
    _msg: T,
) -> io::Result<()> {
    // Hide every message on tests
    #[cfg(not(test))]
    print_log(
        #[cfg(feature = "colored")]
        _color,
        _prefix,
        &_msg,
    )?;

    #[cfg(feature = "persistent")]
    if persistent::check_env() {
        persistent::write_log(_prefix, &_msg)?;
    }
    Ok(())
}

/// Prints log to STDERR
/// `colored` enable colored output to terminal
#[cfg(not(test))]
#[cfg(feature = "colored")]
fn print_log<T: AsRef<str>>(
    #[cfg(feature = "colored")] color: Color,
    prefix: &str,
    msg: &T,
) -> io::Result<()> {
    execute!(
        io::stderr().lock(),
        Print("["),
        SetAttribute(Attribute::Bold),
        SetForegroundColor(color),
        Print(prefix),
        ResetColor,
        Print("]: "),
        Print(msg.as_ref()),
        Print('\n')
    )
}

#[cfg(not(test))]
#[cfg(not(feature = "colored"))]
fn print_log<T: AsRef<str>>(prefix: &str, msg: T) -> io::Result<()> {
    use std::io::Write;
    writeln!(io::stderr().lock(), "[{prefix}]: {}", msg.as_ref()).map(|_| ())
}