expose_association 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+# Specify your gem's dependencies in expose_association.gemspec
+gemspec

data/README.md

@@ -0,0 +1,48 @@
+# Expose Association
+
+
+## Usage:
+
+Suppose you have this two classes: 
+
+<pre>
+class Address &lt; ActiveRecord::Base 
+  belongs_to :contact
+end
+
+class Contact &lt; ActiveRecord::Base
+
+  has_one :primary_address, :class_name => 'Address'
+  expose_association :primary_address, prefix: true, class: Address do
+    expose :address_line_1, :address_line_2, :city
+    expose :phone_number, prefix: false
+    expose :country, prefix: 'primary'
+  end
+
+end
+
+</pre>
+
+You'll be able to use this class like this: 
+
+<pre>
+contact = Contact.new
+contact.primary_address_address_line_1 = "122 Fake St."
+contact.primary_address_address_line_2 = "Apt. 45"
+contact.primary_address_city = "Beverly Hill"
+contact.phone_number = "123-123-1234"
+contact.primary_country = "Argentina"
+contact.save
+</pre>
+
+Specs? 
+
+<pre>
+contact.primary_address.should be_a_kind_of(Address)
+...
+
+# Check te real ones on the spec folder
+
+</pre>
+
+MIT License. 

data/Rakefile

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

data/expose_association.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/expose_association/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Lucas Florio"]
+  gem.email         = ["lucasefe@gmail.com"]
+  gem.description   = %q{Easy exposition of has_one associations at the object
+  level, to avoid nesting.}
+  gem.summary       = %q{...}
+  gem.homepage      = ""
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "expose_association"
+  gem.require_paths = ["lib"]
+  gem.version       = ExposeAssociation::VERSION
+  gem.add_dependency 'activerecord'
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'sqlite3'
+  gem.add_development_dependency 'shoulda'
+end

data/lib/expose_association/base.rb

@@ -0,0 +1,88 @@
+module ExposeAssociation
+  module Base
+    def expose_association association_name, options = {}, &block
+      exposer = AssociationExposer.new(self, association_name, options)
+      setup_class_for_exposition(exposer)
+      if block_given?
+        exposer.instance_eval(&block)
+      end
+    end
+
+    def setup_class_for_exposition(exposer)
+      # allowing mass assignment of the has_one association
+      self.attr_accessible exposer.association_attributes
+      self.accepts_nested_attributes_for exposer.association_name
+      self.send :alias_method, "old_#{exposer.association_name}", exposer.association_name
+      self.send :alias_method, "old_#{exposer.association_name}=", "#{exposer.association_name}="
+      self.class_eval <<-CODE
+        def #{exposer.association_name}
+          #{exposer.association_setup_method}
+        end
+
+        def #{exposer.association_setup_method}
+          self.old_#{exposer.association_name} ||= #{exposer.association_class}.new
+        end
+      CODE
+    end
+  end
+
+  class AssociationExposer
+
+    attr_reader :association_name, :association_class
+
+    def initialize klass, association_name, options = {}
+      @klass = klass
+      options[:class] ||= association_name.to_s.camelize.constantize
+      @association_class = options[:class]
+      @association_name = association_name
+      @options = options
+    end
+
+    def expose *attributes
+      options = attributes.last.is_a?(Hash) ? attributes.pop : {}
+      attributes.each do |attribute|
+        expose_attribute attribute, options
+      end
+    end
+
+    def expose_attribute name, options = {}
+      @klass.delegate name, "#{name}=",
+        to: association_setup_method,
+        prefix: prefix_for(options[:prefix])
+
+      @klass.attr_accessible attr_name_for(name, options[:prefix])
+    end
+
+    def attr_name_for(name, prefix)
+      case prefix
+      when FalseClass then name.to_s
+      when String, Symbol then 
+        "#{prefix.to_s}_#{name}"
+      else
+        "#{association_name}_#{name}"
+      end
+    end
+
+    def prefix_for(prefix_option)
+      case prefix_option
+      when TrueClass, NilClass then association_name.to_s
+      when FalseClass then false
+      when String, Symbol then prefix_option.to_s
+      else # nil
+        raise "Wrong value for prefix: #{prefix_option}"
+      end
+    end
+
+    def association_attributes
+      "#{association_name}_attributes"
+    end
+
+    def association_setup_method
+      "#{setup_method_prefix}_#{@association_name}"
+    end
+
+    def setup_method_prefix
+      @options.fetch(:setup_method_prefix, "setup")
+    end
+  end
+end

data/lib/expose_association/railtie.rb

@@ -0,0 +1,9 @@
+module ExposeAssociation
+  class Railtie < ::Rails::Railtie
+    initializer 'expose_association.ar_hook' do
+      ActiveSupport.on_load :active_record do
+        extend ::ExposeAssociation::Base
+      end
+    end
+  end
+end

data/lib/expose_association/version.rb

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

data/lib/expose_association.rb

@@ -0,0 +1,3 @@
+require "expose_association/version"
+require 'expose_association/base'
+require 'expose_association/railtie' if defined? Rails

data/spec/expose_association/base_spec.rb

@@ -0,0 +1,92 @@
+require 'spec_helper'
+
+class Address < ActiveRecord::Base; end
+class Contact < ActiveRecord::Base
+  extend ExposeAssociation::Base
+  has_one :main_location, :class_name => 'Address'
+end
+
+describe 'SomeModel with ExposeAssociation' do
+
+  it "should include the basic functionality" do
+    Contact.should respond_to(:expose_association)
+  end
+
+  context "exposing another object" do
+
+    before :all do
+      Contact.expose_association :main_location, class: Address do
+        expose :city
+        expose :address_line_1, prefix: false
+      end
+    end
+
+    let(:contact) { Contact.new }
+
+    it "should setup the association with the provided class" do
+      contact.main_location.should be_a_kind_of(Address)
+    end
+
+    it "should add the builder" do
+      contact.should respond_to(:setup_main_location)
+    end
+
+    it "should support mass assignment of the other object" do
+      contact.should allow_mass_assignment_of(:main_location_attributes)
+    end
+
+    it "should expose a given attribute (with prefix)" do
+      contact.should respond_to("main_location_city")
+      contact.should respond_to("main_location_city=")
+      contact.main_location_city = "Madrid"
+      contact.main_location.city.should == "Madrid"
+    end
+
+    it "should allow mass assignment of the exposed attributes" do
+      contact = Contact.new main_location_city: "Barcelona"
+      contact.main_location.city.should == "Barcelona"
+    end
+
+    context "with no prefix" do
+      it "should expose the attribute directly on the main object" do
+        contact.should respond_to(:address_line_1)
+        contact.address_line_1 = "Freire 1008"
+        contact.main_location.address_line_1.should == "Freire 1008"
+      end
+    end
+  end
+
+end
+
+
+describe ExposeAssociation::AssociationExposer do
+  it "should know the setup method" do
+    exposer = ExposeAssociation::AssociationExposer.new(Contact, :main_location, class: Address)
+    exposer.association_setup_method.should == "setup_main_location"
+  end
+
+  it "should infer the class name of the association if none is provided" do
+    exposer = ExposeAssociation::AssociationExposer.new(Contact, :address)
+    exposer.association_class.should == Address
+    exposer = ExposeAssociation::AssociationExposer.new(Contact, :main_location, class: Address)
+    exposer.association_class.should == Address
+  end
+
+  it "should calculate properly the attr_name for a given prefix" do
+    exposer = ExposeAssociation::AssociationExposer.new(Contact, :address)
+    exposer.attr_name_for(:city, nil).should == 'address_city'
+    exposer.attr_name_for(:city, true).should == 'address_city'
+    exposer.attr_name_for(:city, false).should == 'city'
+    exposer.attr_name_for(:city, "culo").should == 'culo_city'
+    exposer.attr_name_for(:city, :culito).should == 'culito_city'
+  end
+
+  it "should calculate properly the prefix " do
+    exposer = ExposeAssociation::AssociationExposer.new(Contact, :address)
+    exposer.prefix_for("culito").should == 'culito'
+    exposer.prefix_for(true).should == 'address'
+    exposer.prefix_for(nil).should == 'address'
+    exposer.prefix_for(false).should == false
+    exposer.prefix_for(:culito).should == 'culito'
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require 'active_record'
+require 'expose_association'
+require 'shoulda'
+
+ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :database => ":memory:")
+
+ActiveRecord::Schema.define(:version => 1) do
+  create_table :contacts do |t|
+    t.string :first_name, :last_name
+  end
+
+  create_table :addresses do |t|
+    t.string  :contactable_type
+    t.integer :contactable_id
+    t.string  :address_line_1, :address_line_2
+    t.string  :city
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: expose_association
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Lucas Florio
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: &70160113896320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70160113896320
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70160113895020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70160113895020
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: &70160113893880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70160113893880
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: &70160113892360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70160113892360
+description: ! "Easy exposition of has_one associations at the object\n  level, to
+  avoid nesting."
+email:
+- lucasefe@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- expose_association.gemspec
+- lib/expose_association.rb
+- lib/expose_association/base.rb
+- lib/expose_association/railtie.rb
+- lib/expose_association/version.rb
+- spec/expose_association/base_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+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: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: ! '...'
+test_files:
+- spec/expose_association/base_spec.rb
+- spec/spec_helper.rb
+has_rdoc: