simple_event_sourcing 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c8f96d29fae329c09e8001a2ce8ab34e725ba76095d61e7927acf42321be8c2
-  data.tar.gz: 69fc9bde337b95d771f4ca23a15f7eedc0b40d0e39df082b39272e96c4ecf88a
+  metadata.gz: 666d470eb4b8fadd4728c3bd093e216b6454272d23a3f2891fef63657855a270
+  data.tar.gz: 828c08776a5200bd236783f0d911b25ac4283ae87d628f102e61554d0c61089e
 SHA512:
-  metadata.gz: 48671ba2bc1b7b37e7130622f87f7d519bafa91f9e38e1f26f3b346d14f60354b92e9cabfe1c8005f309cde15204ded274095867470f3800b7298e5ee7ff7104
-  data.tar.gz: ca37c5f86523fb2d3e28a6eedbe9f3f9ea9999940cba3d05daf616c18e7178e985e97df83f88a3860a6d019a42b778753a23252e6ac91bbc1ae3f0e0a2b37358
+  metadata.gz: d0b8fae3aac98197e3cbcf73f44ed374208239166cb631c952844196abdea07b81fcddbdb2cd03d604481f6d0859f4390384f359e0cc6cdf84df6c4c33df114f
+  data.tar.gz: 888f20ab00ebe27210b225760885cc35e8f654df4050068ad5979e33f4490e3451ed59325be12b6c64b96a774f840ac0634aa4d36dc9e9f07ce938a425bc1717

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    simple_event_sourcing (0.2.0)
+    simple_event_sourcing (0.3.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -51,13 +51,13 @@ class Employee
     apply_record_event SalaryHasChangedEvent.new(@aggregate_id, new_salary)
   end
 
-  def apply_new_employee_is_hired_event(event)
+  on NewEmployeeIsHiredEvent do |event|
     @name = event.name
     @title = event.title
     @salary = event.salary
   end
 
-  def apply_salary_has_changed_event(event)
+  on SalaryHasChangedEvent do |event|
     @salary = event.new_salary
   end
 
@@ -69,19 +69,13 @@ class Employee
 end
 ```
 
-Firts you mus add behaviour including the AggregateRoot module
+First, you must add behaviour including the AggregateRoot module
 
 ```ruby
   include SimpleEventSourcing::AggregateRoot
 ```
 
-After that all domain event must be applied and recorded
-
-```ruby
-apply_record_event SalaryHasChangedEvent.new(@aggregate_id, new_salary)
-```
-
-You must create your own events and a event stream
+You must create your own domain events and a event stream
 
 ```ruby
 class EmployeeStreamEvents < SimpleEventSourcing::StreamEvents
@@ -101,6 +95,22 @@ class SalaryHasChangedEvent < SimpleEventSourcing::Event
 end
 ```
 
+After that all domain event must be applied and recorded
+
+```ruby
+apply_record_event SalaryHasChangedEvent.new(@aggregate_id, new_salary)
+```
+
+SimpleEventSourcing provides a DSL to handle the applied events. You must provide a handler for each event
+
+```ruby
+on SalaryHasChangedEvent do |event|
+  @salary = event.new_salary
+end
+```
+
+
+
 Once you persist the entity you must publish all recorded events.
 
 ```ruby

data/docker-compose.yml

@@ -5,3 +5,5 @@ services:
     volumes:
       - ./:/myapp
     command: tail -f /dev/null
+    environment:
+      - LANG=C.UTF-8

data/example/employee.rb

@@ -29,6 +29,18 @@ class SalaryHasChangedEvent < SimpleEventSourcing::Event
   end
 end
 
+class CongratulateEmployeeSubscriber < SimpleEventSourcing::EventSubscriber
+
+  def is_subscribet_to?(event)
+    event.class == SalaryHasChangedEvent
+  end
+
+  def handle(event)
+    puts "Cogratulations for your new salary => #{event.new_salary}!!!!"
+  end
+
+end
+
 
 class Employee
 
@@ -47,13 +59,13 @@ class Employee
     apply_record_event SalaryHasChangedEvent.new(@aggregate_id, new_salary)
   end
 
-  def apply_new_employee_is_hired_event(event)
+  on NewEmployeeIsHiredEvent do |event|
     @name = event.name
     @title = event.title
     @salary = event.salary
   end
 
-  def apply_salary_has_changed_event(event)
+  on SalaryHasChangedEvent do |event|
     @salary = event.new_salary
   end
 

data/example/main.rb

@@ -1,6 +1,4 @@
-require_relative '../lib/simple_event_sourcing'
-require_relative 'employee_events'
-require_relative 'employee_subscribers'
+require 'simple_event_sourcing'
 require_relative 'employee'
 
 SimpleEventSourcing::EventPublisher.add_subscriber(CongratulateEmployeeSubscriber.new)

data/lib/simple_event_sourcing.rb

@@ -1,6 +1,5 @@
 require 'simple_event_sourcing/version'
 
-
 require_relative 'simple_event_sourcing/aggregate_root/aggregate_root'
 require_relative 'simple_event_sourcing/events/events'
 

data/lib/simple_event_sourcing/aggregate_root/aggregate_root.rb

@@ -1,6 +1,8 @@
 require 'securerandom'
 require 'facets'
 
+require_relative 'self_applier'
+
 module SimpleEventSourcing
   module AggregateRoot
 
@@ -24,7 +26,7 @@ module SimpleEventSourcing
     end
 
     def apply_record_event(event)
-      apply_event event
+      handle_message(event)
       record_event event
     end
 
@@ -51,8 +53,9 @@ module SimpleEventSourcing
       end
 
       def apply_event(event)
-        method = 'apply_' + event.class.name.snakecase
-        send(method, event)
+        handle_message(event)
+        #method = 'apply_' + event.class.name.snakecase
+        #send(method, event)
       end
 
   end

data/lib/simple_event_sourcing/aggregate_root/self_applier.rb

@@ -0,0 +1,41 @@
+module SimpleEventSourcing
+  module AggregateRoot
+    ##
+    # Creates ability to use DSL like:
+    # class MyEventHandler < Sequent::Core::BaseEventHandler
+    #
+    #   on MyEvent do |event|
+    #     do_some_logic
+    #   end
+    # end
+    #
+    # You typically do not need to include this module in your classes. If you extend from
+    # Sequent::Core::AggregateRoot, Sequent::Core::Projector, Sequent::Core::Workflow or Sequent::Core::BaseCommandHandler
+    # you will get this functionality for free.
+    #
+
+      module ClassMethods
+        def on(*message_classes, &block)
+          message_classes.each { |message_class| message_mapping[message_class] = block }
+        end
+
+        def message_mapping
+          @message_mapping ||= {}
+        end
+
+        def handles_message?(message)
+          message_mapping.keys.include? message.class
+        end
+      end
+
+      def self.included(host_class)
+        host_class.extend(ClassMethods)
+      end
+
+      def handle_message(message)
+        handler = self.class.message_mapping[message.class]
+        self.instance_exec(message, &handler) if handler
+      end
+    end
+  
+end

data/lib/simple_event_sourcing/events/events.rb

@@ -26,6 +26,18 @@ module SimpleEventSourcing
     end
   end
 
+  class EventSubscriber
+
+    def is_subscribet_to?(event)
+      raise StandardError "Method not implemented"
+    end
+
+    def handle(event)
+      raise StandardError "Method not implemented"
+    end
+  end
+
+
   module EventPublisher
     @@subscribers = []
 

data/lib/simple_event_sourcing/version.rb

@@ -1,3 +1,3 @@
 module SimpleEventSourcing
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/simple_event_sourcing.gemspec

@@ -6,12 +6,12 @@ require "simple_event_sourcing/version"
 Gem::Specification.new do |spec|
   spec.name          = "simple_event_sourcing"
   spec.version       = SimpleEventSourcing::VERSION
-  spec.authors       = ["Manel"]
+  spec.authors       = ["Manuel López Torrent"]
   spec.email         = ["malotor@gmail.com"]
 
-  spec.summary       = %q{Write a short summary, because RubyGems requires one.}
-  spec.description   = %q{Write a longer description or delete this line.}
-  spec.homepage      = "https://github.com/malotor"
+  spec.summary       = %q{This gem provides a simple way for add events sourcing related behaviour to your models class}
+  spec.description   = %q{This gem provides a simple way for add events sourcing related behaviour to your models class}
+  spec.homepage      = "https://github.com/malotor/ruby_event_sourcing"
   spec.license       = "MIT"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: simple_event_sourcing
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
-- Manel
+- Manuel López Torrent
 autorequire: 
 bindir: exe
 cert_chain: []
@@ -80,7 +80,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Write a longer description or delete this line.
+description: This gem provides a simple way for add events sourcing related behaviour
+  to your models class
 email:
 - malotor@gmail.com
 executables: []
@@ -101,17 +102,16 @@ files:
 - bin/console
 - bin/setup
 - docker-compose.yml
-- example/Gemfile
 - example/employee.rb
-- example/employee_subscribers.rb
 - example/main.rb
 - lib/simple_event_sourcing.rb
 - lib/simple_event_sourcing/aggregate_root/aggregate_root.rb
+- lib/simple_event_sourcing/aggregate_root/self_applier.rb
 - lib/simple_event_sourcing/events/events.rb
 - lib/simple_event_sourcing/version.rb
 - run.sh
 - simple_event_sourcing.gemspec
-homepage: https://github.com/malotor
+homepage: https://github.com/malotor/ruby_event_sourcing
 licenses:
 - MIT
 metadata: {}
@@ -134,5 +134,6 @@ rubyforge_project:
 rubygems_version: 2.7.2
 signing_key: 
 specification_version: 4
-summary: Write a short summary, because RubyGems requires one.
+summary: This gem provides a simple way for add events sourcing related behaviour
+  to your models class
 test_files: []

data/example/Gemfile

@@ -1 +0,0 @@
-gem "simple_event_sourcing", :git => "https://github.com/malotor/ruby_event_sourcing.git"

data/example/employee_subscribers.rb

@@ -1,22 +0,0 @@
-class EmployeeSubscriber
-
-  def (event)
-    raise StandardError "Method not implemented"
-  end
-
-  def handle(event)
-    raise StandardError "Method not implemented"
-  end
-end
-
-class CongratulateEmployeeSubscriber < EmployeeSubscriber
-
-  def is_subscribet_to?(event)
-    event.class == SalaryHasChangedEvent
-  end
-
-  def handle(event)
-    puts "Cogratulations for your new salary => #{event.new_salary}!!!!"
-  end
-
-end