ruby_event_store 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 154e81d7d982c34b92400ed0fd52e37e7c1ba5de
-  data.tar.gz: ec1660f106a05c033c5570cecfe45ae45a648114
+  metadata.gz: 7ae9a071c07547c47d1e9f3ecfdfdc451e9ce235
+  data.tar.gz: 9271a2095a44bceedbe8b4908a6deaff0be50d19
 SHA512:
-  metadata.gz: 97ce3e03d40b9c95fcaf322324a1efe146f2d02647671937af37030271957ab0448657e19c08223649fa03c3b9961ef10c966ddbeaf7aa1c0095e3bf6d7b363e
-  data.tar.gz: e15c18b34e6e661565754e84004ec22e29519f759b188ca3093c466d47f4e7d2af897df0d6935fbfd77be86f32bf5b108e25b50c09ebe6d55f27950df9e21116
+  metadata.gz: a86709c96b0819bbfccff72ae50d27c9813e0bdc7a30a48a6c5a1c41613a3e2aec81cd8def32d96c89e29147ed6d0e5087d664e98a2fcde1fd7b3783664a25a2
+  data.tar.gz: 77c426dfe5eb9e7314f4a86f3d15cddae2acf5b05064427eea7e64fc343cf27532a9d439a2ffd0a5546a5597c67be64a75eba9ecdb74fb249263eb8c12d5c83c

data/.travis.yml

@@ -3,7 +3,7 @@ rvm:
 - 2.1.5
 before_install: gem install bundler
 gemfile: Gemfile
-script: bundle exec mutant --include lib --require ruby_event_store --use rspec "RubyEventStore*"
+script: make mutate
 notifications:
   slack:
     secure: qCcGv1MmryEhPoHzTvZvgSv21UcC7j2Cfq0b0hmQWuYHrHN+jhqjhg7PuElNyr0mk6N1acIcVqOAWpS20ZkG/mipW2RBBXVEc9zVR10pvJnlKDmGKd4Vmj394VgIknn8ciruglw1LoJManf1bV7/Wm4ITMt3zCQqTMGclRUqA0l/dzK2z9zU35cT4v38nTGnoGVrPQx29FvpU3J/h9qC6kGllw3Bkic2nmpFABYOI49LQFF3/vdrbnK3Zo1rudHMV0lNoPg5Ntrbd6XHXUKrBGBcZmGSh3wW/mfYf9Tcft+5MwtCu4b70KnFknx7oFmBlU8JFYg2x5f1xNSIoRkDmLI5/jNDWJ3oLAtYjgY5CdBMlxnhhfnCBmbaxEJhTuscm2sIp+S+4+ggm8x/daIK3BUaBAV5BT8An52BXhQ/F6cdnYiSVn+5lGap/1wF2TWwnN/oVc+JVfATouG9FCygzMekUaji94JMKBtS+QgoLdAE5ufEGBeDONJELRD8Lca1R4uWSg2snf93GWoONca9aJfkIfXj3m+VaoAM9Bq9DGcOXwZESkltE2E+31Fznh5qYCRH1zgtgB0Hx8x7sdaxNQyybvgNS1R0lGnIU/NrUmREcUi5BYEI5YqygBtkTZ7F/nlYQgydKjjHJ6FG3oLc3ggxffE8oAdpuxvlUQ8ZN6o=

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ### HEAD
 
+### 0.6.0 (25.05.2016)
+
+* Ability to provide a custom dispatcher to PubSub::Broker PR #12
+* Add support for projections PR #13
+* Added prettier message for case of missing #handle_event method. PR #14
+* Make file to run all the things PR #15
+
 ### 0.5.0 (21.03.2016)
 
 * Change: Event class refactoring to make default values more explicit PR #11

data/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing to RubyEventStore
+
+Any kind of contribution is welcomed. Here is a few guidelines that we need contributors to follow.
+
+## Found a bug? Have a question?
+
+* [Create a new issue](https://github.com/arkency/ruby_event_store/issues/new), assuming one does not already exist.
+  * Clearly describe the issue including steps to reproduce when it is a bug.
+  * If possible provide a Pull Request with failing test case.
+
+## Getting Started
+
+* Make sure you have a [GitHub account](https://github.com/signup/free).
+* [Fork the repository](https://help.github.com/articles/fork-a-repo/) on GitHub.
+
+## Making Changes
+
+* Create a feature branch from where you want to base your work.
+* Do your work. Please try to keep your commits small and focussed.
+* Make sure you have added the necessary tests for your changes.
+* Push your changes to a feature branch in your fork of the repository.
+* Submit a pull request to the RubyEventStore repository.
+
+# Additional Resources
+
+* [General GitHub documentation](http://help.github.com/)
+* [GitHub pull request documentation](http://help.github.com/send-pull-requests/)

data/Makefile

@@ -0,0 +1,21 @@
+install-bundler: ## Install gem dependencies
+	@echo "Installing gem dependencies"
+	@bundle install
+
+install: install-bundler ## Prepare current development environment
+
+test: ## Run tests
+	@echo "Running basic tests - beware: this won't guarantee build pass"
+	@bundle exec rspec
+
+mutate: test  ## Run mutation tests
+	@echo "Running mutation tests - only 100% free mutation will be accepted"
+	@bundle exec mutant --include lib --require ruby_event_store --use rspec "RubyEventStore*"
+
+.PHONY: help
+
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+
+.DEFAULT_GOAL := help
+

data/README.md

@@ -2,10 +2,19 @@
 [![Gem Version](https://badge.fury.io/rb/ruby_event_store.svg)](http://badge.fury.io/rb/ruby_event_store)
 [![Code Climate](https://codeclimate.com/github/arkency/ruby_event_store/badges/gpa.svg)](https://codeclimate.com/github/arkency/ruby_event_store)
 [![Test Coverage](https://codeclimate.com/github/arkency/ruby_event_store/badges/coverage.svg)](https://codeclimate.com/github/arkency/ruby_event_store/coverage)
+[![Join the chat at https://gitter.im/arkency/rails_event_store](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/arkency/rails_event_store?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 # RubyEventStore
 
-A Ruby implementation of an EventStore. It is an integral part of `rails_event_store` gem.
+A Ruby implementation of an EventStore. It is an integral part of [rails_event_store](http://github.com/arkency/rails_event_store) gem.
+
+# Documentation
+
+All documentation and sample codes are available at [http://railseventstore.arkency.com](http://railseventstore.arkency.com)
+
+# Contributing
+
+Check the contribution guide on [CONTRIBUTING.md](https://github.com/arkency/ruby_event_store/blob/master/CONTRIBUTING.md)
 
 ## About
 

data/lib/ruby_event_store.rb

@@ -1,5 +1,6 @@
 require 'ruby_event_store/pub_sub/broker'
 require 'ruby_event_store/in_memory_repository'
+require 'ruby_event_store/projection'
 require 'ruby_event_store/errors'
 require 'ruby_event_store/constants'
 require 'ruby_event_store/facade'

data/lib/ruby_event_store/projection.rb

@@ -0,0 +1,56 @@
+module RubyEventStore
+  class Projection
+    private_class_method :new
+
+    def self.from_stream(*streams)
+      raise(ArgumentError, "At least one stream must be given") if streams.empty?
+      new(streams)
+    end
+
+    def initialize(streams)
+      @streams  = streams
+      @handlers = Hash.new { ->(_, _) {} }
+      @init     = -> { Hash.new }
+    end
+
+    attr_reader :streams, :handlers
+
+    def init(handler)
+      @init = handler
+      self
+    end
+
+    def when(event, handler)
+      @handlers[event] = handler
+      self
+    end
+
+    def initial_state
+      @init.call
+    end
+
+    def current_state
+      @current_state ||= initial_state
+    end
+
+    def handle_event(event)
+      handlers[event.class].(current_state, event)
+    end
+
+    def handled_events
+      handlers.keys
+    end
+
+    def call(event_store)
+      streams.reduce(initial_state) do |state, stream|
+        event_store.read_stream_events_forward(stream).reduce(state, &method(:transition))
+      end
+    end
+
+    private
+    def transition(state, event)
+      handlers[event.class].(state, event)
+      state
+    end
+  end
+end

data/lib/ruby_event_store/pub_sub/broker.rb

@@ -1,10 +1,12 @@
 module RubyEventStore
   module PubSub
     class Broker
+      DEFAULT_DISPATCHER = ->(subscriber, event) { subscriber.handle_event(event) }
 
-      def initialize
+      def initialize(dispatcher = DEFAULT_DISPATCHER)
         @subscribers = Hash.new {|hsh, key| hsh[key] = [] }
         @global_subscribers = []
+        @dispatcher = dispatcher
       end
 
       def add_subscriber(subscriber, event_types)
@@ -19,16 +21,16 @@ module RubyEventStore
 
       def notify_subscribers(event)
         all_subscribers_for(event.class).each do |subscriber|
-          subscriber.handle_event(event)
+          dispatcher.call(subscriber, event)
         end
       end
 
       private
-      attr_reader :subscribers
+      attr_reader :subscribers, :dispatcher
 
       def verify_subscriber(subscriber)
         raise SubscriberNotExist if subscriber.nil?
-        raise MethodNotDefined unless subscriber.methods.include? :handle_event
+        ensure_method_defined(subscriber)
       end
 
       def subscribe(subscriber, event_types)
@@ -37,9 +39,19 @@ module RubyEventStore
         end
       end
 
+      def ensure_method_defined(subscriber)
+        unless subscriber.methods.include? :handle_event
+          raise MethodNotDefined.new(method_not_defined_message(subscriber))
+        end
+      end
+
       def all_subscribers_for(event_type)
         subscribers[event_type] + @global_subscribers
       end
+
+      def method_not_defined_message(subscriber)
+        "#handle_event method is not found in #{subscriber.class} subscriber. Are you sure it is a valid subscriber?"
+      end
     end
   end
 end

data/lib/ruby_event_store/version.rb

@@ -1,3 +1,3 @@
 module RubyEventStore
-  VERSION = '0.5.0'
+  VERSION = '0.6.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_event_store
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - rybex
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-03-21 00:00:00.000000000 Z
+date: 2016-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -92,7 +92,9 @@ files:
 - ".gitignore"
 - ".travis.yml"
 - CHANGELOG.md
+- CONTRIBUTING.md
 - Gemfile
+- Makefile
 - README.md
 - Rakefile
 - lib/ruby_event_store.rb
@@ -101,6 +103,7 @@ files:
 - lib/ruby_event_store/event.rb
 - lib/ruby_event_store/facade.rb
 - lib/ruby_event_store/in_memory_repository.rb
+- lib/ruby_event_store/projection.rb
 - lib/ruby_event_store/pub_sub/broker.rb
 - lib/ruby_event_store/spec/event_repository_lint.rb
 - lib/ruby_event_store/version.rb