persistence 0.0.1.alpha → 0.0.1

data/spec/persistence/object/complex/index/attribute_index_spec.rb

@@ -0,0 +1,76 @@
+
+require_relative '../../../../../lib/persistence.rb'
+
+describe ::Persistence::Object::Complex::Index::AttributeIndex do
+
+  ##################
+  #  index_object  #
+  ##################
+
+  it 'can index a specific attribute on an object' do
+
+    class ::Persistence::Object::Complex::Index::AttributeIndex::Mock
+      include ::Persistence::Object::Complex
+      attr_non_atomic_accessor :some_value
+    end
+    
+    object = ::Persistence::Object::Complex::Index::AttributeIndex::Mock.new
+
+    bucket = object.persistence_bucket
+
+    bucket.index( :attribute_index ).should == nil
+
+    # before port
+    index_instance = ::Persistence::Object::Complex::Index::AttributeIndex.new( :attribute_index, bucket, false )
+    index_instance.attribute_name = :some_value
+    Proc.new { bucket.create_index( :attribute_index, true ) }.should raise_error
+    index_instance.permits_duplicates?.should == false
+    Proc.new { index_instance.adapter_index }.should raise_error
+    Proc.new { index_instance.index_object( object  ) }.should raise_error
+    Proc.new { index_instance.persisted?( :any_key ) }.should raise_error
+    Proc.new { index_instance.get_object_id( :any_key ) }.should raise_error
+    Proc.new { index_instance.index_object_id( any_id = 0, :any_key ) }.should raise_error
+    Proc.new { index_instance.delete_keys_for_object_id!( any_id = 0 ) }.should raise_error
+
+    # after port
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+
+    index_instance.adapter_index.should_not == nil
+
+    bucket.index( :other_attribute_index ).should == nil
+    index_instance_two = ::Persistence::Object::Complex::Index::AttributeIndex.new( :other_attribute_index, bucket, true )
+    index_instance_two.attribute_name = :some_value
+    index_instance_two.adapter_index.should_not == nil
+    index_instance_two.permits_duplicates?.should == true
+    index_instance_two_conflicting_settings = Proc.new { bucket.create_index( :other_attribute_index, false ) }.should raise_error
+
+    index_instance.persisted?( :any_key ).should == false
+    index_instance.get_object_id( :any_key ).should == nil
+
+    object.some_value = :some_key
+
+    # put object
+    object.persist!
+
+    # create arbitrary index value for object
+    index_instance.index_object( object )
+    
+    # test retrieval of ID for index value
+    index_instance.persisted?( :some_key ).should == true
+    index_instance.get_object_id( :some_key ).should == object.persistence_id
+
+    # delete keys
+    index_instance.delete_keys_for_object_id!( object.persistence_id )
+    index_instance.get_object_id( :some_key ).should == nil
+    
+    # delete object
+    index_instance.index_object( object )
+    index_instance.get_object_id( :some_key ).should == object.persistence_id
+    index_instance.delete_keys_for_object!( object )
+    index_instance.get_object_id( :some_key ).should == nil
+    
+    ::Persistence.disable_port( :mock )
+    
+  end
+
+end

data/spec/persistence/object/flat/bignum_spec.rb

@@ -0,0 +1,33 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe Bignum do
+  
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  it "can put a bignum number object to a persistence port and get it back" do
+    class Bignum
+      include ::Persistence::Object::Flat
+      explicit_index :explicit_index
+    end
+    bignum_object = 10**20
+    bignum_object.persist!
+    Bignum.persist( bignum_object.persistence_id ).should == bignum_object
+    bignum_object.cease!
+    Bignum.persist( bignum_object.persistence_id ).should == nil
+
+    storage_key   = 10**40
+    bignum_object.persist!( :explicit_index => storage_key )
+    Bignum.persist( :explicit_index => storage_key ).should == bignum_object
+    Bignum.cease!( :explicit_index => storage_key )
+    Bignum.persist( :explicit_index => storage_key ).should == nil
+
+  end
+  
+end

data/spec/persistence/object/flat/class_instance_spec.rb

@@ -0,0 +1,30 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe ::Persistence::Object::Flat::ClassInstance do
+  
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+  end
+
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+  
+  #############
+  #  persist  #
+  #############
+  
+  it 'can persist a flat object and test whether it has been persisted' do
+    class ::Persistence::Object::Flat::ClassInstance::Mock
+      include ::Persistence::Object::Flat
+      self.instance_persistence_port = ::Persistence.port( :mock_port )
+    end
+    instance = ::Persistence::Object::Flat::ClassInstance::Mock.new
+    instance.persistence_port.put_object!( instance )
+    instance.persistence_id.nil?.should == false
+    ::Persistence::Object::Flat::ClassInstance::Mock.persisted?( 0 ).should == true
+    ::Persistence::Object::Flat::ClassInstance::Mock.persist( 0 ).should == instance
+  end
+    
+end

data/spec/persistence/object/flat/class_spec.rb

@@ -0,0 +1,38 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe Class do
+  
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  it "can put a class object to a persistence port and get it back" do
+    class Class
+      include ::Persistence::Object::Flat
+      explicit_index :explicit_index
+    end
+
+    class_object = Object
+    class_object.persist!
+    Class.persist( class_object.persistence_id ).should == class_object
+    class_object.cease!
+    Class.persist( class_object.persistence_id ).should == nil
+    ::CascadingConfiguration::Core::Encapsulation.encapsulation( :default ).remove_configuration( Class, :instance_persistence_port )
+    ::CascadingConfiguration::Core::Encapsulation.encapsulation( :default ).remove_configuration( Class, :instance_persistence_bucket )
+
+    storage_key   = String
+    class_object.persist!( :explicit_index, storage_key )
+    Class.persist( :explicit_index, storage_key ).should == class_object
+    Class.cease!( :explicit_index, storage_key )
+    Class.persist( :explicit_index, storage_key ).should == nil
+    ::CascadingConfiguration::Core::Encapsulation.encapsulation( :default ).remove_configuration( Class, :instance_persistence_port )
+    ::CascadingConfiguration::Core::Encapsulation.encapsulation( :default ).remove_configuration( Class, :instance_persistence_bucket )
+
+  end
+  
+end

data/spec/persistence/object/flat/complex_spec.rb

@@ -0,0 +1,36 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe Complex do
+  
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  it "can put a complex number object to a persistence port and get it back" do
+    class Complex
+      include ::Persistence::Object::Flat
+      explicit_index :explicit_index
+    end
+
+    complex_object  = Complex( 42, 1 )
+    storage_key     = Complex( 37, 12 )
+    complex_object.persist!
+    Complex.persist( complex_object.persistence_id ).should == complex_object
+    complex_object.cease!
+    Complex.persist( complex_object.persistence_id ).should == nil
+
+    complex_object  = Complex( 42, 1 )
+    storage_key     = Complex( 37, 12 )
+    complex_object.persist!( :explicit_index, storage_key )
+    Complex.persist( :explicit_index, storage_key ).should == complex_object
+    Complex.cease!( :explicit_index, storage_key )
+    Complex.persist( :explicit_index, storage_key ).should == nil
+
+  end
+  
+end

data/spec/persistence/object/flat/false_class_spec.rb

@@ -0,0 +1,34 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe FalseClass do
+  
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  it "can put a false object to a persistence port and get it back" do
+    class FalseClass
+      include ::Persistence::Object::Flat
+      explicit_index :explicit_index
+    end
+    false_object  = false
+    storage_key   = true
+    false_object.persist!
+    FalseClass.persist( false_object.persistence_id ).should == false_object
+    false_object.cease!
+    FalseClass.persist( false_object.persistence_id ).should == nil
+
+    false_object  = false
+    storage_key   = true
+    false_object.persist!( :explicit_index, storage_key )
+    FalseClass.persist( :explicit_index, storage_key ).should == false_object
+    FalseClass.cease!( :explicit_index, storage_key )
+    FalseClass.persist( :explicit_index, storage_key ).should == nil
+  end
+  
+end

data/spec/persistence/object/flat/file/class_instance_spec.rb

@@ -0,0 +1,54 @@
+
+require_relative '../../../../../lib/persistence.rb'
+
+describe ::Persistence::Object::Flat::File::ClassInstance do
+  
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )  
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )  
+  end
+  
+  #############
+  #  persist  #
+  #############
+  
+  it 'can persist a flat object and test whether it has been persisted' do
+    class ::Persistence::Object::Flat::File::ClassInstance::FileMock < File
+      include ::Persistence::Object::Flat::File
+    end
+    class ::Persistence::Object::Flat::File::Contents
+      include ::Persistence::Object::Flat
+    end
+    class ::Persistence::Object::Flat::File::Path
+      include ::Persistence::Object::Flat
+    end
+    
+    ::Persistence::Object::Flat::File::ClassInstance::FileMock.instance_persistence_port = :mock
+    instance = ::Persistence::Object::Flat::File::ClassInstance::FileMock.open( __FILE__, 'r' )
+    
+    # by content
+    instance_to_persist = ::Persistence::Object::Flat::File::Contents.new( instance.readlines.join )
+    instance_to_persist.persistence_bucket = ::Persistence::Object::Flat::File::ClassInstance::FileMock.instance_persistence_bucket
+    instance_to_persist.persistence_port.put_object!( instance_to_persist )
+    instance_to_persist.persistence_id.should_not == nil
+    
+    ::Persistence::Object::Flat::File::ClassInstance::FileMock.instance_persistence_port.persists_files_by_content!
+    persisted_file = ::Persistence::Object::Flat::File::ClassInstance::FileMock.persist( instance_to_persist.persistence_id )
+    persisted_file.should == instance_to_persist
+
+    # by path
+    instance_to_persist_two = ::Persistence::Object::Flat::File::Path.new( instance.path )
+    instance_to_persist_two.persistence_bucket = ::Persistence::Object::Flat::File::ClassInstance::FileMock.instance_persistence_bucket
+    instance_to_persist_two.persistence_port.put_object!( instance_to_persist_two )
+    instance_to_persist_two.persistence_id.should_not == nil
+
+    ::Persistence::Object::Flat::File::ClassInstance::FileMock.instance_persistence_port.persist_file_paths_as_objects!
+    persisted_file_two = ::Persistence::Object::Flat::File::ClassInstance::FileMock.persist( instance_to_persist_two.persistence_id )
+    persisted_file_two.is_a?( File ).should == true
+    persisted_file_two.path.should == instance_to_persist_two
+  end
+    
+end

data/spec/persistence/object/flat/file/object_instance_spec.rb

@@ -0,0 +1,143 @@
+
+require_relative '../../../../../lib/persistence.rb'
+
+describe ::Persistence::Object::Flat::File::ObjectInstance do
+  
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )  
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )  
+  end
+
+  ##############
+  #  persist!  #
+  ##############
+  
+  it 'can persist a flat object and test whether it has been persisted' do
+    class ::Persistence::Object::Flat::File::ObjectInstance::FileMock < File
+      include ::Persistence::Object::Flat::File
+    end
+    class ::Persistence::Object::Flat::File::Contents
+      include ::Persistence::Object::Flat
+    end
+    class ::Persistence::Object::Flat::File::Path
+      include ::Persistence::Object::Flat
+    end
+    
+    ::Persistence::Object::Flat::File::ObjectInstance::FileMock.instance_persistence_port = :mock
+    instance = ::Persistence::Object::Flat::File::ObjectInstance::FileMock.open( __FILE__, 'r' )
+
+    # by content
+    instance.persists_files_by_content?.should == false
+    instance.persist_files_by_content!
+    instance.persists_files_by_content?.should == true
+    instance.persists_files_by_path?.should == false
+    instance.persist!
+    instance.persistence_id.should_not == nil
+    instance.persistence_port.get_flat_object( instance.persistence_id ).should == instance.readlines.join
+    instance.cease!
+
+    # by path
+    instance.persistence_id = nil
+    instance.persist_files_by_path!
+    instance.persist!
+    instance.persistence_id.should_not == nil
+    instance.persistence_port.get_flat_object( instance.persistence_id ).should == instance.path
+  end
+
+  ###############################
+  #  persist_files_by_path      #
+  #  persists_files_by_content  #
+  #  persists_files_by_path?    #
+  ###############################
+  
+  it 'can persist files either by path or contents' do
+    module ::Persistence::Object::Flat::File::ObjectInstance::PersistFileByPathMock
+      
+      class FileMock < ::File
+        include ::Persistence::Object::Flat::File
+      end
+      
+      # Controller
+      ::Persistence.persists_files_by_path?.should == true
+      ::Persistence.persist_files_by_content!
+      ::Persistence.persists_files_by_path?.should == false
+      ::Persistence.persists_files_by_content?.should == true
+      ::Persistence.persist_files_by_path!
+      ::Persistence.persists_files_by_path?.should == true
+      ::Persistence.persists_files_by_content?.should == false
+      
+      # Port
+      port_instance = FileMock.instance_persistence_port
+      port_instance.persists_files_by_path?.should == true
+      port_instance.persist_files_by_content!
+      port_instance.persists_files_by_path?.should == false
+      port_instance.persists_files_by_content?.should == true
+      port_instance.persist_files_by_path!
+      port_instance.persists_files_by_path?.should == true
+      port_instance.persists_files_by_content?.should == false
+      port_instance.persist_files_by_content!
+      
+      # Bucket
+      bucket_instance = FileMock.instance_persistence_bucket
+      bucket_instance.persists_files_by_path?.should == false
+      port_instance.persist_files_by_path!
+      bucket_instance.persists_files_by_path?.should == true
+      bucket_instance.persists_files_by_content!
+      bucket_instance.persists_files_by_path?.should == false
+      port_instance.persist_files_by_path!
+      bucket_instance.persists_files_by_path?.should == false
+      bucket_instance.persist_files_by_path!
+      port_instance.persists_files_by_content!
+      bucket_instance.persists_files_by_path?.should == true
+      bucket_instance.persists_files_by_content!
+      port_instance.persist_files_by_path!
+      
+      # Class
+      FileMock.class_eval do
+        persists_files_by_path?.should == false
+        bucket_instance.persist_files_by_path!
+        persists_files_by_path?.should == true
+        bucket_instance.persist_files_by_content!
+        persists_files_by_path?.should == false
+        port_instance.persist_files_by_path!
+        persists_files_by_path?.should == false
+        persist_files_by_path!
+        persists_files_by_path?.should == true
+        persists_files_by_content!
+        persists_files_by_path?.should == false
+        bucket_instance.persists_files_by_path?.should == false
+        port_instance.persists_files_by_path?.should == true
+      end
+      
+      # Instance
+      FileMock.new( __FILE__ ).instance_eval do
+        persists_files_by_path?.should == false
+        self.class.persist_files_by_path!
+        persists_files_by_path?.should == true
+        bucket_instance.persist_files_by_content!
+        persists_files_by_path?.should == true
+        self.class.persist_files_by_path!
+        persists_files_by_path?.should == true
+        self.class.persists_files_by_content!
+        persists_files_by_path?.should == false
+        bucket_instance.persist_files_by_path!
+        persists_files_by_path?.should == false      
+        port_instance.persist_files_by_path!
+        persists_files_by_path?.should == false
+        persist_files_by_path!
+        persists_files_by_path?.should == true
+        persists_files_by_content!
+        persists_files_by_path?.should == false
+        self.class.persists_files_by_path?.should == false
+        bucket_instance.persists_files_by_path?.should == true
+        port_instance.persists_files_by_path?.should == true
+      end
+      
+    end
+
+  end
+    
+end