persistence 0.0.1.alpha → 0.0.1

data/spec/persistence/port/bucket/bucket_interface_spec.rb

@@ -0,0 +1,146 @@
+
+require_relative '../../../../lib/persistence.rb'
+
+describe ::Persistence::Port::Bucket::BucketInterface do
+
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  ################
+  #  initialize  #
+  ################
+  
+  it 'can initialize with an adapter and bucket name' do
+    class ::Persistence::Port::Bucket::BucketInterface::Mock
+      include ::Persistence::Port::Bucket::BucketInterface
+    end
+    instance_two = ::Persistence::Port::Bucket::BucketInterface::Mock.new( :mock, :some_bucket )
+    instance_two.parent_port.should == ::Persistence.port( :mock )
+    instance_two.adapter_bucket.name.should == :some_bucket
+  end
+
+  #####################
+  #  put_object!      #
+  #  count            #
+  #  get_object       #
+  #  get_flat_object  #
+  #  delete_object!   #
+  #####################
+
+  it 'can serve as an adapter to a persistence bucket instance in an adapter instance' do
+    module ::Persistence::Port::Bucket::BucketInterface::PutGetDeleteObjectMock
+    
+      class ::Persistence::Port::Bucket::BucketInterface::Mock
+        include ::Persistence::Port::Bucket::BucketInterface
+      end
+      class ::Persistence::Port::Bucket::BucketInterface::MockClass
+        attr_accessor :persistence_port, :persistence_id
+        def instance_variable_hash
+          persistence_hash = { }
+          instance_variables.each do |this_variable|
+            persistence_hash[ this_variable ] = instance_variable_get( this_variable )
+          end
+          return persistence_hash
+        end
+        alias_method :persistence_hash_to_port, :instance_variable_hash
+        def load_persistence_hash( port, persistence_hash )
+          self.persistence_port = port
+          persistence_hash.each do |this_variable, this_value|
+            instance_variable_set( this_variable, this_value )
+          end
+          return self
+        end
+        def self.instance_persistence_bucket
+          return @bucket ||= ::Persistence::Port::Bucket.new( :mock, self.to_s )
+        end
+        def persistence_bucket
+          return self.class.instance_persistence_bucket
+        end
+        def self.non_atomic_attribute_readers
+          return [ ]
+        end
+      end
+      instance = ::Persistence::Port::Bucket::BucketInterface::Mock.new( :mock, :some_bucket )
+      object = ::Persistence::Port::Bucket::BucketInterface::MockClass.new
+      instance.put_object!( object )
+      object.persistence_id.should_not == nil
+      instance.count.should == 1
+      instance.get_object( object.persistence_id ).instance_variable_hash.should == object.instance_variable_hash
+      instance.delete_object!( object.persistence_id )
+      instance.get_object( object.persistence_id ).should == nil
+      class StringMock < String
+        attr_accessor :persistence_id
+        def self.instance_persistence_bucket
+          return @bucket ||= ::Persistence::Port::Bucket.new( :mock, self.to_s )
+        end
+        def persistence_bucket
+          return self.class.instance_persistence_bucket
+        end
+        def persistence_hash_to_port
+          return { self.class.to_s => self }
+        end
+      end
+      string_object = StringMock.new( 'some string' )
+      instance.put_object!( string_object )
+      instance.get_flat_object( string_object.persistence_id ).should == string_object
+      instance.delete_object!( string_object.persistence_id )
+    
+    end
+  end
+
+  ###################################
+  #  delete_cascades?               #
+  #  get_attribute                   #
+  #  put_attribute!                  #
+  #  delete_attribute!               #
+  #  primary_key_for_attribute_name  #
+  ###################################
+  
+  it 'can serve as an adapter to a persistence bucket instance in an adapter instance' do
+    class ::Persistence::Port::Bucket::BucketInterface::Mock
+      include ::Persistence::Port::Bucket::BucketInterface
+    end
+    class ::Persistence::Port::Bucket::BucketInterface::MockClass
+      include ::CascadingConfiguration::Hash
+      attr_accessor :persistence_port, :persistence_bucket, :persistence_id
+      def persistence_hash_to_port
+        persistence_hash = { :simple_var => @simple_var }
+        return persistence_hash
+      end
+      def load_persistence_hash( port, persistence_hash )
+        self.persistence_port = port
+        persistence_hash.each do |this_variable, this_value|
+          instance_variable_set( this_variable, this_value )
+        end
+        return self
+      end
+    end
+    instance = ::Persistence::Port::Bucket::BucketInterface::Mock.new( :mock, :some_bucket )
+    sub_object = ::Persistence::Port::Bucket::BucketInterface::MockClass.new.instance_eval do
+      @simple_var = :value
+      self
+    end
+    sub_object.persistence_port = ::Persistence.port( :mock )
+    sub_object.persistence_bucket = instance
+    object = ::Persistence::Port::Bucket::BucketInterface::MockClass.new.instance_eval do
+      @simple_var = :some_value
+      self
+    end
+    object.persistence_port = ::Persistence.port( :mock )
+    object.persistence_bucket = instance
+    object.persistence_port.persistence_bucket( :some_bucket ).put_object!( object )
+    object.persistence_id.should_not == nil
+    instance.get_attribute( object, :simple_var ).should == :some_value
+    instance.put_attribute!( object, :simple_var, sub_object )
+    instance.get_attribute( object, :simple_var ).persistence_hash_to_port.should == sub_object.persistence_hash_to_port
+    instance.delete_attribute!( object, :simple_var )
+    instance.get_attribute( object, :simple_var ).should == nil
+    instance.primary_key_for_attribute_name( object, :simple_var ).should == :simple_var
+  end
+  
+end

data/spec/persistence/port/bucket/index/bucket_index_spec.rb

@@ -0,0 +1,67 @@
+
+require_relative '../../../../../lib/persistence.rb'
+
+describe ::Persistence::Port::Bucket::BucketIndex do
+
+  it 'is a block index that runs on all inserts into a bucket' do
+    class ::Persistence::Port::Bucket::BucketIndex::Mock
+      include ::Persistence::Object
+      attr_accessor :some_value
+    end
+    
+    object = ::Persistence::Port::Bucket::BucketIndex::Mock.new
+
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+
+    index_instance = object.persistence_bucket.create_index( :bucket_index ) do |object|
+      object.some_value
+    end
+    
+    index_instance.is_a?( ::Persistence::Port::Bucket::BucketIndex ).should == true
+
+    ::Persistence.disable_port( :mock )
+
+  end
+
+  ##################
+  #  create_index  #
+  #  has_index?    #
+  #  count         #
+  #  index         #
+  ##################
+
+  it 'can create an index and then separately retrieve that index' do
+    # before port is open    
+    class ::Persistence::Port::Bucket::BucketIndex::Mock
+      include ::Persistence::Object
+      attr_atomic_accessor :some_value, :some_other_value
+    end
+    
+    bucket = ::Persistence::Port::Bucket::BucketIndex::Mock.instance_persistence_bucket
+    index_instance = bucket.create_index( :index ) do |object|
+      object.some_value
+    end
+    Proc.new { index_instance.adapter_index }.should raise_error
+    bucket.index( :index ).should == index_instance
+
+    # after port is open
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+    index_instance_two = bucket.create_index_with_duplicates( :other_index ) do |object|
+      object.some_other_value
+    end
+    index_instance_two.adapter_index.should_not == nil
+    bucket.index( :other_index ).should == index_instance_two
+    
+    instance = ::Persistence::Port::Bucket::BucketIndex::Mock.new
+    instance.some_value = :a_value
+    bucket.put_object!( instance )
+    bucket.index( :index ).index_object( instance )
+    bucket.count.should == 1
+    bucket.index( :index ).count.should == 1
+    bucket.index( :other_index ).count.should == 0
+    
+    ::Persistence.disable_port( :mock )
+
+  end
+
+end

data/spec/persistence/port/bucket_spec.rb

@@ -0,0 +1,20 @@
+
+require_relative '../../../lib/persistence.rb'
+
+describe ::Persistence::Port::Bucket do
+
+  before :all do
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+  end
+  
+  after :all do
+    ::Persistence.disable_port( :mock )
+  end
+
+  it 'is a module cluster' do
+    ::Persistence::Port::Bucket.new( :mock, :some_bucket ).instance_eval do
+      is_a?( ::Persistence::Port::Bucket::BucketInterface ).should == true
+    end
+  end
+  
+end

data/spec/persistence/port/controller_spec.rb

@@ -0,0 +1,60 @@
+
+require_relative '../../../lib/persistence.rb'
+
+describe ::Persistence::Port::Controller do
+
+  ###########################
+  #  enable_port            #
+  #  port                   #
+  #  current_port           #
+  #  disable_port           #
+  #  set_current_port       #
+  #  port_for_name_or_port  #
+  ###########################
+
+  it 'can enable a port with an adapter instance, get it by name or as the current port, disable it, and re-enable it later' do
+    class ::Persistence::Port::Controller::Mock
+      extend ::Persistence::Port::Controller
+      mock_adapter_instance = ::Persistence::Adapter::Mock.new
+      first_port = enable_port( :mock_adapter, mock_adapter_instance )
+      mock_adapter_instance.enabled?.should == true
+      port( :mock_adapter ).should == first_port
+      first_port.enabled?.should == true
+      current_port.should == first_port
+      disable_port( :mock_adapter )
+      current_port.should == nil
+      mock_adapter_instance.disabled?.should == true
+      second_mock_adapter_instance = ::Persistence::Adapter::Mock.new
+      second_port = enable_port( :second_mock_adapter, second_mock_adapter_instance )
+      port( :second_mock_adapter ).should == second_port
+      second_port.enabled?.should == true
+      current_port.should == second_port
+      set_current_port( :mock_adapter )
+      current_port.should == first_port
+      current_port.disabled?.should == true
+      set_current_port( nil )
+      current_port.should == nil
+      disable_port( :mock_adapter )
+      disable_port( :second_mock_adapter )
+    end
+  end
+
+  ############################
+  #  create_pending_buckets  #
+  #  pending_bucket          #
+  ############################
+  
+  it 'can allow a bucket to be initialized before its port is open' do
+    bucket_instance = ::Persistence.pending_bucket( ::Persistence::Port::Controller, :some_bucket )
+    ::Persistence.instance_eval do
+      pending_buckets.should == { ::Persistence::Port::Controller => bucket_instance }
+    end
+    ::Persistence.enable_port( :mock, ::Persistence::Adapter::Mock.new )
+    ::Persistence.instance_eval do
+      pending_buckets.should == {}
+    end
+    bucket_instance.parent_port.should == ::Persistence.port( :mock )
+    ::Persistence.disable_port( :mock )
+  end
+
+end

data/spec/persistence/port/port_interface_spec.rb

@@ -0,0 +1,105 @@
+
+require_relative '../../../lib/persistence.rb'
+
+require_relative '../adapter/mock_helpers.rb'
+
+describe ::Persistence::Port::PortInterface do
+  
+  before :all do
+
+    class ::Persistence::Port::PortInterface::Mock
+      include ::Persistence::Port::PortInterface
+    end
+
+    @adapter = ::Persistence::Adapter::Mock.new
+    @port_interface = ::Persistence::Port::PortInterface::Mock.new( :port_name, @adapter )
+    @port_interface.enable
+    
+  end
+
+  ################
+  #  initialize  #
+  ################
+
+  it 'can initialize with a port name and adapter instance' do
+    @port_interface.instance_eval do
+      name.should == :port_name
+    end
+  end
+
+  ###############
+  #  enable     #
+  #  enabled?   #
+  #  disabled?  #
+  #  disable    #
+  ###############
+
+  it 'can be enabled, disabled, and report whether it is enabled or not' do
+    @port_interface.instance_eval do
+      enable
+      enabled?.should == true
+      disabled?.should == false
+      disable
+      enabled?.should == false
+      disabled?.should == true
+      enable
+    end
+  end
+  
+  ########################
+  #  persistence_bucket  #
+  ########################
+  
+  it 'can return a persistence bucket instance linked to the bucket instance in the adapter' do
+    @port_interface.persistence_bucket( :some_bucket ).is_a?( ::Persistence::Port::Bucket ).should == true
+  end
+  
+  ###################################
+  #  put_object!                    #
+  #  get_bucket_name_for_object_id  #
+  #  get_class_for_object_id        #
+  #  get_object                     #
+  #  get_object                     #
+  #  delete_object!                 #
+  #  get_flat_object                #
+  ###################################
+
+  it 'can interface with the adapter' do
+    @object = ::Persistence::Adapter::Abstract::Mock::Object.new
+    @object.class.instance_persistence_port = @port_interface
+    bucket = @port_interface.persistence_bucket( :some_bucket )
+    bucket.initialize_for_port( @port_interface )
+    @object.class.instance_persistence_bucket = bucket
+    @object.class.non_atomic_attribute_readers.push( :some_value, :other_value )
+    @object.instance_eval do
+      @some_value = :value
+      @other_value = :other_value
+    end
+    @port_interface.put_object!( @object )
+    @object.persistence_id.should_not == nil
+    
+    @port_interface.get_bucket_name_for_object_id( @object.persistence_id ).should == @object.persistence_bucket.name
+    @port_interface.get_class_for_object_id( @object.persistence_id ).should == @object.class
+
+    persisted_object = @port_interface.get_object( @object.persistence_id )
+    persisted_object.persistence_id.should == @object.persistence_id
+    @port_interface.delete_object!( @object.persistence_id )
+    @port_interface.get_object( @object.persistence_id ).should == nil
+    class String
+      attr_accessor :persistence_id
+      def self.instance_persistence_bucket
+        return @bucket ||= ::Persistence::Adapter::Abstract::Mock::Object.instance_persistence_bucket
+      end
+      def persistence_bucket
+        return self.class.instance_persistence_bucket
+      end
+      def persistence_hash_to_port
+        return { self.class.to_s => self }
+      end
+    end
+    some_string = 'some string'
+    @port_interface.put_object!( some_string )
+    @port_interface.get_flat_object( some_string.persistence_id ).should == some_string
+  end
+  
+end

metadata

@@ -1,32 +1,187 @@
 --- !ruby/object:Gem::Specification
 name: persistence
 version: !ruby/object:Gem::Version
-  version: 0.0.1.alpha
-  prerelease: 6
+  version: 0.0.1
+  prerelease: 
 platform: ruby
 authors:
-- Joe Sak
+- Asher
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-26 00:00:00.000000000 Z
-dependencies: []
-description: An attempt at abstracting the ORM layer from domain objects
-email:
-- joe@joesak.com
+date: 2012-06-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: module-cluster
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cascading-configuration
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Store and retrieve Ruby objects without thinking twice about how they
+  are stored. Designed for maximum in flexibility and intuitive interface.
+email: asher@ridiculouspower.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- Gemfile
-- LICENSE
-- README.md
-- Rakefile
+- lib/namespaces.rb
+- lib/persistence/adapter/abstract/enable_disable.rb
+- lib/persistence/adapter/abstract/primary_key/id_property_string.rb
+- lib/persistence/adapter/abstract/primary_key/simple.rb
+- lib/persistence/adapter/abstract.rb
+- lib/persistence/adapter/mock/adapter_interface.rb
+- lib/persistence/adapter/mock/bucket/bucket_interface.rb
+- lib/persistence/adapter/mock/bucket/index/index_interface.rb
+- lib/persistence/adapter/mock/bucket/index.rb
+- lib/persistence/adapter/mock/bucket.rb
+- lib/persistence/adapter/mock/cursor/cursor_interface.rb
+- lib/persistence/adapter/mock/cursor.rb
+- lib/persistence/adapter/mock.rb
+- lib/persistence/cursor/atomic.rb
+- lib/persistence/cursor/cursor_interface.rb
+- lib/persistence/cursor.rb
+- lib/persistence/exception/block_required.rb
+- lib/persistence/exception/conflicting_index_already_declared.rb
+- lib/persistence/exception/duplicate_violates_unique_index.rb
+- lib/persistence/exception/explicit_index_required.rb
+- lib/persistence/exception/indexing_block_failed_to_generate_keys.rb
+- lib/persistence/exception/indexing_object_requires_keys.rb
+- lib/persistence/exception/key_value_required.rb
+- lib/persistence/exception/no_port_enabled.rb
+- lib/persistence/object/autodetermine.rb
+- lib/persistence/object/class_instance.rb
+- lib/persistence/object/complex/array/class_instance.rb
+- lib/persistence/object/complex/array/object_instance.rb
+- lib/persistence/object/complex/array.rb
+- lib/persistence/object/complex/attributes/attributes_array.rb
+- lib/persistence/object/complex/attributes/attributes_hash.rb
+- lib/persistence/object/complex/attributes/default_atomic_non_atomic.rb
+- lib/persistence/object/complex/attributes/hash_to_port.rb
+- lib/persistence/object/complex/attributes.rb
+- lib/persistence/object/complex/class_and_object_instance.rb
+- lib/persistence/object/complex/class_instance.rb
+- lib/persistence/object/complex/complex_object.rb
+- lib/persistence/object/complex/hash/class_instance.rb
+- lib/persistence/object/complex/hash/object_instance.rb
+- lib/persistence/object/complex/hash.rb
+- lib/persistence/object/complex/index/attribute_index/attribute_index_interface.rb
+- lib/persistence/object/complex/index/attribute_index.rb
+- lib/persistence/object/complex/object_instance.rb
+- lib/persistence/object/complex.rb
+- lib/persistence/object/flat/class_instance.rb
+- lib/persistence/object/flat/file/class_instance.rb
+- lib/persistence/object/flat/file/contents.rb
+- lib/persistence/object/flat/file/file_persistence.rb
+- lib/persistence/object/flat/file/object_instance.rb
+- lib/persistence/object/flat/file/path.rb
+- lib/persistence/object/flat/file.rb
+- lib/persistence/object/flat/object_instance.rb
+- lib/persistence/object/flat.rb
+- lib/persistence/object/index/block_index/block_index_interface.rb
+- lib/persistence/object/index/block_index.rb
+- lib/persistence/object/index/explicit_index/explicit_index_interface.rb
+- lib/persistence/object/index/explicit_index.rb
+- lib/persistence/object/index.rb
+- lib/persistence/object/index_hash.rb
+- lib/persistence/object/object_instance.rb
+- lib/persistence/object/parse_persistence_args.rb
+- lib/persistence/object.rb
+- lib/persistence/port/bucket/bucket_index.rb
+- lib/persistence/port/bucket/bucket_interface.rb
+- lib/persistence/port/bucket.rb
+- lib/persistence/port/controller.rb
+- lib/persistence/port/port_interface.rb
+- lib/persistence/port.rb
 - lib/persistence.rb
-- lib/persistence/version.rb
-- persistence.gemspec
-homepage: ''
+- lib/requires.rb
+- spec/example_objects/complex_object/array_object.rb
+- spec/example_objects/complex_object/hash_object.rb
+- spec/example_objects/complex_object.rb
+- spec/example_objects/flat_object/file_object.rb
+- spec/example_objects/flat_object.rb
+- spec/example_objects.rb
+- spec/Integration_spec.rb
+- spec/persistence/adapter/enable_disable_spec.rb
+- spec/persistence/adapter/mock/cursor_spec.rb
+- spec/persistence/adapter/mock_helpers/bucket.rb
+- spec/persistence/adapter/mock_helpers/integration/dictionary_hash.rb
+- spec/persistence/adapter/mock_helpers/integration/note.rb
+- spec/persistence/adapter/mock_helpers/integration/notes_array.rb
+- spec/persistence/adapter/mock_helpers/integration/user/address.rb
+- spec/persistence/adapter/mock_helpers/integration/user/dictionary_entry.rb
+- spec/persistence/adapter/mock_helpers/integration/user/sub_account.rb
+- spec/persistence/adapter/mock_helpers/integration/user.rb
+- spec/persistence/adapter/mock_helpers/object.rb
+- spec/persistence/adapter/mock_helpers/port.rb
+- spec/persistence/adapter/mock_helpers.rb
+- spec/persistence/adapter/mock_spec.rb
+- spec/persistence/adapter/primary_key/id_property_string_spec.rb
+- spec/persistence/adapter/primary_key/simple_spec.rb
+- spec/persistence/adapter/spec_abstract/adapter_spec.rb
+- spec/persistence/adapter/spec_abstract/cursor_spec.rb
+- spec/persistence/cursor/atomic_spec.rb
+- spec/persistence/cursor/object_and_class_instance_spec.rb
+- spec/persistence/cursor_spec.rb
+- spec/persistence/object/complex/attributes/persistence_hash/array_instance_spec.rb
+- spec/persistence/object/complex/attributes/persistence_hash/hash_instance_spec.rb
+- spec/persistence/object/complex/attributes_spec.rb
+- spec/persistence/object/complex/complex_spec.rb
+- spec/persistence/object/complex/index/attribute_index_spec.rb
+- spec/persistence/object/flat/bignum_spec.rb
+- spec/persistence/object/flat/class_instance_spec.rb
+- spec/persistence/object/flat/class_spec.rb
+- spec/persistence/object/flat/complex_spec.rb
+- spec/persistence/object/flat/false_class_spec.rb
+- spec/persistence/object/flat/file/class_instance_spec.rb
+- spec/persistence/object/flat/file/object_instance_spec.rb
+- spec/persistence/object/flat/file_spec.rb
+- spec/persistence/object/flat/fixnum_spec.rb
+- spec/persistence/object/flat/float_spec.rb
+- spec/persistence/object/flat/indexing_spec.rb
+- spec/persistence/object/flat/rational_spec.rb
+- spec/persistence/object/flat/regexp_spec.rb
+- spec/persistence/object/flat/string_spec.rb
+- spec/persistence/object/flat/symbol_spec.rb
+- spec/persistence/object/flat/true_class_spec.rb
+- spec/persistence/object/indexes/block_index_spec.rb
+- spec/persistence/object/indexes/explicit_index_spec.rb
+- spec/persistence/object/parse_persistence_args_spec.rb
+- spec/persistence/object_spec.rb
+- spec/persistence/port/bucket/bucket_interface_spec.rb
+- spec/persistence/port/bucket/index/bucket_index_spec.rb
+- spec/persistence/port/bucket_spec.rb
+- spec/persistence/port/controller_spec.rb
+- spec/persistence/port/port_interface_spec.rb
+- spec/Persistence_spec.rb
+- README.md
+- CHANGELOG.md
+homepage: http://rubygems.org/gems/persistence
 licenses: []
 post_install_message: 
 rdoc_options: []
@@ -41,13 +196,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.16
+rubyforge_project: persistence
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: There is no summary
+summary: Persistence layer designed to take advantage of Ruby's object model. The
+  back-end is abstracted so that many different adapters can be created.
 test_files: []
+has_rdoc: