browser_log 0.4.0

Advanced logging and panic handling for WebAssembly applications with browser console integration
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

//! This module introduces the `DebugLog` trait, which provides convenient shortcut methods
//! for logging the debug representation of any type that implements `fmt::Debug`.
//! It integrates with the `log` crate to offer logging at various levels.

/// Internal namespace for implementation details.
mod private
{
  // use crate::*;
  use ::log::Level;
  use core::fmt;

  /// A trait that provides convenience methods for logging the debug output of a struct.
  ///
  /// This trait is automatically implemented for any type that implements `fmt::Debug`,
  /// allowing for quick and easy logging without boilerplate code.
  pub trait DebugLog : fmt::Debug
  {
    /// Logs the debug representation of the object at a specified log level.
    #[inline]
    fn debug_log( &self, level : Level )
    {
      log::log!( level, "{self:#?}" );
    }

    /// Logs the debug representation of the object at the `trace` level.
    #[inline]
    fn debug_trace( &self )
    {
      log::trace!( "{self:#?}" );
    }

    /// Logs the debug representation of the object at the `info` level.
    #[inline]
    fn debug_info( &self )
    {
      log::info!( "{self:#?}" );
    }

    /// Logs the debug representation of the object at the `warn` level.
    #[inline]
    fn debug_warn( &self )
    {
      log::warn!( "{self:#?}" );
    }

    /// Logs the debug representation of the object at the `error` level.
    #[inline]
    fn debug_error( &self )
    {
      log::error!( "{self:#?}" );
    }
  }

  impl< T > DebugLog for T
  where
    T : fmt::Debug,
  {
  }
}

// This macro exposes the public interface of the module.
crate::mod_interface!
{
  /// Makes the `DebugLog` trait available for use.
  prelude use DebugLog;
}