@@ -1,3 +1,7 @@ += Version 0.2.0 (2009-05-20) + +Added clean_up options + = Version 0.1.4 (2009-03-25) Added a_number to allow the generation of unique integers CHANGELOG @@ -32,6 +32,22 @@ If you want to generate a unique value yourself, you can use Object::Factory's n :generate => { :field => "unique-value-#{a_number}" } +== Cleaning up + +(currently only for ActiveRecord) + +If you register your (ActiveRecord) class with the clean_up option, then the factory can ensure that all instances are deleted. This is useful if you cannot use transactional_fixtures (for example using Watir or Culerity in your test suite). + +Add a clean_up parameter when registering your classes: + + when_creating_a Person, :auto_generate => [:first_name, :last_name], :clean_up => true + +Then in your "after" section call: + + Object.factory.clean_up + +This will call delete_all on any registered classes (hence it is currently ActiveRecord only). + == Rails To use this with rails, stick the following in your +environment.rb+: README.rdoc @@ -2,7 +2,7 @@ require 'rubygems' require 'rake' require 'echoe' -Echoe.new('object-factory', '0.1.4') do | config | +Echoe.new('object-factory', '0.2.0') do | config | config.description = 'A simple object factory to help you build valid objects in your tests' config.url = 'http://github.com/brightbox/object-factory' config.author = 'Brightbox Systems Ltd' Rakefile @@ -25,6 +25,14 @@ class Object def reset @confirmed_fields = {} @generators = {} + @classes_for_clean_up = [] + end + + # clean up all instances + def clean_up + @classes_for_clean_up.each do | klass | + klass.delete_all + end end # Create a new instance of the given class with the given parameters and apply the auto-generated fields, according to the configured rules @@ -59,6 +67,7 @@ class Object need_to_generate_ip_addresses_for klass, options[:generate_ip_address] unless options[:generate_ip_address].nil? need_to_set_values_for klass, options[:set] unless options[:set].nil? need_to_set_generators_for klass, options[:generate] unless options[:generate].nil? + register_for_clean_up klass if options[:clean_up] end alias :when_creating_an :when_creating_a @@ -102,7 +111,7 @@ class Object end end - private + private def symbol_for object klass = object.is_a?(Class) ? object : object.class @@ -175,6 +184,10 @@ class Object instance.send("#{field_name.to_sym}=".to_sym, value) unless parameters.has_key?(field_name.to_sym) end end + + def register_for_clean_up klass + @classes_for_clean_up << klass + end end end lib/object_factory.rb @@ -2,11 +2,11 @@ Gem::Specification.new do |s| s.name = %q{object-factory} - s.version = "0.1.4" + s.version = "0.2.0" s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version= s.authors = ["Brightbox Systems Ltd"] - s.date = %q{2008-12-08} + s.date = %q{2009-05-20} s.description = %q{A simple object factory to help you build valid objects in your tests} s.email = %q{hello@brightbox.co.uk} s.extra_rdoc_files = ["CHANGELOG", "lib/object_factory.rb", "README.rdoc", "tasks/rspec.rake"] object-factory.gemspec @@ -318,4 +318,20 @@ describe Object::Factory, "generating sequential numbers" do Object.factory.should_receive(:next_number).and_return(1) number = a_number end +end + +describe Object::Factory, "cleaning up ActiveRecord models" do + before :each do + Object.factory.reset + end + + it "should delete all instances for registered classes" do + Object.factory.when_creating_a TestClass, :auto_confirm => :password, :clean_up => true + Object.factory.when_creating_an AnotherTestClass, :clean_up => true + + TestClass.should_receive(:delete_all).and_return(0) + AnotherTestClass.should_receive(:delete_all).and_return(0) + + Object.factory.clean_up + end end \ No newline at end of file spec/object_spec.rb a6e9e1d18c98a491e7e2e86f7078053ff0940152 Rahoul Baruah rahoul@brightbox.co.uk http://github.com/brightbox/object-factory/commit/b5dad1e6be0bf18b399661fd0a9b86c8e5f12434 b5dad1e6be0bf18b399661fd0a9b86c8e5f12434 2009-05-20T14:00:53-07:00 2009-05-20T14:00:53-07:00 added the clean up option e06ca642f1c3d8f5a6b2109def7173edff4d3726 Rahoul Baruah rahoul@brightbox.co.uk