persistence 0.0.1.alpha → 0.0.1

data/spec/persistence/adapter/primary_key/id_property_string_spec.rb

@@ -0,0 +1,27 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe ::Persistence::Adapter::Abstract::PrimaryKey::IDPropertyString do
+
+  ####################################
+  #  primary_key_for_attribute_name  #
+  ####################################
+
+  it 'can be used for a simple primary key' do
+    class ::Persistence::Adapter::Abstract::PrimaryKey::IDPropertyString::Mock
+      include ::Persistence::Adapter::Abstract::PrimaryKey::IDPropertyString
+      Delimiter = '-'
+      def persistence_port
+        return ::Persistence::Adapter::Abstract::PrimaryKey::IDPropertyString::MockPort.new
+      end
+    end
+    ::Persistence::Adapter::Abstract::PrimaryKey::IDPropertyString::Mock.new.instance_eval do
+      instance = Object.new
+      instance.extend( ::CascadingConfiguration::Setting )
+      instance.attr_object_configuration :persistence_id
+      instance.persistence_id = 0
+      primary_key_for_attribute_name( instance, :attribute_name ).should == '0-attribute_name'
+    end
+  end
+
+end

data/spec/persistence/adapter/primary_key/simple_spec.rb

@@ -0,0 +1,19 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe ::Persistence::Adapter::Abstract::PrimaryKey::Simple do
+
+  ####################################
+  #  primary_key_for_attribute_name  #
+  ####################################
+
+  it 'can be used for a simple primary key' do
+    class ::Persistence::Adapter::Abstract::PrimaryKey::Simple::Mock
+      include ::Persistence::Adapter::Abstract::PrimaryKey::Simple
+    end
+    ::Persistence::Adapter::Abstract::PrimaryKey::Simple::Mock.new.instance_eval do
+      primary_key_for_attribute_name( self, :attribute_name ).should == :attribute_name
+    end
+  end
+  
+end

data/spec/persistence/adapter/spec_abstract/adapter_spec.rb

@@ -0,0 +1,223 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe ::Persistence::Adapter do
+  
+  before :all do
+
+    @adapter = $__persistence__spec__adapter__ || ::Persistence::Adapter::Mock.new( '/tmp/persistence_home' )
+
+    ::Persistence.enable_port( :mock, @adapter )
+
+    class ::Persistence::Adapter::MockObject
+      include ::Persistence::Object::ObjectInstance
+      extend ::Persistence::Object::ClassInstance
+      include ::Persistence::Object::Complex::ObjectInstance
+      extend ::Persistence::Object::Complex::ClassInstance
+      include ::CascadingConfiguration::Setting
+      attr_non_atomic_accessor :attribute
+    end
+
+    @object = ::Persistence::Adapter::MockObject.new
+    @object.attribute = :some_value
+
+    @bucket = @adapter.persistence_bucket( @object.persistence_bucket.name )    
+
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+  
+  ################
+  #  initialize  #
+  #  enable      #
+  #  disable     #
+  #  enabled?    #
+  ################
+
+  it 'can initialize enabled state, enable, disable, and report whether enabled' do
+    @object.persistence_port.instance_eval do
+      enabled?.should == true
+      disable
+      enabled?.should == false
+      enable
+      enabled?.should == true
+    end
+  end
+
+  #################
+  #  put_object!  #
+  #################
+
+  it "can put and get an object with simple properties and sub objects" do
+  
+    # put_object!
+    @bucket.put_object!( @object )
+    @object.persistence_id.should_not == nil
+    
+    retrieved_object_hash = @bucket.get_object( @object.persistence_id )
+    retrieved_object_hash.should == {:attribute=>:some_value}
+    
+  end
+
+  ###########
+  #  count  #
+  ###########
+  
+  it 'can report how many objects are persisted' do
+
+    @bucket.count.should == 1
+    
+  end
+
+  ####################
+  #  delete_object!  #
+  ####################
+
+  it "can delete an object" do
+
+    # delete_object!
+    @bucket.delete_object!( @object.persistence_id )
+    @bucket.get_object( @object.persistence_id ).should == nil
+
+    # now put it back
+    @object.persistence_id = nil
+    @bucket.put_object!( @object )
+    retrieved_object_hash = @bucket.get_object( @object.persistence_id )
+    retrieved_object_hash.should == {:attribute=>:some_value}
+    
+  end
+
+  ###################################
+  #  get_bucket_name_for_object_id  #
+  ###################################
+
+  it "can get a bucket for a given object ID" do
+
+    # get_bucket_name_for_object_id
+    @adapter.get_bucket_name_for_object_id( @object.persistence_id ).should == @object.persistence_bucket.name
+  
+  end
+
+  #############################
+  #  get_class_for_object_id  #
+  #############################
+
+  it "can get a class for a given object ID" do
+
+    # get_class_for_object_id
+    @adapter.get_class_for_object_id( @object.persistence_id ).should == @object.class
+  
+  end
+
+  ####################
+  #  put_attribute!  #
+  ####################
+
+  it "can put a attribute for an object" do
+  
+    # put_attribute!
+    primary_key = @bucket.primary_key_for_attribute_name( @object, :attribute )
+    @bucket.put_attribute!( @object, primary_key, 'attribute!' )
+  
+  end
+
+  ###################
+  #  get_attribute  #
+  ###################
+
+  it "can get a attribute for an object" do
+
+    # get_attribute
+    primary_key = @bucket.primary_key_for_attribute_name( @object, :attribute )
+    @bucket.get_attribute( @object, primary_key ).should == 'attribute!'
+  
+  end
+
+  #######################
+  #  delete_attribute!  #
+  #######################
+
+  it "can delete a attribute on an object" do
+
+    # delete_attribute!
+    primary_key = @bucket.primary_key_for_attribute_name( @object, :attribute )
+    @bucket.delete_attribute!( @object, primary_key )
+    @bucket.get_attribute( @object, primary_key ).should == nil
+  
+  end
+
+  ##################
+  #  create_index  #
+  #  has_index?    #
+  #  index         #
+  ##################
+
+  it 'can create an index on a class so instances can be retrieved by key and report whether a given index exists' do
+    @bucket.create_index( :key, false )
+    @bucket.has_index?( :key ).should == true
+    @bucket.index( :key ).should_not == nil
+    @bucket.create_index( :duplicate_key, true )
+    @bucket.has_index?( :duplicate_key ).should == true
+    @bucket.index( :duplicate_key ).should_not == nil
+  end
+
+  #########################
+  #  permits_duplicates?  #
+  #########################
+
+  it 'can report whether an index permits duplicate entries' do
+    @bucket.index( :key ).permits_duplicates?.should == false
+    @bucket.index( :duplicate_key ).permits_duplicates?.should == true
+  end
+
+  ##################
+  #  index_object  #
+  ##################
+
+  it 'can index an object based on a created index so that the object ID can be retrieved by key' do
+    @bucket.index( :key ).index_object_id( @object.persistence_id, @object.attribute )
+    @bucket.index( :key ).get_object_id( @object.attribute ).should == @object.persistence_id
+  end
+
+  ###########
+  #  count  #
+  ###########
+  
+  it 'can report how many objects are persisted' do
+    
+    @bucket.index( :key ).count.should == 1
+    
+  end
+
+  ###################
+  #  get_object_id  #
+  ###################
+
+  it "can get the object ID corresponding to a key in a bucket" do
+  
+    # get_object_id_for_index_and_key
+    @bucket.index( :key ).get_object_id( @object.attribute ).should == @object.persistence_id
+
+  end
+
+  ################################
+  #  delete_keys_for_object_id!  #
+  ################################
+
+  it 'can delete index values for an object' do
+    @bucket.index( :key ).delete_keys_for_object_id!( @object.persistence_id )
+    ( @bucket.index( :key ).get_object_id( @object.attribute ) ? true : false ).should == false
+  end
+
+  ##################
+  #  delete_index  #
+  ##################
+
+  it 'can delete an index that has been created on a class attribute' do
+    @bucket.delete_index( :key )
+    @bucket.has_index?( :key ).should == false
+  end
+  
+end

data/spec/persistence/adapter/spec_abstract/cursor_spec.rb

@@ -0,0 +1,116 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+require_relative '../mock_helpers.rb'
+
+describe ::Persistence::Adapter do
+  
+  before :all do
+
+    @adapter = $__persistence__spec__adapter__ || ::Persistence::Adapter::Mock.new( '/tmp/persistence_home' )
+
+    ::Persistence.enable_port( :mock, @adapter )
+
+    class ::Persistence::Adapter::MockCursorObject
+      include ::Persistence
+      attr_non_atomic_accessor :attribute
+      attr_index :attribute
+    end
+    
+    @bucket = ::Persistence::Adapter::MockCursorObject.instance_persistence_bucket.adapter_bucket
+    @index = @bucket.index( :attribute )
+
+    @objects = [ ]
+    ::Persistence::Adapter::Abstract::Mock::Object.instance_persistence_bucket = @bucket
+    5.times do |this_number|
+      this_attribute = 'Number ' << this_number.to_s
+      unless instance = ::Persistence::Adapter::MockCursorObject.persist( :attribute, this_attribute )
+        instance = ::Persistence::Adapter::MockCursorObject.new
+        instance.attribute = this_attribute
+        instance.persist!
+      end
+      @objects[ this_number ] = instance
+    end    
+
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  ################
+  #  first       #
+  #  get_key     #
+  #  persisted?  #
+  #  current     #
+  #  next        #
+  ################
+
+  it 'it can return an object ID for persistence ID' do
+    
+    # persistence id
+    bucket_cursor = @bucket.cursor
+    
+    if bucket_cursor.supports_bucket_order?
+    
+      bucket_cursor.first.should == @objects[ 0 ].persistence_id
+
+      bucket_cursor.persisted?( @objects[ 0 ].persistence_id ).should == true
+      bucket_cursor.current.should == @objects[ 0 ].persistence_id
+
+      bucket_cursor.persisted?( @objects[ 3 ].persistence_id ).should == true
+      bucket_cursor.persisted?( @objects[ 2 ].persistence_id ).should == true
+      
+    else
+      
+      begin
+        has_object = false
+        while this_object_id = bucket_cursor.next
+          @objects.each do |this_object|
+            break if has_object = ( this_object.persistence_id == this_object_id )
+          end
+          has_object.should == true
+        end
+      rescue ::StopIteration
+      end
+      
+    end
+    
+    bucket_cursor.close
+
+  end
+  
+  it 'it can return an object ID for key' do
+    
+    # index
+    index_cursor = @index.cursor
+    
+    if index_cursor.supports_index_order?
+      
+      index_cursor.first.should == @objects[ 0 ].persistence_id
+
+      index_cursor.persisted?( @objects[ 0 ].attribute ).should == true
+      index_cursor.current.should == @objects[ 0 ].persistence_id
+
+      index_cursor.persisted?( @objects[ 1 ].attribute ).should == true
+
+    else
+      
+      begin
+        has_object = false
+        while this_object_id = index_cursor.next
+          @objects.each do |this_object|
+            break if has_object = ( this_object.persistence_id == this_object_id )
+          end
+          has_object.should == true
+        end
+      rescue ::StopIteration
+      end
+      
+    end
+    
+    index_cursor.close
+    
+  end
+
+end

data/spec/persistence/cursor/atomic_spec.rb

@@ -0,0 +1,86 @@
+
+require_relative '../../../lib/persistence.rb'
+
+describe ::Persistence::Cursor::Atomic do
+
+  before( :all ) do
+
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+
+    class ::Persistence::Cursor::Atomic::Mock
+      include ::Persistence
+      attr_non_atomic_accessor :name
+    end
+
+    @objects = [ ]
+    5.times do |this_number|
+      instance = ::Persistence::Cursor::Atomic::Mock.new
+      instance.name = 'Number ' << this_number.to_s
+      instance.persist!
+      @objects.push( instance )
+    end    
+
+    @cursor = ::Persistence::Cursor::Atomic::Mock.instance_persistence_bucket.atomic_cursor
+    
+  end
+
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  ################
+  #  persisted?  #
+  ################
+
+  it 'can report whether a key exists and set its position to the key if it does' do
+    @cursor.persisted?( @objects[ 0 ].persistence_id ).should == true
+  end
+
+  ###########
+  #  first  #
+  ###########
+  
+  it 'can set its position to the first key' do
+    @cursor.first.should == @objects.first
+    @cursor.first.instance_variables.empty?.should == true
+    @cursor.first( 2 ).should == @objects.first( 2 )
+  end
+
+  #############
+  #  current  #
+  #############
+  
+  it 'can return the current key' do
+    @cursor.first
+    @cursor.current.should == @objects.first
+    @cursor.current.instance_variables.empty?.should == true
+  end
+
+  ##########
+  #  next  #
+  ##########
+  
+  it 'can set its position to the next key' do
+    @cursor.first.should == @objects[ 0 ]
+    @cursor.next.should == @objects[ 0 ]
+    @cursor.next.should == @objects[ 1 ]
+    @cursor.next( 2 ).should == @objects[ 2..3 ]
+  end
+
+  ##########
+  #  each  #
+  ##########
+
+  it 'can iterate each record' do
+    @cursor.first
+    @cursor.each_with_index do |this_object, this_index|
+      this_object.should == @objects[ this_index ]
+    end
+    @cursor.first
+    enum = @cursor.each
+    enum.is_a?( Enumerator ).should == true
+    enum.next.should == @objects[ 0 ]
+    enum.next.should == @objects[ 1 ]
+  end
+
+end