.gitignore @@ -179,6 +179,28 @@ Call @Fixjour.verify!@ to ensure the following things: # @new_*@ methods are returning new records. # @new_*@ and @create_*@ methods return instances of the correct class. +h3. Recommended usage with RSpec and Cucumber + +If you want to use Fixjour with RSpec and Cucumber you probably want to avoid adding the builder methods onto Object directly. To do this you should first create a file where your Fixjour builder definitions can live. Say for example you put it at spec/fixjour_builders.rb. To take advantage of these builders from RSpec use the following code in your spec_helper.rb: + +<pre> +require File.expand_path(File.dirname(__FILE__) + "/fixjour_builders.rb") + +Spec::Runner.configure do |config| + config.include(Fixjour) # This will add the builder methods to your ExampleGroups and not pollute Object + ... +end +</pre> + +To use the same builders in Cucumber you simply need to include Fixjour into your Wolrd object from features/support/env.rb: + +<pre> +require File.expand_path(File.dirname(__FILE__) +'/../../spec/fixjour_builders.rb') +World { |world| world.extend(Fixjour) } +</pre> + +Be sure to do this after you define your World object. So, if you are using Rails you should include Fixjour after you require 'cucumber/rails/world'. + h4. TODO * There should be a @Builder@ class. @@ -192,4 +214,4 @@ I've talked to smart people who like these instead: * "fixturereplacement":http://github.com/smtlaissezfaire/fixturereplacement/tree/master * "factory girl":http://github.com/thoughtbot/factory_girl/tree -(c) Copyright 2008 Pat Nakajima, released under MIT License. \ No newline at end of file +(c) Copyright 2008 Pat Nakajima, released under MIT License. README.textile f410218c91dcc8e52d23607546fb611194203cb3 Ben Mabey ben@benmabey.com http://github.com/bmabey/fixjour/commit/ed7ea2e8b7379b213eb3b422d01441ef0fec8c2a ed7ea2e8b7379b213eb3b422d01441ef0fec8c2a 2009-02-05T09:21:55-08:00 2009-02-05T09:21:55-08:00 docs - how to use Fixjour in RSpec and Cucumber efad532070ebfcdb93c6ef31cef9375e2c54d295 Ben Mabey ben@benmabey.com