nexus_cqrs 0.0.2 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ba1253220a5001fa661f26e56de987cd722c82e829de410db982b9a86ab5537
-  data.tar.gz: d9975663c85d29129aa674a8992ed22500fe18f0ba6004ddedaf5bcf2a2c733b
+  metadata.gz: 23309f2a97f391f3a2862722c27c512f008253c52e42340286d1d5717d854520
+  data.tar.gz: f5af26755f89d08af6adc420e92488e634916992dc5723dbd1f1a83bed0b990c
 SHA512:
-  metadata.gz: 0c75bdfe91634c238f50ac20925296cf6c44982ee97148d27c38753775ebc2766be459f61cb82a862af50a470b73c200ef2b47820d60dc0edb41215366f80033
-  data.tar.gz: ac89b393e010c8f65fd371c5a467a4e2c2c6e5eec21ec98a1997a731b6f096f6f4a8a5b25ada653995da7064bd27506a586d0d16fd4f89a6c5690d19d60e147a
+  metadata.gz: 428a3c2707b17c1ff953fe50a90b2fc65b50500165bc502c7c8112dd78074093e95b75bcab6efb89da8c66fd7e7012cc78dfa206a114dcfae1ac8c088e3ea862
+  data.tar.gz: e5fe947c629472f7ac1078ea941ffebdcb8f03c4fdc8877f759c9507f0cb90e9f93c42df87b90d892a9c403b3e429efc1f826df23ca773003bda11ae69d5a8e7

data/.gitlab-ci.yml

@@ -0,0 +1,16 @@
+image: "ruby:2.7"
+
+before_script:
+  - sudo apt-get update -qq && sudo apt-get install -y -qq sqlite3 libsqlite3-dev nodejs
+  - ruby -v
+  - which ruby
+  - gem install bundler --no-document
+  - bundle install --jobs $(nproc)  "${FLAGS[@]}"
+
+rspec:
+  script:
+    - bundle exec rspec
+
+rubocop:
+  script:
+    - bundle exec rubocop

data/.rubocop.yml

@@ -0,0 +1,11 @@
+inherit_gem:
+  rubocop-shopify: rubocop.yml
+
+AllCops:
+  Exclude:
+    - 'lib/generators/nexus_cqrs/templates/**/*.rb'
+
+Style/GlobalVars:
+  Enabled: false
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/Gemfile

@@ -1,6 +1,11 @@
 source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in cqrs-core.gemspec
 gemspec
 
-gem "rake", "~> 12.0"
+gem 'rubocop'
+gem 'rubocop-shopify', "~> 1.0.4", require: false
+
+gem 'rspec'
+gem 'thread_safe'

data/Gemfile.lock

@@ -0,0 +1,58 @@
+PATH
+  remote: .
+  specs:
+    nexus_cqrs (0.0.6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.1)
+    diff-lcs (1.4.4)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
+    rubocop (0.86.0)
+      parallel (~> 1.10)
+      parser (>= 2.7.0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.0.3, < 1.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.3.0)
+      parser (>= 2.7.1.4)
+    rubocop-shopify (1.0.4)
+      rubocop (>= 0.85, < 0.87)
+    ruby-progressbar (1.10.1)
+    thread_safe (0.3.6)
+    unicode-display_width (1.7.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  nexus_cqrs!
+  rspec
+  rubocop
+  rubocop-shopify (~> 1.0.4)
+  thread_safe
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -9,7 +9,7 @@ TODO: Delete this and the text above, and describe your gem
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'cqrs-core'
+gem 'nexus_cqrs'
 ```
 
 And then execute:
@@ -18,23 +18,14 @@ And then execute:
 
 Or install it yourself as:
 
-    $ gem install cqrs-core
+    $ gem install nexus_cqrs
 
 ## Usage
 
-TODO: Write usage instructions here
+Generators can be used to aide in the creation of Commands and Queries:
 
-## Development
+    rails g nexus_cqrs:command CommandName
+    rails g nexus_cqrs:query QueryName
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+Once installed, a CommandBus is required to control the flow of Commands and/or Queries:
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/cqrs-core. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/cqrs-core/blob/master/CODE_OF_CONDUCT.md).
-
-
-## Code of Conduct
-
-Everyone interacting in the Cqrs::Core project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/cqrs-core/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,2 +1,3 @@
 require "bundler/gem_tasks"
-task :default => :spec
+require 'bundler/gem_tasks'
+task(default: :spec)

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
-require "bundler/setup"
-require "cqrs/core"
+require 'bundler/setup'
+require 'cqrs/core'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +10,5 @@ require "cqrs/core"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/lib/generators/nexus_cqrs/command_generator.rb

@@ -5,8 +5,25 @@ module NexusCqrs
     source_root File.expand_path('templates', __dir__)
 
     def copy_command_file
-      template "command.rb", "app/domain/commands/#{file_name}.rb"
-      template "command_handler.rb", "app/domain/commands/#{file_name}_handler.rb"
+      # TODO: add namespace support
+      full_name = file_name
+
+      template('command.rb', "app/domain/commands/#{full_name}.rb")
+      template('command_handler.rb', "app/domain/commands/#{full_name}_handler.rb")
+
+      register_command(full_name)
+    end
+
+    def register_command(full_name)
+      handler_config = 'config/initializers/register_cqrs_handlers.rb'
+
+      unless File.exist?('config/initializers/register_cqrs_handlers.rb')
+        template('register_cqrs_handlers.rb', handler_config)
+      end
+
+      code_to_inject = "$QUERY_EXECUTOR.register_command(#{full_name}, #{full_name}Handler)"
+
+      inject_into_file(handler_config, code_to_inject, after: '# Register Commands')
     end
   end
 end

data/lib/generators/nexus_cqrs/query_generator.rb

@@ -5,8 +5,8 @@ module NexusCqrs
     source_root File.expand_path('templates', __dir__)
 
     def copy_query_file
-      template "query.rb", "app/domain/queries/#{file_name}.rb"
-      template "query_handler.rb", "app/domain/queries/#{file_name}_handler.rb"
+      template('query.rb', "app/domain/queries/#{file_name}.rb")
+      template('query_handler.rb', "app/domain/queries/#{file_name}_handler.rb")
     end
   end
 end

data/lib/generators/nexus_cqrs/templates/command.rb

@@ -1,5 +1,5 @@
 module Commands
-  class <%= class_name %> < BaseCommand
+  class <%= class_name %> < NexusCqrs::BaseCommand
 
     # Define attributes for this command
     attr_accessor :id

data/lib/generators/nexus_cqrs/templates/command_handler.rb

@@ -1,5 +1,5 @@
 module Commands
-  class <%= class_name %>Handler < BaseCommandHandler
+  class <%= class_name %>Handler < NexusCqrs::BaseCommandHandler
 
     # call is where the Command is executed
     def call(command)

data/lib/generators/nexus_cqrs/templates/query.rb

@@ -1,5 +1,5 @@
 module Queries
-  class <%= class_name %> < BaseQuery
+  class <%= class_name %> < NexusCqrs::BaseQuery
 
     # Define attributes for this query
     attr_accessor :id

data/lib/generators/nexus_cqrs/templates/query_handler.rb

@@ -1,5 +1,5 @@
 module Queries
-  class <%= class_name %>Handler < BaseQueryHandler
+  class <%= class_name %>Handler < NexusCqrs::BaseQueryHandler
 
     # call is where the Query is executed
     def call(command)

data/lib/generators/nexus_cqrs/templates/register_cqrs_handlers.rb

@@ -0,0 +1,9 @@
+command_bus = NexusCqrs::CommandBus.new
+query_bus = NexusCqrs::CommandBus.new
+
+$COMMAND_EXECUTOR = NexusCqrs::CommandExecutor.new command_bus
+$QUERY_EXECUTOR = NexusCqrs::CommandExecutor.new query_bus
+
+# Register Queries
+
+# Register Commands

data/lib/nexus_cqrs.rb

@@ -0,0 +1,11 @@
+require 'nexus_cqrs/base_command'
+require 'nexus_cqrs/base_command_handler'
+require 'nexus_cqrs/base_query'
+require 'nexus_cqrs/base_query_handler'
+require 'nexus_cqrs/command_bus'
+require 'nexus_cqrs/command_executor'
+require 'nexus_cqrs/helpers'
+
+module NexusCqrs
+  class Error < StandardError; end
+end

data/lib/nexus_cqrs/base_command.rb

@@ -1,5 +1,4 @@
 module NexusCqrs
   class BaseCommand
-
   end
-end
+end

data/lib/nexus_cqrs/base_command_handler.rb

@@ -1,4 +1,6 @@
 module NexusCqrs
   class BaseCommandHandler
+    def call(command)
+    end
   end
-end
+end

data/lib/nexus_cqrs/base_query.rb

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

data/lib/nexus_cqrs/base_query_handler.rb

@@ -1,4 +1,4 @@
 module NexusCqrs
   class BaseQueryHandler
   end
-end
+end

data/lib/nexus_cqrs/command_bus.rb

@@ -7,21 +7,29 @@ module NexusCqrs
 
     def initialize
       @handlers =
-          ThreadSafe::Cache.new
+        ThreadSafe::Cache.new
     end
 
     def register(klass, handler)
-      raise MultipleHandlers.new("Multiple handlers not allowed for #{klass}") if handlers[klass]
+      raise MultipleHandlers, "Multiple handlers not allowed for #{klass}" if handlers[klass]
+
       handlers[klass] = handler
     end
 
     def call(command)
+      unregistered_handler = proc { raise UnregisteredHandler, "Missing handler for #{command.class}" }
+
+      handlers
+        .fetch(command.class, &unregistered_handler)
+        .call(command)
+    end
+
+    def registered_handlers
       handlers
-          .fetch(command.class) { raise UnregisteredHandler.new("Missing handler for #{command.class}")  }
-      .(command)
     end
 
     private
+
     attr_reader :handlers
   end
-end
+end

data/lib/nexus_cqrs/command_executor.rb

@@ -1,18 +1,24 @@
 module NexusCqrs
   class CommandExecutor
-    def initialize
-      @bus = CommandBus.new
+    def initialize(command_bus)
+      @bus = command_bus
 
       register_commands
     end
 
     def execute(command)
-      @bus.(command)
+      @bus.call(command)
+    end
+
+    def register_command(klass, handler)
+      Rails.logger.debug("Registered #{klass} to #{handler}")
+      @bus.register(klass, handler)
     end
 
     private
-      def register_commands
-        # TODO, Register Commands/Queries
-      end
+
+    def register_commands
+      # TODO, Register Commands/Queries
+    end
   end
-end
+end

data/lib/nexus_cqrs/helpers.rb

@@ -12,7 +12,7 @@ module NexusCqrs
 
     # Provide access to the CQRS executor
     def command_executor
-      @command_executor ||= NexusCqrs::CommandExecutor.new
+      @command_executor ||= $COMMAND_EXECUTOR
     end
   end
-end
+end

data/lib/nexus_cqrs/version.rb

@@ -1,3 +1,3 @@
 module NexusCqrs
-  VERSION = "0.0.2"
+  VERSION = '0.0.7'
 end

data/nexus_cqrs.gemspec

@@ -1,23 +1,20 @@
 require_relative 'lib/nexus_cqrs/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "nexus_cqrs"
+  spec.name          = 'nexus_cqrs'
   spec.version       = NexusCqrs::VERSION
-  spec.authors       = ["Dean Lovett"]
-  spec.email         = ["dean.lovett@nexusmods.com"]
+  spec.authors       = ['Dean Lovett']
+  spec.email         = ['dean.lovett@nexusmods.com']
 
-  spec.summary       = %q{Core package for the nexus cqrs gem}
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.summary       = 'Core package for the nexus cqrs gem'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    %x(git ls-files -z).split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "bundler", "~> 1.3"
-  spec.add_development_dependency "rails", "~> 5"
+  spec.require_paths = ['lib']
 end

metadata

@@ -1,43 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: nexus_cqrs
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.7
 platform: ruby
 authors:
 - Dean Lovett
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-08-20 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
-- !ruby/object:Gem::Dependency
-  name: rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5'
+date: 2020-08-24 00:00:00.000000000 Z
+dependencies: []
 description: 
 email:
 - dean.lovett@nexusmods.com
@@ -46,8 +18,11 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".gitlab-ci.yml"
+- ".rubocop.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
+- Gemfile.lock
 - README.md
 - Rakefile
 - bin/console
@@ -59,6 +34,8 @@ files:
 - lib/generators/nexus_cqrs/templates/command_handler.rb
 - lib/generators/nexus_cqrs/templates/query.rb
 - lib/generators/nexus_cqrs/templates/query_handler.rb
+- lib/generators/nexus_cqrs/templates/register_cqrs_handlers.rb
+- lib/nexus_cqrs.rb
 - lib/nexus_cqrs/base_command.rb
 - lib/nexus_cqrs/base_command_handler.rb
 - lib/nexus_cqrs/base_query.rb