oslog

Crates.iooslog
lib.rsoslog
version0.2.0
sourcesrc
created_at2020-05-14 20:34:40.579128
updated_at2022-02-17 13:37:46.799444
descriptionA minimal safe wrapper around Apple's Logging system
homepage
repositoryhttps://github.com/steven-joruk/oslog
max_upload_size
id241643
size16,843
Steven Joruk (steven-joruk)

documentation

README

Crate

A minimal wrapper around Apple's unified logging system.

By default support for the log crate is provided, but if you would prefer just to use the lower level bindings you can disable the default features.

When making use of targets (info!(target: "t", "m");), you should be aware that a new log is allocated and stored in a map for the lifetime of the program. I expect log allocations are extremely small, but haven't attempted to verify it.

Logging example

This is behind the logger feature flag and is enabled by default.

fn main() {
    OsLogger::new("com.example.test")
        .level_filter(LevelFilter::Debug)
        .category_level_filter("Settings", LevelFilter::Trace)
        .init()
        .unwrap();

    // Maps to OS_LOG_TYPE_DEBUG
    trace!(target: "Settings", "Trace");

    // Maps to OS_LOG_TYPE_INFO
    debug!("Debug");

    // Maps to OS_LOG_TYPE_DEFAULT
    info!(target: "Parsing", "Info");

    // Maps to OS_LOG_TYPE_ERROR
    warn!("Warn");

    // Maps to OS_LOG_TYPE_FAULT
    error!("Error");
}

Missing features

  • Activities
  • Tracing
  • Native support for line numbers and file names.
Commit count: 21

cargo fmt