nexus_cqrs 0.0.12 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 194d9582819dfbce269179cd41d5c442a3a66a3797b0d77d09ef80e7343f6b25
-  data.tar.gz: ff860d659e433356d3ce6880aa445257fb6eab5ee1f9e53ea6e7ef2161e7be2c
+  metadata.gz: 24bafc3e27cbf1ef65d1e507bdb2798b67283c92c64b274bbf8818cfffa9618a
+  data.tar.gz: e653d3e7b76bc2173a780cf6128974afaecaba8278c0f39e56527ae442395cff
 SHA512:
-  metadata.gz: f4d420c2e28c58bfa155ac015f95a3edf51a201bf3e6ab478529b41be162b5cd375c01a0de66ee8559ea07de663bc703f8ae14d19086ea80d879d00158a49c21
-  data.tar.gz: 134ab0e8e19e9d1e3378f4fe2d8efabb8f469b7924e30bc9685f82e5e4cc7fc0761191e988e80c9c46b3b36d8b9eb7a9232ef65253ce05ac6f6150ff5384cc7a
+  metadata.gz: 38a848d5da2a2a61116f1bb2f04df2fae1c0cb368e6482854e0f7896a9bfcd0b2baab39e58c223c2b1f5a1a0c62bc028c0dddf1d2daccebc7268010e9506559c
+  data.tar.gz: 6f7b0c32343f39b5b3eb61b9c4afb5cc338bbce81eeb5d998b0d0e1293fe1fa35984264f86ed8fbc8d1a0a29106602566a0ee00096951b4d54fc63ddb3d9f3d7

data/.gitlab-ci.yml

@@ -1,5 +1,9 @@
 image: "ruby:2.7"
 
+stages:
+  - release
+  - test
+
 before_script:
   - sudo apt-get update -qq && sudo apt-get install -y -qq sqlite3 libsqlite3-dev nodejs
   - ruby -v
@@ -13,4 +17,23 @@ rspec:
 
 rubocop:
   script:
-    - bundle exec rubocop
+    - bundle exec rubocop
+
+release:
+  stage: release
+  rules:
+    - if: '$CI_COMMIT_TAG'
+  script:
+    - mkdir -p ~/.gem
+    - cp $RUBYGEMS_CREDENTIALS ~/.gem/credentials
+    - chmod 0600 ~/.gem/credentials
+    - gem update --system
+    - ruby --version
+    - gem env version
+    - sed -i "s/0.1.0/$CI_COMMIT_TAG/g" lib/nexus_cqrs/version.rb
+    - gem build nexus_cqrs.gemspec
+    - gem push nexus_cqrs*.gem
+  artifacts:
+    paths:
+      - nexus_cqrs*.gem
+    expire_in: 30 days

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/Gemfile

@@ -9,3 +9,4 @@ gem 'rubocop-shopify', "~> 1.0.4", require: false
 gem 'rspec'
 gem "generator_spec"
 gem 'thread_safe'
+gem 'ibsciss-middleware'

data/Gemfile.lock

@@ -1,7 +1,10 @@
 PATH
   remote: .
   specs:
-    nexus_cqrs (0.0.8)
+    nexus_cqrs (0.1.0)
+      generator_spec
+      ibsciss-middleware
+      thread_safe
 
 GEM
   remote: https://rubygems.org/
@@ -36,17 +39,13 @@ GEM
       railties (>= 3.0.0)
     i18n (1.8.5)
       concurrent-ruby (~> 1.0)
+    ibsciss-middleware (0.4.2)
     loofah (2.6.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
     method_source (1.0.0)
     mini_portile2 (2.4.0)
     minitest (5.14.1)
-    multi_json (1.15.0)
-    net-scp (3.0.0)
-      net-ssh (>= 2.6.5, < 7.0.0)
-    net-ssh (6.1.0)
-    net-telnet (0.1.1)
     nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
     parallel (1.19.2)
@@ -79,9 +78,6 @@ GEM
     rspec-expectations (3.9.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
-    rspec-its (1.3.0)
-      rspec-core (>= 3.0.0)
-      rspec-expectations (>= 3.0.0)
     rspec-mocks (3.9.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
@@ -100,17 +96,6 @@ GEM
     rubocop-shopify (1.0.4)
       rubocop (>= 0.85, < 0.87)
     ruby-progressbar (1.10.1)
-    serverspec (2.41.5)
-      multi_json
-      rspec (~> 3.0)
-      rspec-its
-      specinfra (~> 2.72)
-    sfl (2.3)
-    specinfra (2.82.19)
-      net-scp
-      net-ssh (>= 2.7)
-      net-telnet (= 0.1.1)
-      sfl
     thor (1.0.1)
     thread_safe (0.3.6)
     tzinfo (1.2.7)
@@ -123,11 +108,11 @@ PLATFORMS
 
 DEPENDENCIES
   generator_spec
+  ibsciss-middleware
   nexus_cqrs!
   rspec
   rubocop
   rubocop-shopify (~> 1.0.4)
-  serverspec
   thread_safe
 
 BUNDLED WITH

data/README.md

@@ -29,6 +29,32 @@ Generators can be used to aide in the creation of Commands and Queries:
 
 Once installed, a CommandBus is required to control the flow of Commands and/or Queries:
 
+### Middleware
+
+Middleware can be created by extending the base middleware:
+
+```ruby
+class MyMiddleware < NexusCqrs::BaseMiddleware
+  def call(command)
+    @next.call(command)
+  end
+end
+```
+
+The above middleware will pass responsibility for execution to the next responder in the chain.
+
+For more information on writing middleware see: https://github.com/Ibsciss/ruby-middleware
+
+When creating a bus, middleware can be attached like so:
+
+```ruby
+middleware_stack = Middleware::Builder.new do |b|
+  b.use MyMiddleware
+end
+
+command_bus = Bus.new(middleware: middleware_stack)
+```
+
 ## Development
 
 To contribute to this gem, simple pull the repository, run `bundle install` and run tests:
@@ -36,4 +62,8 @@ To contribute to this gem, simple pull the repository, run `bundle install` and
 ```shell script
     bundle exec rspec
     bundle exec rubocop
-```
+```
+
+## Releasing
+
+The release process is tied to the git tags. Simply creating a new tag and pushing will trigger a new release to reubygems.

data/lib/nexus_cqrs/base_command.rb

@@ -1,4 +1,4 @@
 module NexusCqrs
-  class BaseCommand
+  class BaseCommand < BaseMessage
   end
 end

data/lib/nexus_cqrs/base_message.rb

@@ -0,0 +1,28 @@
+module NexusCqrs
+  class BaseMessage
+    def set_metadata(key, value)
+      @metadata = {} unless @metadata
+      @metadata[key.to_sym] = value
+    end
+
+    def metadata
+      @metadata || {}
+    end
+
+    def to_h
+      hash = instance_variables.each_with_object({}) do |var, acc|
+        acc[var.to_s[1..-1].to_sym] = instance_variable_get(var)
+      end
+      hash[:metadata] = @metadata || {}
+      hash
+    end
+
+    def policy_class
+      demodularised_class_name + 'Policy'
+    end
+
+    def demodularised_class_name
+      self.class.name.split('::').last
+    end
+  end
+end

data/lib/nexus_cqrs/base_middleware.rb

@@ -0,0 +1,11 @@
+module NexusCqrs
+  class BaseMiddleware
+    def initialize(next_)
+      @next = next_
+    end
+
+    # @param [BaseMessage] message
+    def call(message)
+    end
+  end
+end

data/lib/nexus_cqrs/base_query.rb

@@ -1,4 +1,4 @@
 module NexusCqrs
-  class BaseQuery
+  class BaseQuery < BaseMessage
   end
 end

data/lib/nexus_cqrs/base_query_handler.rb

@@ -1,6 +1,6 @@
 module NexusCqrs
   class BaseQueryHandler
-    def call(command)
+    def call(query)
     end
   end
 end

data/lib/nexus_cqrs/command_bus.rb

@@ -1,13 +1,14 @@
 require 'thread_safe'
+require 'middleware'
 
 module NexusCqrs
   class CommandBus
     UnregisteredHandler = Class.new(StandardError)
     MultipleHandlers    = Class.new(StandardError)
 
-    def initialize
-      @handlers =
-        ThreadSafe::Cache.new
+    def initialize(middleware: nil)
+      @handlers = ThreadSafe::Cache.new
+      @middleware = middleware || Middleware::Builder.new
     end
 
     def register(klass, handler)
@@ -17,19 +18,27 @@ module NexusCqrs
     end
 
     def call(command)
-      unregistered_handler = proc { raise UnregisteredHandler, "Missing handler for #{command.class}" }
-
-      handlers
-        .fetch(command.class.name, &unregistered_handler)
-        .call(command)
+      runner = Middleware::Builder.new
+      runner.use(@middleware)
+      runner.use(->(command_) { handler_for_command(command_).call(command_) })
+      runner.call(command)
     end
 
     def registered_handlers
       handlers
     end
 
-    private
+    def clear_handlers
+      @handlers = ThreadSafe::Cache.new
+    end
 
     attr_reader :handlers
+
+    private
+
+    def handler_for_command(command)
+      unregistered_handler = proc { raise UnregisteredHandler, "Missing handler for #{command.class}" }
+      handlers.fetch(command.class, &unregistered_handler)
+    end
   end
 end

data/lib/nexus_cqrs/command_executor.rb

@@ -1,24 +1,30 @@
 module NexusCqrs
   class CommandExecutor
+    # @param [NexusCqrs::CommandBus] command_bus
     def initialize(command_bus)
       @bus = command_bus
-
-      register_commands
     end
 
+    # @param [NexusCqrs::BaseCommand] command
     def execute(command)
       @bus.call(command)
     end
 
+    # @param [NexusCqrs::BaseCommandHandler] handler
     def register_command(klass, handler)
-      Rails.logger.debug("Registered #{klass} to #{handler}")
-      @bus.register(klass.name, handler)
+      @bus.register(klass, handler)
     end
 
-    private
+    def reregister_handlers
+      return if @register_handlers.nil?
+
+      @bus.clear_handlers
+      @register_handlers.call(self)
+    end
 
-    def register_commands
-      # TODO, Register Commands/Queries
+    def configure_handlers(&block)
+      @register_handlers = block
+      @register_handlers.call(self)
     end
   end
 end

data/lib/nexus_cqrs/helpers.rb

@@ -7,12 +7,16 @@ module NexusCqrs
 
     # Executes a CQRS Query
     def query(query)
-      command_executor.execute(query)
+      query_executor.execute(query)
     end
 
     # Provide access to the CQRS executor
     def command_executor
       @command_executor ||= $COMMAND_EXECUTOR
     end
+
+    def query_executor
+      @query_executor ||= $QUERY_EXECUTOR
+    end
   end
 end

data/lib/nexus_cqrs/version.rb

@@ -1,3 +1,3 @@
 module NexusCqrs
-  VERSION = '0.0.12'
+  VERSION = '0.2.2'
 end

data/lib/nexus_cqrs.rb

@@ -1,3 +1,5 @@
+require 'nexus_cqrs/base_message'
+require 'nexus_cqrs/base_middleware'
 require 'nexus_cqrs/base_command'
 require 'nexus_cqrs/base_command_handler'
 require 'nexus_cqrs/base_query'

data/nexus_cqrs.gemspec

@@ -17,4 +17,7 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
+  spec.add_dependency('generator_spec')
+  spec.add_dependency('thread_safe')
+  spec.add_dependency('ibsciss-middleware')
 end

metadata

@@ -1,15 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: nexus_cqrs
 version: !ruby/object:Gem::Version
-  version: 0.0.12
+  version: 0.2.2
 platform: ruby
 authors:
 - Dean Lovett
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-09-09 00:00:00.000000000 Z
-dependencies: []
+date: 2021-08-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: generator_spec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thread_safe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ibsciss-middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - dean.lovett@nexusmods.com
@@ -19,6 +61,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".gitlab-ci.yml"
+- ".rspec"
 - ".rubocop.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -38,6 +81,8 @@ files:
 - lib/nexus_cqrs.rb
 - lib/nexus_cqrs/base_command.rb
 - lib/nexus_cqrs/base_command_handler.rb
+- lib/nexus_cqrs/base_message.rb
+- lib/nexus_cqrs/base_middleware.rb
 - lib/nexus_cqrs/base_query.rb
 - lib/nexus_cqrs/base_query_handler.rb
 - lib/nexus_cqrs/command_bus.rb
@@ -63,7 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.2.26
 signing_key: 
 specification_version: 4
 summary: Core package for the nexus cqrs gem