blueprints 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Lachie Cox
+
+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.rdoc

@@ -0,0 +1,150 @@
+= Blueprints
+
+Another replacement for factories and fixtures that focuses on being DRY and making developers type as little as possible.
+
+== Usage
+
+Plans look like:
+
+    plan :apple do
+      Fruit.create! :species => 'apple'
+    end
+
+    plan :orange do
+      Fruit.create! :species => 'orange'
+    end
+
+    plan :fruitbowl => [:apple, :orange] do
+      FruitBowl.create! :fruit => [@apple,@orange]
+    end
+
+    plan :kitchen => :fruitbowl do
+      Kitchen.create! :fruitbowl => @fruitbowl
+    end
+
+...and you use them in specs like:
+
+    describe Fruit, "@apple" do
+      before do
+        build :apple
+      end
+  
+      it "should be an apple" do
+        @apple.species.should == 'apple'
+      end
+    end
+
+    describe FruitBowl, "with and apple and an orange" do
+      before do
+        build :fruitbowl
+      end
+
+      it "should have 2 fruits" do
+        @fruitbowl.should have(2).fruit
+      end
+    end
+
+Result of 'plan' block is evaluated and assigned to instance variable with the same name. You can also assign your own instance variables
+inside 'plan' block and they will be accessible in tests that build this plan.
+
+All scenarios are run only once, no matter how many times they were called, meaning that you don't need to worry about
+duplicating data.
+
+There's also a possibility to delete preloaded data with demolish. When called without arguments it will drop all data.
+You can also pass it table names, that will be cleared of any data. Beware that any scenarios already executed will still be
+marked as executed, so you won't be able to execute them again. If you want to execute those scenarios later in test, you
+can pass :undo option with list of scenarios to mark as not executed or :all if you want to mark that no scenario has been executed.
+
+    demolish :fruits, :trees # Deletes trees and fruits tables
+    demolish # Deletes all data except tables that are defined by Hornsby.skip_tables
+    demolish :fruits, :undo => :apples # Deletes fruits table and marks :apples scenario as not executed
+    demolish :undo => :all # Deletes all tables and marks all scenario as not executed (fresh start)
+
+Blueprints searches for scenario files in this particular order in Rails (Merb) root:
+* blueprints.rb
+* blueprints/*.rb
+* blueprint.rb
+* blueprint/*.rb
+* spec/blueprints.rb
+* spec/blueprints/*.rb
+* spec/blueprint.rb
+* spec/blueprint/*.rb
+* test/blueprints.rb
+* test/blueprints/*.rb
+* test/blueprint.rb
+* test/blueprint/*.rb
+You can pass :root option to override framework root and :filename option to pass custom filename pattern 
+
+== Setup
+
+The easiest way to install this gem for Ruby on Rails is just add this line to config/environment.rb (or config/environments/test.rb):
+
+    config.gem 'sinsiliux-blueprints', :lib => 'blueprints', :source => 'http://gems.github.com'
+
+If you’re not using rails, then you can install it through command line
+
+    gem sources -a http://gems.github.com
+    sudo gem install sinsiliux-blueprints
+
+Lastly you could use it as plugin:
+
+    ruby script/plugin install git://github.com/sinsiliux/blueprints.git
+
+Hornsby scenarios is activated by calling enable_blueprints. For specifics on how to call that in your testing framework see a little lower.
+enable_blueprintssupports these parameters:
+* root - custom framework root if automatic detection fails for some reason (eg. not rails/merb project)
+* filename - custom files pattern with blueprints plans
+* prebuild - list of blueprints plans that should be preloaded (available in all tests, never reloaded so they're much faster)
+
+=== RSpec
+
+Add the following to spec_helper.rb
+
+    Spec::Runner.configure do |config|
+      ...
+  
+      config.enable_blueprints :filename => 'scenarios.rb', :prebuild => :preloaded_scenario
+    end
+
+=== Test::Unit
+
+Add the following lines to test_helper.rb
+
+    class ActiveSupport::TestCase
+      ...
+
+      enable_blueprints
+    end
+
+== Advanced Usage
+
+Its just ruby, right? So go nuts:
+
+    1.upto(9) do |i|
+      plan("user_#{i}") do
+        user = User.create! :name => "user#{i}"
+        instance_variable_set("@user_#{i}",user)
+      end
+    end
+
+== Transactions
+
+Blueprints is transactional, meaning that after every test transaction is dropped and database is reset to
+starting point. Starting point is empty database + any scenarios that you specify in enable_blueprints.
+
+== TODO
+
+* Add plan namespaces for better organisation.
+* Add ability to revert one plan.
+* Add preloading plans for whole block of tests.
+* Fix rake tasks
+
+== Credits
+
+Andrius Chamentauskas <sinsiliux@gmail.com>
+
+The code is based on hornsby scenario plugin by Lachie Cox, which is based on Err's code found in this post: http://errtheblog.com/post/7708
+
+== License
+
+MIT, see LICENCE

data/lib/blueprints.rb

@@ -0,0 +1,76 @@
+require File.join(File.dirname(__FILE__), 'blueprints/plan')
+require File.join(File.dirname(__FILE__), 'blueprints/file_context')
+require File.join(File.dirname(__FILE__), 'blueprints/helper')
+require File.join(File.dirname(__FILE__), 'blueprints/errors')
+if defined? Spec
+  require File.join(File.dirname(__FILE__), 'blueprints/rspec_extensions')
+else
+  require File.join(File.dirname(__FILE__), 'blueprints/test_unit_extensions')
+end
+
+module Blueprints
+  PLAN_FILES = [nil, "spec", "test"].map do |dir|
+    ["blueprint", "blueprints"].map do |file|
+      path = File.join([dir, file].compact)
+      ["#{path}.rb", File.join(path, "*.rb")]
+    end
+  end.flatten
+
+  DELETE_POLICIES = {:delete => "DELETE FROM %s", :truncate => "TRUNCATE %s"}
+
+  def self.framework_root
+    @@framework_root ||= RAILS_ROOT rescue Rails.root rescue Merb.root rescue nil
+  end
+
+  def self.setup(current_context)
+    Plan.setup
+    Plan.copy_ivars(current_context)
+    ActiveRecord::Base.connection.increment_open_transactions
+    ActiveRecord::Base.connection.transaction_joinable = false
+    ActiveRecord::Base.connection.begin_db_transaction
+  end
+
+  def self.teardown
+    ActiveRecord::Base.connection.rollback_db_transaction
+    ActiveRecord::Base.connection.decrement_open_transactions
+  end
+
+  def self.load(options = {})
+    options.assert_valid_keys(:delete_policy, :filename, :prebuild, :root)
+    return unless Plan.plans.empty?
+
+    @@delete_sql = DELETE_POLICIES[options[:delete_policy]] || DELETE_POLICIES[:delete]                              
+    delete_tables
+    @@framework_root = options[:root] if options[:root]
+    load_scenarios_files(options[:filename] || PLAN_FILES)
+
+    Plan.prebuild(options[:prebuild])
+  end
+
+  def self.load_scenarios_files(*patterns)
+    patterns.flatten!
+    patterns.collect! {|pattern| File.join(framework_root, pattern)} if framework_root
+    
+    patterns.each do |pattern|
+      unless (files = Dir.glob(pattern)).empty?
+        files.each{|f| FileContext.module_eval File.read(f)}
+        return
+      end
+    end
+    
+    raise "Plans file not found! Put plans in #{patterns.join(' or ')} or pass custom filename pattern with :filename option"
+  end
+  
+  def self.delete_tables(*args)
+    args = tables if args.blank?
+    args.each { |t| ActiveRecord::Base.connection.delete(@@delete_sql % t)  }
+  end
+
+  def self.tables
+    ActiveRecord::Base.connection.tables - skip_tables
+  end
+
+  def self.skip_tables
+    %w( schema_info schema_migrations )
+  end
+end

data/lib/blueprints/errors.rb

@@ -0,0 +1,11 @@
+module Blueprints
+  class PlanNotFoundError < NameError
+    def initialize(*args)
+      @plans = args
+    end
+
+    def to_s
+      "Plan(s) not found '#{@plans.join(',')}'"
+    end
+  end
+end

data/lib/blueprints/file_context.rb

@@ -0,0 +1,7 @@
+module Blueprints
+  module FileContext
+    def self.blueprint(plan, &block)
+      Plan.new(plan, &block)
+    end
+  end
+end

data/lib/blueprints/helper.rb

@@ -0,0 +1,25 @@
+module Blueprints
+  module Helper
+    def build_plan(*names)
+      Plan.build(*names)   
+      Plan.copy_ivars(self)
+    end
+
+    alias :build :build_plan
+
+    def demolish(*args)
+      options = args.extract_options!
+      Blueprints.delete_tables(*args)
+
+      if options[:undo] == :all
+        Plan.executed_plans.clear
+      else
+        undo = [options[:undo]].flatten.compact
+        unless (not_found = undo - Plan.executed_plans.to_a).blank?
+          raise(ArgumentError, "Scenario(s) #{not_found} not found")
+        end
+        Plan.executed_plans -= undo
+      end
+    end
+  end
+end

data/lib/blueprints/plan.rb

@@ -0,0 +1,98 @@
+module Blueprints
+  class Plan
+    cattr_reader :plans
+    cattr_accessor :executed_plans
+    @@plans = {}
+    @@executed_plans = Set.new
+    @@global_executed_plans = Set.new
+
+    @@global_context = Module.new
+    @@context = nil
+
+    def self.setup
+      @@context = YAML.load(@@global_context)
+      @@executed_plans = @@global_executed_plans.clone
+    end
+
+    def self.copy_ivars(to)
+      @@context.instance_variables.each do |iv|
+        to.instance_variable_set(iv, @@context.instance_variable_get(iv))
+      end
+    end
+
+    def self.prebuild(plans)
+      @@context = @@global_context
+      @@global_scenarios = Plan.build(plans) if plans
+      @@global_executed_plans = @@executed_plans
+      @@global_context = YAML.dump(@@global_context)
+    end
+
+    def self.build(*names)
+      names.map {|name| @@plans[name.to_sym] or raise PlanNotFoundError, name}.each {|p| p.build}
+    end
+
+    # Instance
+
+    attr_reader :name
+
+    def initialize(scenario, &block)
+      @name, @parents = parse_name(scenario)
+      @block = block
+
+      @@plans[@name] = self
+    end
+
+    def build
+      build_parent_plans(@@context)
+      build_plan(@@context)   
+    end
+
+    protected
+
+    def parse_name(name)
+      case name
+        when Hash
+          return name.keys.first.to_sym, [name.values.first].flatten.map{|sc| parse_name(sc).first}
+        when Symbol, String
+          return name.to_sym, []
+        else
+          raise TypeError, "Pass plan names as strings or symbols only, cannot build plan #{name.inspect}"
+      end
+    end
+
+    def say(*messages)
+      puts messages.map { |message| "=> #{message}" }
+    end
+
+    def build_plan(context)
+      surface_errors do
+        if @block
+          result = context.module_eval(&@block)
+          iv_name = :"@#{@name}"
+          context.instance_variable_set(iv_name, result) unless context.instance_variable_get(iv_name)
+        end
+      end unless @@executed_plans.include?(@name)
+      @@executed_plans << @name
+    end
+
+    def build_parent_plans(context)
+      @parents.each do |p|
+        parent = @@plans[p] or raise PlanNotFoundError, p
+
+        parent.build_parent_plans(context)
+        parent.build_plan(context)
+      end
+    end
+
+    def surface_errors
+      yield
+    rescue StandardError => error
+      puts
+      say "There was an error building scenario '#{@name}'", error.inspect
+      puts
+      puts error.backtrace
+      puts
+      raise error
+    end
+  end
+end

data/lib/blueprints/rspec_extensions.rb

@@ -0,0 +1,17 @@
+module Spec
+  module Runner
+    class Configuration
+      def enable_blueprints(options = {})
+        Blueprints.load(options)
+
+        include(Blueprints::Helper)
+        before do
+          Blueprints.setup(self)
+        end
+        after do
+          Blueprints.teardown
+        end
+      end
+    end
+  end
+end

data/lib/blueprints/test_unit_extensions.rb

@@ -0,0 +1,17 @@
+module Test
+  module Unit
+    class TestCase
+      def run_with_blueprints(result, &progress_block)
+        Blueprints.setup(self)
+        run_without_blueprints(result, &progress_block)
+        Blueprints.teardown
+      end
+
+      def self.enable_blueprints(options = {})
+        include Blueprints::Helper
+        Blueprints.load(options)
+        alias_method_chain :run, :blueprints
+      end
+    end
+  end
+end

data/lib/tasks/blueprints_tasks.rake

@@ -0,0 +1,12 @@
+require File.dirname(__FILE__)+'/../blueprints'
+
+namespace :hornsby do
+
+  desc "Load the scenario named in the env var SCENARIO"
+  task :scenario => :environment do
+    raise "set SCENARIO to define which scenario to load" unless ENV['SCENARIO']
+    ::Hornsby.load
+    ::Hornsby.build(ENV['SCENARIO'])
+  end
+  
+end

data/spec/blueprints.rb

@@ -0,0 +1,35 @@
+blueprint :apple do
+  Fruit.create! :species => 'apple'
+end
+
+blueprint :many_apples => [:apple, :apple, :apple]
+
+blueprint :bananas_and_apples => :apple do
+  @banana = Fruit.create! :species => 'banana'
+end
+
+blueprint :orange do
+  Fruit.create! :species => 'orange'
+end
+
+blueprint :fruit => [:apple, :orange] do
+  [@orange, @apple]
+end
+
+blueprint :bananas_and_apples_and_oranges => [:bananas_and_apples, :orange] do
+  @fruit = [@orange, @apple, @banana]
+end
+
+blueprint :cherry do
+  Fruit.create! :species => 'cherry', :average_diameter => 3
+end
+
+blueprint :big_cherry => :cherry do
+  Fruit.create! :species => @cherry.species, :average_diameter => 7
+end
+
+blueprint :cherry_basket => [:big_cherry, :cherry] do
+  [@cherry, @big_cherry]
+end
+
+blueprint :parent_not_existing => :not_existing

data/spec/blueprints_spec.rb

@@ -0,0 +1,216 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe Blueprints do
+  describe "scenario files" do
+    it "should be loaded from specified dirs" do
+      Blueprints::PLAN_FILES.should == ["blueprint.rb", "blueprint/*.rb", "blueprints.rb", "blueprints/*.rb", "spec/blueprint.rb", "spec/blueprint/*.rb", "spec/blueprints.rb", "spec/blueprints/*.rb", "test/blueprint.rb", "test/blueprint/*.rb", "test/blueprints.rb", "test/blueprints/*.rb"]   
+    end
+  end
+
+  describe "with apple scenario" do
+    before do
+      build :apple
+    end
+
+    it "should create @apple" do
+      @apple.should_not be_nil
+    end
+
+    it "should create Fruit @apple" do
+      @apple.should be_instance_of(Fruit)
+    end
+
+    it "should not create @banana" do
+      @banana.should be_nil
+    end
+
+    it "should have correct species" do
+      @apple.species.should == 'apple'
+    end
+  end
+
+  describe "with bananas_and_apples scenario" do
+    before do
+      build :bananas_and_apples
+    end
+
+    it "should have correct @apple species" do
+      @apple.species.should == 'apple'
+    end
+
+    it "should have correct @banana species" do
+      @banana.species.should == 'banana'
+    end
+  end
+
+  describe "with fruit scenario" do
+    before do
+      build :fruit
+    end
+
+    it "should have 2 fruits" do
+      @fruit.should have(2).items
+    end
+
+    it "should have an @apple" do
+      @apple.species.should == 'apple'
+    end
+
+    it "should have an @orange" do
+      @orange.species.should == 'orange'
+    end
+
+    it "should have no @banana" do
+      @banana.should be_nil
+    end
+  end
+
+  describe 'with preloaded cherry scenario' do
+    it "should have correct size after changed by second test" do
+      @cherry.average_diameter.should == 3
+      @cherry.update_attribute(:average_diameter, 1)
+      @cherry.average_diameter.should == 1
+    end
+
+    it "should have correct size" do
+      @cherry.average_diameter.should == 3
+      @cherry.update_attribute(:average_diameter, 5)
+      @cherry.average_diameter.should == 5
+    end
+
+    it "should create big cherry" do
+      @big_cherry.species.should == 'cherry'
+    end
+  end
+
+  describe 'demolish' do
+    before do
+      build :apple
+    end
+
+    it "should clear scenarios when calling demolish" do
+      demolish
+      Fruit.count.should == 0
+    end
+
+    it "should clear only tables passed" do
+      Tree.create!(:name => 'oak')
+      demolish :fruits
+      Tree.count.should == 1
+      Fruit.count.should == 0
+    end
+
+    it "should mark scenarios as undone when passed :undone option" do
+      build :fruit
+      demolish :undo => [:apple]
+      Fruit.count.should == 0
+      build :fruit
+      Fruit.count.should == 1
+    end
+
+    it "should mark all scenarios as undone when passed :undone option as :all" do
+      build :fruit
+      demolish :undo => :all
+      Fruit.count.should == 0
+      build :fruit
+      Fruit.count.should == 2
+    end
+
+    it "should raise error when not executed scenarios passed to :undo option" do
+      lambda {
+        demolish :undo => :orange
+      }.should raise_error(ArgumentError)
+    end
+  end
+
+  describe 'delete policies' do
+    before do
+      Blueprints::Plan.plans.should_receive(:empty?).and_return(true)
+      Blueprints.should_receive(:load_scenarios_files).with(Blueprints::PLAN_FILES)
+      Blueprints::Plan.should_receive(:prebuild).with(nil)
+    end
+
+    it "should allow using custom delete policy" do
+      ActiveRecord::Base.connection.should_receive(:delete).with("TRUNCATE fruits")
+      ActiveRecord::Base.connection.should_receive(:delete).with("TRUNCATE trees")
+
+      Blueprints.load(:delete_policy => :truncate)
+    end
+
+    it "should default to :delete policy if unexisting policy given" do
+      ActiveRecord::Base.connection.should_receive(:delete).with("DELETE FROM fruits")
+      ActiveRecord::Base.connection.should_receive(:delete).with("DELETE FROM trees")
+
+      Blueprints.load(:delete_policy => :ukndown)
+    end
+  end
+
+  describe 'with many apples scenario' do
+    before do
+      build :many_apples, :cherry, :cherry_basket
+    end
+
+    it "should create only one apple" do
+      Fruit.all(:conditions => 'species = "apple"').size.should == 1
+    end
+
+    it "should create only two cherries even if they were preloaded" do
+      Fruit.all(:conditions => 'species = "cherry"').size.should == 2
+    end
+
+    it "should contain cherries in basket if basket is loaded in test and cherries preloaded" do
+      @cherry_basket.should == [@cherry, @big_cherry]
+    end
+  end
+
+  describe 'transactions' do
+    before do
+      build :apple
+    end
+
+    it "should drop only inner transaction" do
+      @apple.reload.should_not be_nil
+      begin
+        ActiveRecord::Base.transaction do
+          f = Fruit.create(:species => 'orange')
+          f.reload.should_not be_nil
+          raise 'some error'
+        end
+      rescue
+      end
+      @apple.reload.should_not be_nil
+      Fruit.find_by_species('orange').should be_nil
+    end
+  end
+
+  describe 'errors' do
+    it 'should raise ScenarioNotFoundError when scenario could not be found' do
+      lambda {
+        build :not_existing
+      }.should raise_error(Blueprints::PlanNotFoundError, "Plan(s) not found 'not_existing'")
+    end
+    
+    it 'should raise ScenarioNotFoundError when scenario parent could not be found' do
+      lambda {
+        build :parent_not_existing
+      }.should raise_error(Blueprints::PlanNotFoundError, "Plan(s) not found 'not_existing'")
+    end
+
+    it 'should raise TypeError when scenario name is not symbol or string' do
+      lambda {
+        Blueprints::Plan.new(1)
+      }.should raise_error(TypeError, "Pass plan names as strings or symbols only, cannot build plan 1")
+    end
+  end
+
+#describe "with pitted namespace" do
+#  before do
+#    Hornsby.build('pitted:peach').copy_ivars(self)
+#  end
+
+#  it "should have @peach" do
+#    @peach.species.should == 'peach'
+#  end
+#end
+end
+

data/spec/db/database.yml.example

@@ -0,0 +1,8 @@
+test:
+  adapter: mysql
+  socket: /var/run/mysqld/mysqld.sock
+  encoding: utf8
+  database: hornsby_test
+  username: root
+  password:
+  host: localhost

data/spec/db/fruit.rb

@@ -0,0 +1,2 @@
+class Fruit < ActiveRecord::Base
+end

data/spec/db/schema.rb

@@ -0,0 +1,10 @@
+ActiveRecord::Schema.define(:version => 0) do
+  create_table :fruits, :force => true do |t|
+    t.string :species
+    t.integer :average_diameter
+  end
+
+  create_table :trees, :force => true do |t|
+    t.string :name
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+require 'fileutils'
+require 'activerecord'
+begin
+  require 'mysqlplus'
+rescue LoadError
+end
+
+Dir.chdir File.join(File.dirname(__FILE__), '..')
+
+ActiveRecord::Base.logger = Logger.new("debug.log")
+
+databases = YAML::load(IO.read("spec/db/database.yml"))
+db_info = databases[ENV["DB"] || "test"]
+ActiveRecord::Base.establish_connection(db_info)
+
+require 'spec/autorun'
+require 'lib/blueprints'
+require 'spec/db/fruit'
+require 'spec/db/tree'
+
+Spec::Runner.configure do |config|
+  config.enable_blueprints :root => File.expand_path(File.join(File.dirname(__FILE__), '..')), :prebuild => :big_cherry
+end

data/test/blueprints_test.rb

@@ -0,0 +1,194 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class BlueprintsTest < ActiveSupport::TestCase
+  context "scenario files" do
+    should "be loaded from specified dirs" do
+      assert(Blueprints::PLAN_FILES == ["blueprint.rb", "blueprint/*.rb", "blueprints.rb", "blueprints/*.rb", "spec/blueprint.rb", "spec/blueprint/*.rb", "spec/blueprints.rb", "spec/blueprints/*.rb", "test/blueprint.rb", "test/blueprint/*.rb", "test/blueprints.rb", "test/blueprints/*.rb"]   )
+    end
+  end
+
+  context "with apple scenario" do
+    setup do
+      build :apple
+    end
+
+    should "create @apple" do
+      assert(!(@apple.nil?))
+    end
+
+    should "create Fruit @apple" do
+      assert(@apple.instance_of?(Fruit))
+    end
+
+    should "not create @banana" do
+      assert(@banana.nil?)
+    end
+
+    should "have correct species" do
+      assert(@apple.species == 'apple')
+    end
+  end
+
+  context "with bananas_and_apples scenario" do
+    setup do
+      build :bananas_and_apples
+    end
+
+    should "have correct @apple species" do
+      assert(@apple.species == 'apple')
+    end
+
+    should "have correct @banana species" do
+      assert(@banana.species == 'banana')
+    end
+  end
+
+  context "with fruit scenario" do
+    setup do
+      build :fruit
+    end
+
+    should "have 2 fruits" do
+      assert(@fruit.size == 2)
+    end
+
+    should "have an @apple" do
+      assert(@apple.species == 'apple')
+    end
+
+    should "have an @orange" do
+      assert(@orange.species == 'orange')
+    end
+
+    should "have no @banana" do
+      assert(@banana.nil?)
+    end
+  end
+
+  context 'with preloaded cherry scenario' do
+    should "have correct size after changed by second test" do
+      assert(@cherry.average_diameter == 3)
+      @cherry.update_attribute(:average_diameter, 1)
+      assert(@cherry.average_diameter == 1)
+    end
+
+    should "have correct size" do
+      assert(@cherry.average_diameter == 3)
+      @cherry.update_attribute(:average_diameter, 5)
+      assert(@cherry.average_diameter == 5)
+    end
+
+    should "create big cherry" do
+      assert(@big_cherry.species == 'cherry')
+    end
+  end
+
+  context 'demolish' do
+    setup do
+      build :apple
+    end
+
+    should "clear scenarios when calling demolish" do
+      demolish
+      assert(Fruit.count == 0)
+    end
+
+    should "clear only tables passed" do
+      Tree.create!(:name => 'oak')
+      demolish :fruits
+      assert(Tree.count == 1)
+      assert(Fruit.count == 0)
+    end
+
+    should "mark scenarios as undone when passed :undone option" do
+      build :fruit
+      demolish :undo => [:apple]
+      assert(Fruit.count == 0)
+      build :fruit
+      assert(Fruit.count == 1)
+    end
+
+    should "mark all scenarios as undone when passed :undone option as :all" do
+      build :fruit
+      demolish :undo => :all
+      assert(Fruit.count == 0)
+      build :fruit
+      assert(Fruit.count == 2)
+    end
+
+    should "raise error when not executed scenarios passed to :undo option" do
+      assert_raise(ArgumentError) do
+        demolish :undo => :orange
+      end
+    end
+  end
+
+  context 'with many apples scenario' do
+    setup do
+      build :many_apples, :cherry, :cherry_basket
+    end
+
+    should "create only one apple" do
+      assert(Fruit.all(:conditions => 'species = "apple"').size == 1)
+    end
+
+    should "create only two cherries even if they were preloaded" do
+      assert(Fruit.all(:conditions => 'species = "cherry"').size == 2)
+    end
+
+    should "contain cherries in basket if basket is loaded in test and cherries preloaded" do
+      assert(@cherry_basket == [@cherry, @big_cherry])
+    end
+  end
+
+  context 'transactions' do
+    setup do
+      build :apple
+    end
+
+    should "drop only inner transaction" do
+      assert(!(@apple.reload.nil?))
+      begin
+        ActiveRecord::Base.transaction do
+          f = Fruit.create(:species => 'orange')
+          assert(!(f.reload.nil?))
+          raise 'some error'
+        end
+      rescue
+      end
+      assert(!(@apple.reload.nil?))
+      assert(Fruit.find_by_species('orange').nil?)
+    end
+  end
+
+  context 'errors' do
+    should 'raise ScenarioNotFoundError when scenario could not be found' do
+      assert_raise(Blueprints::PlanNotFoundError, "Plan(s) not found 'not_existing'") do
+        build :not_existing
+      end
+    end
+    
+    should 'raise ScenarioNotFoundError when scenario parent could not be found' do
+      assert_raise(Blueprints::PlanNotFoundError, "Plan(s) not found 'not_existing'") do
+        build :parent_not_existing
+      end
+    end
+
+    should 'raise TypeError when scenario name is not symbol or string' do
+      assert_raise(TypeError, "Pass plan names as strings or symbols only, cannot build plan 1") do
+        Blueprints::Plan.new(1)
+      end
+    end
+  end
+
+#describe "with pitted namespace" do
+#  before do
+#    Hornsby.build('pitted:peach').copy_ivars(self)
+#  end
+
+#  it "should have @peach" do
+#    @peach.species.should == 'peach'
+#  end
+#end
+end
+

data/test/test_helper.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'activerecord'
+require 'test/unit'
+require 'active_record/test_case'
+require 'shoulda'
+begin
+  require 'mysqlplus'
+rescue LoadError
+end
+
+Dir.chdir(File.join(File.dirname(__FILE__), '..'))
+
+ActiveRecord::Base.logger = Logger.new("debug.log")
+
+databases = YAML::load(IO.read("spec/db/database.yml"))
+db_info = databases[ENV["DB"] || "test"]
+ActiveRecord::Base.establish_connection(db_info)
+
+require 'lib/blueprints'
+require 'spec/db/fruit'
+require 'spec/db/tree'
+
+class ActiveSupport::TestCase
+  enable_blueprints :root => File.join(File.dirname(__FILE__), '..'), :prebuild => :big_cherry
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: blueprints
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Andrius Chamentauskas
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-27 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.0
+    version: 
+description: 
+email: sinsiliux@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/blueprints.rb
+- lib/blueprints/errors.rb
+- lib/blueprints/file_context.rb
+- lib/blueprints/helper.rb
+- lib/blueprints/plan.rb
+- lib/blueprints/rspec_extensions.rb
+- lib/blueprints/test_unit_extensions.rb
+- lib/tasks/blueprints_tasks.rake
+- README.rdoc
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/sinsiliux/blueprints
+licenses: []
+
+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.3.5
+signing_key: 
+specification_version: 3
+summary: Another replacement for factories and fixtures
+test_files: 
+- spec/spec_helper.rb
+- spec/blueprints_spec.rb
+- spec/blueprints.rb
+- spec/db/fruit.rb
+- spec/db/database.yml.example
+- spec/db/schema.rb
+- test/test_helper.rb
+- test/blueprints_test.rb