bazza 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.rvmrc

@@ -0,0 +1 @@
+rvm --create use 1.9.2@bazza

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+gemspec
+gem 'rspec'

data/README.markdown

@@ -0,0 +1,80 @@
+bazza - the builder
+=======
+
+Build objects easily:
+
+  * specify defaults
+    * tailor defaults within tests at build time with optional hash or block
+  * chain builders
+  * reuse builder instances to create multiple objects
+  * specialise builders
+  * Readable usage
+```ruby
+customer = Customer.with.Order.with(:total => 22.21).thats.active
+```
+
+Why not a use factory?
+
+  * Common for consumers of builders to:
+    * specialise defaults; provide a readable way to accommodate this;
+    * build several objects of the same type; 
+
+An Example
+----------
+
+```ruby
+customer = Customer.with.Order.with(:total => 22.21).thats.active
+```
+
+class Customer
+end
+
+class Order
+end
+
+class CustomerBuilder
+end
+
+class OrderBuilder
+end
+
+
+License
+-------
+
+<a rel="license" href="http://creativecommons.org/licenses/by/3.0/">
+  <img src="http://i.creativecommons.org/l/by/3.0/88x31.png" alt="Creative Commons License" style="border:none;" height="31" width="88">
+</a>
+
+
+TODO
+----
+
+  * Class>>#build interpolate builder string rather than concat
+  * Split bazza spec by building/defaulting to reduce nesting
+  * Gemfile: make rspec dev dependency
+  * Overriding defaults
+  * Reusing builders
+  * Replace String>>#to_class implementation from stack overflow article with a spec'd/tested version
+
+Notes
+-----
+
+* Old school way:
+
+orderBuilder = OrderBuilder.new.with(:total => 22.21).makeActive
+customer = CustomerBuilder.with(:orderBuilder => orderBuilder).build
+
+* Aim:
+
+Customer.with.Order.with(:total => 22.21).thats.active
+
+- with
+  - no args: assumes next token is class name of associated attribute
+    - no-op, return self
+    - next message expected to be class name, resolve via method missing?  
+      - What about other method missing handlers? Better to return instance of class rather than self that permits chaining.
+    - attributeBuilder
+    
+  - args: attributes of target being built
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+
+task :default => :spec

data/bazza.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "bazza/version"
+
+Gem::Specification.new do |s|
+  s.name        = "bazza"
+  s.version     = Bazza::VERSION
+  s.authors     = ["mattdunn"]
+  s.email       = ["contact@mattonsoftware.com"]
+  s.homepage    = "https://github.com/mattdunn/bazza"
+  s.summary     = "bazza - the builder"
+  s.description = ""
+
+  s.rubyforge_project = "bazza"
+
+  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"]
+
+  s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/bazza.rb

@@ -0,0 +1,3 @@
+require "bazza/version"
+require "bazza/string_extensions"
+require "bazza/class_extensions"

data/lib/bazza/class_extensions.rb

@@ -0,0 +1,6 @@
+class Class
+  def build
+    klass = (self.name + 'Builder').to_class
+    return klass.nil? ? nil : klass.new.build
+  end 
+end

data/lib/bazza/string_extensions.rb

@@ -0,0 +1,11 @@
+# Rather than introducing a dependency on ActiveSupports#constantize,
+# using implementation from http://stackoverflow.com/questions/1448670/ruby-stringto-class
+class String
+  def to_class(parent = Kernel)
+    chain = self.split "::"
+    klass = parent.const_get chain.shift
+    return chain.size < 1 ? (klass.is_a?(Class) ? klass : nil) : chain.join("::").to_class(klass)
+    rescue
+      nil
+  end  
+end

data/lib/bazza/version.rb

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

data/spec/bazza_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require 'models/order'
+
+describe Bazza do
+  describe 'building an object' do
+    describe 'resolving builder class [ClassName]Builder' do
+      context 'when no class exists' do
+        it 'should return nil' do
+          Order.build.should be_nil
+        end
+      end
+      context 'when class exists' do
+        before do
+          class OrderBuilder
+            def build
+              Order.new({}) 
+            end
+          end
+        end
+        it 'should create an instance' do
+          Order.build.should be_an_instance_of Order
+        end
+        context 'with defaults' do
+          before do
+            class OrderBuilder
+              def build
+                Order.new(:total => 22.34)
+              end
+            end
+          end
+          it 'should create instance with defaults' do
+            Order.build.total.should == 22.34
+          end
+        end
+      end
+    end
+  end
+end

data/spec/models/order.rb

@@ -0,0 +1,7 @@
+class Order 
+  attr_reader :total
+  
+  def initialize(attrs)
+    @total = attrs[:total]
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'bazza'
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification 
+name: bazza
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- mattdunn
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-10-18 00:00:00 +01: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
+description: ""
+email: 
+- contact@mattonsoftware.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- README.markdown
+- Rakefile
+- bazza.gemspec
+- lib/bazza.rb
+- lib/bazza/class_extensions.rb
+- lib/bazza/string_extensions.rb
+- lib/bazza/version.rb
+- spec/bazza_spec.rb
+- spec/models/order.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/mattdunn/bazza
+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: bazza
+rubygems_version: 1.6.1
+signing_key: 
+specification_version: 3
+summary: bazza - the builder
+test_files: 
+- spec/bazza_spec.rb
+- spec/models/order.rb
+- spec/spec_helper.rb