inherits_from 0.0.1

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in pseudo_inheritance.gemspec
+gemspec
+
+gem 'rake'
+
+group :test do
+  gem 'rspec', '2.8.0'
+end

data/README.rdoc

@@ -0,0 +1,41 @@
+= inherits_from - A gem that provides an inheritance interface for ActiveRecord Models
+
+== Introduction
+inherits_from address the different paradigms between OO and RDBMS to allow ActiveRecord(AR) 
+objects to inherit from AR objects.  Both systems have objects with Behavior, Identity & State.
+OO objects that inherit from each other should have direct access to all superclasses' behavior 
+identity and state. RDBMS entities relate to each other.  RDBMS entries should normalize 
+state across multiple tables.  Because AR stores state in RDBMS, objects that should 
+inherit from other AR objects are required to use composition.
+
+inherits_from provides an interface that allows ActiveRecord models to access other 
+ActiveRecord models as though they were subclassed, while allowing data to be stored 
+in a normalized RDBMS.
+
+== Resources
+
+=== Installation
+
+  gem install inherits_from
+	
+=== Git Repository
+	https://github.com/itchy/inherits_from
+
+== Requirements
+	inherits_from requires ActiveRecord
+	
+=== Example
+  class User < ActiveRecord::Base
+    has_many :profiles
+    # has an attribute of email
+  end
+
+  class Profile < ActiveRecord::Base
+    extend InheritsFrom::ClassMethods
+    inherits_from :user # this would be belongs_to if not using inherits_from
+  end	
+
+  p = Profile.first
+  p.email => provides p.user.email
+  p.email="new@email.com" => sets the value of p.user.email
+  p.save => will also save p.user if it is tainted?

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/inherits_from.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "inherits_from/version"
+
+Gem::Specification.new do |s|
+  s.name        = "inherits_from"
+  s.version     = InheritsFrom::VERSION
+  s.authors     = ["Scott Johnson"]
+  s.email       = ["7.scott.j@gmail.com"]
+  s.homepage    = "https://github.com/itchy/inherits_from"
+  s.summary     = %q{ gem that provides an inheritance interface for ActiveRecord Models}
+  s.description = %q{inherits_from provides an interface that allows ActiveRecord models to access other 
+  ActiveRecord models as though they were subclassed, while allowing data to be stored 
+  in a normalized RDBMS.}
+
+  s.rubyforge_project = "inherits_from"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_runtime_dependency "activerecord"
+end

data/lib/inherits_from.rb

@@ -0,0 +1,59 @@
+require "inherits_from/version"
+
+module InheritsFrom
+  module ClassMethods
+    def inherits_from(inheriter, args={})
+      belongs_to inheriter, args
+      inherited_methods(inheriter)
+      inherited_save(inheriter)
+      inherited_respond_to(inheriter)
+    end
+
+  private
+    def inherited_methods(inheriter)
+      define_method("method_missing") do |method, *args, &block|
+        @memoized_references ||= {}  
+        @memoized_references[inheriter.to_sym] ||= self.send inheriter
+        model = @memoized_references[inheriter.to_sym]
+  
+        if model.send :respond_to?, method
+          if method.to_s[/=$/]
+            model.send :taint
+            model.send method, *args
+          else  
+            model.send method
+          end  
+        else
+          super(method, *args, &block)
+        end
+      end  
+    end
+  
+    def inherited_save(inheriter)
+      save_methods = %w(save save!)
+      save_methods.each do |method|
+        define_method(method) do
+          # only momoized models need to be checked
+          if @memoized_references  
+            @memoized_references.each_pair do |key, model|
+              model.send method if model.send :tainted?
+            end
+          end
+          super()  
+        end
+      end  
+    end
+  
+    def inherited_respond_to(inheriter)
+      define_method("respond_to?") do |*args|
+        method = args[0]
+        include_private = args[1] ||= false
+        return true if super(method, include_private)
+        model = self.send inheriter
+        model.respond_to?(method, include_private) 
+      end
+    end
+  end
+end
+
+

data/lib/inherits_from/version.rb

@@ -0,0 +1,3 @@
+module InheritsFrom
+  VERSION = "0.0.1"
+end

data/spec/inherits_from/inherits_from_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+class User 
+  attr_accessor :user_field
+  def initialize
+    self.user_field = "User Field"
+  end
+end 
+
+class Profile
+  extend InheritsFrom::ClassMethods
+  # rewrite inherits_from to not use belongs_to
+  def self.inherits_from(inheriter, args={})
+    inherited_methods(inheriter)
+    inherited_save(inheriter)
+    inherited_respond_to(inheriter)
+  end
+  attr_accessor :profile_field, :user
+  inherits_from :user
+  
+  def initialize
+    self.user = User.new
+    self.profile_field = "Profile Field"
+  end
+end
+
+
+describe Profile do 
+  before(:each) do
+    @p = Profile.new
+  end  
+  
+  it "should have inherits_from, inherited_methods, inherited_save & inherited_respond_to methods" do
+    Profile.methods.include?(:inherits_from).should be_true
+    Profile.private_methods.include?(:inherited_methods).should be_true
+    Profile.private_methods.include?(:inherited_save).should be_true
+    Profile.private_methods.include?(:inherited_respond_to).should be_true
+  end  
+  
+  it "should be able to access methods in user from profile" do
+    @p.user_field.should == "User Field"
+  end
+  
+  it "should be able to access update methods in user from profile" do
+    @p.user_field = "Test Set User Field"
+    @p.user_field.should == "Test Set User Field"
+  end
+  
+  it "should set user.tainted? to true when user attribute is set" do
+    @p.user.tainted?.should be_false
+    @p.user_field = "Test Set User Field"
+    @p.user.tainted?.should be_true
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'inherits_from' # and any other gems you need
+
+RSpec.configure do |config|
+  # some (optional) config here
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: inherits_from
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Scott Johnson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-02-24 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: |-
+  inherits_from provides an interface that allows ActiveRecord models to access other 
+    ActiveRecord models as though they were subclassed, while allowing data to be stored 
+    in a normalized RDBMS.
+email: 
+- 7.scott.j@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- README.rdoc
+- Rakefile
+- inherits_from.gemspec
+- lib/inherits_from.rb
+- lib/inherits_from/version.rb
+- spec/.DS_Store
+- spec/inherits_from/inherits_from_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/itchy/inherits_from
+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: inherits_from
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: gem that provides an inheritance interface for ActiveRecord Models
+test_files: 
+- spec/inherits_from/inherits_from_spec.rb
+- spec/spec_helper.rb