= Hornsby

A Scenario Builder without the fixture pain.

== Usage

Scenarios look like:

    scenario :apple do
      @apple = Fruit.create! :species => 'apple'
    end

    scenario :orange do
      @orange = Fruit.create! :species => 'orange'
    end

    scenario :fruitbowl => [:apple,:orange] do
      @fruitbowl = FruitBowl.create! :fruit => [@apple,@orange]
    end

    scenario :kitchen => :fruitbowl do
      @kitchen = Kitchen.create! :fruitbowl => @fruitbowl
    end

...and you use them in specs like:

    describe Fruit, "@apple" do
      before do
        hornsby_scenario :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
        hornsby_scenario :fruitbowl
      end

      it "should have 2 fruits" do
        @fruitbowl.should have(2).fruit
      end
    end

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.

== 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-hornsby', :lib => 'hornsby', :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-hornsby

Lastly you could use it as plugin:

    ruby script/plugin install git://github.com/sinsiliux/hornsby.git

Add the following to spec_helper.rb

    Spec::Runner.configure do |config|
      ...
  
      Hornsby.configure_rspec(config, :filename => 'scenarios.rb', :scenarios => :preloaded_scenario)
    end

configure_rspec supports two parameters:
* filename - file with hornsby scenarios (by default Rails.root/spec/hornsby_scenarios.rb)
* scenarios - list of hornsby scenarios that should be preloaded (available in all tests, never reloaded so they're much faster)

== Advanced Usage

Its just ruby, right? So go nuts:

    1.upto(9) do |i|
      scenario("user_#{i}") do
        user = User.create! :name => "user#{i}"
        instance_variable_set("@user_#{i}",user)
      end
    end

== Transactions

Hornsby scenarios 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 configure_rspec.

== Rake

If you'd like simply to load your scenarios into a database, use the rake task like so:

    $ rake hornsby:scenario RAILS_ENV=test SCENARIO=fruitbowl

== TODO

* Add scenario namespaces for better organisation.

== Credits

Lachie Cox <lachie@smartbomb.com.au>

Andrius Chamentauskas <sinsiliux@gmail.com>

The code is based on Err's code found in this post: http://errtheblog.com/post/7708

== License

MIT, see LICENCE