technologic 0.23.7 → 0.25.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c9753c2c1bee55de0e812e4757d95e6a6cb9bcfb0358c6d0d9f77afa8839eb4
-  data.tar.gz: dd1c0abe366994853b6a1a51c81ce05e89bbfdab71a9cd863f0887ebf33de3b6
+  metadata.gz: 963a8a4e9bd65397546fdf836975388005ae17bb07aa1d2debf6931f5d5fb70e
+  data.tar.gz: 4a2beee34bcffd776b5c8e243853d7b3ddb343be9a61616183614b5ef3ce061a
 SHA512:
-  metadata.gz: 11ba16c1bf6bf62b06e80c1213b77e59c3ff64f7bed92bcff51102dd808af03cbe0642c528846f0ee0f9d578f1917cba6fd035669a40b2f7d2d5684f7eb951b6
-  data.tar.gz: be32bc2dc631d436efee377e3af50e74d8d45b0e9050f0756292a71336f2dbda7995bcb33d440d355c9bcbf80502cad9a403bfb8137a5f1bf1a7f755a65fbb29
+  metadata.gz: 393b0f65f6db28ce7ba2df74d44ef0295b2f294e55aab62657e72796bca62a1b2b4667aa69ae9b74e0c17117fd6eff020b42c49b88c9a5bc90b50460cb7ae39e
+  data.tar.gz: a47641269f0fbb1a7e791f0018ef81a4f0a36a58bda5b04c4c93fa4ebd991934ac04bb220f9d66790372accb79747c8c1f590ce135cd16c542c17f32d3052404

data/README.md

@@ -53,6 +53,40 @@ error :email_for_user_does_not_exist, user_id: @user.email
 fatal :it_is_going_to_be_a_long_day, need_to_know: info_dump
 ```
 
+If given a block, these methods will include the runtime duration of the given block after the code is evaluated:
+```ruby
+info :something_happening_in_here, extra_data: "I really need this data" do
+  sleep 0.5
+  puts "Important things happening here!"
+end
+
+# Results in:
+
+Important things happening here!
+{"extra_data":"I really need this data","event":"something_happening_in_here.Object","duration":503.745,"@timestamp":"2020-07-27T20:05:06.355-04:00","@version":"1","severity":"INFO","host":"localhost"}
+```
+
+### Configuration
+
+_TODO: Improve me_
+
+* `log_duration_in_ms` - Boolean; default: false
+  
+  By default, Technologic will log duration as a float in seconds. To log duration as milliseconds instead, set it in your application config:
+    
+  ```ruby
+  # Rails app - in application.rb
+  Rails.application.configure do |config|
+    ...
+    technologic.log_duration_in_ms = true
+  end
+  
+  # For a plain ol' Ruby app with no Railties:
+  Technologic::ConfigOptions.log_duration_in_ms = true
+  ```
+  
+  **NOTE:** In a future version of Technologic, the default will change from `false` to `true`
+
 ## Development
 
 Consult Spicerack's [development instructions](../README.md#development) for more info.

data/lib/technologic/config_options.rb

@@ -2,6 +2,8 @@
 
 module Technologic
   class ConfigOptions
+    include AroundTheWorld
+
     class_attribute :enabled, default: true
 
     class_attribute :subscribe_to_fatal, default: true
@@ -15,5 +17,22 @@ module Technologic
     class_attribute :log_warn_events, default: true
     class_attribute :log_info_events, default: true
     class_attribute :log_debug_events, default: true
+
+    class_attribute :log_duration_in_ms, default: false
+
+    # TODO: Remove with duration-as-seconds deprecation
+    class << self
+      around_method :log_duration_in_ms= do |*args|
+        super(*args).tap do
+          @_log_duration_in_ms_set_explicitly = true
+        end
+      end
+
+      private
+
+      def log_duration_in_ms_set_explicitly?
+        !!@_log_duration_in_ms_set_explicitly
+      end
+    end
   end
 end

data/lib/technologic/event.rb

@@ -4,6 +4,8 @@ module Technologic
   class Event
     include ShortCircuIt
 
+    LOGGABLE_DURATION_THRESHOLD_MS = 0.04
+
     attr_reader :name, :duration
 
     def initialize(name, started, finished, payload)
@@ -13,10 +15,12 @@ module Technologic
     end
 
     def data
+      duration_in_ms = duration * 1000
+
       {}.tap do |hash|
         hash.merge!(@payload)
         hash[:event] = name
-        hash[:duration] = duration if duration.round > 0
+        hash[:duration] = ConfigOptions.log_duration_in_ms ? duration_in_ms : duration if duration_in_ms > LOGGABLE_DURATION_THRESHOLD_MS
       end
     end
     memoize :data

data/lib/technologic/setup.rb

@@ -8,6 +8,7 @@ module Technologic
 
         setup_subscribers(technologic_config)
         setup_loggers(technologic_config)
+        warn_duration_unit_not_set(technologic_config)
       end
 
       private
@@ -27,6 +28,12 @@ module Technologic
         Technologic::InfoSubscriber.on_event { |e| Technologic::Logger.log(:info, e) } if config.log_info_events
         Technologic::DebugSubscriber.on_event { |e| Technologic::Logger.log(:debug, e) } if config.log_debug_events
       end
+
+      def warn_duration_unit_not_set(config)
+        return if config.__send__(:log_duration_in_ms_set_explicitly?)
+
+        warn "WARNING: Technologic.log_duration_in_ms is not set. In a future version of Technologic, the default value will change from false to true. To maintain existing behavior, set `application.config.technologic.log_duration_in_ms = false` explicitly."
+      end
     end
   end
 end

data/lib/technologic/version.rb

@@ -2,5 +2,5 @@
 
 module Technologic
   # This constant is managed by spicerack
-  VERSION = "0.23.7"
+  VERSION = "0.25.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: technologic
 version: !ruby/object:Gem::Version
-  version: 0.23.7
+  version: 0.25.2
 platform: ruby
 authors:
 - Eric Garside
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-14 00:00:00.000000000 Z
+date: 2020-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.23.7
+        version: 0.25.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.23.7
+        version: 0.25.2
 description: A clean and terse way to produce standardized, highly actionable, and
   data-rich logs
 email:
@@ -87,7 +87,7 @@ metadata:
   homepage_uri: https://github.com/Freshly/spicerack/tree/master/technologic
   source_code_uri: https://github.com/Freshly/spicerack/tree/master/technologic
   changelog_uri: https://github.com/Freshly/spicerack/blob/master/technologic/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/technologic/0.23.7
+  documentation_uri: https://www.rubydoc.info/gems/technologic/0.25.2
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -103,7 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Logging system built on an extensible event triggering system requiring minimal