Default-library-logger

Create a LibraryLogger[ConsoleSink] from the current shared default console logger settings. This is the narrow library-facing counterpart to default_logger().

Interface

pub fn default_library_logger() -> LibraryLogger[ConsoleSink] {

output

• LibraryLogger[ConsoleSink] - Library-facing console logger built from the current shared defaults.

Explanation

Detailed rules explaining key parameters and behaviors

• This API wraps default_logger() as a library facade.
• Each call reflects the current shared default minimum level and default target at that moment.
• The returned facade wraps the same underlying Logger[ConsoleSink] value that default_logger() would produce directly at that moment.
• The returned value exposes the narrower LibraryLogger surface rather than the full Logger surface.
• Later changes to shared defaults do not mutate an already-created facade value because the wrapped logger is captured when default_library_logger() is called.
• Call default_library_logger() again after shared default changes if a fresh narrowed value should reflect the updated defaults.

How to Use

Here are some specific examples provided.

When Need A Default Logger But Want A Narrower Facade

When a library should adopt the shared console defaults without exposing the full logger type:

let logger = default_library_logger()
if logger.is_enabled(Level::Info) {
  logger.info("ready")
}

In this example, the library facade mirrors the current global defaults.

And if the caller later unwraps it with to_logger(), the same captured default target and minimum level are still present on the full logger value.

Error Case

e.g.:

• If the shared default target is empty, the returned logger is still valid.

• Later changes to shared defaults do not mutate an already-created facade value.

Notes

1. Use to_logger() if callers need the full sync logger surface.

2. This helper is useful for library-facing APIs that should stay narrower than Logger.

3. Call default_library_logger() again after shared default changes if a fresh facade value should reflect the new defaults.