debug_logging 4.0.0 → 4.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80eec636fd64a69b41aaf67704b79c784bc5ffa989e181c51106bc908bc645c8
-  data.tar.gz: 8feca3ec5aadd298bc0da9f75631834f4a16bd73aa9d39572c8caf72ec2834b4
+  metadata.gz: c5059baba71c02b6f460a6cc3badf9871441b16e926afe59636ad7ef2f8b907c
+  data.tar.gz: 9ac589b2e46cd7f439f45751c50404e09bf07f0cc2b5e9713b93d83338e2f5e6
 SHA512:
-  metadata.gz: bd13ad1dca5706140626730a48dc4e9133efc5e3db3d55f64b4c79f3a0bb21765d82a237c2a021d93ec2b4d0632d4a0a4bc5a3c28ef2bad088de9de37d6fdc3e
-  data.tar.gz: 9be10f369557ed872853e387870528c0a64df4981c854b3df6b27d22f0d24eac741d51e69beec9c6e6cfd2398748838d47ac5955df951d906d77378f60d4331a
+  metadata.gz: ed2fdd91670149c07f1ef0c118fda035b858b63cbe87d7d09000c18ab14f4133bf37a340ad11ec0c851be4bd2f1e2b807444a21b3bb002cdbaa6f8b9ddb6b17e
+  data.tar.gz: 41bedf5260a5e667d0dc6570987f26c05a66651638623e2cfddbaf132782e50067693d1f1bc9660808146456a06ab5e4c8f497de5555783e6aa073c5cabb811e

data/CHANGELOG.md

@@ -11,7 +11,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 ### Removed
 
-## [4.0.0] - unreleased
+## [4.0.2] ([tag][4.0.2t]) - 2024-05-12
+### Added
+- More documentation
+### Changed
+- DRY logic for `DebugLogging::ClassLogger` & `DebugLogging::InstanceLogger` via `LambDart`
+- Refactored test suite; increased test coverage to 97%
+- Refactored ActiveSupport::Notification integration (DRY)
+### Fixed
+- Add undeclared runtime dependency `version_gem`
+- `DebugLogging::Hooks` integration via `extend`
+- `DebugLogging::ClassNotifier` support for method signatures with kwargs
+- `error_handler_proc` support for method signatures with kwargs
+
+## [4.0.1] ([tag][4.0.1t]) - 2024-03-01
+### Added
+- Support for all Numeric types to be used as monotonic timestamps for ActiveSupport::Notifications
+- `time_formatter_proc` - used to format timestamp added to beginning of log lines
+- `add_timestamp` - Add timestamp to front of each log line
+### Changed
+- `DebugLogging::ArgumentPrinter.debug_time_to_s` => `DebugLogging::ArgumentPrinter.debug_event_time_to_s`
+### Fixed
+### Removed
+
+## [4.0.0] ([tag][4.0.0t]) - 2024-02-28
 ### Added
 - Class method DSL:
     - `logged`
@@ -30,57 +53,57 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for `include DebugLogging::InstanceLogger.new(...)`
 - Support for `include DebugLogging::InstanceNotifier.new(...)`
 
-## [3.1.9] - 2023-10-31
+## [3.1.9] ([tag][3.1.9t]) - 2023-10-31
 ### Fixed
 - Maximum Ruby version is 2.7. Versions 3.x are not compatible with Ruby >= 3
 
-## [3.1.8] - 2020-12-19
+## [3.1.8] ([tag][3.1.8t]) - 2020-12-19
 
-## [3.1.7] - 2020-12-19
+## [3.1.7] ([tag][3.1.7t]) - 2020-12-19
 
-## [3.1.6] - tagged, but unreleased
+## [3.1.6] ([tag][3.1.6t]) - tagged, but unreleased
 
-## [3.1.5] - 2020-12-18
+## [3.1.5] ([tag][3.1.5t]) - 2020-12-18
 
-## [3.1.4] - 2020-12-18
+## [3.1.4] ([tag][3.1.4t]) - 2020-12-18
 
-## [3.1.3] - 2020-12-18
+## [3.1.3] ([tag][3.1.3t]) - 2020-12-18
 
-## [3.1.2] - 2020-12-10
+## [3.1.2] ([tag][3.1.2t]) - 2020-12-10
 
-## [3.1.1] - 2020-12-09
+## [3.1.1] ([tag][3.1.1t]) - 2020-12-09
 
-## [3.1.0] - 2020-10-24
+## [3.1.0] ([tag][3.1.0t]) - 2020-10-24
 
-## [3.0.0] - 2020-10-07
+## [3.0.0] ([tag][3.0.0t]) - 2020-10-07
 
-## [2.0.0] - 2020-10-06
+## [2.0.0] ([tag][2.0.0t]) - 2020-10-06
 
-## [1.0.17] - 2018-09-10
+## [1.0.17] ([tag][1.0.17t]) - 2018-09-10
 
-## [1.0.16] - 2018-01-16
+## [1.0.16] ([tag][1.0.16t]) - 2018-01-16
 
-## [1.0.15] - 2017-10-17
+## [1.0.15] ([tag][1.0.15t]) - 2017-10-17
 
-## [1.0.14] - 2017-10-09
+## [1.0.14] ([tag][1.0.14t]) - 2017-10-09
 
-## [1.0.13] - 2017-10-08
+## [1.0.13] ([tag][1.0.13t]) - 2017-10-08
 
-## [1.0.12] - 2017-10-08
+## [1.0.12] ([tag][1.0.12t]) - 2017-10-08
 
-## [1.0.11] - 2017-10-06
+## [1.0.11] ([tag][1.0.11t]) - 2017-10-06
 
-## [1.0.10] - 2017-09-26
+## [1.0.10] ([tag][1.0.10t]) - 2017-09-26
 
-## [1.0.9] - 2017-09-06
+## [1.0.9] ([tag][1.0.9t]) - 2017-09-06
 
-## [1.0.8] - 2017-09-06
+## [1.0.8] ([tag][1.0.8t]) - 2017-09-06
 
-## [1.0.7] - 2017-09-06
+## [1.0.7] ([tag][1.0.7t]) - 2017-09-06
 
-## [1.0.6] - 2017-09-05
+## [1.0.6] ([tag][1.0.6t]) - 2017-09-05
 
-## [1.0.5] ([tag][1.0.1t]) - 2017-03-31
+## [1.0.5] ([tag][1.0.5t]) - 2017-03-31
 
 ## [1.0.4] ([tag][1.0.4t]) - 2017-03-31
 
@@ -95,7 +118,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] ([tag][0.1.0t]) - 2017-03-25
 - Initial release
 
-[Unreleased]: https://gitlab.com/kettle-rb/kettle-soup-cover/-/compare/v3.1.9...HEAD
+[Unreleased]: https://gitlab.com/kettle-rb/kettle-soup-cover/-/compare/v4.0.2...HEAD
+[4.0.2t]: https://gitlab.com/pboling/debug_logging/-/tags/v4.0.2
+[4.0.2]: https://gitlab.com/kettle-rb/kettle-soup-cover/-/compare/v4.0.1...v4.0.2
+[4.0.1t]: https://gitlab.com/pboling/debug_logging/-/tags/v4.0.1
+[4.0.1]: https://gitlab.com/kettle-rb/kettle-soup-cover/-/compare/v4.0.0...v4.0.1
+[4.0.0t]: https://gitlab.com/pboling/debug_logging/-/tags/v4.0.0
+[4.0.0]: https://gitlab.com/kettle-rb/kettle-soup-cover/-/compare/v3.1.9...v4.0.0
 [3.1.9t]: https://gitlab.com/pboling/debug_logging/-/tags/v3.1.9
 [3.1.9]: https://gitlab.com/kettle-rb/kettle-soup-cover/-/compare/v3.1.8...v3.1.9
 [3.1.8t]: https://gitlab.com/pboling/debug_logging/-/tags/v3.1.8

data/CONTRIBUTING.md

@@ -20,7 +20,7 @@ To release a new version:
 6. Run `git checkout main` (Or whichever branch is considered `trunk`, e.g. `master`)
 7. Run `git pull origin main` to ensure you will release the latest trunk code.
 8. Set `SOURCE_DATE_EPOCH` so `rake build` and `rake release` use same timestamp, and generate same checksums
-   a. Run `export SOURCE_DATE_EPOCH=$EPOCHSECONDS`
+   a. Run `export SOURCE_DATE_EPOCH=$EPOCHSECONDS && echo $SOURCE_DATE_EPOCH`
 9. Run `bundle exec rake build`
 10. Run [`bin/checksums`](https://github.com/rubygems/guides/pull/325) to create SHA-256 and SHA-512 checksums
    a. Checksums will be committed automatically by the script, but not pushed

data/README.md

@@ -60,7 +60,7 @@ Supports `ActiveSupport::Notifications` (thanks [@jgillson](https://github.com/j
 [✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=plastic&logo=angellist
 [🐦twitter]: http://twitter.com/intent/user?screen_name=galtzo
 [🐦twitter-img]: https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow%20@galtzo
-[🚎blog]: http://www.railsbling.com/tags/oauth2/
+[🚎blog]: http://www.railsbling.com/tags/debug_logging/
 [🚎blog-img]: https://img.shields.io/badge/blog-railsbling-brightgreen.svg?style=flat
 [my🧪lab]: https://gitlab.com/pboling
 [my🧊berg]: https://codeberg.org/pboling
@@ -82,6 +82,7 @@ Supports `ActiveSupport::Notifications` (thanks [@jgillson](https://github.com/j
 * *All configuration is inheritable to, and overridable by, child classes, since v3.1.3*
 * *[Class finalization hook](https://stackoverflow.com/a/34559282) (optional: `require 'debug_logging/finalize'` and `extend DebugLogging::Finalize`), since v3.1.3*
 * *Error handling hooks you can use to log problems when they happen, since v3.1.7*
+  * *Fixed: Works with benchmarking options since v4.0.2*
 * **so many free ponies** 🎠🐴🎠🐴🎠🐴
 
 ## Next Level Magic
@@ -89,7 +90,7 @@ Supports `ActiveSupport::Notifications` (thanks [@jgillson](https://github.com/j
 Herein you will find:
 
 * ~~Classes inheriting from Module~~ Refactored to use standard Modules and `prepend`!
-* Zero tolerance policy on monkey patching
+* Zero tolerance policy on global monkey patching
   * When the gem is loaded there are no monkey patches.
   * Rather, your own classes/methods get "patched" and "hooked" as you configure them.
 * 100% clean, 0% obtrusive
@@ -148,7 +149,7 @@ Recommend creating `config/initializers/debug_logging.rb`, or adding to `config/
 ```ruby
 # Showing the defaults
 DebugLogging.configuration.logger = Logger.new($stdout) # you probably want to override to be the Rails.logger, and if so you can't set it in the initializer, as it needs to be set after Rails.logger is set.
-DebugLogging.configuration.log_level = :debug # at what level do the messages created by this gem sent at?
+DebugLogging.configuration.log_level = :debug # at what level are the messages created by this gem sent at?
 DebugLogging.configuration.multiple_last_hashes = false # pass every hash argument to last_hash_to_s_proc?
 DebugLogging.configuration.last_hash_to_s_proc = nil # e.g. ->(hash) { "keys: #{hash.keys}" }
 DebugLogging.configuration.last_hash_max_length = 1_000
@@ -160,11 +161,13 @@ DebugLogging.configuration.active_support_notifications = false
 DebugLogging.configuration.colorized_chain_for_method = false # e.g. ->(colorized_string) { colorized_string.red.on_blue.underline }
 DebugLogging.configuration.colorized_chain_for_class = false # e.g. ->(colorized_string) { colorized_string.colorize(:light_blue ).colorize( :background => :red) }
 DebugLogging.configuration.add_invocation_id = true # identify a method call uniquely in a log, pass a proc for colorization, e.g. ->(colorized_string) { colorized_string.light_black }
+DebugLogging.configuration.time_formatter_proc = DebugLogging::Constants::DEFAULT_TIME_FORMATTER
+DebugLogging.configuration.add_timestamp = false
 DebugLogging.configuration.ellipsis = " ✂️ …".freeze
 DebugLogging.configuration.mark_scope_exit = true # Only has an effect if benchmarking is off, since benchmarking always marks the scope exit
 DebugLogging.configuration.add_payload = false # or a proc which will be called to print the payload
 DebugLogging.configuration.payload_max_length = 1000
-DebugLogging.configuration.error_handler_proc = nil # e.g. ->(error, config, obj, method_name, args) { config.log { "#{error.class}: #{error.message} in #{method_name}\nargs: #{args.inspect}" } }
+DebugLogging.configuration.error_handler_proc = nil # e.g. ->(error, config, obj, method_name, *args, **kwargs) { config.log { "#{error.class}: #{error.message} in #{method_name}\nargs: #{args.inspect}" } }
 ```
 
 If you prefer to use the block style:
@@ -183,12 +186,14 @@ DebugLogging.configure do |config|
   config.active_support_notifications = false
   config.colorized_chain_for_method = false # e.g. ->(colorized_string) { colorized_string.red.on_blue.underline }
   config.colorized_chain_for_class = false # e.g. ->(colorized_string) { colorized_string.colorize(:light_blue ).colorize( :background => :red) }
+  config.time_formatter_proc = DebugLogging::Constants::DEFAULT_TIME_FORMATTER
+  config.add_timestamp = false
   config.add_invocation_id = true # identify a method call uniquely in a log, pass a proc for colorization, e.g. ->(colorized_string) { colorized_string.light_black }
   config.ellipsis = " ✂️ …".freeze
   config.mark_scope_exit = true # Only has an effect if benchmarking is off, since benchmarking always marks the scope exit
   config.add_payload = false # or a proc which will be called to print the payload
   config.payload_max_length = 1000
-  config.error_handler_proc = nil # e.g. ->(error, config, obj, method_name, args) { config.log { "#{error.class}: #{error.message} in #{method_name}\nargs: #{args.inspect}" } }
+  config.error_handler_proc = nil # e.g. ->(error, config, obj, method_name, *args, **kwargs) { config.log { "#{error.class}: #{error.message} in #{method_name}\nargs: #{args.inspect}" } }
 end
 ```
 
@@ -208,7 +213,7 @@ Just send along a hash of the config options, similar to the following:
 
 See the example class below, and the specs.
 
-**NOTE ON** `Rails.logger` - It will probably be nil in your initializer, so setting the `config.logger` to `Rails.logger` there will result in setting it to `nil`, which means the default will end up being used: `Logger.new(STDOUT)`. Instead just config the logger in your application.rb, or anytime later, but *before your classes get loaded* and start inheriting the config:
+**NOTE ON** `Rails.logger` - It will probably be nil in your initializer, so setting the `config.logger` to `Rails.logger` there will result in setting it to `nil`, which means the default will end up being used: `Logger.new($stdout)`. Instead just config the logger in your application.rb, or anytime later, but *before your classes get loaded* and start inheriting the config:
 
 ```ruby
 DebugLogging.configuration.logger = Rails.logger
@@ -260,6 +265,7 @@ class Car
   logged :dealer_options, {
     something: "here", # <= will be logged, and available to last_hash_to_s_proc
     multiple_last_hashes: true, # <= Overrides config
+    error_handler_proc: nil, # NOTE: if you define the error_handler_proc inside a class like this you can use self inside the proc to refer to the class the method was called on!
   }
   def self.will_not_be_logged
     false
@@ -294,7 +300,28 @@ class Car
   # Override configuration options for any instance method(s), by passing a hash as the last argument
   # In the last hash any non-Configuration keys will be data that gets logged,
   #     and also made available to last_hash_to_s_proc
-  i_logged [:faster], {add_invocation_id: false}
+  # Here's an example that sets every possible option, while also showing what the default values are!
+  i_logged [:faster], {
+    logger: Logger.new($stdout), # probably want to override to be the Rails.logger
+    log_level: :debug, # at what level do the messages created by this gem sent at?
+    multiple_last_hashes: false,
+    last_hash_to_s_proc: nil, # e.g. ->(hash) { "keys: #{hash.keys}" }
+    last_hash_max_length: 1_000,
+    args_to_s_proc: nil, # e.g. ->(*record) { "record id: #{record.first.id}" }
+    args_max_length: 1_000,
+    colorized_chain_for_method: false, # e.g. ->(colorized_string) { colorized_string.red.on_blue.underline }
+    colorized_chain_for_class: false,  # e.g. ->(colorized_string) { colorized_string.colorize(:light_blue ).colorize( :background => :red) }
+    add_invocation_id: true, # allows unique identification of method call; association of entry and exit log lines
+    ellipsis: " ✂️ …".freeze,
+    mark_scope_exit: false,
+    add_payload: true, # Can also be a proc returning a string, which will be called when printing the payload
+    payload_max_length: 1_000,
+    error_handler_proc: nil, # NOTE: if you define the error_handler_proc inside a class like this you can use self inside the proc to refer to the instance of the class the method was called on!
+    time_formatter_proc: DebugLogging::Constants::DEFAULT_TIME_FORMATTER,
+    add_timestamp: false,
+    instance_benchmarks: false,
+    class_benchmarks: false,
+  }
 
   # You can also use `i_logged` as a true method decorator:
   i_logged def slower
@@ -414,8 +441,8 @@ end
 Run tests!
 
 ```shell
-bundle install
-bundle exec rake
+bin/setup
+bin/rake
 ```
 
 ## Contributing
@@ -486,13 +513,15 @@ See [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright
 [homepage]: https://github.com/pboling/debug_logging
 [blogpage]: http://www.railsbling.com/tags/debug_logging/
 
-[comment]: <> ( PERSONAL LINKS )
+[comment]: <> ( 💁🏼‍♂️ PERSONAL LINKS )
 
 [💁🏼‍♂️aboutme]: https://about.me/peter.boling
 [💁🏼‍♂️angellist]: https://angel.co/peter-boling
 [💁🏼‍♂️devto]: https://dev.to/galtzo
 [💁🏼‍♂️followme]: https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow
 [💁🏼‍♂️twitter]: http://twitter.com/galtzo
+[💁🏼‍♂️peterboling]: http://www.peterboling.com
+[💁🏼‍♂️railsbling]: http://www.railsbling.com
 
 [comment]: <> ( KEYED LINKS )
 

data/SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version | Supported |
 |---------|-----------|
-| 3.1.x   | ✅         |
-| 3.0.x   | ❌         |
+| 4.x     | ✅         |
+| 3.x     | ❌         |
 | 2.x     | ❌         |
 | 1.x     | ❌         |
 

data/lib/debug_logging/argument_printer.rb

@@ -7,11 +7,13 @@ module DebugLogging
       "completed in #{format("%f", tms.real)}s (#{format("%f", tms.total)}s CPU)"
     end
 
-    def debug_invocation_id_to_s(args: nil, kwargs: nil, config_proxy: nil)
+    def debug_invocation_id_to_s(args: nil, kwargs: nil, start_at: nil, config_proxy: nil)
       return "" unless (args || kwargs) && config_proxy
 
       if config_proxy.debug_add_invocation_id
-        invocation = " ~#{args.object_id}|#{kwargs.object_id}@#{(Time.now.to_f.to_s % "%#-21a")[4..-4]}~"
+        time = start_at ? Util.debug_time(start_at) : Time.now
+        unique_id = (time.to_f.to_s % "%#-21a")[4..-4]
+        invocation = " ~#{args.object_id}|#{kwargs.object_id}@#{unique_id}~"
         case config_proxy.debug_add_invocation_id
         when true
           invocation
@@ -23,24 +25,28 @@ module DebugLogging
       end
     end
 
-    def debug_time_to_s(time_or_monotonic)
+    # @return [String]
+    def debug_time_to_s(time_or_monotonic, config_proxy: nil)
+      return "" unless config_proxy&.debug_add_timestamp
+      return config_proxy.debug_time_formatter_proc.call(Time.now) unless time_or_monotonic
+
+      time = Util.debug_time(time_or_monotonic)
+
+      config_proxy.debug_time_formatter_proc.call(time)
+    end
+
+    # A custom time format will never apply here, because ActiveSupport::Notifications have a required time format
+    def debug_event_time_to_s(time_or_monotonic)
       # Time format must match:
       #   \d{4,}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} [-+]\d{4}
       #   YYYY-MM-DD HH:mm:ss +00:00
       #   strftime("%F %T %z")
-      case time_or_monotonic
-      when Float
-        Time.at(time_or_monotonic).strftime("%F %T %z")
-      when Time, DateTime
-        time_or_monotonic.strftime("%F %T %z")
-      when String
-        Time.parse(time_or_monotonic).strftime("%F %T %z")
-      else
-        time_or_monotonic
-      end
+      time_or_monotonic = Time.now if time_or_monotonic.nil? || (time_or_monotonic.respond_to?(:empty?) && time_or_monotonic.empty?)
+      time = Util.debug_time(time_or_monotonic)
+      DebugLogging::Constants::EVENT_TIME_FORMATTER.call(time)
     end
 
-    def debug_invocation_to_s(klass: nil, separator: nil, method_to_log: nil, config_proxy: nil)
+    def debug_invocation_to_s(klass: nil, separator: nil, decorated_method: nil, config_proxy: nil)
       return "" unless config_proxy
 
       klass_string = if config_proxy.debug_colorized_chain_for_class
@@ -49,9 +55,9 @@ module DebugLogging
         klass.to_s
       end
       method_string = if config_proxy.debug_colorized_chain_for_method
-        config_proxy.debug_colorized_chain_for_method.call(ColorizedString[method_to_log.to_s])
+        config_proxy.debug_colorized_chain_for_method.call(ColorizedString[decorated_method.to_s])
       else
-        method_to_log.to_s
+        decorated_method.to_s
       end
       "#{klass_string}#{separator}#{method_string}"
     end
@@ -63,7 +69,7 @@ module DebugLogging
 
       add_args_ellipsis = false
       args = args.dup
-      args.push(kwargs) if kwargs
+      args.push(kwargs) if kwargs&.keys && !kwargs&.keys&.length&.zero?
       if config_proxy.debug_last_hash_to_s_proc && args[-1].is_a?(Hash)
         add_other_args_ellipsis = false
         if args.length > 1
@@ -188,7 +194,7 @@ module DebugLogging
           proc_name: "add_payload",
           proc: config_proxy.debug_add_payload,
           args: payload,
-          max_length: config_proxy.payload_max_length,
+          max_length: config_proxy.debug_payload_max_length,
         )
         printed_payload += printed
         printed_payload += config_proxy.debug_ellipsis if add_payload_ellipsis
@@ -198,8 +204,8 @@ module DebugLogging
 
     module_function
 
-    def debug_event_name_to_s(method_to_notify: nil)
-      "#{method_to_notify}.log"
+    def debug_event_name_to_s(decorated_method: nil)
+      "#{decorated_method}.log"
     end
   end
 end

data/lib/debug_logging/class_logger.rb

@@ -1,72 +1,42 @@
 module DebugLogging
   module ClassLogger
+    class << self
+      def extended(base)
+        base.extend(LambDartable::Log)
+      end
+    end
+
     def logged(*methods_to_log)
       methods_to_log, payload, config_opts = DebugLogging::Util.extract_payload_and_config(
         method_names: methods_to_log,
         payload: nil,
         config: nil,
       )
-      Array(methods_to_log).each do |method_to_log|
-        method_to_log, method_payload, method_config_opts = DebugLogging::Util.extract_payload_and_config(
-          method_names: method_to_log,
+      Array(methods_to_log).each do |decorated_method|
+        decorated_method, method_payload, method_config_opts = DebugLogging::Util.extract_payload_and_config(
+          method_names: decorated_method,
           payload: payload,
           config: config_opts,
         )
-        original_method = method(method_to_log)
+        original_method = method(decorated_method)
         (class << self; self; end).class_eval do
-          define_method(method_to_log) do |*args, &block|
-            config_proxy = DebugLogging::Util.config_proxy_finder(
-              scope: self,
-              config_opts: method_config_opts,
-              method_name: method_to_log,
-              proxy_ref: "kl",
+          define_method(decorated_method) do |*args, **kwargs, &block|
+            lamb_dart = LambDart::Log.new(
+              klass: self,
+              method_config_opts:,
+              method_payload:,
+              args:,
+              kwargs:,
+              decorated_method:,
             )
-            method_return_value = nil
-            log_prefix = nil
-            invocation_id = nil
-            begin
-              config_proxy.log do
-                paydirt = DebugLogging::Util.payload_instance_variable_hydration(scope: self, payload: method_payload)
-                log_prefix = debug_invocation_to_s(
-                  klass: to_s,
-                  separator: "::",
-                  method_to_log: method_to_log,
-                  config_proxy: config_proxy,
-                )
-                invocation_id = debug_invocation_id_to_s(args: args, config_proxy: config_proxy)
-                signature = debug_signature_to_s(args: args, config_proxy: config_proxy)
-                paymud = debug_payload_to_s(payload: paydirt, config_proxy: config_proxy)
-                "#{log_prefix}#{signature}#{invocation_id} debug: #{paymud}"
-              end
-              if config_proxy.benchmarkable_for?(:debug_class_benchmarks)
-                tms = Benchmark.measure do
-                  method_return_value = if args.size == 1 && (harsh = args[0]) && harsh.is_a?(Hash)
-                    original_method.call(**harsh, &block)
-                  else
-                    original_method.call(*args, &block)
-                  end
-                end
-                config_proxy.log do
-                  "#{log_prefix} #{debug_benchmark_to_s(tms: tms)}#{invocation_id}"
-                end
-              else
-                method_return_value = if args.size == 1 && (harsh = args[0]) && harsh.is_a?(Hash)
-                  original_method.call(**harsh, &block)
-                else
-                  original_method.call(*args, &block)
-                end
-                if config_proxy.exit_scope_markable? && invocation_id && !invocation_id.empty?
-                  config_proxy.log do
-                    "#{log_prefix} completed#{invocation_id}"
-                  end
-                end
-              end
-              method_return_value
-            rescue StandardError => e
-              if config_proxy.error_handler_proc
-                config_proxy.error_handler_proc.call(config_proxy, e, self, method_to_log, args)
-              else
-                raise e
+            real_mccoy = ->() {
+              original_method.call(*args, **kwargs, &block)
+            }
+            _dl_ld_enter_log(lamb_dart) do
+              _dl_ld_error_handle(lamb_dart) do
+                return _dl_ld_benchmarked(lamb_dart) { real_mccoy.call } if lamb_dart.bench?
+
+                _dl_ld_exit_log(lamb_dart) { real_mccoy.call }
               end
             end
           end

data/lib/debug_logging/class_notifier.rb

@@ -1,53 +1,37 @@
 module DebugLogging
   module ClassNotifier
+    class << self
+      def extended(base)
+        base.extend(LambDartable::Note)
+      end
+    end
+
     def notified(*methods_to_notify)
       methods_to_notify, payload, config_opts = DebugLogging::Util.extract_payload_and_config(
         method_names: methods_to_notify,
         payload: nil,
         config: nil,
       )
-      Array(methods_to_notify).each do |method_to_notify|
-        method_to_notify, method_payload, method_config_opts = DebugLogging::Util.extract_payload_and_config(
-          method_names: method_to_notify,
+      Array(methods_to_notify).each do |decorated_method|
+        decorated_method, method_payload, method_config_opts = DebugLogging::Util.extract_payload_and_config(
+          method_names: decorated_method,
           payload: payload,
           config: config_opts,
         )
-        original_method = method(method_to_notify)
+        original_method = method(decorated_method)
         (class << self; self; end).class_eval do
-          define_method(method_to_notify) do |*args, &block|
-            config_proxy = DebugLogging::Util.config_proxy_finder(
-              scope: self,
-              config_opts: method_config_opts,
-              method_name: method_to_notify,
-              proxy_ref: "kn",
-            ) do |proxy|
-              ActiveSupport::Notifications.subscribe(
-                DebugLogging::ArgumentPrinter.debug_event_name_to_s(method_to_notify: method_to_notify),
-              ) do |*debug_args|
-                proxy.log do
-                  DebugLogging::LogSubscriber.log_event(ActiveSupport::Notifications::Event.new(*debug_args))
-                end
-              end
-            end
-            paydirt = DebugLogging::Util.payload_instance_variable_hydration(scope: self, payload: method_payload)
-            ActiveSupport::Notifications.instrument(
-              DebugLogging::ArgumentPrinter.debug_event_name_to_s(method_to_notify: method_to_notify),
-              {
-                debug_args: args,
-                config_proxy: config_proxy,
-                **paydirt,
-              },
-            ) do
-              if args.size == 1 && (harsh = args[0]) && harsh.is_a?(Hash)
-                original_method.call(**harsh, &block)
-              else
-                original_method.call(*args, &block)
-              end
-            rescue StandardError => e
-              if config_proxy.error_handler_proc
-                config_proxy.error_handler_proc.call(config_proxy, e, self, method_to_notify, args)
-              else
-                raise e
+          define_method(decorated_method) do |*args, **kwargs, &block|
+            lamb_dart = LambDart::Note.new(
+              klass: self,
+              method_config_opts:,
+              method_payload:,
+              args:,
+              kwargs:,
+              decorated_method:,
+            )
+            _dl_ld_notify(lamb_dart) do
+              _dl_ld_error_handle(lamb_dart) do
+                original_method.call(*args, **kwargs, &block)
               end
             end
           end

data/lib/debug_logging/configuration.rb

@@ -12,16 +12,25 @@ module DebugLogging
     #     extend DebugLogging::InstanceLogger
     #     i_logged [:drive, :stop],
     #       {
-    #         logger: Logger.new(STDOUT) # probably want to override to be the Rails.logger
-    #         log_level: :debug # at what level do the messages created by this gem sent at?
-    #         last_hash_to_s_proc: nil # e.g. ->(hash) { "keys: #{hash.keys}" }
-    #         last_hash_max_length: 1_000
-    #         args_to_s_proc: nil # e.g. ->(*record) { "record id: #{record.first.id}" }
-    #         args_max_length: 1_000
-    #         instance_benchmarks: false
-    #         class_benchmarks: false
-    #         add_invocation_id: true # invocation id allows you to identify a method call uniquely in a log
-    #         ellipsis: " ✂️ …".freeze
+    #         logger: Logger.new($stdout), # probably want to override to be the Rails.logger
+    #         log_level: :debug, # at what level do the messages created by this gem sent at?
+    #         multiple_last_hashes: false,
+    #         last_hash_to_s_proc: nil, # e.g. ->(hash) { "keys: #{hash.keys}" }
+    #         last_hash_max_length: 1_000,
+    #         args_to_s_proc: nil, # e.g. ->(*record) { "record id: #{record.first.id}" }
+    #         args_max_length: 1_000,
+    #         colorized_chain_for_method: false, # e.g. ->(colorized_string) { colorized_string.red.on_blue.underline }
+    #         colorized_chain_for_class: false,  # e.g. ->(colorized_string) { colorized_string.colorize(:light_blue ).colorize( :background => :red) }
+    #         add_invocation_id: true, # allows unique identification of method call; association of entry and exit log lines
+    #         ellipsis: " ✂️ …".freeze,
+    #         mark_scope_exit: false,
+    #         add_payload: true, # Can also be a proc returning a string, which will be called when printing the payload
+    #         payload_max_length: 1_000,
+    #         error_handler_proc: nil,
+    #         time_formatter_proc: DebugLogging::Constants::DEFAULT_TIME_FORMATTER,
+    #         add_timestamp: false,
+    #         instance_benchmarks: false,
+    #         class_benchmarks: false,
     #       }
     #
     CONFIG_KEYS.each do |key|
@@ -29,11 +38,11 @@ module DebugLogging
     end
 
     class << self
-      def config_pointer(type, method_to_log)
+      def config_pointer(type, decorated_method)
         # Methods names that do not match the following regex can't be part of an ivar name
         #   /[a-zA-Z_][a-zA-Z0-9_]*/
         # Thus we have to use a different form of the method name that is compatible with ivar name conventions
-        "@debug_logging_config_#{type}_#{Digest::MD5.hexdigest(method_to_log.to_s)}".to_sym
+        "@debug_logging_config_#{type}_#{Digest::MD5.hexdigest(decorated_method.to_s)}".to_sym
       end
     end