stenotype 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d77ba29ea50a26b7a8592149629d6a58368b56a615246ebaff36ade2a8a9f3a7
-  data.tar.gz: d519ef0ee071b97d6ff3dbed088f06b18826adbfdadcddaf89019c230b1aecb3
+  metadata.gz: 5f58226124306beb915f76259d055c013e197d24dee87513d751764486ce8033
+  data.tar.gz: eee031ad3b4f4b9d5b8ed8645e5d7f676f0490f1f9351cec516ffc72ef5b298a
 SHA512:
-  metadata.gz: b59b094ef4c1379a2771f78fef83639040fedc62a0a2d2fb9209c50060e2c96856ea26fd28090a5788a06c4d97942b78c954df1eba861d4fbdd07d675f91d60e
-  data.tar.gz: dfca37efc78a9063d8a239e27b2ed36a6b2ae981c330b072a2b3b43b46c9359323f4fd1ac790096c1458a38e860519ceb972f84ef9f9e12f2788b77d96c11709
+  metadata.gz: fe129ae49b3b255a02f1cadcc6920820348846d0b10dba93ab554322b545401a63c8bce7becd239502e9ff433b127e738ff612d4b1cc9903a0f32212ce68eda1
+  data.tar.gz: 275de1f70c2c0f4e9d608e79d93e773d75538b18a47c1f2848a7753bb6151b5f96a8ef7c74b36b3a462360de7be196a247d3be3429cfd7f1b00364691ae01a5e

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 *Release Date*: 2020/01/13
 
+### 0.1.7 2020/01/20
+* Adds a config option to allow explicit adapter setup.
+* Adds an `after_initialize` rails hook to setup adapters.
+* Remove topic from the list of Google Cloud adapter arguments.
+
+### 0.1.6 2020/01/17
+* Allow topic to be explicitly set upon Google Cloud adapter initialization
+
 ### 0.1.5 2020/01/13
 * In case `graceful_error_handling` is set to off raise a generic `Stenotype::Error` on any exception in order to intercept a single error type in the client code.
 * Adds an `at_exit` hook to flush the async message queue when using the library in async mode.

data/Gemfile.lock

@@ -96,7 +96,7 @@ GEM
       googleauth (~> 0.9)
       grpc (~> 1.24)
       rly (~> 0.2.3)
-    google-protobuf (3.11.1-universal-darwin)
+    google-protobuf (3.11.1)
     googleapis-common-protos (1.3.9)
       google-protobuf (~> 3.0)
       googleapis-common-protos-types (~> 1.0)
@@ -110,7 +110,7 @@ GEM
       multi_json (~> 1.11)
       os (>= 0.9, < 2.0)
       signet (~> 0.12)
-    grpc (1.25.0-universal-darwin)
+    grpc (1.25.0)
       google-protobuf (~> 3.8)
       googleapis-common-protos-types (~> 1.0)
     grpc-google-iam-v1 (0.6.9)

data/README.md

@@ -31,10 +31,11 @@ Stenotype.configure do |config|
     Stenotype::Adapters::GoogleCloud.new
   ]
 
-  config.uuid_generator          = SecureRandom
-  config.dispatcher              = Stenotype::Dispatcher.new
-  config.logger                  = Logger.new(STDOUT)
-  config.graceful_error_handling = true
+  config.uuid_generator               = SecureRandom
+  config.dispatcher                   = Stenotype::Dispatcher.new
+  config.logger                       = Logger.new(STDOUT)
+  config.graceful_error_handling      = true
+  config.auto_adapter_initialization  = true
 
   config.google_cloud do |gc_config|
     gc_config.project_id  = "google_cloud_project_id"
@@ -98,6 +99,10 @@ Allows to enable/disable Rails ActionController extension
 
 Allows to enable/disable Rails ActiveJob extension
 
+#### config.rails.auto_adapter_initialization
+
+Controls whether the hook `auto_initialize!` is run for each adapter. If set to true `auto_initialize!` is invoked for every adapter. If false `auto_initialize!` is not run. For example for google cloud adapter this will instantiate `client` and `topic` objects before first publish. If set to false `client` and `topic` are lazy initialized.
+
 #### Configuring context handlers
 
 Each event is emitted in a context which might be an ActionController instance or an ActiveJob instance or potentially any other place. Context handlers are implemented as plain ruby classes, so before using them you must register them. By default a plain `Class` handler is registered when not used with any framework. In case Ruby on Rails is used, then there are two additional context handlers for `ActionController` and `ActiveJob` instances.
@@ -228,6 +233,14 @@ class CustomAdapter < Stenotype::Adapters::Base
   def publish(event_data, **additional_arguments)
     # custom publishing logic
   end
+
+  def flush!
+    # actions to be taken to flush the messages
+  end
+
+  def auto_initialize!
+    # actions to be taken to setup internal adapter state (client, endpoint, whatsoever)
+  end
 end
 ```
 

data/lib/stenotype/adapters/base.rb

@@ -42,6 +42,14 @@ module Stenotype
               "#{self.class.name} must implement method #publish"
       end
 
+      #
+      # Allows custom setup of the adapter. Noop by default
+      # @abstract
+      #
+      def auto_initialize!
+        # noop by default
+      end
+
       #
       # This method is expected to be implemented by subclasses. In case async
       # publisher is used the process might end before the async queue of

data/lib/stenotype/adapters/google_cloud.rb

@@ -34,12 +34,6 @@ module Stenotype
     #   end
     #
     class GoogleCloud < Base
-      attr_reader :topic
-
-      def initialize(client: nil, topic: nil)
-        super(client: client)
-        @topic = topic
-      end
       #
       # @param event_data {Hash} The data to be published to Google Cloud
       # @raise {Stenotype::MessageNotPublishedError} unless message is published
@@ -72,6 +66,16 @@ module Stenotype
         topic.async_publisher.stop.wait!
       end
 
+      #
+      # If not called both client and topic are lazy initialized on first call (if not
+      # passed to #initialize). #auto_initialize! is going to explicitly initialize
+      # both client and topic.
+      #
+      def auto_initialize!
+        client
+        topic
+      end
+
       private
 
       def publish_sync(event_data, **additional_attrs)

data/lib/stenotype/at_exit.rb

@@ -1,8 +1,10 @@
-require 'stenotype'
+# frozen_string_literal: true
 
 # :nocov:
+require "stenotype"
+
 at_exit do
   targets = Stenotype.config.targets
   targets.each(&:flush!)
 end
-# :nocov:
+# :nocov:

data/lib/stenotype/configuration.rb

@@ -35,6 +35,9 @@ module Stenotype
     # @!attribute enabled
     # @return {true, false} a flag indicating whether event emission is enabled
 
+    # @!attribute auto_adapter_initialization
+    # @return {true, false} enables/disables lazy initialization of adapters' clients
+
     # @!attribute targets
     # @return {Array<#publish>} a list of targets responding to method [#publish]
 
@@ -59,7 +62,6 @@ module Stenotype
     # @!attribute [rw] google_cloud.async
     # @return [true, false] GC publish mode, either async if true, sync if false
 
-
     # @!attribute [rw] rails
     # @return [NestedConfiguration] Rails configuration.
 
@@ -87,6 +89,7 @@ module Stenotype
       nested :rails do
         option :enable_action_controller_ext, default: true
         option :enable_active_job_ext, default: true
+        option :auto_adapter_initialization, default: true
       end
     end
 
@@ -110,6 +113,7 @@ module Stenotype
     #
     def logger
       return config.logger if config.logger
+
       config.logger || Logger.new(STDOUT)
     end
 

data/lib/stenotype/event.rb

@@ -24,12 +24,12 @@ module Stenotype
         event = new(name, attributes, eval_context: eval_context, dispatcher: dispatcher)
         event.emit!
         event
-      rescue => error
+      rescue StandardError => exception
         #
         # @todo This is a temporary solution to enable conditional logger fetching
         #   needs a fix to use default Spicerack::Configuration functionality
         #
-        Stenotype::Configuration.logger.error(error)
+        Stenotype::Configuration.logger.error(exception)
 
         raise Stenotype::Error unless Stenotype.config.graceful_error_handling
       end
@@ -68,12 +68,12 @@ module Stenotype
 
       begin
         dispatcher.publish(self)
-      rescue => error
+      rescue StandardError => exception
         #
         # @todo This is a temporary solution to enable conditional logger fetching
         #   needs a fix to use default Spicerack::Configuration functionality
         #
-        Stenotype::Configuration.logger.error(error)
+        Stenotype::Configuration.logger.error(exception)
 
         raise Stenotype::Error unless Stenotype.config.graceful_error_handling
       end

data/lib/stenotype/railtie.rb

@@ -18,6 +18,8 @@ module Stenotype
 
     config.stenotype = Stenotype.config
 
+    config.after_initialize { config.stenotype.targets.each(&:auto_initialize!) } if config.stenotype.rails.auto_adapter_initialization
+
     if config.stenotype.rails.enable_action_controller_ext
       ActiveSupport.on_load(:action_controller) do
         Stenotype::ContextHandlers.register Stenotype::ContextHandlers::Rails::Controller

data/lib/stenotype/version.rb

@@ -2,6 +2,6 @@
 
 module Stenotype
   # :nodoc:
-  VERSION = "0.1.6"
+  VERSION = "0.1.7"
   # :nodoc:
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stenotype
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Roman Kapitonov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-01-17 00:00:00.000000000 Z
+date: 2020-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport