ruby_cqrs 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a5f70e7b70c21215981195e374595fce852f0d94
-  data.tar.gz: 5312d18d87f660591396ca99cc120edb5e63bfb1
+  metadata.gz: e5defe0400414fa278a0716341c10d41dcf050a9
+  data.tar.gz: 303081f7864984adc5675514c0a3355538f67c5c
 SHA512:
-  metadata.gz: 95dbd4d1ebc007450eba00a2f7bc4e8cf2dd47b439299bed29ee1bea5138b09e3058a68528f214345ae7cfdca02df8b78dead78037e810e5f6dcc5fb1a694a41
-  data.tar.gz: 0f4ea2e1eea528a598fa1e34a760994a51276e79c929a7078767ae7e5a4c31afffe5fad7c732ce1c9988618dd5a78a98e029a4ea955ced1c6a30550902dbea37
+  metadata.gz: bb699d7dda967e16639dc5d28b640845941a6c0545ffb4108e9338242352b0bd7a92253ef3b8329d0717c37ca44eb85ffb559c7b0d4874b25d1b70c6b9611bd4
+  data.tar.gz: e975d958f11be45a15dc16b27ab410546d470a80d579dd60cdc94b5bb5a38a25665ac2f0658c7d7d74f8e973e5b8e68428ff28bca43586ccb463069b7e204230

data/lib/ruby_cqrs/data/in_memory_event_store.rb

@@ -9,6 +9,18 @@ module RubyCqrs
         @snapshot_store = {}
       end
 
+      # the returned format is as bellow
+      # { :aggregate_id => some_aggregtate_id(uuid),
+      #   :aggregate_type => the full qualified name of the aggregate type(string),
+      #   :events => [ {:aggregate_id => the aggregate_id of the event belongs to(uuid),
+      #                 :event_type => the full qualified name of the event type(string),
+      #                 :version => the version number of the event(integer),
+      #                 :data => protobuf encoded content of the event object(string)}, ..., {} ],
+      #   :snapshot => { :state_type => the full qualified name of the snapshot type(string),
+      #                  :version => the version number of the aggregate when snapshot(integer),
+      #                  :data => protobuf encoded content of the snapshot object(string)} }
+      # the snapshot object could be null; and the events array should return events which has a version
+      # number greater than the version number of the returning snapshot, if any.
       def load_by guid, command_context
         key = guid.to_sym
         state = { :aggregate_id => guid,
@@ -23,6 +35,8 @@ module RubyCqrs
         state
       end
 
+      # the changes are defined as an array of aggregate change,
+      # each change's format is identical to what above load_by returns
       def save changes, command_context
         changes.each do |change|
           key = change[:aggregate_id].to_sym

data/lib/ruby_cqrs/data/serialization.rb

@@ -13,11 +13,7 @@ module RubyCqrs
         raise ObjectNotEncodableError
       end
     end
-  end
-end
 
-module RubyCqrs
-  module Data
     module Decodable
 
       def try_decode type_str, data

data/lib/ruby_cqrs/domain/aggregate_repository.rb

@@ -2,9 +2,9 @@ require 'active_support/inflector'
 require_relative '../guid'
 
 module RubyCqrs
-  class AggregateNotFound < Error; end
+  class AggregateNotFoundError < Error; end
   class AggregateConcurrencyError < Error; end
-  class AggregateInstanceDuplicatedError < Error; end
+  class AggregateDuplicationError < Error; end
 
   module Domain
     class AggregateRepository
@@ -15,7 +15,7 @@ module RubyCqrs
         raise ArgumentError unless Guid.validate? aggregate_id
 
         state = @event_store.load_by(aggregate_id, @command_context)
-        raise AggregateNotFound if (state.nil? or state[:aggregate_type].nil? or\
+        raise AggregateNotFoundError if (state.nil? or state[:aggregate_type].nil? or\
                                     ((state[:events].nil? or state[:events].empty?) and state[:snapshot].nil?))
 
         create_instance_from state
@@ -59,7 +59,7 @@ module RubyCqrs
 
       def verify_uniqueness_of aggregates
         uniq_array =  aggregates.uniq { |aggregate| aggregate.aggregate_id }
-        raise AggregateInstanceDuplicatedError unless uniq_array.size == aggregates.size
+        raise AggregateDuplicationError unless uniq_array.size == aggregates.size
       end
 
       def prep_changes_for aggregates

data/lib/ruby_cqrs/version.rb

@@ -1,3 +1,3 @@
 module RubyCqrs # :nodoc:
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

data/spec/feature/basic_usage_spec.rb

@@ -15,7 +15,7 @@ class Customer
 
   attr_reader :name, :credit
 
-  # unfortunately, you should not try to define your own initialize method
+  # unfortunately, you should not try to define your own initialize method with parameters
   # at the time being, it could potentially cause error with aggregate_repository
   # when it tries to instantiate an aggregate back to live.
   # Still looking for better way to do this.

data/spec/unit/aggregate_repository_spec.rb

@@ -64,9 +64,9 @@ describe RubyCqrs::Domain::AggregateRepository do
       let(:matches_nothing_repository) { RubyCqrs::Domain::AggregateRepository.new\
                                          empty_event_store, command_context }
 
-      it 'raises error of type AggregateNotFound' do
+      it 'raises error of type AggregateNotFoundError' do
         expect { matches_nothing_repository.find_by(aggregate_id) }.to \
-          raise_error(RubyCqrs::AggregateNotFound)
+          raise_error(RubyCqrs::AggregateNotFoundError)
       end
     end
 
@@ -183,13 +183,13 @@ describe RubyCqrs::Domain::AggregateRepository do
       end
 
       context 'when saving 2 instances of the same aggregate' do
-        it 'raises AggregateInstanceDuplicatedError and nothing should be changed' do
+        it 'raises AggregateDuplicationError and nothing should be changed' do
           aggregate_1 = aggregate_type.new
           aggregate_2 = aggregate_1.dup
           aggregate_1.test_fire
           aggregate_2.test_fire
           aggregates = [ aggregate_1, aggregate_2 ]
-          expect{ repository.save aggregates }.to raise_error(RubyCqrs::AggregateInstanceDuplicatedError)
+          expect{ repository.save aggregates }.to raise_error(RubyCqrs::AggregateDuplicationError)
           expect(aggregate_1.version).to_not eq(aggregate_1.instance_variable_get(:@source_verrsion))
           expect(aggregate_2.version).to_not eq(aggregate_2.instance_variable_get(:@source_verrsion))
         end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_cqrs
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Raven Chen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-14 00:00:00.000000000 Z
+date: 2015-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: uuidtools
@@ -107,7 +107,7 @@ rubyforge_project:
 rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
-summary: ruby_cqrs-0.2.1
+summary: ruby_cqrs-0.2.2
 test_files:
 - spec/feature/basic_usage_spec.rb
 - spec/feature/snapshot_spec.rb