#log #log-format #format

macro no-std l0g-macros

proc-macros for l0g crate

1 stable release

1.0.0 Mar 21, 2024

#50 in #log-format

Download history 21/week @ 2024-07-18 16/week @ 2024-07-25 185/week @ 2024-08-01 210/week @ 2024-08-08 274/week @ 2024-08-15 135/week @ 2024-08-22 21/week @ 2024-08-29 10/week @ 2024-09-19 8/week @ 2024-09-26 24/week @ 2024-10-03 16/week @ 2024-10-10 42/week @ 2024-10-17 2/week @ 2024-10-31

63 downloads per month
Used in l0g

MIT license

6KB

l0g

Opinionated l0gging facade meant for the no_std libraries that are also sometimes used in a std context.

Overview

Logging facilities differ depending on the environment, especially between no_std and std. This facade allows to delegate the decision which l0gging implementation shall be used to the top-level application.

Any call to l0g::{error,warn,info,debug,trace} turns into a

  • noop when no feature is set
  • log::{error,warn,info,debug,trace} from the log crate when log feature is set
  • defmt::{error,warn,info,debug,trace} from the defmt crate when defmt feature is set

Moreover, proc-macro is provided to generalize over which formatting implementation should be used

#[l0g::format]
struct MyStruct {
    value: u8
}

turns into

#[derive(core::fmt::Debug)]
struct MyStruct {
    value: u8
}

if log feature is used or

#[derive(defmt::Format)]
struct MyStruct {
    value: u8
}

if defmt feature is used.

This allows a {:?} formatting to work, regardless of which logging implementation is chosen.

Usage

In the Cargo.toml of your libraries just say

l0g = "1"

In the no_std top-level application specify the dependency with the defmt feature. For how to make defmt work, take a look into its respective documentation.

l0g = { version = "1", features = ["defmt"] }

In the std top-level application specify the dependency with the log feature. For how to make log work, take a look into its respective documentation.

l0g = { version = "1", features = ["log"] }

Dependencies

~275–730KB
~17K SLoC