Skip to content

A `log::Log` implementation for WASM components backed by the `wasi:logging/logging` WIT interface.

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

juntyr/wasi-logger

Repository files navigation

CI Status MSRV Latest Version Rust Doc Crate Rust Doc Main

wasi-logger

wasi-logger provides a Logger implementing the log::Log logging API, which is backed by the wasi:logging/logging WIT interface.

Usage

To use the Logger as a logger, it first needs to be installed once in the top-level WASM component using Logger::install, e.g. in a main function, a ctor, or using a std::sync::OnceLock. Remember to also set the global logging max level using log::set_max_level to ensure that log entries created with log::log! and others are actually recorded.

#[macro_use]
extern crate log;

extern crate wasi_logger;

fn main() {
    wasi_logger::Logger::install().expect("failed to install wasi_logger::Logger");
    log::set_max_level(log::LevelFilter::Info);

    error!("Something went really wrong with {x} / {y}", x=42, y=0);
    info!(target: "my-target", "This is good to know and has a custom target");
    debug!("This message is not recorded as the trace level is currently disabled");
}

Features

  • The kv feature transitively enables log/kv and includes the key-value pairs in a log record in the log message.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Funding

wasi-logger has been developed as part of ESiWACE3, the third phase of the Centre of Excellence in Simulation of Weather and Climate in Europe.

Funded by the European Union. This work has received funding from the European High Performance Computing Joint Undertaking (JU) under grant agreement No 101093054.

About

A `log::Log` implementation for WASM components backed by the `wasi:logging/logging` WIT interface.

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Languages