technologic 0.23.5 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e95af55ae8ed97d20f8f816f4bcdeb670b32289083832981edab908413a925a3
-  data.tar.gz: 98a07d19ce8d32d64a25ab157e736ff8d46c94c2a8a59fb92363b1fb4250e235
+  metadata.gz: e333d0af1583653fced513daedb31e19418713c0caa7b4e43a901caa33424480
+  data.tar.gz: 8b65c9e69d6262921b46d54b98efedb8f5893e45574f5765f6226aa1a9685578
 SHA512:
-  metadata.gz: 5eeaddf8d01d9ef2dddf660199424c211ec976c105662c8d837feb21914da55772cdfd6cea321b27a8888697029622589bf4cd0345d3d737c591189d54a91a1a
-  data.tar.gz: e48185d476460aea42d2d32f9cce3540c337259a794b8a5a22de605cc8d1f69bacd8677fba235c23ed65a6f9c5d468105f0e8cf2dab608a81b356fa1e7e71af7
+  metadata.gz: c72e054a970b09029029ddbad1d0d20cc4f099b7e2cfd8e57d11a0724ef0455bdf918ba84c8515374d6ad2775ee47aa5716d3923c7e5b7f3b61d014c0ae1f68d
+  data.tar.gz: 90df5f8d297bb54d863121b19f1dec7d6dceff5a00ef64d5c30318364c11a3b5e4274763b1f74a01ad30af8fc5be699bd9fe379f459422ec2793c872416a0308

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.5"
+  VERSION = "0.25.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: technologic
 version: !ruby/object:Gem::Version
-  version: 0.23.5
+  version: 0.25.0
 platform: ruby
 authors:
 - Eric Garside
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-05 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.5
+        version: 0.25.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.23.5
+        version: 0.25.0
 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.5
+  documentation_uri: https://www.rubydoc.info/gems/technologic/0.25.0
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -103,8 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Logging system built on an extensible event triggering system requiring minimal