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 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140
#![deny( missing_docs, trivial_casts, trivial_numeric_casts, unsafe_code, unstable_features, unused_import_braces, unused_qualifications, warnings )] //!## Usage //! //!All examples can be found in the `examples` directory. //! //!### Basic //! //!The simpliest way is just to call `init`. //!The default log level is `Info`, so that debug and trace messages are not shown. //! //!``` rust //!//! examples/01_basic.rs //!//! # Basic usage for the logger //!use log::{error, warn, info, debug, trace}; //!use loggify::Loggify; //! //!/// The default level is INFO. So debug and trace outputs are oppressed //!fn main() { //! Loggify::init().unwrap(); //! //! error!("My error message"); //! warn!("My warn message"); //! info!("My info message"); //! debug!("Will not be shown"); //! trace!("Will not be shown"); //!} //!``` //! //!### With log level //! //!``` rust //!//! examples/02_log_level.rs //!//! Example for initializing the logger with a log level //!use log::{error, warn, info, debug, trace, Level}; //!use loggify::Loggify; //! //!/// Same as the basic example with the difference that //!/// the logger is intialized with the debug log level. //!fn main() { //! Loggify::init_with_level(Level::Debug).unwrap(); //! //! error!("My error message"); //! warn!("My warn message"); //! info!("My info message"); //! debug!("My debug message"); //! trace!("Will not be shown"); //!} //!``` //! //!### Log builder //!``` rust //!//! examples/03_builder.rs //!//! Example for initializing the logger with the LogBuilder //!use log::{error, warn, info, debug, trace}; //!use loggify::LogBuilder; //! //!/// The `LogBuilder` is used to set more logger options //!/// This example will change the log level to Trace //!/// and the printed time format to time only //!fn main() { //! LogBuilder::new() //! .set_level(log::Level::Trace) //! .set_time_format(String::from("%H:%M:%S")) //! .build() //! .unwrap(); //! //! error!("My error message"); //! warn!("My warn message"); //! info!("My info message"); //! debug!("My debug message"); //! trace!("My trace message"); //!} //!``` //! //!### Exclude targets from log //! //!``` rust //!//! examples/04_exclude.rs //!//! Example for excluding log targets from getting logged //!use log::{error, warn, info, debug, trace}; //!use loggify::LogBuilder; //! //!mod example { //! pub mod excluded { //! use log::info; //! //! pub fn call_me() { //! info!("I will not be logged"); //! } //! } //! //! pub mod included { //! use log::info; //! //! pub fn call_me() { //! info!("I will be logged"); //! } //! } //!} //! //!/// Exmple on how to exclude specific log targets //!fn main() { //! LogBuilder::new() //! // this will show the log targets so that we can determine //! // what to exclude //! .set_log_target(true) //! // this will oppress all logs coming from example::excluded::* //! .add_exclude("example::excluded".to_string()) //! .set_level(log::Level::Trace) //! .build() //! .unwrap(); //! //! error!("My error message"); //! warn!("My warn message"); //! info!("My info message"); //! debug!("My debug message"); //! trace!("My trace message"); //! //! // the log message of this call will not be shown //! example::excluded::call_me(); //! // this log message will be shown //! example::included::call_me(); //!} //!``` mod loggify; mod log_builder; pub use self::loggify::Loggify; pub use self::log_builder::LogBuilder;