Merge pull request #39 from qorix-group/arkjedrz_mw-log-subscriber

log: Rust-based backend implementation

Author: pawelrutkaq

Cargo.lock

@@ -20,14 +20,17 @@ default-members = [
     "src/log/mw_log",
     "src/log/mw_log_fmt",
     "src/log/mw_log_fmt_macro",
+    "src/log/stdout_logger",
 ]
 # Include tests and examples as a member for IDE support and Bazel builds.
 members = [
     "src/containers",
     "src/log/mw_log",
     "src/log/mw_log_fmt",
     "src/log/mw_log_fmt_macro",
-    "examples/log_example",
+    "src/log/stdout_logger",
+    "examples/log_builtin",
+    "examples/log_custom",
 ]
 
 [workspace.package]
@@ -40,6 +43,7 @@ authors = ["S-CORE Contributors"]
 mw_log = { path = "src/log/mw_log" }
 mw_log_fmt = { path = "src/log/mw_log_fmt" }
 mw_log_fmt_macro = { path = "src/log/mw_log_fmt_macro" }
+stdout_logger = { path = "src/log/stdout_logger" }
 
 [workspace.lints.clippy]
 std_instead_of_core = "warn"

Cargo.toml

@@ -0,0 +1,23 @@
+# *******************************************************************************
+# Copyright (c) 2025 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+
+load("@rules_rust//rust:defs.bzl", "rust_binary")
+
+rust_binary(
+    name = "log_builtin",
+    srcs = glob(["src/**/*.rs"]),
+    deps = [
+        "//src/log/mw_log",
+        "//src/log/stdout_logger",
+    ],
+)

examples/log_builtin/BUILD

@@ -0,0 +1,12 @@
+[package]
+name = "log_builtin"
+version.workspace = true
+authors.workspace = true
+edition.workspace = true
+
+[dependencies]
+mw_log.workspace = true
+stdout_logger.workspace = true
+
+[lints]
+workspace = true

examples/log_builtin/Cargo.toml

@@ -0,0 +1,44 @@
+//
+// Copyright (c) 2025 Contributors to the Eclipse Foundation
+//
+// See the NOTICE file(s) distributed with this work for additional
+// information regarding copyright ownership.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Apache License Version 2.0 which is available at
+// <https://www.apache.org/licenses/LICENSE-2.0>
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+
+//! Example app utilizing built-in backend implementation.
+
+use mw_log::{debug, error, fatal, info, trace, warn, LevelFilter};
+use stdout_logger::StdoutLoggerBuilder;
+
+fn main() {
+    // Initialize logger.
+    StdoutLoggerBuilder::new()
+        .context("EXAMPLE")
+        .show_module(true)
+        .show_file(true)
+        .show_line(true)
+        .log_level(LevelFilter::Info)
+        .set_as_default_logger();
+
+    // Example logs.
+    trace!("trace log - hidden!");
+    debug!("debug log - hidden!");
+    info!("info log");
+    warn!("warn log");
+    error!("error log");
+    fatal!("fatal log");
+
+    // Logs with changed context.
+    trace!(context: "CHANGED", "trace log - hidden!");
+    debug!(context: "CHANGED", "debug log - hidden!");
+    info!(context: "CHANGED", "info log");
+    warn!(context: "CHANGED", "warn log");
+    error!(context: "CHANGED", "error log");
+    fatal!(context: "CHANGED", "fatal log");
+}

examples/log_builtin/src/main.rs

@@ -14,7 +14,7 @@
 load("@rules_rust//rust:defs.bzl", "rust_binary")
 
 rust_binary(
-    name = "log_example",
+    name = "log_custom",
     srcs = glob(["src/**/*.rs"]),
     deps = [
         "//src/log/mw_log",

examples/log_example/BUILD examples/log_custom/BUILDexamples/log_example/BUILD renamed to examples/log_custom/BUILD

@@ -12,7 +12,7 @@
 # *******************************************************************************
 
 [package]
-name = "log_example"
+name = "log_custom"
 version.workspace = true
 authors.workspace = true
 edition.workspace = true

examples/log_example/Cargo.toml examples/log_custom/Cargo.tomlexamples/log_example/Cargo.toml renamed to examples/log_custom/Cargo.toml

@@ -21,9 +21,8 @@ use mw_log::{debug, error, fatal, info, trace, warn, LevelFilter};
 fn main() {
     // Initialize logger.
     mw_log::set_max_level(LevelFilter::Info);
-    let result = mw_log::set_global_logger(Box::new(ExampleLogger));
-    if result.is_err() {
-        panic!("unable to set logger")
+    if let Err(e) = mw_log::set_global_logger(Box::new(ExampleLogger)) {
+        panic!("unable to set logger: {e}");
     }
 
     // Example logs.

examples/log_example/src/logger.rs examples/log_custom/src/logger.rsexamples/log_example/src/logger.rs renamed to examples/log_custom/src/logger.rs

@@ -311,6 +311,11 @@ pub trait Log: Sync + Send {
     fn context(&self) -> &str;
 
     /// Logs the [`Record`].
+    ///
+    /// # For implementors
+    ///
+    /// Note that [`Log::enabled`] is *not* necessarily called before this method.
+    /// Implementations should perform all necessary filtering internally.
     fn log(&self, record: &Record);
 
     /// Flushes any buffered records.