stenotype 0.1.5 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 78f28a1322b09dc099de1351779e15e67247ad5010c907b0cf99efb05e9c3ca4
-  data.tar.gz: 949901992d1c976941ca306154f546292bbd7f0df0bcb21a27a4458daa0dcd59
+  metadata.gz: fd4b1f727ef1c544ff5df02cc9162f69831e27105e89095d0b6b533cdddb0e05
+  data.tar.gz: 0ae2c31943e14b6752fe418afd9bbb031622bbf7119b69381529ee9620b93226
 SHA512:
-  metadata.gz: 18e3d0ea81fc68afbe99cf5da1569e2c87c1819c30430fcc1f23c23b6cb201767cf35885d7d2a643ac3bf284b8ee00d5e26644a08ab0ace902b863fff4f0527e
-  data.tar.gz: 63a868b627122e6c46f6b920b6b237f2fa7c88c1827ef7946e226868644a80e43a0c4c9a89e66dfec4909ca54bc53cc7b5c534bf8a9972621016521ffb1faeab
+  metadata.gz: 25753465eeeb0b876f72e548e81e2707bb12080aba5fbaa531db8d9ac1d4006f8bd0e9a83692d1996b2b7fed9b2f392c70748a89752ec24b5e524f559909e002
+  data.tar.gz: 0deacdeb626e43e3415fb398098f864ec2337b50642cae156e928839a307dbbafd9f23e828c7f94367af0ea809910e1a7b645799853ed76d268755357bdf2aba

data/.github/workflows/rspec.yml

@@ -0,0 +1,41 @@
+name: RSpec
+
+on: push
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby:
+        - "2.6.x"
+        rails:
+        - "5.2.0"
+        - "6.0.0"
+
+    steps:
+    - uses: actions/checkout@v1
+    - uses: actions/cache@v1
+      with:
+        path: vendor/bundle
+        key: ${{ runner.os }}-gems-${{ matrix.ruby }}-${{ matrix.rails }}-${{ hashFiles('**/Gemfile.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-gems-${{ matrix.ruby }}-${{ matrix.rails }}
+    - name: Set up Ruby ${{ matrix.ruby }}
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - name: Apply Rails ${{ matrix.rails }} dependencies
+      run: |
+        echo "gem 'rails', '~> ${{ matrix.rails }}'" >> Gemfile
+    - name: Set up dependencies
+      env:
+          BUNDLE_GEM__FURY__IO: ${{ secrets.GEMFURY_DEPLOY_TOKEN }}
+      run: |
+        gem install bundler
+        bundle config path vendor/bundle
+        bundle update rails --jobs 4 --retry 3
+        bundle install --jobs 4 --retry 3
+    - name: Run RSpec
+      run: |
+        bundle exec rspec

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 *Release Date*: 2020/01/13
 
+### 0.1.10
+Switch from Spicerack::Configurable to Spicerack::Directive
+
+### 0.1.9
+* Pass all attributes in the data field instead of attributes field for google cloud. Attributes field did not allow nested objects, which data field allows. See google pub sub documentation for more reference.
+
+### 0.1.8
+* Switch auto target initialization to false
+
+### 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

@@ -1,10 +1,10 @@
 PATH
   remote: .
   specs:
-    stenotype (0.1.3)
+    stenotype (0.1.9)
       activesupport (>= 5.0.0)
       google-cloud-pubsub (~> 1.0.0)
-      spicery (>= 0.19.0, < 1.0)
+      spicery (>= 0.22.0, < 1.0)
 
 GEM
   remote: https://rubygems.org/
@@ -53,37 +53,43 @@ GEM
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
     arel (9.0.0)
-    around_the_world (0.19.2)
+    around_the_world (0.22.2)
       activesupport (>= 5.2.1)
     ast (2.4.0)
     builder (3.2.3)
     coderay (1.1.2)
-    collectible (0.19.2)
+    collectible (0.22.2)
       activesupport (>= 5.2.1)
-      short_circu_it (= 0.19.2)
-      tablesalt (= 0.19.2)
+      short_circu_it (= 0.22.2)
+      tablesalt (= 0.22.2)
     concurrent-ruby (1.1.5)
-    conjunction (0.19.2)
+    conjunction (0.22.2)
+      activemodel (>= 5.2.1)
       activesupport (>= 5.2.1)
+      spicerack (= 0.22.2)
     crass (1.0.5)
     diff-lcs (1.3)
+    directive (0.22.2)
+      activesupport (>= 5.2.1)
     docile (1.3.2)
     erubi (1.9.0)
-    facet (0.19.2)
+    facet (0.22.2)
       activesupport (>= 5.2.1)
-      short_circu_it (= 0.19.2)
-      tablesalt (= 0.19.2)
+      short_circu_it (= 0.22.2)
+      tablesalt (= 0.22.2)
     faker (1.9.6)
       i18n (>= 0.7)
-    faraday (0.17.1)
+    faraday (0.17.3)
       multipart-post (>= 1.2, < 3)
     github-markup (3.0.4)
     globalid (0.4.2)
       activesupport (>= 4.2.0)
-    google-cloud-core (1.4.1)
+    google-cloud-core (1.5.0)
       google-cloud-env (~> 1.0)
+      google-cloud-errors (~> 1.0)
     google-cloud-env (1.3.0)
       faraday (~> 0.11)
+    google-cloud-errors (1.0.0)
     google-cloud-pubsub (1.0.2)
       concurrent-ruby (~> 1.1)
       google-cloud-core (~> 1.2)
@@ -96,7 +102,7 @@ GEM
       googleauth (~> 0.9)
       grpc (~> 1.24)
       rly (~> 0.2.3)
-    google-protobuf (3.11.1)
+    google-protobuf (3.11.2)
     googleapis-common-protos (1.3.9)
       google-protobuf (~> 3.0)
       googleapis-common-protos-types (~> 1.0)
@@ -110,7 +116,7 @@ GEM
       multi_json (~> 1.11)
       os (>= 0.9, < 2.0)
       signet (~> 0.12)
-    grpc (1.25.0)
+    grpc (1.26.0)
       google-protobuf (~> 3.8)
       googleapis-common-protos-types (~> 1.0)
     grpc-google-iam-v1 (0.6.9)
@@ -146,7 +152,7 @@ GEM
     pry (0.12.2)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
-    public_suffix (4.0.1)
+    public_suffix (4.0.3)
     rack (2.0.8)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
@@ -178,10 +184,10 @@ GEM
     rake (10.5.0)
     redcarpet (3.5.0)
     redis (4.1.3)
-    redis_hash (0.19.2)
+    redis_hash (0.22.2)
       activesupport (>= 5.2.1)
       redis (>= 3.0)
-      tablesalt (= 0.19.2)
+      tablesalt (= 0.22.2)
     rly (0.2.3)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
@@ -214,9 +220,9 @@ GEM
     rubocop-rspec (1.35.0)
       rubocop (>= 0.60.0)
     ruby-progressbar (1.10.1)
-    short_circu_it (0.19.2)
+    short_circu_it (0.22.2)
       activesupport (>= 5.2.1)
-      around_the_world (= 0.19.2)
+      around_the_world (= 0.22.2)
     signet (0.12.0)
       addressable (~> 2.3)
       faraday (~> 0.9)
@@ -227,22 +233,23 @@ GEM
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
-    spicerack (0.19.2)
-      around_the_world (= 0.19.2)
-      redis_hash (= 0.19.2)
-      short_circu_it (= 0.19.2)
-      tablesalt (= 0.19.2)
-      technologic (= 0.19.2)
+    spicerack (0.22.2)
+      around_the_world (= 0.22.2)
+      directive (= 0.22.2)
+      redis_hash (= 0.22.2)
+      short_circu_it (= 0.22.2)
+      tablesalt (= 0.22.2)
+      technologic (= 0.22.2)
     spicerack-styleguide (0.19.2)
       rubocop (= 0.74)
       rubocop-performance (= 1.4.1)
       rubocop-rails (= 2.3.0)
       rubocop-rspec (= 1.35.0)
-    spicery (0.19.2)
-      collectible (= 0.19.2)
-      conjunction (= 0.19.2)
-      facet (= 0.19.2)
-      spicerack (= 0.19.2)
+    spicery (0.22.2)
+      collectible (= 0.22.2)
+      conjunction (= 0.22.2)
+      facet (= 0.22.2)
+      spicerack (= 0.22.2)
     sprockets (4.0.0)
       concurrent-ruby (~> 1.0)
       rack (> 1, < 3)
@@ -250,13 +257,13 @@ GEM
       actionpack (>= 4.0)
       activesupport (>= 4.0)
       sprockets (>= 3.0.0)
-    tablesalt (0.19.2)
+    tablesalt (0.22.2)
       activemodel (>= 5.2.1)
       activesupport (>= 5.2.1)
-    technologic (0.19.2)
+    technologic (0.22.2)
       activesupport (>= 5.2.1)
       railties (>= 5.2.1)
-      short_circu_it (= 0.19.2)
+      short_circu_it (= 0.22.2)
     thor (0.20.3)
     thread_safe (0.3.6)
     timecop (0.9.1)

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.rb

@@ -28,7 +28,7 @@ module Stenotype
   # has never been registered in known handlers in {Stenotype::ContextHandlers::Collection}.
   class UnknownHandlerError < Error; end
 
-  include Spicerack::Configurable::ConfigDelegation
+  include Directive::ConfigDelegation
   delegates_to_configuration
 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

@@ -35,7 +35,7 @@ module Stenotype
     #
     class GoogleCloud < Base
       #
-      # @param event_data {Hash} The data to be published to Google Cloud
+      # @param event_data {String} The data to be published to Google Cloud
       # @raise {Stenotype::MessageNotPublishedError} unless message is published
       #
       # @example With default client
@@ -66,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/adapters/stdout_adapter.rb

@@ -21,7 +21,7 @@ module Stenotype
     #
     class StdoutAdapter < Base
       #
-      # @param event_data {Hash} The data to be published to STDOUT
+      # @param event_data {Sting} The data to be published to STDOUT
       #
       # @example Publishing to default client (STDOUT)
       #  adapter = Stenotype::Adapters::StdoutAdapter.new
@@ -33,10 +33,7 @@ module Stenotype
       #
       def publish(event_data, **additional_attrs)
         client.info("[Stenotype::Event] emitted with the following attributes") do
-          {
-            **event_data,
-            **additional_attrs,
-          }
+          "MESSAGE BODY: #{event_data}, MESSAGE ATTRIBUTES #{additional_attrs.to_json}"
         end
       end
 

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

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "directive"
+
 module Stenotype
   #
   # A module containing freshly-event gem configuration
@@ -24,7 +26,7 @@ module Stenotype
   #   end
   #
   module Configuration
-    extend Spicerack::Configurable
+    extend Directive
 
     # @!attribute graceful_error_handling
     # @return {true, false} a flag for suppressing error raised withing the gem
@@ -35,6 +37,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 +64,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 +91,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: false
       end
     end
 
@@ -110,6 +115,7 @@ module Stenotype
     #
     def logger
       return config.logger if config.logger
+
       config.logger || Logger.new(STDOUT)
     end
 

data/lib/stenotype/dispatcher.rb

@@ -21,7 +21,7 @@ module Stenotype
       event_data = serializer.new(event).serialize
 
       targets.each do |t|
-        t.publish(event_data)
+        t.publish(event_data.to_json)
       end
 
       self

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.5"
+  VERSION = "0.1.10"
   # :nodoc:
 end

data/stenotype.gemspec

@@ -32,7 +32,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "activesupport", ">= 5.0.0"
   spec.add_dependency "google-cloud-pubsub", "~> 1.0.0"
 
-  spec.add_runtime_dependency "spicery", ">= 0.19.0", "< 1.0"
+  spec.add_runtime_dependency "spicery", ">= 0.22.0", "< 1.0"
 
   spec.add_development_dependency "bundler", "~> 2.0"
   spec.add_development_dependency "github-markup", "~> 3.0"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stenotype
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.10
 platform: ruby
 authors:
 - Roman Kapitonov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-01-13 00:00:00.000000000 Z
+date: 2020-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -44,7 +44,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.0
+        version: 0.22.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -54,7 +54,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.0
+        version: 0.22.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -245,6 +245,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/rspec.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"