technologic 0.23.6 → 0.25.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e2555a534bf3ddf34969d3481a984b2f1edb65290afeaa7320cc468bd414ae1
-  data.tar.gz: 2077f2bf684c77db114a4170478d0e133b0c9b56a6884f67d5f727a464160661
+  metadata.gz: 235ef4113251dd4e7af4aa97d8048ffe017e27b70e6a0052bf9f9371bfd99a0a
+  data.tar.gz: 39c501d0a9ddbc770958c5dc3ea1caeaad60e70bf85a5c9f92c3f9da070a5978
 SHA512:
-  metadata.gz: 678a0a08cff447e4162d98c4e89e14467f5a2c246939ef413005ae89132af4d9518a8504f286f0f8c59191f743e248138b8d61e7ada26ed4439a97ccd015a87a
-  data.tar.gz: 8c1a7053c7bc916cd55f422ffad965a25fec8b5dff67233a1e360b885deb729c9c323eb2c90a9d9b3c5070c3ba2965ac169a58bdfd14fd36c6524542e3d8acdf
+  metadata.gz: 4d41e9dddbf5c37c730ec4e4ff3120e7bc78e25524ab6f89f92402a4d168ff932eaf5b7b421d8e67cd1348febb03da9ec8c4e5b7946077f3e01ab37567be443d
+  data.tar.gz: 773014349cfbfc35fd0cc00823584956aefae5c1597f58f36fb1c2065ea354b612fdd2b889277f14c0b342d50c81ffe5847983ec3d5ebc8034733b21788db9cf

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.6"
+  VERSION = "0.25.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: technologic
 version: !ruby/object:Gem::Version
-  version: 0.23.6
+  version: 0.25.1
 platform: ruby
 authors:
 - Eric Garside
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-14 00:00:00.000000000 Z
+date: 2020-10-13 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.6
+        version: 0.25.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.23.6
+        version: 0.25.1
 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.6
+  documentation_uri: https://www.rubydoc.info/gems/technologic/0.25.1
 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.0.3
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Logging system built on an extensible event triggering system requiring minimal