event_sourcing 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 41f92fcb759e0e8e3aad1d3a38b5a497cb5434c4
+  data.tar.gz: 30ae75bea380d66f7a92b1e314559822f4132ff8
+SHA512:
+  metadata.gz: 4c84d2d1defebb5d6b31766548bd1f68166855c3d26019bf86f90fd7aafe3bc5b143baa82b8a7329c8d1ce9a4b92c8cca3289f1b73ca7c76c004bcdee9e9a0d1
+  data.tar.gz: 20482096bc9d26104f9d30d190196e759d63e6c10dbb7ca019a74737a73b63445e2d4eae9f2165d073e6bfc42bd914029c474cf835c88c94856786bf49513683

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+bin/
+coverage
+doc/
+lib/bundler/man
+log/*
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--backtrace

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+ruby "2.0.0", engine: "jruby", engine_version: "1.7.13"
+#ruby=jruby-1.7.13
+
+# Specify your gem's dependencies in event_sourcing.gemspec
+gemspec
+gem "concurrent-ruby", "0.7.0.rc2" #TODO: Move to gemspec once released 

data/Guardfile

@@ -0,0 +1,12 @@
+guard 'spinach', all_on_start: false, backtrace: true do
+  watch(%r|^features/(.*)\.feature|)
+  watch(%r|^features/steps/(.*)([^/]+)\.rb|) do |m|
+    "features/#{m[1]}#{m[2]}.feature"
+  end
+end
+
+guard :rspec, cmd: "bin/rspec --tty" do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib\/event_sourcing\/(.+)\.rb$}) { |m| "spec/unit/#{m[1]}_spec.rb" }
+  watch('spec/unit_helper.rb')  { "spec" }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Rodrigo Alvarez
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# EventSourcing
+
+EventSourcing, as its name suggests, is an Actor based Event Sourcing library for ruby.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'event_sourcing'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install event_sourcing
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/event_sourcing/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+    t.rspec_opts = "--tty"
+end
+
+desc 'Run spinach features'
+task :spinach do
+  exec "bin/spinach"
+end
+
+task :default => [:spec, :spinach]

data/event_sourcing.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'event_sourcing/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "event_sourcing"
+  spec.version       = EventSourcing::VERSION
+  spec.authors       = ["Rodrigo Alvarez"]
+  spec.email         = ["papipo@gmail.com"]
+  spec.summary       = %q{Actor based EventSourcing framework for ruby.}
+  spec.homepage      = "https://github.com/Papipo/event_sourcing"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "values"
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "spinach"
+  spec.add_development_dependency "guard-spinach"
+  spec.add_development_dependency "guard-rspec"
+end

data/features/steps/whole_stack.rb

@@ -0,0 +1,29 @@
+require_relative "../support/sample_app"
+require "event_sourcing/event/store/memory"
+
+class Spinach::Features::WholeStack < Spinach::FeatureSteps
+  before do
+    File.open(SampleApp::Logger.file_path, "w")
+  end
+
+  step 'my app is running' do
+    @app = SampleApp.run!(event_store: event_store)
+  end
+
+  step 'I send a command to an aggregate' do
+    @app.execute_command SampleApp::PublishPost.new(post_id: "some-id", title: "My post")
+  end
+
+  step 'an event is raised' do
+    sleep 0.01 #FIXME wait with timeout instead
+    expect(File.read(SampleApp::Logger.file_path)).to eq("Post with title \"My post\" has been published!\n")
+  end
+
+  after do
+    @app.shutdown if @app
+  end
+
+  def event_store
+    @event_store ||= EventSourcing::Event::Store::Memory.new
+  end
+end

data/features/support/env.rb

@@ -0,0 +1,5 @@
+require "rspec"
+require "rspec/expectations"
+require "./spec/concurrent_logging"
+
+ Concurrent::Actor.i_know_it_is_experimental!

data/features/support/logger.log

@@ -0,0 +1 @@
+Post with title "My post" has been published!

data/features/support/sample_app.rb

@@ -0,0 +1,40 @@
+require "event_sourcing/application"
+require "event_sourcing/event"
+require "event_sourcing/event/subscriber"
+require "event_sourcing/command"
+require "event_sourcing/aggregate"
+
+SampleApp = EventSourcing::Application.new(:sample_app)
+
+SampleApp::PostPublished = EventSourcing::Event.define(:title)
+
+SampleApp::PublishPost   = EventSourcing::Command.define(:post_id, :title) do |aggregate_manager|
+  aggregate_manager.instance_of(SampleApp::Post, post_id).publish(title)
+end
+
+class SampleApp::Post
+  include EventSourcing::Aggregate
+
+  def publish(title)
+    ::SampleApp::PostPublished.new(title: title) unless @title
+  end
+
+  handle ::SampleApp::PostPublished do |e|
+    @title = e.title
+  end
+end
+
+class SampleApp::Logger < EventSourcing::Event::Subscriber
+
+  @file_path = File.dirname(__FILE__) + '/logger.log'
+
+  class << self
+    attr_reader :file_path
+  end
+  
+  subscribe_to SampleApp::PostPublished do |e|
+    File.open(self.class.file_path, 'a') do |f|
+      f.puts "Post with title \"#{e.title}\" has been published!"
+    end
+  end
+end

data/features/whole_stack.feature

@@ -0,0 +1,6 @@
+Feature: Whole stack
+  
+  Scenario: Sending commands to aggregates
+    Given my app is running
+    When I send a command to an aggregate
+    Then an event is raised

data/lib/event_sourcing.rb

@@ -0,0 +1,3 @@
+module EventSourcing
+  require "event_sourcing/version"
+end

data/lib/event_sourcing/aggregate.rb

@@ -0,0 +1,30 @@
+require "event_sourcing/aggregate/actor"
+
+module EventSourcing
+  module Aggregate
+    def self.included(base)
+      base.const_set("Actor", EventSourcing::Aggregate::Actor.for(base))
+      base.extend ClassMethods
+    end
+
+    def initialize(events = [])
+      events.each do |e|
+        _apply(e)
+      end
+    end
+
+    def _apply(e)
+      if respond_to?("apply_#{e}")
+        send("apply_#{e}", e)
+      else
+        raise "unsupported event #{e}"
+      end
+    end
+
+    module ClassMethods
+      def handle(event_name, &block)
+        define_method "apply_#{event_name}", &block
+      end
+    end
+  end
+end

data/lib/event_sourcing/aggregate/actor.rb

@@ -0,0 +1,29 @@
+require "concurrent/actor"
+
+module EventSourcing
+  module Aggregate
+    class Actor
+      def self.for(aggregate)
+        Class.new(Concurrent::Actor::RestartingContext) do
+          define_method :initialize do |event_bus, event_stream|
+            @aggregate = aggregate.new(event_stream)
+            @event_bus = event_bus
+            @event_stream = event_stream
+          end
+
+          #FIXME: this is doing too many things
+
+          def on_message(message) # Format is [:method, arg1, arg2]
+            if @aggregate.respond_to?(message.first)
+              events = @aggregate.send(*message) # FIXME: what happens if events is empty or falsy?
+              @event_stream.append(events) # FIXME: Event Stream is now stale
+              @event_bus.publish(events) 
+              # FIXME: spec what happens if event hasn't been stored for some reason
+              @aggregate._apply(events)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/event_sourcing/aggregate/manager.rb

@@ -0,0 +1,33 @@
+require "concurrent/actor"
+
+module EventSourcing
+  module Aggregate
+    class Manager < Concurrent::Actor::RestartingContext
+
+      require "event_sourcing/aggregate/manager/reference"
+      require "event_sourcing/aggregate/manager/cache"
+      require "event_sourcing/aggregate/message"
+
+      def initialize(event_bus)
+        @event_bus = event_bus
+      end
+
+      def on_message(message)
+        case message
+        when Aggregate::Message
+          cache.instance_of(message.aggregate, message.id).tell(message.message)
+          #TODO Handle aggregate timeout and failure (remove from cache)
+        end
+      end
+
+      def default_reference_class
+        Reference
+      end
+
+      private
+      def cache
+        @cache ||= Cache.new(@event_bus)
+      end
+    end
+  end
+end

data/lib/event_sourcing/aggregate/manager/cache.rb

@@ -0,0 +1,17 @@
+require "event_sourcing/aggregate/manager"
+
+module EventSourcing
+  module Aggregate
+    class Manager
+      class Cache < Hash
+        def initialize(event_bus)
+          @event_bus = event_bus
+        end
+
+        def instance_of(aggregate, id)
+          self[id] ||= aggregate::Actor.spawn!(name: id, supervise: true, args: [@event_bus, @event_bus.get_stream(id)])
+        end
+      end
+    end
+  end
+end

data/lib/event_sourcing/aggregate/manager/instance_of.rb

@@ -0,0 +1,11 @@
+# TODO Remove
+require "values"
+require "event_sourcing/aggregate/manager"
+
+module EventSourcing
+  module Aggregate
+    class Manager
+      InstanceOf = Value.new(:aggregate, :id)
+    end
+  end
+end

data/lib/event_sourcing/aggregate/manager/reference.rb

@@ -0,0 +1,14 @@
+require "concurrent/actor"
+require "event_sourcing/aggregate/wrapper"
+
+module EventSourcing
+  module Aggregate
+    class Manager
+      class Reference < Concurrent::Actor::Reference
+        def instance_of(aggregate, id)
+          EventSourcing::Aggregate::Wrapper.new(self, aggregate, id)
+        end
+      end
+    end
+  end
+end

data/lib/event_sourcing/aggregate/message.rb

@@ -0,0 +1,7 @@
+require "values"
+
+module EventSourcing
+  module Aggregate
+    Message = Value.new(:aggregate, :id, :message)
+  end
+end

data/lib/event_sourcing/aggregate/wrapper.rb

@@ -0,0 +1,18 @@
+require "event_sourcing/aggregate/message"
+require "values"
+
+module EventSourcing
+  module Aggregate
+    class Wrapper < Value.new(:manager, :aggregate, :id)
+
+      def method_missing(name, *args)
+        manager.tell(wrap(name, args))
+      end
+
+      protected
+      def wrap(method, args)
+        Message.new(aggregate, id, [method] + args)
+      end
+    end
+  end
+end

data/lib/event_sourcing/application.rb

@@ -0,0 +1,37 @@
+module EventSourcing
+  module Application
+    require "event_sourcing/application/actor"
+    
+    def self.new(name)
+      Class.new do
+
+        @name = name
+
+        class << self
+
+          attr_reader :name
+
+          def run!(options = {})
+            new(Array(options[:event_store]))
+          end
+
+          def inspect
+            "EventSourcing::Application(#{name})"
+          end
+        end
+        
+        def initialize(options)
+          @actor = Actor.spawn!(name: self.class.name, args: options)
+        end
+
+        def shutdown
+          @actor.terminate!
+        end
+
+        def execute_command(command)
+          @actor.execute_command(command)
+        end
+      end
+    end
+  end
+end