command_post 0.0.1

data/spec/command_post/identity/identity_lookup_value_checksum_spec.rb

@@ -0,0 +1,108 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../command_post/require')
+
+
+
+
+
+class Test002Person < CommandPost::Persistence 
+  include CommandPost::Identity
+
+  def initialize
+    super
+  end
+  def self.schema 
+    fields = Hash.new
+    fields[  :first_name        ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[  :last_name         ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[  :ssn               ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[  :lookup            ] = { :use => :checksum }
+    fields 
+  end 
+end
+
+
+describe CommandPost::Identity do 
+  it 'should produce and return a checksum when declaring the lookup to be :checksum in the schema and the checksum should be able to find the aggregate by value (checksum)'  do 
+
+    params = Hash.new  # like a web request... 
+
+    params['first_name']  = 'John'                                            #hash key is a string to mimic a web post/put
+    params['last_name']   = 'Doe'                                             #hash key is a string to mimic a web post/put
+    params['ssn']         = "%09d" %  CommandPost::SequenceGenerator.misc     #hash key is a string to mimic a web post/put
+
+
+    #----------------------------------------------------------------
+    # The code below will eventually be replaced by the 
+    # 'handle' method of the CommandXXXXXX class.
+    #----------------------------------------------------------------
+
+    object = Test002Person.load_from_hash Test002Person, params
+    event = CommandPost::AggregateEvent.new 
+    event.aggregate_id = object.aggregate_id
+    event.object = object
+    event.aggregate_type =  Test002Person
+    event.event_description = 'hired'
+    event.user_id = 'test' 
+    event.publish
+
+
+
+    #----------------------------------------------------------------
+    # Retrieve the object by both aggregate_id and aggregate_lookup_value
+    # Both ways should retrieve the same object and the fields of both
+    # should match the original values used to create the object.
+    #----------------------------------------------------------------
+
+
+    saved_person = CommandPost::Aggregate.get_by_aggregate_id Test002Person, event.aggregate_id 
+    saved_person2 = CommandPost::Aggregate.get_aggregate_by_lookup_value Test002Person,  saved_person.aggregate_lookup_value
+
+    
+    params['first_name'].must_equal saved_person.first_name
+    params['last_name'].must_equal saved_person.last_name
+    params['ssn'].must_equal saved_person.ssn
+
+    params['first_name'].must_equal saved_person2.first_name
+    params['last_name'].must_equal saved_person2.last_name
+    params['ssn'].must_equal saved_person2.ssn
+  end
+end
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

data/spec/command_post/identity/identity_lookup_value_field_spec.rb

@@ -0,0 +1,83 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../command_post/require')
+
+
+
+
+
+class Test001Person < CommandPost::Persistence 
+  include CommandPost::Identity
+
+  def initialize
+    super
+  end
+  def self.schema 
+    fields = Hash.new
+    fields[  :first_name        ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[  :last_name         ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[  :ssn               ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[  :lookup            ] = { :use => :ssn }
+    fields 
+  end 
+end
+
+
+
+describe CommandPost::Identity do 
+  it 'it should return use the SSN as the lookup value' do 
+
+    params = Hash.new  # like a web request... 
+
+    params['first_name']  = 'John'                                            #hash key is a string to mimic a web post/put
+    params['last_name']   = 'Doe'                                             #hash key is a string to mimic a web post/put
+    params['ssn']         = "%09d" %  CommandPost::SequenceGenerator.misc     #hash key is a string to mimic a web post/put
+
+
+    #----------------------------------------------------------------
+    # The code below will eventually be replaced by the 
+    # 'handle' method of the CommandXXXXXX class.
+    #----------------------------------------------------------------
+
+    object = Test001Person.load_from_hash Test001Person, params
+    puts "OBJECT IS NIL #{'=' * 80}" if object.nil?
+    event = CommandPost::AggregateEvent.new 
+    event.aggregate_id = object.aggregate_id
+    event.object = object
+    event.aggregate_type =  Test001Person
+    event.event_description = 'hired'
+    event.user_id = 'test' 
+    event.publish
+
+
+    #----------------------------------------------------------------
+    # Retrieve the object by both aggregate_id and aggregate_lookup_value
+    # Both ways should retrieve the same object and the fields of both
+    # should match the original values used to create the object.
+    #----------------------------------------------------------------
+
+
+    saved_person = CommandPost::Aggregate.get_by_aggregate_id Test001Person, event.aggregate_id 
+    saved_person2 = CommandPost::Aggregate.get_aggregate_by_lookup_value Test001Person,  saved_person.aggregate_lookup_value
+
+    
+    params['first_name'].must_equal saved_person.first_name
+    params['last_name'].must_equal saved_person.last_name
+    params['ssn'].must_equal saved_person.ssn
+
+    params['first_name'].must_equal saved_person2.first_name
+    params['last_name'].must_equal saved_person2.last_name
+    params['ssn'].must_equal saved_person2.ssn
+  end
+end
+
+
+
+
+
+
+
+
+
+
+
+
+

data/spec/command_post/persistence/data_validation_spec.rb

@@ -0,0 +1,74 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../command_post/require')
+
+class SomeClass  < CommandPost::Persistence 
+  include CommandPost::Identity
+
+  def initialize
+    super
+  end
+
+  def self.schema 
+    fields = Hash.new
+    fields[ :first_name        ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[ :last_name         ] = { :required => true,       :type => String,    :location => :local  } 
+    fields[ :birth_date        ] = { :required => true,       :type => Date,      :location => :local  } 
+    fields[ :favorite_number   ] = { :required => true,       :type => Fixnum,    :location => :local  } 
+    fields 
+  end
+end
+
+
+
+
+def get_instance
+  some_class = SomeClass.new 
+  SomeClass.new 
+end
+
+
+describe CommandPost::DataValidation do 
+
+ it 'should be valid if all required fields are present and types are correct' do
+    obj = get_instance
+    obj.first_name = 'Joe'
+    obj.last_name = 'Schmoe'
+    obj.birth_date = Date.new(1980,1,1)
+    obj.favorite_number = 3
+    obj.valid?.must_equal true
+  end
+
+  it 'should not be valid if missing required fields ' do
+    obj = get_instance
+    obj.first_name = 'Joe'
+    obj.last_name = 'Schmoe'
+    obj.birth_date = Date.new(1980,1,1)
+    # ===>  missing      obj.favorite_number = 3      
+    obj.valid?.must_equal false
+  end
+
+  it 'should not be valid if a type is incorrect ' do
+    obj = get_instance
+    obj.first_name = 'Joe'
+    obj.last_name = 'Schmoe'
+    obj.birth_date = Date.new(1980,1,1)
+    obj.favorite_number = "3"  # <---- should be Fixnum      
+    obj.valid?.must_equal false
+  end
+end
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 

data/spec/command_post/persistence/schema_validation_spec.rb

@@ -0,0 +1,269 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../command_post/require')
+
+
+
+  describe CommandPost::Persistence do 
+
+    it 'should complain if the schema is bad' do
+
+      class SomeClass01 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => true,       :type => String,    :location => :local  } 
+          fields[ :last_name         ] = { :required => true,       :type => String,    :location => :local  } 
+          fields 
+        end
+      end
+      some_class = SomeClass01.new 
+      some_class.class.must_be_same_as SomeClass01
+    end
+
+
+
+
+
+
+
+    it 'should raise an error when a instance of Symbol is not used to identify a field.' do 
+
+      class SomeClass02 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ 'first_name'        ] = { :required => true,       :type => String,    :location => :local  } 
+          fields[ 'last_name'         ] = { :required => true,       :type => String,    :location => :local  } 
+          fields 
+        end 
+      end
+
+      assert_raises(ArgumentError) { some_class = SomeClass02.new } 
+    end
+
+
+
+
+
+
+    it 'should raise an error when a keyword requires a value of true or false but gets neither.'  do 
+
+      class SomeClass03 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => :flase,      :type => String,    :location => :local  } 
+          fields[ :last_name         ] = { :required => true,       :type => String,    :location => :local  }  
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass03.new } 
+    end
+
+
+
+
+
+
+    it 'should raise an error when a :location gets neither :remote or :local for a value.'  do 
+
+      class SomeClass04 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => true,        :type => String,    :location => :x  } 
+          fields[ :last_name         ] = { :required => true,        :type => String,    :location => :local  }  
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass04.new } 
+    end
+
+
+
+
+
+
+    it 'should raise an error when a :auto_load is true but type is not an CommandPost::Identity class.'  do 
+
+      class SomeClass05 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => true,       :type => String,    :location => :local, :auto_load => true  } 
+          fields[ :last_name         ] = { :required => true,       :type => String,    :location => :local  } 
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass05.new } 
+    end
+
+
+
+
+
+
+    it 'should raise an error when a :auto_load is true, :type is Array and :of is not supplied.'  do 
+
+      class SomeClass06 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => true,        :type => Array,     :location => :remote,   :auto_load => true  } 
+          fields[ :last_name         ] = { :required => true,        :type => String,    :location => :local  } 
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass06.new } 
+    end
+
+
+
+
+
+
+
+    it 'should raise an error when a :auto_load is true, :type is Array, :of is supplied but its value is not an CommandPost::Identity class.'  do 
+
+      class SomeClass06 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => false,       :type => Array,   :of => String,  :location => :remote, :auto_load => true  } 
+          fields[ :last_name         ] = { :required => true,        :type => String,    :location => :local  } 
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass06.new } 
+
+    end
+
+
+
+
+
+
+    it 'should raise an error when a :auto_load is true, :type is Array, :of is supplied but it is a CommandPost::IdentityPersistent class, not an CommandPost::Identity class.'  do 
+
+
+      class Helper07 < CommandPost::Persistence 
+      end 
+
+      class SomeClass07 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => true,        :type => Array,   :of => Helper07,  :location => :remote, :auto_load => true  } 
+          fields[ :last_name         ] = { :required => true,        :type => String,                  :location => :local  } 
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass07.new } 
+
+    end
+
+
+
+
+
+
+    it 'should raise an error when a :auto_load is true,  its value is Persistent, but not an CommandPost::Identity class.'  do 
+
+
+      class Helper08 < CommandPost::Persistence 
+      end 
+
+      class SomeClass08 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => true,        :type => Helper08,    :location => :remote, :auto_load => true  } 
+          fields[ :last_name         ] = { :required => true,        :type => String,      :location => :local  } 
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass08.new } 
+    end
+
+
+
+
+    it 'should raise an error when an CommandPost::Identity class is the :type and location is :local.'  do 
+
+
+      class Helper09 < CommandPost::Persistence
+        include CommandPost::Identity 
+      end 
+
+      class SomeClass09 < CommandPost::Persistence 
+        include CommandPost::Identity
+
+        def initialize
+          super
+        end
+
+        def self.schema 
+          fields = Hash.new
+          fields[ :first_name        ] = { :required => true,        :type => Helper09,    :location => :local   } 
+          fields[ :last_name         ] = { :required => true,        :type => String,      :location => :local  } 
+          fields 
+        end
+      end
+
+      assert_raises(ArgumentError)  { some_class = SomeClass09.new } 
+    end
+
+  end
+
+
+ 

data/spec/command_post/require.rb

@@ -0,0 +1,9 @@
+require 'date'
+require 'minitest/autorun'
+require 'minitest/spec'
+require File.expand_path(File.dirname(__FILE__) + '/../../lib/command_post/persistence/persistence')
+require File.expand_path(File.dirname(__FILE__) + '/../../lib/command_post/persistence/data_validation')
+require File.expand_path(File.dirname(__FILE__) + '/../../lib/command_post/identity/identity')
+require File.expand_path(File.dirname(__FILE__) + '/../../lib/command_post/event_sourcing/aggregate')
+require File.expand_path(File.dirname(__FILE__) + '/../../lib/command_post/event_sourcing/aggregate_event')
+require File.expand_path(File.dirname(__FILE__) + '/../../lib/command_post/identity/sequence_generator')

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: command_post
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Joe Meirow
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-21 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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: CommandPost
+email:
+- joe.meirow@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- command_post.gemspec
+- lib/command_post/command/command.rb
+- lib/command_post/command_post.rb
+- lib/command_post/db/connection.rb
+- lib/command_post/db/postgresql.sql
+- lib/command_post/event_sourcing/aggregate.rb
+- lib/command_post/event_sourcing/aggregate_event.rb
+- lib/command_post/identity/identity.rb
+- lib/command_post/identity/sequence_generator.rb
+- lib/command_post/persistence/aggregate_pointer.rb
+- lib/command_post/persistence/auto_load.rb
+- lib/command_post/persistence/data_validation.rb
+- lib/command_post/persistence/persistence.rb
+- lib/command_post/persistence/schema_validation.rb
+- lib/command_post/util/hash_util.rb
+- lib/command_post/util/string_util.rb
+- lib/command_post/version.rb
+- spec/command_post/command/command_spec.rb
+- spec/command_post/identity/identity_lookup_value_aggregate_id_spec.rb
+- spec/command_post/identity/identity_lookup_value_checksum_spec.rb
+- spec/command_post/identity/identity_lookup_value_field_spec.rb
+- spec/command_post/persistence/data_validation_spec.rb
+- spec/command_post/persistence/nested_remote_spec.rb
+- spec/command_post/persistence/schema_validation_spec.rb
+- spec/command_post/require.rb
+- spec/spec_helper.rb
+homepage: http://github.com/jmeirow/command_post
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.7
+signing_key: 
+specification_version: 4
+summary: CommandPost - Object storage/retrieval, event sourcing, command pattern
+test_files:
+- spec/command_post/command/command_spec.rb
+- spec/command_post/identity/identity_lookup_value_aggregate_id_spec.rb
+- spec/command_post/identity/identity_lookup_value_checksum_spec.rb
+- spec/command_post/identity/identity_lookup_value_field_spec.rb
+- spec/command_post/persistence/data_validation_spec.rb
+- spec/command_post/persistence/nested_remote_spec.rb
+- spec/command_post/persistence/schema_validation_spec.rb
+- spec/command_post/require.rb
+- spec/spec_helper.rb