bricks 0.0.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

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

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.2"
+  gem "rcov", ">= 0"
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Mojo Tech
+
+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.md

@@ -0,0 +1,221 @@
+Bricks
+======
+
+Bricks is a hybrid Object Builder/Factory implementation. It aims to be a more flexible alternative to the existing Object Factory solutions while retaining as much simplicity as possible.
+
+Usage
+-----
+
+Let's assume you have the following class:
+
+    # Only ActiveRecord objects are supported right now.
+
+    # == Schema Information
+    #
+    # Table name: articles
+    #
+    #  id              :integer(4)      not null, primary key
+    #  title           :string(255)
+    #  author          :string(255)
+    #  formatted_title :string(510)
+    #  publication_id  :integer(4)
+    #
+    class Article < ActiveRecord::Base
+      belongs_to :publication
+      has_many   :readers
+    end
+
+    # == Schema Information
+    #
+    # Table name: publications
+    #
+    #  id   :integer(4)      not null, primary key
+    #  name :string(255)
+    #  type :string(255)
+    #
+    class Publication < ActiveRecord::Base
+    end
+
+    class Newspaper < Publication
+    end
+
+    # == Schema Information
+    #
+    # Table name: publications
+    #
+    #  id         :integer(4)      not null, primary key
+    #  name       :string(255)
+    #  birth_date :date
+    #
+    class Reader < ActiveRecord::Base
+    end
+
+At its simplest, you can start using Bricks without declaring any builder (*note:* it gets less verbose).
+
+    article_builder = build(Article)
+
+This will give you a builder for the Article class, which you can then use to build an Article
+
+    article_builder.
+      title("Why I hate Guybrush Threepwood").
+      author("Ghost Pirate LeChuck")
+
+Contrary to the original pattern, builders are stateful (i.e., you don't get a new builder every time you call a method on the current builder).
+
+You can get the underlying instance by calling _#generate_.
+
+    article = article_builder.generate
+
+This will initialize an Article with the attributes you passed the builder. If, instead of initializing, you'd prefer the record to be created right away, use _#create_ instead.
+
+If you don't really care about the builder and just want the underlying instance you can instead use.
+
+    article = build(Article).
+      title("Why I hate Guybrush Threepwood").
+      author!("Ghost Pirate LeChuck") # Note the "!"
+
+When you want to use the default builder, without customizing it any further, you can tack the "!" at the end of the builder method:
+
+    build!(Article)
+    create!(Article)
+
+### Building builders
+
+Of course, using builders like described above isn't of much use. Let's create a builder for _Article_:
+
+    Bricks do
+      builder Article do
+        title  "Why I hate Guybrush Threepwood"
+        author "Ghost Pirate LeChuck"
+      end
+    end
+
+You can then use it as you'd expect:
+
+    # initializes an Article with default attributes set, and saves it
+    article = create!(Article)
+
+### Deferred initialization
+
+    builder Article do
+      # ...
+
+      formatted_title { "The formatted title at #{Date.now}." }
+    end
+
+You can get at the underlying instance from deferred blocks:
+
+    builder Article do
+      # ...
+
+      formatted_title { |obj| obj.title + " by " + obj.author }
+    end
+
+### Associations
+
+Bricks supports setting association records.
+
+#### Many-to-one (belongs to)
+
+    Bricks do
+      builder Publication do
+        name "The Caribbean Times"
+      end
+
+      builder Article do
+        # ...
+
+        publication # instantiate a publication with the default attributes set
+      end
+    end
+
+You can also customize the association builder instance:
+
+    builder Article do
+      # ...
+      publication.name("The Caribeeaneer")
+    end
+
+If you prepend a "~" to the association declaration, the record will be initialized/created *only* if a record with the given attributes doesn't exist yet:
+
+    builder Article do
+      # ...
+      ~publication # will search for a record with name "The Caribbean Times"
+    end
+
+#### One-to-many, Many-to-many (has many, has and belongs to many)
+
+    Bricks do
+      builder Article do
+        # ...
+
+        # readers association will have 3 records
+        %w(Tom Dick Harry).each { |r| readers.name(r) }
+      end
+    end
+
+Each call to the *-to-many association name will add a new builder, which you can then further customize:
+
+    readers.name("Tom").birth_date(30.years.ago)
+
+(Note that you don't use "!" here. That's only when building the records in your tests.)
+
+### Builder Inheritance
+
+Given the builder:
+
+    builder Publication do
+      name "The Caribbean Times"
+    end
+
+you can do something like:
+
+    np = build!(Newspaper)
+    np.name # => "The Caribbean Times"
+
+### Traits
+
+The real power of the Builder pattern comes from the use of traits. Instead of declaring name factories in a single-inheritance model, you instead declare traits, which you can then mix and match:
+
+    builder Article
+      # ...
+
+      trait :alternative_publication do |name|
+        publication.name(name)
+      end
+
+      trait :by_elaine do
+        title  "Why I love Guybrush Threepwood"
+        author "Elaine Marley-Threepwood"
+      end
+    end
+
+Use it like this:
+
+    build(Article).alternative_publication("The Caribeaneer").by_elaine
+
+Note that if you want to override a *-to-many association inside a trait, you need to clear it first:
+
+    builder Article
+      # ...
+
+      # this will reset the readers association
+      trait :new_readers do
+        readers.clear
+
+        %(Charlotte Emily Anne).each { |r| readers.name(r) }
+      end
+
+      # this will add to the readers association
+      trait :more_readers do
+        readers.name("Groucho")
+      end
+    end
+
+For an executable version of this documentation, please see spec/bricks_spec.rb.
+
+Copyright
+---------
+
+Copyright (c) 2011 Mojo Tech. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "bricks"
+  gem.homepage = "http://github.com/mojotech/bricks"
+  gem.license = "MIT"
+  gem.summary = %Q{Hybrid object builder/factory.}
+  gem.email = "david@mojotech.com"
+  gem.author = "David Leal"
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "bricks #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.0

data/bricks.gemspec

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{bricks}
+  s.version = "0.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["David Leal"]
+  s.date = %q{2011-06-16}
+  s.email = %q{david@mojotech.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "bricks.gemspec",
+    "lib/bricks.rb",
+    "lib/bricks/adapters/active_record.rb",
+    "lib/bricks/builder.rb",
+    "lib/bricks/builder_set.rb",
+    "lib/bricks/dsl.rb",
+    "rails/init.rb",
+    "spec/bricks/adapters/active_record_spec.rb",
+    "spec/bricks/builder_spec.rb",
+    "spec/bricks_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/active_record.rb"
+  ]
+  s.homepage = %q{http://github.com/mojotech/bricks}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Hybrid object builder/factory.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, ["~> 2.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, ["~> 2.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, ["~> 2.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/lib/bricks/adapters/active_record.rb

@@ -0,0 +1,43 @@
+require 'bricks'
+require 'active_record'
+
+module Bricks
+  module Adapters
+    class ActiveRecord
+      class Association
+        attr_reader :type
+
+        def initialize(klass, kind)
+          @class = klass
+          @type  = case kind
+                   when :belongs_to;                         :one
+                   when :has_many, :has_and_belongs_to_many; :many
+                   else "Unknown AR association type: #{kind}."
+                   end
+        end
+
+        def klass
+          @class
+        end
+      end
+
+      def association?(klass, name, type = nil)
+        association(klass, name, type)
+      end
+
+      def association(klass, name, type = nil)
+        if ar = klass.reflect_on_association(name.to_sym)
+          a  = Association.new(ar.klass, ar.macro)
+
+          a if type.nil? || a.type == type
+        end
+      end
+
+      def find(klass, obj)
+        klass.find(:first, :conditions => obj.attributes)
+      end
+
+      Bricks::Builder.adapter = self.new
+    end
+  end
+end

data/lib/bricks/builder.rb

@@ -0,0 +1,150 @@
+require 'bricks/dsl'
+require 'bricks/builder_set'
+
+module Bricks
+  class Builder
+    include Bricks::DSL
+
+    def self.adapter
+      @@adapter
+    end
+
+    def self.adapter=(adapter)
+      @@adapter = adapter
+    end
+
+    def self.instances
+      @@instances ||= {}
+    end
+
+    def ~@()
+      @search = true
+
+      self
+    end
+
+    def derive(klass = @class, save = @save)
+      Builder.new(klass, @attrs, @traits, save)
+    end
+
+    def dup_as_builder
+      derive(@class, false)
+    end
+
+    def dup_as_creator
+      derive(@class, true)
+    end
+
+    def initialize(klass, attrs = nil, traits = nil, save = false, &block)
+      @class  = klass
+      @attrs  = attrs ? deep_copy(attrs) : []
+      @traits = traits ? Module.new { include traits } : Module.new
+      @save   = save
+
+      extend @traits
+
+      instance_eval &block if block_given?
+    end
+
+    def generate
+      obj = initialize_object
+
+      obj = adapter.find(@class, obj) || obj if @search
+      save_object(obj)                       if @save
+
+      obj
+    end
+
+    def trait(name, &block)
+      @traits.class_eval do
+        define_method "__#{name}", &block
+
+        define_method name do |*args|
+          send "__#{name}", *args
+
+          self
+        end
+      end
+    end
+
+    def method_missing(name, *args, &block)
+      attr = (return_object = name.to_s =~ /!$/) ? name.to_s.chop : name
+
+      result = if respond_to?(attr)
+                 send(attr, *args)
+               elsif settable?(attr)
+                 set attr, *args, &block
+               else
+                 raise Bricks::NoAttributeOrTrait, "Can't find `#{name}'."
+               end
+
+      if return_object
+        generate
+      else
+        result
+      end
+    end
+
+    private
+
+    def subject
+      Builder.instances[@class] ||= @class.new
+    end
+
+    def adapter
+      Builder.adapter
+    end
+
+    def deep_copy(attrs)
+      attrs.inject([]) { |a, (k, v)|
+        a.tap { a << [k, Builder === v ? v.derive : v] }
+      }
+    end
+
+    def save_object(obj)
+      obj.save!
+    end
+
+    def initialize_object
+      obj = @class.new
+
+      @attrs.each { |(k, v)|
+        val = case v
+              when Proc
+                v.call *[obj].take([v.arity, 0].max)
+              when Builder, BuilderSet
+                v.generate
+              else
+                v
+              end
+
+        obj.send "#{k}=", val
+      }
+
+      obj
+    end
+
+    def settable?(name)
+      subject.respond_to?("#{name}=")
+    end
+
+    def set(name, val = nil, &block)
+      raise Bricks::BadSyntax, "Block and value given" if val && block_given?
+
+      pair = @attrs.assoc(name) || (@attrs << [name, nil]).last
+
+      if block_given?
+        pair[-1] = block
+      elsif val
+        pair[-1] = val
+      elsif adapter.association?(@class, name, :one)
+        pair[-1] = create(adapter.association(@class, name).klass)
+      elsif adapter.association?(@class, name, :many)
+        pair[-1] ||= BuilderSet.new(adapter.association(@class, name).klass)
+      else
+        raise Bricks::BadSyntax,
+              "No value or block given and not an association: #{name}."
+      end
+    end
+  end
+end

data/lib/bricks/builder_set.rb

@@ -0,0 +1,40 @@
+require 'bricks/dsl'
+
+module Bricks
+  class BuilderSet
+    include Bricks::DSL
+
+    def build(klass)
+      (@builders << super).last
+    end
+
+    def build!(klass)
+      (@builders << super).last
+    end
+
+    def clear
+      @builders.clear
+    end
+
+    def create(klass)
+      (@builders << super).last
+    end
+
+    def create!(klass)
+      (@builders << super).last
+    end
+
+    def initialize(klass)
+      @class    = klass
+      @builders = []
+    end
+
+    def method_missing(name, *args)
+      build(@class).send(name, *args)
+    end
+
+    def generate
+      @builders.map { |b| b.generate }
+    end
+  end
+end

data/lib/bricks/dsl.rb

@@ -0,0 +1,23 @@
+module Bricks
+  module DSL
+    def build(klass)
+      builder(klass).dup_as_builder
+    end
+
+    def build!(klass)
+      build(klass).generate
+    end
+
+    def create(klass)
+      builder(klass).dup_as_creator
+    end
+
+    def create!(klass)
+      create(klass).generate
+    end
+
+    def builder(klass)
+      Bricks.builders[klass]
+    end
+  end
+end

data/lib/bricks.rb

@@ -0,0 +1,43 @@
+require 'bricks/builder'
+require 'bricks/dsl'
+
+module Bricks
+  class << self
+    attr_writer :builders
+
+    def builders
+      @builders ||= BuilderHashSet.new
+    end
+  end
+
+  class NoAttributeOrTrait < StandardError; end
+  class BadSyntax < StandardError; end
+
+  class BuilderHashSet
+    def initialize(&block)
+      @builders = {}
+    end
+
+    def [](key)
+      if @builders[key]
+        @builders[key]
+      elsif Class === key
+        @builders[key] = if builder = @builders[key.superclass]
+                           builder.derive(key)
+                         else
+                           builder(key)
+                         end
+      end
+    end
+
+    def builder(klass, &block)
+      @builders[klass] = Bricks::Builder.new(klass, &block)
+    end
+  end
+end
+
+def Bricks(&block)
+  Bricks::builders = Bricks::BuilderHashSet.new
+
+  Bricks::builders.instance_eval(&block)
+end

data/rails/init.rb

@@ -0,0 +1,5 @@
+if defined?(ActiveRecord)
+  require 'bricks/adapters/active_record'
+else
+  Rails.logger.warn "No suitable Brick adapter found."
+end

data/spec/bricks/adapters/active_record_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe Bricks::Adapters::ActiveRecord do
+  subject { Bricks::Adapters::ActiveRecord.new }
+
+  it "gracefully handles a missing association" do
+    subject.association?(Reader, :birth_date, :one).should be_nil
+  end
+
+  it "gracefully handles a missing association of the given type" do
+    subject.association?(Article, :newspaper, :many).should be_nil
+  end
+end

data/spec/bricks/builder_spec.rb

@@ -0,0 +1,41 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe Bricks::Builder do
+  before :all do
+    Bricks::Builder.adapter = Class.new {
+      def association(*args)
+        nil
+      end
+
+      alias_method :association?, :association
+    }.new
+
+    class Person
+      attr_accessor :name
+    end
+  end
+
+  it "fails if the model is missing the given attribute" do
+    lambda {
+      Bricks::Builder.new(Person).birth_date(Date.new(1978, 5, 3))
+    }.should raise_error(Bricks::NoAttributeOrTrait)
+  end
+
+  it "forbids passing a block and an initial value" do
+    lambda {
+      Bricks::Builder.new(Person).name("Jack") { "heh" }
+    }.should raise_error(Bricks::BadSyntax)
+  end
+
+  it "forbids passing no value or block to a non-association attribute" do
+    lambda {
+      Bricks::Builder.new(Person).name
+    }.should raise_error(Bricks::BadSyntax)
+  end
+
+  it "always generates a new object" do
+    b = Bricks::Builder.new(Person)
+
+    b.generate.object_id.should_not == b.generate.object_id
+  end
+end

data/spec/bricks_spec.rb

@@ -0,0 +1,189 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Bricks do
+  include Bricks::DSL
+
+  before :all do
+    Bricks::Builder.adapter = Bricks::Adapters::ActiveRecord.new
+
+    Bricks do
+      builder PrintMedium do
+        start_date Date.new(1900, 1, 1)
+      end
+
+      builder Newspaper do
+        name "The Daily Planet"
+
+        trait :daily_bugle do
+          name "The Daily Bugle"
+        end
+      end
+
+      builder Article do
+        author 'Jack Jupiter'
+        title  'a title'
+        body   'the body'
+        formatted_title { |obj| obj.title + " by " + obj.author }
+        deferred { Time.now }
+        newspaper
+
+        %w(Socrates Plato Aristotle).each { |n| readers.name(n) }
+
+        trait :in_english do
+          language "English"
+        end
+
+        trait :by_jove do
+          author "Jack Jupiter"
+        end
+
+        trait :maybe_bugle do
+          ~newspaper.daily_bugle
+        end
+
+        trait :on_the_bugle do
+          newspaper.daily_bugle
+        end
+
+        trait :with_alternative_readers do
+          readers.clear
+
+          %w(Tom Dick Harry).each { |n| readers.name(n) }
+        end
+      end
+    end
+  end
+
+  after do
+    Reader.delete_all
+    Article.delete_all
+    PrintMedium.delete_all
+    Newspaper.delete_all
+  end
+
+  it "#build returns the constructor" do
+    build(Article).should be_kind_of(Bricks::Builder)
+  end
+
+  it "#create returns the constructor" do
+    create(Article).should be_kind_of(Bricks::Builder)
+  end
+
+  it "initializes a model" do
+    a = build!(Article)
+
+    a.should be_instance_of(Article)
+    a.should be_new_record
+  end
+
+  it "creates a model" do
+    a = create!(Article)
+
+    a.should be_instance_of(Article)
+    a.should be_saved
+  end
+
+  describe "with simple fields" do
+    it "initializes model fields" do
+      a = build!(Article)
+
+      a.title.should == 'a title'
+      a.body.should  == 'the body'
+    end
+
+    it "defers field initialization" do
+      time = Time.now
+      a    = build!(Article)
+
+      a.deferred.should > time
+    end
+
+    it "uses the object being built in deferred initialization" do
+      build!(Article).formatted_title.should == "a title by Jack Jupiter"
+    end
+  end
+
+  describe "with traits" do
+    it "returns the builder after calling the trait" do
+      build(Article).in_english.should be_kind_of(Bricks::Builder)
+    end
+
+    it "#build returns the object if the trait is called with a bang" do
+      a = build(Article).in_english!
+
+      a.should be_kind_of(Article)
+      a.should be_new_record
+    end
+
+    it "#create creates the object if the trait is called with a bang" do
+      a = create(Article).in_english!
+
+      a.should be_kind_of(Article)
+      a.should be_saved
+    end
+
+    it "initializes the model fields" do
+      build(Article).in_english!.language.should == "English"
+    end
+
+    it "combines multiple traits" do
+      a = build(Article).in_english.by_jove!
+
+      a.language.should == "English"
+      a.author.should   == "Jack Jupiter"
+    end
+  end
+
+  describe "with a many-to-one association" do
+    it "initializes an association with the default values" do
+      build!(Article).newspaper.name.should == 'The Daily Planet'
+    end
+
+    it "overrides the association" do
+      build(Article).on_the_bugle!.newspaper.name.
+        should == 'The Daily Bugle'
+    end
+
+    it "possibly looks for an existing record" do
+      n = create(Newspaper).daily_bugle!
+      a = create(Article).maybe_bugle!
+
+      a.newspaper.should == n
+    end
+
+    it "possibly looks for an existing record (and finds none)" do
+      a = create(Article).maybe_bugle!
+
+      a.newspaper.should_not be_new_record
+      a.newspaper.name.should == "The Daily Bugle"
+    end
+  end
+
+  describe "with a one-to-many association" do
+    it "initializes an association with the default values" do
+      build!(Article).readers.map { |r|
+        r.name
+      }.should == %w(Socrates Plato Aristotle)
+    end
+
+    it "overrides the association" do
+      build(Article).with_alternative_readers!.readers.map { |r|
+        r.name
+      }.should == %w(Tom Dick Harry)
+    end
+  end
+
+  describe "builder inheritance" do
+    it "uses the parent's builder if the model has none" do
+      mag = build!(Magazine)
+
+      mag.should be_a(Magazine)
+      mag.start_date.should == Date.new(1900, 1, 1)
+    end
+
+    it "creates a builder for models that don't have one" do
+      build!(Reader).should be_a(Reader)
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'bricks'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/spec/support/active_record.rb

@@ -0,0 +1,52 @@
+require 'active_support/core_ext/class/attribute_accessors'
+require 'active_support/core_ext/module/delegation'
+require 'benchmark'
+require 'bricks/adapters/active_record'
+
+ActiveRecord::Base.establish_connection(
+  :adapter => "sqlite3",
+  :database => ":memory:"
+ )
+
+ActiveRecord::Schema.define(:version => 20110608204150) do
+  create_table "articles", :force => true do |t|
+    t.string   "author"
+    t.string   "body"
+    t.datetime "deferred"
+    t.string   "formatted_title"
+    t.string   "language"
+    t.integer  "newspaper_id"
+    t.string   "title"
+  end
+
+  create_table "newspapers", :force => true do |t|
+    t.string   "name"
+  end
+
+  create_table "print_media", :force => true do |t|
+    t.date     "start_date"
+    t.string   "type"
+  end
+
+  create_table "readers", :force => true do |t|
+    t.integer  "article_id"
+    t.string   "name"
+  end
+end
+
+class Article < ActiveRecord::Base
+  belongs_to :newspaper
+  has_many   :readers
+
+  def saved?
+    ! new_record?
+  end
+end
+
+class PrintMedium < ActiveRecord::Base; end
+
+class Magazine < PrintMedium; end
+
+class Newspaper < ActiveRecord::Base; end
+
+class Reader < ActiveRecord::Base; end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification 
+name: bricks
+version: !ruby/object:Gem::Version 
+  hash: 31
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 0
+  version: 0.0.0
+platform: ruby
+authors: 
+- David Leal
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-16 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
+  name: rspec
+  requirement: *id001
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  name: bundler
+  requirement: *id002
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 6
+        - 2
+        version: 1.6.2
+  name: jeweler
+  requirement: *id003
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rcov
+  requirement: *id004
+  type: :development
+description: 
+email: david@mojotech.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.md
+files: 
+- .document
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- bricks.gemspec
+- lib/bricks.rb
+- lib/bricks/adapters/active_record.rb
+- lib/bricks/builder.rb
+- lib/bricks/builder_set.rb
+- lib/bricks/dsl.rb
+- rails/init.rb
+- spec/bricks/adapters/active_record_spec.rb
+- spec/bricks/builder_spec.rb
+- spec/bricks_spec.rb
+- spec/spec_helper.rb
+- spec/support/active_record.rb
+has_rdoc: true
+homepage: http://github.com/mojotech/bricks
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Hybrid object builder/factory.
+test_files: []
+