identifies_as 1.0.0

data/CHANGELOG.rdoc

@@ -0,0 +1,4 @@
+
+== 6/12/2012
+
+Initial release.

data/README.md

@@ -0,0 +1,89 @@
+# Identifies As #
+
+http://rubygems.org/gems/identifies_as
+
+# Summary #
+
+Permits objects to identify as if they are other types of objects. Effects :is_a? and :===.
+
+# Description #
+
+Provides IdentifiesAs, which offers :identifies_as!, :instances_identify_as!, :identifies_as?, :instances_identify_as?, :no_longer_identifies_as!, :instances_no_longer_identify_as, :identities, :instance_identities, and overrides :is_a? and :===.
+
+# Install #
+
+* sudo gem install identifies_as
+
+# Usage #
+
+* Example One:
+
+```ruby
+
+class SomeOtherClass
+end
+
+class NotAnArray
+  include IdentifiesAs
+  instances_identify_as!( Array )
+  identifies_as!( SomeOtherClass )
+end
+
+NotAnArray.is_a?( SomeOtherClass )
+# => true
+
+instance = NotAnArray.new
+
+instance.identifies_as?( Array )
+# => true
+
+instance.is_a?( Array )
+# => true
+
+Array === instance
+# => true
+```
+
+* Example Two:
+
+```ruby
+instance = Object.new
+
+instance.extend( IdentifiesAs )
+
+instance.identifies_as!( Array )
+
+instance.identifies_as?( Array )
+# => true
+
+instance.is_a?( Array )
+# => true
+
+Array === instance
+# => true
+```
+
+# License #
+
+  (The MIT License)
+
+  Copyright (c) Asher
+
+  Permission is hereby granted, free of charge, to any person obtaining
+  a copy of this software and associated documentation files (the
+  'Software'), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to
+  permit persons to whom the Software is furnished to do so, subject to
+  the following conditions:
+
+  The above copyright notice and this permission notice shall be
+  included in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+  CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+  TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,85 @@
+== Identifies As
+
+http://rubygems.org/gems/identifies_as
+
+== Summary
+
+Permits objects to identify as if they are other types of objects. Effects :is_a? and :===.
+
+== Description
+
+Provides IdentifiesAs, which offers :identifies_as!, :instances_identify_as!, :identifies_as?, :instances_identify_as?, :no_longer_identifies_as!, :instances_no_longer_identify_as, :identities, :instance_identities, and overrides :is_a? and :===.
+
+== Install
+
+* sudo gem install identifies_as
+
+== Usage
+
+* Example One:
+
+	class SomeOtherClass
+	end
+
+	class NotAnArray
+	  include IdentifiesAs
+	  instances_identify_as!( Array )
+	  identifies_as!( SomeOtherClass )
+	end
+
+	NotAnArray.is_a?( SomeOtherClass )
+	# => true
+
+	instance = NotAnArray.new
+
+	instance.identifies_as?( Array )
+	# => true
+
+	instance.is_a?( Array )
+	# => true
+
+	Array === instance
+	# => true
+
+* Example Two:
+
+	instance = Object.new
+
+	instance.extend( IdentifiesAs )
+
+	instance.identifies_as!( Array )
+
+	instance.identifies_as?( Array )
+	# => true
+
+	instance.is_a?( Array )
+	# => true
+
+	Array === instance
+	# => true
+
+
+== License
+
+  (The MIT License)
+
+  Copyright (c) Asher
+
+  Permission is hereby granted, free of charge, to any person obtaining
+  a copy of this software and associated documentation files (the
+  'Software'), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to
+  permit persons to whom the Software is furnished to do so, subject to
+  the following conditions:
+
+  The above copyright notice and this permission notice shall be
+  included in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+  CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+  TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/identifies_as/IdentifiesAs/EqualsEqualsEquals.rb

@@ -0,0 +1,38 @@
+
+module ::IdentifiesAs::EqualsEqualsEquals
+  
+  #########
+  #  ===  #
+  #########
+
+  def ===( object )
+
+    is_equal = false
+
+    if identifies_as_hash = ::IdentifiesAs.object_identities_hash( object )
+      identifies_as_hash.each do |this_object, true_value|
+        if super( this_object ) or ( self < this_object ) != nil
+          is_equal = true
+          break
+        end
+      end
+    end
+
+    if identifies_as_hash = ::IdentifiesAs.object_instance_identities_hash( object.class )
+      identifies_as_hash.each do |this_object, true_value|
+        if super( this_object ) or ( self < this_object ) != nil
+          is_equal = true
+          break
+        end
+      end
+    end
+    
+    unless is_equal
+      is_equal = super
+    end
+    
+    return is_equal
+    
+  end
+  
+end

data/lib/identifies_as/IdentifiesAs.rb

@@ -0,0 +1,290 @@
+
+module ::IdentifiesAs
+  
+  extend ::ModuleCluster::Define::Cluster
+  
+  include_also_extends( self )
+
+  @identities = { }
+  @instance_identities = { }
+  
+  ################################
+  #  self.object_identifies_as!  #
+  ################################
+  
+  def self.object_identifies_as!( object, *objects )
+
+    object_id = object.__id__
+
+    unless identifies_as_hash = @identities[ object_id ]
+      identifies_as_hash = { }
+      @identities[ object_id ] = identifies_as_hash
+    end
+    
+    objects.each do |this_object|
+      identifies_as_hash[ this_object ] = true
+    end
+    
+    return identifies_as_hash
+    
+  end
+
+  ########################################
+  #  self.object_instances_identify_as!  #
+  ########################################
+  
+  def self.object_instances_identify_as!( object_class, *objects )
+
+    unless identifies_as_hash = @instance_identities[ object_class ]
+      identifies_as_hash = { }
+      @instance_identities[ object_class ] = identifies_as_hash
+    end
+    
+    objects.each do |this_object|
+      identifies_as_hash[ this_object ] = true
+    end
+    
+    return identifies_as_hash
+    
+  end
+
+  ################################
+  #  self.object_identifies_as?  #
+  ################################
+
+  def self.object_identifies_as?( object, other_object_type )
+    
+    object_identifies = false
+    
+    if identifies_as_hash = @identities[ object.__id__ ]
+      object_identifies = identifies_as_hash.has_key?( other_object_type )
+    end
+
+    unless object_identifies
+      object_identifies = object_instances_identify_as?( object.class, other_object_type )
+    end
+    
+    return object_identifies
+    
+  end
+
+  ########################################
+  #  self.object_instances_identify_as?  #
+  ########################################
+
+  def self.object_instances_identify_as?( object_class, other_object_type )
+    
+    object_identifies = false
+
+    if identifies_as_hash = @instance_identities[ object_class ]
+      object_identifies = identifies_as_hash.has_key?( other_object_type )
+    end
+    
+    return object_identifies
+    
+  end
+
+  ############################
+  #  self.object_identities  #
+  ############################
+  
+  def self.object_identities( object )
+    
+    return object_identities_hash( object ).keys
+    
+  end
+
+  #####################################
+  #  self.object_instance_identities  #
+  #####################################
+  
+  def self.object_instance_identities( object_class )
+    
+    return object_instance_identities_hash( object_class ).keys
+    
+  end
+
+  #################################
+  #  self.object_identities_hash  #
+  #################################
+  
+  def self.object_identities_hash( object )
+    
+    return @identities[ object.__id__ ]
+    
+  end
+
+  ##########################################
+  #  self.object_instance_identities_hash  #
+  ##########################################
+  
+  def self.object_instance_identities_hash( object_class )
+    
+    return @instance_identities[ object_class ]
+    
+  end
+
+  ##########################################
+  #  self.object_no_longer_identifies_as!  #
+  ##########################################
+  
+  def self.object_no_longer_identifies_as!( object, *objects )
+
+    if identifies_as_hash = @identities[ object ]
+      object_identifies = identifies_as_hash.has_key?( object )
+      objects.each do |this_object|
+        object_identifies.delete( this_object.__id__ )
+      end
+    end
+    
+    return identifies_as_hash
+
+  end
+
+  ##################################################
+  #  self.object_instances_no_longer_identify_as!  #
+  ##################################################
+  
+  def self.object_instances_no_longer_identify_as!( object_class, *objects )
+
+    if identifies_as_hash = @instance_identities[ object_class ]
+      object_identifies = identifies_as_hash.has_key?( object_class )
+      objects.each do |this_object|
+        object_identifies.delete( this_object )
+      end
+    end
+    
+    return identifies_as_hash
+
+  end
+  
+  ####################
+  #  identifies_as!  #
+  ####################
+  
+  # Cause receiver to identify as specified objects.
+  # @param [Array<Object>] objects Other objects self should identify as.
+  # @return [Object] Self.
+  def identifies_as!( *objects )
+
+    return ::IdentifiesAs.object_identifies_as!( self, *objects )
+    
+  end
+
+  ############################
+  #  instances_identify_as!  #
+  ############################
+  
+  # Cause instances of receiver to identify as specified objects.
+  # @param [Array<Object>] objects Other objects self should identify as.
+  # @return [Object] Self.
+  def instances_identify_as!( *objects )
+    
+    return ::IdentifiesAs.object_instances_identify_as!( self, *objects )
+    
+  end
+
+  ####################
+  #  identifies_as?  #
+  ####################
+  
+  # Query whether receiver identifies as specified object.
+  # @param [Object] object Object against which identity is being tested.
+  # @return [true,false] Whether receiver identifies as object.
+  def identifies_as?( object )
+    
+    return ::IdentifiesAs.object_identifies_as?( self, object )    
+    
+  end
+
+  ############################
+  #  instances_identify_as?  #
+  ############################
+  
+  # Query whether instances of receiver identify as specified object.
+  # @param [Object] object Object against which identity is being tested.
+  # @return [true,false] Whether instances of receiver identify as object.
+  def instances_identify_as?( object )
+    
+    return ::IdentifiesAs.object_instances_identify_as?( self, object )    
+    
+  end
+
+  ################
+  #  identities  #
+  ################
+  
+  # Identities that receiver identifies as, beyond those which it actually is.
+  # @return [Array<Object>] Identities receiver identifies as.
+  def identities
+    
+    return ::IdentifiesAs.object_identities( self )    
+    
+  end
+
+  #########################
+  #  instance_identities  #
+  #########################
+  
+  # Identities that instances of receiver identify as, beyond those which it actually is.
+  # @return [Array<Object>] Identities instances of receiver identifies as.
+  def instance_identities
+    
+    return ::IdentifiesAs.object_instance_identities( self )    
+    
+  end
+
+  ##############################
+  #  no_longer_identifies_as!  #
+  ##############################
+  
+  # Cause receiver to no longer identify as specified objects.
+  # @param [Array<Object>] objects Other objects receiver should no longer identify as.
+  # @return [Object] Self.
+  def no_longer_identifies_as!( *objects )
+    
+    return ::IdentifiesAs.object_no_longer_identifies_as!( self, *objects )    
+    
+  end
+
+  ######################################
+  #  instances_no_longer_identify_as!  #
+  ######################################
+  
+  # Cause instances of receiver to no longer identify as specified objects.
+  # @param [Array<Object>] objects Other objects instance of receiver should no longer identify as.
+  # @return [Object] Self.
+  def no_longer_identifies_as!( *objects )
+    
+    return ::IdentifiesAs.object_instances_no_longer_identify_as!( self, *objects )    
+    
+  end
+
+  ####################
+  #  actually_is_a?  #
+  ####################
+  
+  # Alias to the original :is_a? method without IdentifyAs functionality.
+  # @param [Object] objects Other object to test identity against.
+  # @return [true,false] Whether receiver is actually instance of specified object.
+  alias_method :actually_is_a?, :is_a?
+
+  ###########
+  #  is_a?  #
+  ###########
+  
+  def is_a?( object )
+    
+    is_type = false
+    
+    if identifies_as?( object )    
+      is_type = true
+    else
+      is_type = super
+    end
+    
+    return is_type
+    
+  end
+    
+end

data/lib/identifies_as.rb

@@ -0,0 +1,9 @@
+
+require 'module-cluster'
+
+require_relative 'identifies_as/IdentifiesAs.rb'
+require_relative 'identifies_as/IdentifiesAs/EqualsEqualsEquals.rb'
+
+class ::Object
+  extend ::IdentifiesAs::EqualsEqualsEquals
+end

data/spec/IdentifiesAs_spec.rb

@@ -0,0 +1,48 @@
+
+require_relative '../lib/identifies_as.rb'
+
+describe ::IdentifiesAs do
+
+  ######################################
+  #  identifies_as!                    #
+  #  identifies_as?                    #
+  #  instances_identify_as!            #
+  #  instances_identify_as?            #
+  #  identities                        #
+  #  no_longer_identifies_as!          #
+  #  instances_no_longer_identify_as!  #
+  #  is_a?                             #
+  #  ===                               #
+  ######################################
+  
+  it 'lets an object pretend it is another object' do
+    
+    instance = Object.new
+    instance.extend( IdentifiesAs )
+    
+    instance.identifies_as!( Array )
+    instance.identifies_as?( Array ).should == true
+    instance.identities.should == [ Array ]
+    
+    instance.is_a?( Array ).should == true
+    ( Array === instance ).should == true
+
+    class SomeOtherClass
+    end
+    class NotAnArray
+      include IdentifiesAs
+      identifies_as!( Array )
+      instances_identify_as!( Array )
+      identifies_as!( SomeOtherClass )
+    end
+    
+    NotAnArray.is_a?( SomeOtherClass ).should == true
+    
+    instance = NotAnArray.new
+    instance.identifies_as?( Array ).should == true
+    instance.is_a?( Array ).should == true
+    ( Array === instance ).should == true
+    
+  end
+  
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: identifies_as
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Asher
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-12 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'
+description: Provides IdentifiesAs, which offers :identifies_as!, :identifies_as?,
+  :no_longer_identifies_as! and :identities, and overrides :is_a? and :===.
+email: asher@ridiculouspower.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/identifies_as/IdentifiesAs/EqualsEqualsEquals.rb
+- lib/identifies_as/IdentifiesAs.rb
+- lib/identifies_as.rb
+- spec/IdentifiesAs_spec.rb
+- README.md
+- README.rdoc
+- CHANGELOG.rdoc
+homepage: http://rubygems.org/gems/identifies_as
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: identifies_as
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Permits objects to identify as if they are other types of objects. Effects
+  :is_a? and :===.
+test_files: []
+has_rdoc: