update chrono

CHANGELOG.md

@@ -1,121 +1,142 @@
+## Unreleased
+ - The `new` method of loggers are now `#[must_use]` to prevent confusion when `new` is used called instead of `init`
+## v0.12.0
+ - Replaces the semingly unmaintained chrono library with the time crate.
+ - Addresses through this update 
+     - RUSTSEC-2020-0159 (chrono)
+     - RUSTSEC-2020-0071 (time)
+ - `ConfigBuilder::set_time_to_local` is replaced by `ConfigBuilder::set_time_offset_to_local`.
+     - This function requires the new (and by default activated) `local-offset` feature.
+     - This function may fail, for more information read the docs.
+     - simplelog will not determine the local offset dynamically anymore, but only once, when this config option is set.
+         - Due to safety reasons there is no way to provide this property currently.
+ - `ConfigBuilder::set_time_offset` now takes a `time::UtcOffset` instead of a `chrono::FixedOffset`.
+ - `ConfigBuilder::set_time_format` has been replaced by three new variants
+     - `ConfigBuilder::set_time_format_rfc2822` sets the time format to use the format described by rfc2822.
+     - `ConfigBuilder::set_time_format_rfc3339` sets the time format to use the format described by rfc3339.
+     - `ConfigBuilder::set_time_format_custom` sets the time format to a custom time format best created using `time::macros::format_description`.
+         - Runtime provided time format configuration is possible, but difficult due to lifetime constraints.
+         - Fixing this will require a solution to https://github.com/time-rs/time/issues/429
+     - *Note*: The default format is unchanged "[hour]:[minute]:[second]"
+
 ## v0.11.0
-    - Add colored log levels using `ansi_term` (PR #88, credits to @manio)
-    - Add target padding (PR #85, credits to @bytebeamio)
-    - Add optional color and style support using `paris` crate (PR #84, credits to @manio)
+ - Add colored log levels using `ansi_term` (PR #88, credits to @manio)
+ - Add target padding (PR #85, credits to @bytebeamio)
+ - Add optional color and style support using `paris` crate (PR #84, credits to @manio)
 
 ## v0.10.2
-    - Fix flushing with `BufferedStandardStreams` (PR #82, credits to @mrkline)
+ - Fix flushing with `BufferedStandardStreams` (PR #82, credits to @mrkline)
 
 ## v0.10.1
-    - Fix TermLogger performance using `termcolor::BufferedStandardStream` (PR #80, credits to @mrkline)
-    - Add write thread name support for `termlog` (PR #76, credits to @zeroflaw)
+ - Fix TermLogger performance using `termcolor::BufferedStandardStream` (PR #80, credits to @mrkline)
+ - Add write thread name support for `termlog` (PR #76, credits to @zeroflaw)
 
 ## v0.10.0
-    - Fix wrong argument naming (PR #70, credits to @scvalex)
-    - *Breaking*: More color customization options (PR #72, credits to @mrkline)
-    - Clarify docs on config levels
+ - Fix wrong argument naming (PR #70, credits to @scvalex)
+ - *Breaking*: More color customization options (PR #72, credits to @mrkline)
+ - Clarify docs on config levels
 
 ## v0.9.0
-    - Add customizable level label colors (PR #69. credits to @JarrettBillingsley)
-    - Remove unneeded TermLogError
-    - Future-proof config by adding `#[non_exhaustive]`
-    - Fix compiling with minimal-versions
+ - Add customizable level label colors (PR #69. credits to @JarrettBillingsley)
+ - Remove unneeded TermLogError
+ - Future-proof config by adding `#[non_exhaustive]`
+ - Fix compiling with minimal-versions
 
 ## v0.8.0
-    - Switch from `term` to `termcolor` (PR #59. credits to @raybritton)
-    - Fix typo in docs (PR #58, credits to @anthonyjmartinez)
-    - Switch default padding to `Off`. Padding is annoyingly controversal, just set it to whatever you prefer, if you want it.
+ - Switch from `term` to `termcolor` (PR #59. credits to @raybritton)
+ - Fix typo in docs (PR #58, credits to @anthonyjmartinez)
+ - Switch default padding to `Off`. Padding is annoyingly controversial, just set it to whatever you prefer, if you want it.
 
 ## v0.7.6
-    - Derive `Clone`,`Copy`,`PartialEq`,`Eq`,`Debug` and `Hash` for `TerminalMode`. (PR #56, credits to @panhania)
+ - Derive `Clone`,`Copy`,`PartialEq`,`Eq`,`Debug` and `Hash` for `TerminalMode`. (PR #56, credits to @panhania)
 
 ## v0.7.5
-    - Use `target()` instead of `module_path()` for filtering as suggested by `log`s docs. (PR #52, credits to @tsidea)
-    - Allow logging thread names and pad thread ids (defaults match the old behaviour). (PR #53, credits to @mulark)
+ - Use `target()` instead of `module_path()` for filtering as suggested by `log`s docs. (PR #52, credits to @tsidea)
+ - Allow logging thread names and pad thread ids (defaults match the old behaviour). (PR #53, credits to @mulark)
 
 ## v0.7.4
-    - Fixed time formats with 
+ - Fixed time formats with 
 
 ## v0.7.3
-    - Fixed `test` feature
+ - Fixed `test` feature
 
 ## v0.7.2
-    - Allow Level Padding to be configured
+ - Allow Level Padding to be configured
 
 ## v0.7.1
-    - Fix `LevelFilter:Off` not turning off parts of the log messages
+ - Fix `LevelFilter:Off` not turning off parts of the log messages
 
 ## v0.7.0
-    - Add local time zone option
-    - Change config to builder pattern avoiding future major version bumps
-    - Add further documentation about dealing with `TermLogger` failing
-    - `term` 0.6.* is now also supported
+ - Add local time zone option
+ - Change config to builder pattern avoiding future major version bumps
+ - Add further documentation about dealing with `TermLogger` failing
+ - `term` 0.6.* is now also supported
 
 ## v0.6.0
-    - Add time offset parameter (defaults to UTC)
-    - Add thread_id output (credits to @kurtlawrence)
-    - Pad log level
-    - Add TestLogger (credits to @AlexW-GH)
-    - Add stream configuration to TermLogger
-    - Implement allow- and ignore-filtering (credits to @ryankurte)
+ - Add time offset parameter (defaults to UTC)
+ - Add thread_id output (credits to @kurtlawrence)
+ - Pad log level
+ - Add TestLogger (credits to @AlexW-GH)
+ - Add stream configuration to TermLogger
+ - Implement allow- and ignore-filtering (credits to @ryankurte)
 
 ## v0.5.3
-    - Fix minimal chrono version / update to chrono v0.4.1 (PR #27, credits to @samueltardieu)
+ - Fix minimal chrono version / update to chrono v0.4.1 (PR #27, credits to @samueltardieu)
 
 ## v0.5.2
-    - Don't interleave stdout and stderr (PR #23, credits to @hansjorg)
+ - Don't interleave stdout and stderr (PR #23, credits to @hansjorg)
 
 ## v0.5.1
-    - Updated `simplelog` to `log` 0.4.1
-    - Updated `simplelog` to `term` 0.5.1
-    - Fixed compiler warning about unused `#[macro_use]`
+ - Updated `simplelog` to `log` 0.4.1
+ - Updated `simplelog` to `term` 0.5.1
+ - Fixed compiler warning about unused `#[macro_use]`
 
 ## v0.5.0
-    - Update `simplelog` to `log` 0.4
+ - Update `simplelog` to `log` 0.4
 
 ## v0.4.4
-    - Fixed building non-default feature sets
+ - Fixed building non-default feature sets
 
 ## v0.4.3
-    - Publically export TermLogger Error type
+ - Publicly export TermLogger Error type
 
 ## v0.4.2
-    - Removed a debug println! statement
+ - Removed a debug println! statement
 
 ## v0.4.1
-    - Fix `None` config value
+ - Fix `None` config value
 
 ## v0.4.0
-    - `Config` is not using `LogLevelFilter` anymore but `Option<LogLevel>`
-        - `None` represents no logging of the `Config` parameter at all
-        - `LogLevelFilter::Off` was supposed to provide this feature, but is actually
-          ordered higher then `LogLevelFilter::Error`, and presents *no filtering* instead
-          of the incorrectly assumed *filter everything*.
+ - `Config` is not using `LogLevelFilter` anymore but `Option<LogLevel>`
+     - `None` represents no logging of the `Config` parameter at all
+     - `LogLevelFilter::Off` was supposed to provide this feature, but is actually
+       ordered higher then `LogLevelFilter::Error`, and presents *no filtering* instead
+       of the incorrectly assumed *filter everything*.
 
 ## v0.3.0
-    - Merged PullRequest by *Antoni Boucher* - Avoid unwrapping in `TermLogger`:
-        - `TermLogger::new` now returns an Option
-        - `TermLogger::init` now has its own ErrorType
-    - Move FileLogger to WriteLogger
-        - More generic, accepts not only `File`, but everything that implements `Write`
-    - Loggers now initialize with a `Config` struct, that list, what parts of the typical log message shall be printed, at which levels
-        - Migrate from `::init(level, ...)` to `::init(level, Config::default(), ...)`
-        - Migrate from `::new(level, ...)` or `::new(level, Config::default(), ...)`
-        - Exception: `CombinedLogger` has no use for its own `Config` and does not take the new argument
-        - Optionally use rust's `Default` syntax to override some settings
-            - E.g. always print location: `Config { location: LogLevelFilter::Error, ..Default::default() }`
-            - E.g. never print the target: `Config { target: LogLevelFilter::Off, ..Default::default() }`
-    - Target does now by default only log for Debug and lower
-    - Added CHANGELOG
-    - Removed some internal code duplication
+ - Merged PullRequest by *Antoni Boucher* - Avoid unwrapping in `TermLogger`:
+     - `TermLogger::new` now returns an Option
+     - `TermLogger::init` now has its own ErrorType
+ - Move FileLogger to WriteLogger
+     - More generic, accepts not only `File`, but everything that implements `Write`
+ - Loggers now initialize with a `Config` struct, that list, what parts of the typical log message shall be printed, at which levels
+     - Migrate from `::init(level, ...)` to `::init(level, Config::default(), ...)`
+     - Migrate from `::new(level, ...)` or `::new(level, Config::default(), ...)`
+     - Exception: `CombinedLogger` has no use for its own `Config` and does not take the new argument
+     - Optionally use rust's `Default` syntax to override some settings
+         - E.g. always print location: `Config { location: LogLevelFilter::Error, ..Default::default() }`
+         - E.g. never print the target: `Config { target: LogLevelFilter::Off, ..Default::default() }`
+ - Target does now by default only log for Debug and lower
+ - Added CHANGELOG
+ - Removed some internal code duplication
 
 ## v0.2.0
-    - Local changes that (accidentially) made it to crates.io, but not git
-        - Basically a worse version of *Antoni Boucher* 0.3.0 changes
-        - Got noticed, when he made a Pull Request
+ - Local changes that (accidentally) made it to crates.io, but not git
+     - Basically a worse version of *Antoni Boucher* 0.3.0 changes
+     - Got noticed, when he made a Pull Request
 
-    Sorry, what a mess. If you still have that version, here are the docs:
-        https://docs.rs/simplelog/0.2.0/
+ Sorry, what a mess. If you still have that version, here are the docs:
+     https://docs.rs/simplelog/0.2.0/
 
 ## v0.1.0
-    - Initial Release
+ - Initial Release

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "simplelog"
-version = "0.11.2"
+version = "0.12.0"
 edition = "2018"
 authors = ["Drakulix <github@drakulix.de>"]
 description = "A simple and easy-to-use logging facility for Rust's log crate"
@@ -20,11 +20,13 @@ include = [
 
 [features]
 test = []
-default = ["termcolor"]
+default = ["termcolor", "local-offset"]
+local-offset = ["time/local-offset"]
 
 [dependencies]
 log = { version = "0.4.*", features = ["std"] }
 termcolor = { version = "1.1.*", optional = true }
-paris = { version = "~1.5", optional = true }
+paris = { version = "~1.5.12", optional = true }
 ansi_term = { version = "0.12", optional = true }
-chrono = "0.4.1"
+time = { version = "0.3.11", optional = true, features = ["formatting", "macros"] }
+chrono = { version = "0.4.26", optional = true }

README.md

@@ -42,22 +42,22 @@ fn main() {
 ### Results in
 ```
 $ cargo run --example usage
-   Compiling simplelog v0.10.0 (file:///home/drakulix/Projects/simplelog)
+   Compiling simplelog v0.12.0 (file:///home/drakulix/Projects/simplelog)
      Running `target/debug/examples/usage`
 [ERROR] Bright red error
 ```
 and my_rust_binary.log
 ```
 11:13:03 [ERROR] usage: Bright red error
-11:13:03 [ INFO] usage: This only appears in the log file
+11:13:03 [INFO] usage: This only appears in the log file
 ```
 
 ## Getting Started
 
 Just add
 ```
 [dependencies]
-simplelog = "^0.10.0"
+simplelog = "^0.12.0"
 ```
 to your `Cargo.toml`
 

examples/custom_colors.rs

@@ -1,4 +1,4 @@
-#[cfg(all(feature = "termcolor", not(feature = "paris")))]
+#[cfg(feature = "termcolor")]
 use log::*;
 #[cfg(feature = "termcolor")]
 use simplelog::*;

examples/default_colors.rs

@@ -1,4 +1,4 @@
-#[cfg(all(feature = "termcolor", not(feature = "paris")))]
+#[cfg(feature = "termcolor")]
 use log::*;
 #[cfg(feature = "termcolor")]
 use simplelog::*;

examples/paris_demo/Cargo.toml

@@ -0,0 +1,9 @@
+[package]
+name = "paris_demo"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+simplelog = { path = "../../", features = ["paris"] }

examples/paris_demo/src/main.rs

@@ -0,0 +1,8 @@
+fn main() {
+    simplelog::TermLogger::init(simplelog::LevelFilter::Debug,
+                                simplelog::Config::default(),
+                                simplelog::TerminalMode::Mixed,
+                                simplelog::ColorChoice::Auto).expect("Failed to start simplelog");
+
+    simplelog::info!("I can write <b>bold</b> text or use tags to <red>color it</>");
+}

examples/rgb_colors.rs

@@ -1,8 +1,4 @@
-#[cfg(all(
-    not(target_family = "windows"),
-    feature = "termcolor",
-    not(feature = "paris")
-))]
+#[cfg(all(not(target_family = "windows"), feature = "termcolor"))]
 use log::*;
 #[cfg(all(not(target_family = "windows"), feature = "termcolor"))]
 use simplelog::*;

examples/usage.rs

@@ -1,4 +1,3 @@
-#[cfg(not(feature = "paris"))]
 use log::*;
 use simplelog::*;