elight-machinist 1.0.0

data/.autotest

@@ -0,0 +1,7 @@
+Autotest.add_hook :initialize do |at|
+  at.clear_mappings
+  
+  at.add_mapping(%r%^spec/(.*)_spec.rb$%) {|filename, _| filename }
+  at.add_mapping(%r%^lib/(.*).rb$%) {|_, match| "spec/#{match[1]}_spec.rb" }
+  at.add_mapping(%r%^spec/spec_helper.rb$%) { at.files_matching(%r%^spec/(.*)_spec.rb$%) }
+end

data/.gitignore

@@ -0,0 +1 @@
+coverage

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Peter Yandell
+
+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.markdown

@@ -0,0 +1,201 @@
+Machinist
+=========
+
+*Fixtures aren't fun. Machinist is.*
+
+Machinist lets you construct test data on the fly, but instead of doing this:
+
+    describe Comment do
+      before do
+        @user = User.create!(:name => "Test User")
+        @post = Post.create!(:title => "Test Post", :author => @user, :body => "Lorem ipsum...")
+        @comment = Comment.create!(
+          :post => @post, :author_name => "Test Commenter", :author_email => "commenter@example.com",
+          :spam => true
+        )
+      end
+    
+      it "should not include comments marked as spam in the without_spam named scope" do
+        Comment.without_spam.should_not include(@comment)
+      end
+    end
+  
+you can just do this:
+
+    describe Comment do
+      before do
+        @comment = Comment.make(:spam => true)
+      end
+    
+      it "should not include comments marked as spam in the without_spam named scope" do
+        Comment.without_spam.should_not include(@comment)
+      end
+    end
+  
+Machinist generates data for the fields you don't care about, and constructs any necessary associated objects.
+
+You tell Machinist how to do this with blueprints:
+
+    require 'faker'
+  
+    Sham.name  { Faker::Name.name }
+    Sham.email { Faker::Internet.email }
+    Sham.title { Faker::Lorem.sentence }
+    Sham.body  { Faker::Lorem.paragraph }
+  
+    User.blueprint do
+      name { Sham.name }
+    end
+  
+    Post.blueprint do
+      title  { Sham.title }
+      author { User.make }
+      body   { Sham.body }
+    end
+  
+    Comment.blueprint do
+      post
+      author_name  { Sham.name }
+      author_email { Sham.email }
+      body         { Sham.body }
+    end
+
+
+Installation
+------------
+
+Install the plugin:
+
+    ./script/plugin install git://github.com/notahat/machinist.git
+  
+Create a blueprints.rb in your test (or spec) directory, and require it in your test\_helper.rb (or spec\_helper.rb):
+
+    require File.expand_path(File.dirname(__FILE__) + "/blueprints")
+
+Set Sham to reset before each test. In the `class Test::Unit::TestCase` block in your test\_helper.rb, add:
+    
+    setup { Sham.reset }
+    
+or, if you're on RSpec, in the `Spec::Runner.configure` block in your spec\_helper.rb, add:
+
+    config.before(:each) { Sham.reset }
+    
+    
+Sham - Generating Attribute Values
+----------------------------------
+
+Sham lets you generate random but repeatable unique attributes values.
+
+For example, you could define a way to generate random names as:
+
+    Sham.name { (1..10).map { ('a'..'z').to_a.rand } }
+
+Then, to generate a name, call:
+
+    Sham.name
+
+So why not just define a method? Sham ensures two things for you:
+
+1. You get the same sequence of values each time your test is run
+2. You don't get any duplicate values
+    
+Sham works very well with the excellent [Faker gem](http://faker.rubyforge.org/) by Benjamin Curtis. Using this, a much nicer way to generate names is:
+    
+    Sham.name { Faker::Name.name }
+    
+Sham also supports generating numbered sequences if you prefer.
+
+    Sham.name {|index| "Name #{index}" }
+    
+If you want to allow duplicate values for a sham, you can pass the `:unique` option:
+
+    Sham.coin_toss(:unique => false) { rand(2) == 0 : 'heads' : 'tails' }
+
+
+Blueprints - Generating ActiveRecord Objects
+--------------------------------------------
+
+A blueprint describes how to build a generic object for an ActiveRecord model. The idea is that you let the blueprint take care of constructing all the objects and attributes that you don't care about in your test, leaving you to focus on the just the things that you're testing.
+
+A simple blueprint might look like this:
+
+    Comment.blueprint do
+      body "A comment!"
+    end
+
+Once that's defined, you can construct a comment from this blueprint with:
+    
+    Comment.make
+    
+Machinist calls `save!` on your ActiveRecord model to create the comment, so it will throw an exception if the blueprint doesn't pass your validations. It also calls `reload` after the `save!`.
+
+You can override values defined in the blueprint by passing parameters to make:
+
+    Comment.make(:body => "A different comment!")
+    
+Rather than providing a constant value for an attribute, you can use Sham to generate a value for each new object:
+
+    Sham.body { Faker::Lorem.paragraph }
+    Comment.blueprint do
+      body { Sham.body }
+    end
+    
+Notice the curly braces around `Sham.body`. If you call `Comment.make` with your own body attribute, this block will not be executed.
+
+You can use this same syntax to generate associated objects:
+    
+    Comment.blueprint do
+      post { Post.make }
+    end
+    
+If the associated model has the same name as the field, you can abbreviate this to:
+    
+    Comment.blueprint do
+      post
+    end
+    
+You can refer to already assigned attributes when constructing a new attribute:
+    
+    Comment.blueprint do
+      post
+      body { "Comment on " + post.name }
+    end
+    
+You can also override associated objects when calling make:
+
+    post = Post.make
+    3.times { Comment.make(:post => post) }
+
+It's common to need to construct an object with particular attributes, or a particular object graph, in a number of tests. The best way to abstract out the construction is to put something like this in your blueprints.rb:
+
+    class Post
+      def self.make_with_comments(attributes = {})
+        Post.make(attributes) do |post|
+          3.times { Comment.make(:post => post) }
+        end
+      end
+    end
+    
+Note that make can take a block, into which it will pass the newly constructed object.
+
+If you want to generate an object graph without saving to the database, use make\_unsaved:
+
+    Comment.make_unsaved
+    
+This will generate both the Comment and the associated Post without saving either.
+
+
+Credits
+-------
+
+Written by [Pete Yandell](http://notahat.com/).
+    
+Contributors:
+
+- [Roland Swingler](http://github.com/knaveofdiamonds)
+
+Thanks to Thoughtbot's [Factory Girl](http://github.com/thoughtbot/factory_girl/tree/master). Machinist was written because I loved the idea behind Factory Girl, but I thought the philosophy wasn't quite right, and I hated the syntax.
+
+---
+    
+Copyright (c) 2008 Peter Yandell, released under the MIT license

data/Rakefile

@@ -0,0 +1,20 @@
+require 'rake'
+require 'rake/gempackagetask'
+require 'rake/clean'
+require 'spec/rake/spectask'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc 'Run all the specs for the machinist plugin.'
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov = false
+end
+
+spec = eval(File.read(File.join(File.dirname(__FILE__), 'machinist.gemspec')))
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end

data/init.rb

@@ -0,0 +1,10 @@
+require 'active_record'
+
+if RAILS_ENV == 'test'
+  require 'machinist'
+  require 'sham'
+
+  class ActiveRecord::Base
+    include Machinist::ActiveRecordExtensions
+  end
+end

data/lib/machinist.rb

@@ -0,0 +1,88 @@
+require 'active_support'
+require 'active_record'
+ 
+module Machinist
+  def self.with_save_nerfed
+    begin
+      @@nerfed = true
+      yield
+    ensure
+      @@nerfed = false
+    end
+  end
+  
+  @@nerfed = false
+  def self.nerfed?
+    @@nerfed
+  end
+  
+  module ActiveRecordExtensions
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+    
+    module ClassMethods
+      def blueprint(&blueprint)
+        @blueprint = blueprint
+      end
+  
+      def make(attributes = {})
+        raise "No blueprint for class #{self}" if @blueprint.nil?
+        lathe = Lathe.new(self.new, attributes)
+        lathe.instance_eval(&@blueprint)
+        unless Machinist.nerfed?
+          lathe.object.save!
+          lathe.object.reload
+        end
+        returning(lathe.object) do |object|
+          yield object if block_given?
+        end
+      end
+    
+      def make_unsaved(attributes = {})
+        returning(Machinist.with_save_nerfed { make(attributes) }) do |object|
+          yield object if block_given?
+        end
+      end
+    end
+  end
+  
+  class Lathe
+    def initialize(object, attributes)
+      @object = object
+      @assigned_attributes = []
+      attributes.each do |key, value|
+        @object.send("#{key}=", value)
+        @assigned_attributes << key
+      end
+    end
+
+    attr_reader :object
+
+    def method_missing(symbol, *args, &block)
+      if @assigned_attributes.include?(symbol)
+        @object.send(symbol)
+      else
+        value = if block
+          block.call
+        elsif args.first.is_a?(Hash) || args.empty?
+          symbol.to_s.camelize.constantize.make(args.first || {})
+        else
+          args.first
+        end
+        @object.send("#{symbol}=", value)
+        @assigned_attributes << symbol
+      end
+    end
+  end
+end
+
+if RAILS_ENV == 'test'
+  require 'sham'
+ 
+  class ActiveRecord::Base
+    include Machinist::ActiveRecordExtensions
+  end
+end
+
+

data/lib/sham.rb

@@ -0,0 +1,65 @@
+require 'active_support'
+
+class Sham
+  @@shams = {}
+  
+  # Over-ride module's built-in name method, so we can re-use it for
+  # generating names. This is a bit of a no-no, but we get away with
+  # it in this context.
+  def self.name(*args, &block)
+    method_missing(:name, *args, &block)
+  end
+  
+  def self.method_missing(symbol, *args, &block)
+    if block_given?
+      @@shams[symbol] = Sham.new(symbol, args.pop || {}, &block)
+    else
+      sham = @@shams[symbol]
+      raise "No sham defined for #{symbol}" if sham.nil?
+      sham.fetch_value
+    end
+  end
+
+  def self.reset
+    @@shams.values.each(&:reset)
+  end
+  
+  def initialize(name, options = {}, &block)
+    @name      = name
+    @generator = block
+    @offset    = 0
+    @unique    = options.has_key?(:unique) ? options[:unique] : true
+    generate_values(12)
+  end
+  
+  def reset
+    @offset = 0
+  end
+  
+  def fetch_value
+    # Generate more values if we need them.
+    if @offset >= @values.length
+      generate_values(2 * @values.length)
+      raise "Can't generate more unique values for Sham.#{@name}" if @offset >= @values.length
+    end
+    returning @values[@offset] do
+      @offset += 1
+    end
+  end
+    
+private
+  
+  def generate_values(count)
+    @values = seeded { (1..count).map(&@generator) }
+    @values.uniq! if @unique
+  end
+  
+  def seeded
+    begin
+      srand(1)
+      yield
+    ensure
+      srand
+    end
+  end
+end

data/machinist.gemspec

@@ -0,0 +1,22 @@
+MACHINIST_SPEC = Gem::Specification.new do |s|
+  s.name     = "machinist"
+  s.author   = "notahat"
+  s.homepage = "http://github.com/notahat/machinist/tree"
+  s.version  = "1.0.0"
+  s.date     = "2008-11-22"
+  s.summary  = "Im in ur specs machining your fixtures"
+  s.has_rdoc = true
+  s.files    = [
+    ".autotest",
+    ".gitignore",
+		"MIT-LICENSE", 
+		"README.markdown",
+		"Rakefile", 
+		"machinist.gemspec", 
+                "init.rb",
+		"lib/machinist.rb", 
+    "lib/sham.rb"
+  ]
+  s.test_files = ["spec/machinist_spec.rb", "spec/sham_spec.rb", "spec/spec_helper.rb"]
+  s.add_dependency "activesupport"
+end

data/spec/machinist_spec.rb

@@ -0,0 +1,110 @@
+require File.dirname(__FILE__) + '/spec_helper'
+require 'machinist'
+
+class Base
+  include Machinist::ActiveRecordExtensions
+  
+  def save!;  @saved = true;          end
+  def reload; @reloaded = true; self; end
+
+  def saved?;    @saved;    end
+  def reloaded?; @reloaded; end
+end
+
+class Post < Base
+  attr_accessor :title
+  attr_accessor :body
+end
+
+class Comment < Base
+  attr_accessor :post
+  attr_accessor :author
+  attr_accessor :body
+end
+
+Post.blueprint do
+  title "An Example Post"
+  body  { "The quick brown fox." }
+end
+
+Comment.blueprint do
+  post
+  author "Fred Bloggs"
+  body   "Just a comment."
+end
+  
+describe Machinist do
+  describe "make methd" do
+    before do
+      @post = Post.make
+    end
+    
+    it "should set a field from a constant in the blueprint" do
+      @post.title.should == "An Example Post"
+    end
+  
+    it "should set a field from a block in the blueprint" do
+      @post.body.should == "The quick brown fox."
+    end
+    
+    it "should save the object" do
+      @post.should be_saved
+    end
+    
+    it "should reload the object" do
+      @post.should be_reloaded
+    end
+  end
+  
+  describe "make_unsaved method" do
+    before do
+      @comment = Comment.make_unsaved
+    end
+    
+    it "should not save the object" do
+      @comment.should_not be_saved
+    end
+    
+    it "should not reload the object" do
+      @comment.should_not be_reloaded
+    end
+    
+    it "should not save associated objects" do
+      @comment.post.should_not be_saved
+    end
+    
+    it "should not reload associated objects" do
+      @comment.post.should_not be_reloaded
+    end
+  end
+  
+  it "should override a field from the blueprint with a parameter" do
+    post = Post.make(:title => "A Different Title")
+    post.title.should == "A Different Title"
+  end
+  
+  it "should create an associated object for a field with no arguments in the blueprint" do
+    comment = Comment.make
+    comment.post.should_not be_nil
+  end
+  
+  it "should allow passing a block to make" do
+    comments = nil
+    post = Post.make do |post|
+      comments = (1..3).map { Comment.make(:post => post) }
+    end
+    post.should be_an_instance_of(Post)
+    comments.should_not be_nil
+    comments.each {|comment| comment.post.should == post }
+  end
+  
+  it "should not nerf make within a block passed to make_unsaved" do
+    comment = nil
+    post = Post.make_unsaved do |post|
+      comment = Comment.make(:post => post)
+    end
+    post.should_not be_saved
+    comment.should  be_saved
+    comment.post.should == post
+  end
+end

data/spec/sham_spec.rb

@@ -0,0 +1,45 @@
+require File.dirname(__FILE__) + '/spec_helper'
+require 'sham'
+
+Sham.random { rand }
+Sham.half_index {|index| index/2 }
+Sham.coin_toss(:unique => false) {|index| index % 2 == 1 ? 'heads' : 'tails' }
+Sham.limited {|index| index%10 }
+Sham.index {|index| index }
+Sham.name  {|index| index }
+
+describe Sham do
+  it "should ensure generated values are unique" do
+    values = (1..10).map { Sham.half_index }
+    values.should == (0..9).to_a
+  end
+
+  it "should generate non-unique values when asked" do
+    values = (1..4).map { Sham.coin_toss }
+    values.should == ['heads', 'tails', 'heads', 'tails']
+  end
+  
+  it "should generate more than a dozen values" do
+    values = (1..25).map { Sham.index }
+    values.should == (1..25).to_a
+  end
+    
+  it "should generate the same sequence of values after a reset" do
+    values1 = (1..10).map { Sham.random }
+    Sham.reset
+    values2 = (1..10).map { Sham.random }
+    values2.should == values1
+  end
+  
+  it "should die when it runs out of unique values" do
+    lambda {
+      (1..100).map { Sham.limited }
+    }.should raise_error(RuntimeError)
+  end
+  
+  it "should allow over-riding the name method" do
+    Sham.name.should == 1
+  end
+  
+    
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+require 'test/unit'
+require 'spec'
+require 'rubygems'
+require 'sham'
+
+Spec::Runner.configure do |config|
+  config.before(:each) { Sham.reset }
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: elight-machinist
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- notahat
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-22 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: 
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .autotest
+- .gitignore
+- MIT-LICENSE
+- README.markdown
+- Rakefile
+- machinist.gemspec
+- init.rb
+- lib/machinist.rb
+- lib/sham.rb
+has_rdoc: true
+homepage: http://github.com/notahat/machinist/tree
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Im in ur specs machining your fixtures
+test_files: 
+- spec/machinist_spec.rb
+- spec/sham_spec.rb
+- spec/spec_helper.rb