has_associative_facades 1.0.3

data/.gitignore

@@ -0,0 +1,4 @@
+.* # Ignore all dotfiles...
+!.gitignore # except for .gitignore
+pkg/*
+.rake_tasks~

data/History.txt

@@ -0,0 +1,8 @@
+== 1.0.3 2010-04-26
+
+* Got rid of situation where no method error or other exceptions are eaten instead of raised again.
+
+
+== 1.0.0 2009-06-25
+
+* Initial release

data/README.rdoc

@@ -0,0 +1,110 @@
+= has_associative_facades
+
+http://github.com/midas/has_associative_facades/tree/master
+
+
+== DESCRIPTION:
+
+A Rails gem that creates getters and setters for associated object's attributes to aid in not breaking Demeter's Law.
+
+== WHY
+
+From http://en.wikipedia.org/wiki/Law_of_Demeter, the "Law of Demeter for Functions/Methods” (LoD-F) states:
+
+An object A can request a service (call a method) of an object instance B, but object A cannot “reach through” object 
+B to access yet another object, C, to request its services.  Doing so would mean that object A implicitly requires greater 
+knowledge of object B’s internal structure. Instead, B’s class should be modified if necessary so that object A can simply 
+make the request directly of object B, and then let object B propagate the request to any relevant subcomponents. Or A should 
+have a direct reference to object C and make the call directly. If the law is followed, only object B knows its own internal 
+structure.
+
+In particular, an object should avoid invoking methods of a member object returned by another method. For many modern object 
+oriented languages that use a dot as field identifier, the law can be stated simply as "use only one dot". That is, the code 
+"a.b.Method()" breaks the law where "a.Method()" does not.
+
+As a simple example, when one wants to walk a dog, it would be folly to command the dog’s legs to walk directly; instead one 
+commands the dog and lets it take care of its legs itself
+
+The advantage of following the Law of Demeter is that the resulting software tends to be more maintainable and adaptable. Since 
+objects are less dependent on the internal structure of other objects, object containers can be changed without reworking their 
+callers.
+
+A disadvantage of the Law of Demeter is that it sometimes requires writing a large number of small “wrapper” methods (sometimes 
+referred to as Demeter Transmogrifiers) to propagate method calls to the components. Furthermore, a class’s interface can become 
+bulky as it hosts methods for contained classes resulting in a class without a cohesive interface.
+
+This is where has_associative_facades steps in.  Instead of writing this large number of wrapper methods, you can just call the 
+methods and they will be defined on an as needed basis, remaining in memory until the object is destroyed.  So now you can avoid
+coupling your objects together without the extra work.  Only the interface to your object need remain the same.  You can change 
+the internal implementation of methods to your heart;s content without breaking your project.
+
+
+== FEATURES:
+
+* Automatically creates facade getter methods for has one and belongs to associations.
+
+
+== TO IMPLEMENT:
+
+* Automatically creates facade setter methods for has one and belongs to associations.
+* Possibly provide a static way to define through macro type singleton methods (like attr_accessor, attr_reader, etc).
+
+
+== USAGE:
+
+For:
+  
+  class Account < ActiveRecord::Base
+    # has name attribute
+  end
+
+  class User
+    has_associative_facades
+    
+    belongs_to :account
+  end
+
+You can now:
+
+  user = User.first # or User.new, User.find, etc
+  user.account_name # is the same as user.account.name
+
+
+== REQUIREMENTS:
+
+* ActiveRecord
+
+
+== INSTALL:
+
+  sudo gem install midas-has_associative_facades
+
+In your Rails environment file:
+
+  config.gem 'has_associative_facades'
+
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 C. Jason Harrelson (midas)
+
+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/Rakefile

@@ -0,0 +1,67 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "has_associative_facades"
+    gem.summary = %Q{An active record gem that creates getters and setters for associated object's attributes to aid in not breaking Demeter's Law.}
+    gem.description = %Q{A Rails gem that creates getters and setters for associated object's attributes to aid in not breaking Demeter's Law.}
+    gem.email = "jason@lookforwardenterprises.com"
+    gem.homepage = "http://github.com/midas/guilded"
+    gem.authors = ["C. Jason Harrelson (midas)"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_dependency "activerecord", ">= 2.0.0"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "tester #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION

@@ -0,0 +1 @@
+1.0.3

data/has_associative_facades.gemspec

@@ -0,0 +1,62 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{has_associative_facades}
+  s.version = "1.0.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["C. Jason Harrelson (midas)"]
+  s.date = %q{2010-04-26}
+  s.description = %q{A Rails gem that creates getters and setters for associated object's attributes to aid in not breaking Demeter's Law.}
+  s.email = %q{jason@lookforwardenterprises.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "History.txt",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "has_associative_facades.gemspec",
+     "lib/has_associative_facades.rb",
+     "lib/has_associative_facades/acts_methods.rb",
+     "lib/has_associative_facades/instance_methods.rb",
+     "script/console",
+     "script/destroy",
+     "script/generate",
+     "spec/has_associative_facades_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "tasks/rspec.rake"
+  ]
+  s.homepage = %q{http://github.com/midas/guilded}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{An active record gem that creates getters and setters for associated object's attributes to aid in not breaking Demeter's Law.}
+  s.test_files = [
+    "spec/has_associative_facades_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_runtime_dependency(%q<activerecord>, [">= 2.0.0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<activerecord>, [">= 2.0.0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<activerecord>, [">= 2.0.0"])
+  end
+end
+

data/lib/has_associative_facades.rb

@@ -0,0 +1,15 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'has_associative_facades/acts_methods'
+require 'has_associative_facades/instance_methods'
+
+module HasAssociativeFacades
+  VERSION = '1.0.3'
+  
+  def self.included( base ) 
+    base.extend ActsMethods 
+  end
+end
+
+ActiveRecord::Base.send( :include, HasAssociativeFacades ) if defined?( ActiveRecord::Base )

data/lib/has_associative_facades/acts_methods.rb

@@ -0,0 +1,13 @@
+module HasAssociativeFacades
+  module ActsMethods
+    
+    # Use this method to declare the associated facade behavior on your ActiveRecord class.
+    #
+    def has_associative_facades 
+      unless included_modules.include? InstanceMethods
+        include InstanceMethods
+      end
+    end
+    
+  end
+end

data/lib/has_associative_facades/instance_methods.rb

@@ -0,0 +1,78 @@
+module HasAssociativeFacades
+  module InstanceMethods
+    
+    # When the method being called is the case of "#{association_name}_#{attribute_or_method}" a getter method 
+    # will be defined and called returning its value.  This works for an ActiveRecord object created through the
+    # new operator having all attributes set to nil or an find of some sort having all attributes populated.
+    #
+    # If the associated object is nil but has an attribute or method with the given name a nil is reurned.  Otherwise,
+    # the NoMethodError is raised.
+    #
+    def method_missing( method, *args )
+      method_name = method.to_s
+      super( method, *args ) # allow super to win if it has the method
+    rescue NoMethodError => ex
+      association = nil
+      association_reflection = nil
+      associateds = self.class.inheritable_attributes[:reflections]
+      associateds.each do |associated|
+        if /#{associated[0]}_/.match( method_name )
+          association_reflection = associated
+          association = associated[0]
+          break
+        end
+      end
+      if association.nil?
+        raise NoMethodError.new('has_associative_facades could find no ' +
+                                'association to resolve ' +
+                                "#{self.class.name}##{method}",
+                                method,
+                                args)
+      end
+
+      if match = /#{association}_([_a-zA-Z]\w*)/.match( method_name )
+        if match.captures.empty? || match.captures.size > 2
+          raise NoMethodError.new('has_associative_facades failed to resolve ' +
+                                  "#{self.class.name}##{method} via "          +
+                                  "#{self.class.name}##{association}",
+                                  method,
+                                  args)
+        end
+        attribute = match.captures[0].to_sym
+
+        assoc_klass = nil
+        begin
+          assoc_klass = association.to_s.classify.constantize
+        rescue
+          assoc_klass = association_reflection[1].options[:class_name].constantize
+        end
+        unless assoc_klass.columns_hash.has_key?( attribute.to_s ) || assoc_klass.public_instance_methods.include?( attribute.to_s )
+          if match.captures.empty? || match.captures.size > 2
+            raise NoMethodError.new('has_associative_facades could find no ' +
+                                    "#{assoc_klass.name}##{method} "         +
+                                    'method to resolve '                     +
+                                    "#{self.class.name}##{method}",
+                                    method,
+                                    args)
+          end
+        end
+
+        self.class.class_eval <<-END
+        def #{method_name}
+          return self.send( :#{association} ).send( :#{attribute} ) unless self.send( :#{association} ).nil?
+          nil
+        end
+        END
+
+        return self.send( method_name )
+      end
+
+      raise NoMethodError.new('has_associative_facades failed to resolve ' +
+                              "#{self.class.name}##{method} via "          +
+                              "any association on #{self.class.name}",
+                              method,
+                              args)
+    end
+    
+  end
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/has_associative_facades.rb'}"
+puts "Loading has_associative_facades gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/spec/has_associative_facades_spec.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe HasAssociativeFacades do
+
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'has_associative_facades'

data/tasks/rspec.rake

@@ -0,0 +1,21 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: has_associative_facades
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 3
+  version: 1.0.3
+platform: ruby
+authors: 
+- C. Jason Harrelson (midas)
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-26 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
+  type: :runtime
+  version_requirements: *id002
+description: A Rails gem that creates getters and setters for associated object's attributes to aid in not breaking Demeter's Law.
+email: jason@lookforwardenterprises.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- History.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- has_associative_facades.gemspec
+- lib/has_associative_facades.rb
+- lib/has_associative_facades/acts_methods.rb
+- lib/has_associative_facades/instance_methods.rb
+- script/console
+- script/destroy
+- script/generate
+- spec/has_associative_facades_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/rspec.rake
+has_rdoc: true
+homepage: http://github.com/midas/guilded
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: An active record gem that creates getters and setters for associated object's attributes to aid in not breaking Demeter's Law.
+test_files: 
+- spec/has_associative_facades_spec.rb
+- spec/spec_helper.rb