dan-manges-unit_record 0.4.1 → 0.9.0

data/CHANGELOG

@@ -1,7 +1,16 @@
 *HEAD
 
-* Added UnitRecord::AssociationStubbing module to stub associations. Is not included by default.
-* Give exception message if trying to use fixtures instead of failing silently.
+* Add association stubbing with mocha
+
+  ActiveRecord::Base.disconnect! :stub_associations => true
+
+* Add option to no-op instead of raise.
+
+  ActiveRecord::Base.disconnect! :strategy => :noop
+  or
+  ActiveRecord::Base.disconnect! :strategy => :raise
+  
+* Implemented as a connection adapter
 
 *0.4.1* (December 10th, 2007)
 

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007-2008 Dan Manges
+
+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,137 @@
+UnitRecord
+==========
+
+Enables unit testing ActiveRecord classes without hitting the database.
+
+Why?
+----
+
+Rationale: [http://www.dcmanges.com/blog/rails-unit-record-test-without-the-database](http://www.dcmanges.com/blog/rails-unit-record-test-without-the-database)
+
+One of the biggest benefits to disconnecting unit tests from the database is having a faster test suite.  Here is the benchmark from one of my current projects:
+
+    Finished in 19.302702 seconds.
+    4920 tests, 7878 assertions, 0 failures, 0 errors
+  
+4 seconds per 1,000 tests is a good guideline.
+
+Installation
+------------
+
+    gem install unit_record
+
+Usage
+-----
+
+Restructuring the Rails Test Directory
+--------------------------------------
+
+The Rails test directory typically places testing for models under <tt>test/unit</tt> and tests for controllers under <tt>test/functional</tt>.  However, we need to change the definition of unit and functional.  Controllers can be unit tested (mocking out models and not rendering the view).  Models can be functionally tested (hitting the database).  Also, each type of test needs its own test\_helper.  I recommend restructuring your test directory like this:
+
+    test
+      test_helper.rb
+      unit
+        unit_test_helper.rb
+        controllers
+        models
+      functional
+        functional_test_helper.rb
+        controllers
+        models
+
+You should move existing functional tests into functional/controllers.  You will also need to change the require line at the top of those tests to require the functional\_test\_helper.rb file instead of the test\_helper.rb file.
+
+The <tt>functional_test_helper.rb</tt> file only needs to require <tt>test_helper.rb</tt>:
+
+    require File.dirname(__FILE__) + "/../test_helper"
+
+For moving unit tests, you have a few options.  I recommend moving them to unit/models and then disconnecting your unit tests from the database.  Any tests that fail should then be modified to not hit the database or moved to functional/models.
+
+Usage
+-----
+
+In the <tt>test/unit/unit\_test\_helper.rb</tt> file you created when restructuring your test directory, you should add these lines:
+
+    require File.dirname(__FILE__) + "/../test_helper"
+    require "unit_record"
+    ActiveRecord::Base.disconnect!
+  
+The <tt>disconnect!</tt> method will do everything necessary to run your unit tests without hitting the database.
+
+Strategy
+--------
+
+There are two options for what should happen if you hit the database. You can either have UnitRecord raise an exception, or simply no-op. Raising an exception can help identify why a test is failing, but it also may be inconvenient to work around.
+
+If you want to raise an exception:
+
+    ActiveRecord::Base.disconnect! :strategy => :raise
+    
+    Person.find(:all)
+    #=> RuntimeError: ActiveRecord is disconnected; database access is unavailable in unit tests.
+
+If you want to no-op:
+
+    ActiveRecord::Base.disconnect! :strategy => :noop
+    
+    Person.find(:all)
+    #=> []
+    
+You can also change strategies within a block:
+
+    ActiveRecord::Base.connection.change_strategy(:raise) do
+      Person.find(:all)
+      #=> RuntimeError: ActiveRecord is disconnected; database access is unavailable in unit tests.
+    end
+
+    ActiveRecord::Base.connection.change_strategy(:noop) do
+      Person.find(:all)
+      #=> []
+    end
+    
+Association Stubbing
+--------------------
+
+One painful aspect of unit testing ActiveRecord classes is setting associations. Because Rails does type checking when setting an association, you'll receive an exception if you try to use a stub in place of the expected class.
+
+    Pet.new :owner => stub("person")
+    #=> ActiveRecord::AssociationTypeMismatch: Person(#16620740) expected, got Mocha::Mock(#11567340)
+    
+If you're using mocha, you can have UnitRecord stub associations. To enable association stubbing:
+
+    ActiveRecord::Base.disconnect! :stub_associations => true
+
+The above example would no longer raise an exception. It would be the equivalent of:
+
+    pet = Pet.new
+    pet.stubs(:owner).returns(stub("person"))
+    
+Note that using this approach, the setter for the association will not work for that instance.
+
+Development
+-----------
+
+Active development occurs on the [GitHub](http://github.com/dan-manges/unit-record). Changes are also pushed to the Rubyforge git repository.
+
+For bugs/patches/etc please use the [Rubyforge tracker](http://rubyforge.org/tracker/?group_id=4239).
+
+Continuous integration is provided by [RunCodeRun](http://runcoderun.com/dan-manges/unit-record).
+
+Thanks
+------
+Thanks to Jay Fields for the [original implementation](http://blog.jayfields.com/2007/03/rails-activerecord-unit-testing-part-ii.html).
+
+Maintainer
+----------
+
+[Dan Manges](http://www.dcmanges.com)
+
+Contributors
+------------
+
+* David Lowenfels
+* Rob Sanheim
+
+License
+-------
+Released under the MIT license

data/Rakefile

@@ -1,62 +1,51 @@
 require 'rake'
 require 'rake/testtask'
-require 'rake/rdoctask'
-require 'rake/gempackagetask'
-require 'rake/contrib/sshpublisher'
 
 desc "Default: run tests"
-task :default => :test
+task :default => %w[test:multi_verbose spec]
 
 Rake::TestTask.new("test") do |t|
-  t.libs << 'lib'
-  t.pattern = 'test/**/*_test.rb'
+  t.pattern = "test/**/*_test.rb"
   t.verbose = true
 end
 
-desc "Generate documentation"
-Rake::RDocTask.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = "doc"
-  rdoc.title    = "UnitRecord"
-  rdoc.options << '--line-numbers'
-  rdoc.rdoc_files.include('README.rdoc', 'CHANGELOG')
-end
-
-desc "Upload RDoc to RubyForge"
-task :publish_rdoc => [:rdoc] do
-  Rake::SshDirPublisher.new("dcmanges@rubyforge.org", "/var/www/gforge-projects/unit-test-ar", "doc").upload
+begin
+  require "rcov/rcovtask"
+  desc "run tests with rcov"
+  Rcov::RcovTask.new do |t|
+    t.pattern = "test/**/*_test.rb"
+    t.rcov_opts << ["--no-html", "--exclude 'Library,#{Gem.path.join(',')}'"]
+    t.verbose = true
+  end
+rescue LoadError
 end
 
-Gem.manage_gems
 require "date"
 
 gem_spec = Gem::Specification.new do |s|
 	s.name   = "unit_record"
   s.summary = "UnitRecord enables unit testing without hitting the database."
-	s.version = "0.4.1"
+	s.version = "0.9.0"
 	s.author = "Dan Manges"
 	s.description = "UnitRecord enables unit testing without hitting the database."
 	s.email = "daniel.manges@gmail.com"
   s.homepage = "http://unit-test-ar.rubyforge.org"
   s.rubyforge_project = "unit-test-ar"
-
-  s.has_rdoc = true
-  s.extra_rdoc_files = ['README.rdoc', 'CHANGELOG']
-  s.rdoc_options << '--title' << "UnitRecord" << '--main' << 'README.rdoc' << '--line-numbers'
+  
+  s.has_rdoc = false
 
   s.autorequire = "unit_record"
-  s.files = FileList['{lib,test}/**/*.rb', 'CHANGELOG', 'README.rdoc', 'Rakefile'].to_a
+  s.files = FileList['{lib,test,vendor}/**/*.rb', 'CHANGELOG', 'LICENSE', 'README.markdown', 'Rakefile'].to_a
 end
 
-Rake::GemPackageTask.new(gem_spec) do |package|
-  package.need_zip = false
-  package.need_tar = false
+task :gem => %w[test:multi] do
+  Gem::Builder.new(gem_spec).build
 end
-Rake::Task["gem"].prerequisites.unshift "test:multi"
 
 namespace :gemspec do
-  desc "generates unit_record.gemspec"
+  desc "generates unit-record.gemspec"
   task :generate do
-    File.open("unit_record.gemspec", "w") do |f|
+    File.open("unit-record.gemspec", "w") do |f|
       f.puts "# this file is generated by rake gemspec:generate for github"
       f.write gem_spec.to_ruby
     end
@@ -70,16 +59,36 @@ task :readme do
   sh "open #{file}"
 end
 
-RAILS_VERSIONS = %w[1.2.6 2.0.2 2.1.0 2.1.1]
+RAILS_VERSIONS = %w[1.2.6 2.0.2 2.1.0 2.1.1 2.2.2]
 
 namespace :test do
   desc "test with multiple versions of rails"
   task :multi do
     RAILS_VERSIONS.each do |rails_version|
+      puts "Testing with Rails #{rails_version}"
       sh "RAILS_VERSION='#{rails_version}' rake test > /dev/null 2>&1"
     end
-  end      
+  end
+  
+  task :multi_verbose do
+    (RAILS_VERSIONS - %w[2.2.2]).each do |rails_version|
+      task = defined?(Rcov) ? "rcov" : "test"
+      sh "RAILS_VERSION='#{rails_version}' rake #{task}"
+    end
+  end
+end
+
+begin
+  gem "rspec"
+  require "spec/rake/spectask"
+  Spec::Rake::SpecTask.new(:spec) do |t|
+    t.spec_files = %w[test/sample_spec.rb]
+  end
+rescue LoadError
+  task :spec do
+    puts "== RSpec failed to load"
+  end
 end
 
 desc "pre-commit task"
-task :pc => %w[test:multi gemspec:generate]
+task :pc => %w[test:multi spec gemspec:generate]

data/lib/active_record/connection_adapters/unit_record_adapter.rb

@@ -56,6 +56,10 @@ class ActiveRecord::ConnectionAdapters::UnitRecordAdapter < ::ActiveRecord::Conn
   def execute(sql, name = nil)
     raise_or_noop
   end
+  
+  def insert(sql, name = nil, pk = nil, id_value = nil, sequence_name = nil)
+    raise_or_noop
+  end if Rails::VERSION::MAJOR == 1
 
   def select_rows(sql, name = nil)
     raise_or_noop []

data/lib/unit_record/association_stubbing.rb

@@ -15,7 +15,9 @@ module UnitRecord
     def extract_associations(attributes = {})
       attributes.inject({}) do |associations,(attr,value)|
         next associations unless self.class.reflections.keys.include? attr
-        associations[attr] = attributes.delete attr
+        unless value.is_a?(self.class.reflections[attr].klass)
+          associations[attr] = attributes.delete attr
+        end
         associations
       end
     end

data/lib/unit_record/disconnected_active_record.rb

@@ -1,19 +1,18 @@
 module UnitRecord
   module DisconnectedActiveRecord
     def disconnected?
-      false
+      connected? && connection.is_a?(ActiveRecord::ConnectionAdapters::UnitRecordAdapter)
     end
 
     def disconnect!(options = {})
       return if disconnected?
       establish_connection options.merge(:adapter => "unit_record")
-      (class << self; self; end).class_eval do
-        def disconnected?
-          true
-        end
+      if options[:stub_associations]
+        ActiveRecord::Base.send :include, UnitRecord::AssociationStubbing
       end
       Fixtures.disconnect!
       Test::Unit::TestCase.disconnect!
+      ActiveRecord::Migration.verbose = false
       ActiveRecord::Base.connection.change_strategy(:noop) do
         load(RAILS_ROOT + "/db/schema.rb")
       end

data/test/active_record/connection_adapters/unit_record_adapter_test.rb

@@ -2,6 +2,12 @@ require File.dirname(__FILE__) + "/../../test_helper"
 
 functional_tests do
 
+  test "reconnect works" do
+    ActiveRecord::Base.connection.reconnect!
+    assert_kind_of ActiveRecord::ConnectionAdapters::UnitRecordAdapter,
+      ActiveRecord::Base.connection
+  end
+
   test "find(:all)" do
     ActiveRecord::Base.connection.change_strategy(:raise) do
       assert_raises(RuntimeError) { Person.find(:all) }
@@ -52,6 +58,12 @@ functional_tests do
       ActiveRecord::Base.connection.rename_column "people", "first_name", "name_first"
     end
   end
+
+  test "insert raises an exception" do
+    assert_raises_disconnected_exception do
+      ActiveRecord::Base.connection.rename_column "people", "first_name", "name_first"
+    end
+  end
   
   test "initialize can set strategy" do
     ActiveRecord::Base.establish_connection :adapter => "unit_record", :strategy => :noop
@@ -63,6 +75,7 @@ functional_tests do
   test "noop" do
     ActiveRecord::Base.connection.change_strategy(:noop) do
       assert_nil ActiveRecord::Base.connection.execute("SELECT 1")
+      assert_nil ActiveRecord::Base.connection.insert("INSERT INTO ...")
       assert_equal [], ActiveRecord::Base.connection.select_rows("SELECT * FROM people")
       assert_equal [], ActiveRecord::Base.connection.send(:select, "SELECT * FROM people")
       assert_nil ActiveRecord::Base.connection.rename_table("people", "persons")

data/test/sample_spec.rb

@@ -0,0 +1,40 @@
+require "rubygems"
+gem "rspec", "1.1.11"
+require "test/unit"
+require "spec"
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+RAILS_ROOT = File.dirname(__FILE__)
+
+if rails_version = ENV['RAILS_VERSION']
+  gem "rails", rails_version
+end
+require "rails/version"
+puts "==== Testing with Rails #{Rails::VERSION::STRING} ===="
+require 'active_record'
+require 'active_record/fixtures'
+require "action_controller"
+require "action_controller/test_process"
+
+require "unit_record"
+
+# Needed because of this line in setup_with_fixtures and teardown_with_fixtures:
+#   return unless defined?(ActiveRecord::Base) && !ActiveRecord::Base.configurations.blank?
+ActiveRecord::Base.configurations = {"irrelevant" => {:adapter => "stub"}}
+
+ActiveRecord::Base.disconnect! :strategy => :raise, :stub_associations => true
+
+describe UnitRecord do
+  it "disconnects tests from the database" do
+    lambda do
+      ActiveRecord::Base.connection.select_value("SELECT 1")
+    end.should raise_error
+  end
+
+  it "can change strategy to noop" do
+    ActiveRecord::Base.connection.change_strategy(:noop) do
+      ActiveRecord::Base.connection.select_value("SELECT 1").should == nil
+    end
+  end
+end

data/test/test_helper.rb

@@ -20,14 +20,17 @@ end
 require "action_controller/test_process"
 
 begin
+  gem "mocha"
   require 'mocha'
-  require 'dust'
-rescue LoadError
-  raise "Need Mocha and Dust gems to Test"
+rescue LoadError, Gem::LoadError
+  raise "need mocha to test"
 end
+$LOAD_PATH << File.dirname(__FILE__) + "/../vendor/dust-0.1.6/lib"
+require 'dust'
 Test::Unit::TestCase.disallow_setup!
 
-require "#{File.dirname(__FILE__)}/../init"
+$LOAD_PATH << File.dirname(__FILE__) + "/../lib"
+require "unit_record"
 
 Test::Unit::TestCase.use_transactional_fixtures = true
 
@@ -35,8 +38,6 @@ Test::Unit::TestCase.use_transactional_fixtures = true
 #   return unless defined?(ActiveRecord::Base) && !ActiveRecord::Base.configurations.blank?
 ActiveRecord::Base.configurations = {"irrelevant" => {:adapter => "stub"}}
 
-ActiveRecord::Base.send :include, UnitRecord::AssociationStubbing
-
 class Preference < ActiveRecord::Base
 end
 
@@ -61,7 +62,7 @@ class DoesNotExist < ActiveRecord::Base
   set_table_name "table_does_not_exist"
 end
 
-ActiveRecord::Base.disconnect! :strategy => :raise
+ActiveRecord::Base.disconnect! :strategy => :raise, :stub_associations => true
 # make sure calling disconnect multiple times does not cause problems
-ActiveRecord::Base.disconnect!
+ActiveRecord::Base.disconnect! :strategy => :raise, :stub_associations => true
 end

data/test/unit_record/association_stubbing_test.rb

@@ -14,6 +14,21 @@ functional_tests do
     assert_equal person, pet.person
   end
   
+  test "using correct classes does not stub" do
+    person = Person.new(:first_name => "Dan")
+    pet = Pet.new :person => person
+    pet.person = Person.new(:first_name => "Tom")
+    assert_equal "Tom", pet.person.first_name
+  end
+
+  test "using other than correct classes does stub" do
+    person = Object.new
+    def person.first_name; "Dan"; end
+    pet = Pet.new :person => person
+    pet.person = Person.new(:first_name => "Tom")
+    assert_equal "Dan", pet.person.first_name
+  end
+  
   test "multiple includes doesn't hurt" do
     ActiveRecord::Base.send :include, UnitRecord::AssociationStubbing
     Person.new

data/test/unit_record/disconnected_active_record_test.rb

@@ -45,4 +45,8 @@ functional_tests do
     assert_equal true, pref.show_help
     assert_equal true, pref.show_help?
   end
+  
+  test "migrations are not verbose" do
+    assert_equal false, ActiveRecord::Migration.verbose
+  end
 end

data/vendor/dust-0.1.6/lib/array_extension.rb

@@ -0,0 +1,5 @@
+class Array  #:nodoc:
+  def arrayize
+    self
+  end
+end

data/vendor/dust-0.1.6/lib/definition_error.rb

@@ -0,0 +1,20 @@
+module Dust #:nodoc:
+  # Dust::DefinitionError is raised when you attempt to define a disallowed method within a test file.
+  # 
+  #    Test::Unit::TestCase.disallow_setup!
+  # 
+  #    unit_tests do
+  #      def setup
+  #        ...
+  #      end
+  #        
+  #      test "name" do
+  #        ...
+  #      end
+  #    end
+  # 
+  # The above code will generate the following error
+  #    Dust::DefinitionError: setup is not allowed on class Units::[TestClassName]
+  class DefinitionError < StandardError
+  end
+end

data/vendor/dust-0.1.6/lib/dust.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+require File.expand_path(File.dirname(__FILE__) + '/object_extension')
+require File.expand_path(File.dirname(__FILE__) + '/array_extension')
+require File.expand_path(File.dirname(__FILE__) + '/nil_extension')
+require File.expand_path(File.dirname(__FILE__) + '/string_extension')
+require File.expand_path(File.dirname(__FILE__) + '/symbol_extension')
+require File.expand_path(File.dirname(__FILE__) + '/test_case_extension')
+require File.expand_path(File.dirname(__FILE__) + '/definition_error')

data/vendor/dust-0.1.6/lib/nil_extension.rb

@@ -0,0 +1,5 @@
+class NilClass #:nodoc:
+  def arrayize
+    []
+  end
+end

data/vendor/dust-0.1.6/lib/object_extension.rb

@@ -0,0 +1,62 @@
+class Object
+  # call-seq: unit_tests(options={}, &block)
+  # 
+  # Used to define a block of unit tests.
+  # 
+  #    unit_tests do
+  #      test "verify something" do                                   
+  #        ...
+  #      end                                                     
+  #    end                 
+  # 
+  # Configuration Options:
+  #   * allow - Allows you to specify the methods that are allowed despite being disallowed.  
+  #     See Test::Unit::TestCase.disallow_helpers! or Test::Unit::TestCase.disallow_setup! for more info
+  def unit_tests(options={}, &block)
+    do_tests("Units", options, &block)
+  end
+
+  # call-seq: functional_tests(options={}, &block)
+  # 
+  # Used to define a block of functional tests.
+  # 
+  #    functional_tests do
+  #      test "verify something" do                                   
+  #        ...
+  #      end                                                     
+  #    end                                                       
+  # 
+  # Configuration Options:
+  #   * allow - Allows you to specify the methods that are allowed despite being disallowed.  
+  #     See Test::Unit::TestCase.disallow_helpers! or Test::Unit::TestCase.disallow_setup! for more info
+  def functional_tests(options={}, &block)
+    do_tests("Functionals", options, &block)
+  end
+  
+  protected
+  def do_tests(type, options, &block) #:nodoc:
+    options[:allow] = options[:allow].arrayize
+    full_path_file_name = eval "__FILE__", block.binding
+    test_name = File.basename(full_path_file_name, ".rb")
+    test_class = eval "module #{type}; class #{test_name.to_class_name} < Test::Unit::TestCase; self; end; end"
+    test_class.class_eval &block
+    check_for_setup(test_class, options)
+    check_for_helpers(test_class, options)
+  end
+  
+  def check_for_setup(test_class, options) #:nodoc:
+    if test_class.instance_methods(false).include?("setup") && Test::Unit::TestCase.disallow_setup? && 
+       !options[:allow].include?(:setup)
+      raise Dust::DefinitionError.new("setup is not allowed on class #{test_class.name}")
+    end
+  end
+  
+  def check_for_helpers(test_class, options) #:nodoc:
+    test_class.instance_methods(false).each do |method_name|
+      if method_name !~ /^test_/ && Test::Unit::TestCase.disallow_helpers? && !options[:allow].include?(method_name.to_sym)
+        p method_name.to_sym
+        raise Dust::DefinitionError.new("helper methods are not allowed on class #{test_class.name}")
+      end
+    end
+  end
+end

data/vendor/dust-0.1.6/lib/string_extension.rb

@@ -0,0 +1,5 @@
+class String #:nodoc:
+  def to_class_name
+    gsub(/(^|_)(.)/) { $2.upcase }  
+  end
+end

data/vendor/dust-0.1.6/lib/symbol_extension.rb

@@ -0,0 +1,5 @@
+class Symbol #:nodoc:
+  def arrayize
+    [self]
+  end
+end

data/vendor/dust-0.1.6/lib/test_case_extension.rb

@@ -0,0 +1,76 @@
+module Test #:nodoc:
+  module Unit #:nodoc:
+    class TestCase
+      # call-seq: disallow_setup!
+      # 
+      # Used to disallow setup methods in test specifications.
+      # 
+      #    Test::Unit::TestCase.disallow_setup!
+      #
+      # A test specification can override this behavior by passing :setup in the :allow options.
+      # 
+      #    unit_tests :allow => :setup do
+      #      def setup
+      #        ...
+      #      end        
+      #                                              
+      #      test "verify something" do                                   
+      #        ...
+      #      end                                                     
+      #    end
+      def self.disallow_setup!
+        @disallow_setup = true
+      end
+  
+      def self.disallow_setup? #:nodoc:
+        @disallow_setup
+      end
+  
+      # call-seq: disallow_helpers!
+      # 
+      # Used to disallow helper methods in test specifications.
+      # 
+      #    Test::Unit::TestCase.disallow_helper!
+      # 
+      # A test specification can override this behavior by passing the helper name (as a symbol) in the :allow options.
+      # 
+      #    unit_tests :allow => [:create_something, :destroy_something] do
+      #      test "verify something" do                                   
+      #        ...
+      #      end                   
+      #                                   
+      #      def create_something
+      #        ...
+      #      end                          
+      #                            
+      #      def destroy_something
+      #        ...
+      #      end                                                     
+      #    end
+      def self.disallow_helpers!
+        @disallow_helpers = true
+      end
+  
+      def self.disallow_helpers? #:nodoc:
+        @disallow_helpers
+      end
+
+      # call-seq: test(name, &block)
+      # 
+      # Used to define a test and assign it a descriptive name.
+      # 
+      #    unit_tests do
+      #      test "verify something" do                                   
+      #        ...
+      #      end                                                     
+      #    end                                                       
+      def self.test(name, &block)
+        test_name = "test_#{name.gsub(/[\s]/,'_')}".to_sym
+        raise "#{test_name} is already defined in #{self}" if self.instance_methods.include? test_name.to_s
+        define_method test_name do
+          instance_eval &block
+        end
+      end
+    end
+  end
+end

data/vendor/dust-0.1.6/rakefile.rb

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/contrib/sshpublisher'
+
+task :default => :test
+
+task :test do
+  require File.dirname(__FILE__) + '/test/all_tests.rb'
+end
+
+desc 'Generate RDoc'
+Rake::RDocTask.new do |task|
+  task.main = 'README'
+  task.title = 'Dust'
+  task.rdoc_dir = 'doc'
+  task.options << "--line-numbers" << "--inline-source"
+  task.rdoc_files.include('README', 'lib/**/*.rb')
+end
+
+desc "Upload RDoc to RubyForge"
+task :publish_rdoc => [:rdoc] do
+  Rake::SshDirPublisher.new("jaycfields@rubyforge.org", "/var/www/gforge-projects/dust", "doc").upload
+end
+
+Gem::manage_gems
+
+specification = Gem::Specification.new do |s|
+	s.name   = "dust"
+  s.summary = "Dust is an add on for Test::Unit that allows an alternative test definintion syntax."
+	s.version = "0.1.6"
+	s.author = 'Jay Fields'
+	s.description = "Dust is an add on for Test::Unit that allows an alternative test definintion syntax."
+	s.email = 'dust-developer@rubyforge.org'
+  s.homepage = 'http://dust.rubyforge.org'
+  s.rubyforge_project = 'dust'
+
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README']
+  s.rdoc_options << '--title' << 'Dust' << '--main' << 'README' << '--line-numbers'
+
+  s.autorequire = 'dust'
+  s.files = FileList['{lib,test}/**/*.rb', '[A-Z]*$', 'rakefile.rb'].to_a
+	s.test_file = "test/all_tests.rb"
+end
+
+Rake::GemPackageTask.new(specification) do |package|
+  package.need_zip = false
+  package.need_tar = false
+end

data/vendor/dust-0.1.6/test/all_tests.rb

@@ -0,0 +1 @@
+Dir['**/*_test.rb'].each { |test_case| require test_case }

data/vendor/dust-0.1.6/test/failing_with_helper_unit_test.rb

@@ -0,0 +1,16 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+begin
+  unit_tests do
+    Test::Unit::TestCase.disallow_helpers!
+    def helper_method
+    end
+    
+    test("true"){}
+  end
+  raise "shouldn't be here"
+rescue Dust::DefinitionError => ex
+  raise unless ex.message == "helper methods are not allowed on class Units::FailingWithHelperUnitTest"
+ensure
+  Test::Unit::TestCase.class_eval {  @disallow_helpers = nil }
+end

data/vendor/dust-0.1.6/test/failing_with_setup_unit_test.rb

@@ -0,0 +1,16 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+begin
+  unit_tests do
+    Test::Unit::TestCase.disallow_setup!
+    def setup
+    end
+    
+    test("true"){}
+  end
+  raise "shouldn't be here"
+rescue Dust::DefinitionError => ex
+  raise unless ex.message == "setup is not allowed on class Units::FailingWithSetupUnitTest"
+ensure
+  Test::Unit::TestCase.class_eval {  @disallow_setup = nil }
+end

data/vendor/dust-0.1.6/test/functional_test.rb

@@ -0,0 +1,12 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+functional_tests do
+  test "assert true" do
+    assert_equal true, true
+  end
+  
+  test "class name is Functionals::FunctionalTest" do
+    assert_equal "Functionals::FunctionalTest", self.class.name
+  end
+
+end

data/vendor/dust-0.1.6/test/passing_unit_test.rb

@@ -0,0 +1,11 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+unit_tests do
+  test "assert true" do
+    assert_equal true, true
+  end
+  
+  test "class name is Units::PassingUnitTest" do
+    assert_equal "Units::PassingUnitTest", self.class.name
+  end
+end

data/vendor/dust-0.1.6/test/passing_with_helper_unit_test.rb

@@ -0,0 +1,10 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+Test::Unit::TestCase.disallow_helpers!
+unit_tests :allow => :helper do
+  def helper
+  end
+  
+  test("true"){}
+end
+Test::Unit::TestCase.class_eval {  @disallow_helpers = nil }

data/vendor/dust-0.1.6/test/passing_with_helpers_unit_test.rb

@@ -0,0 +1,13 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+Test::Unit::TestCase.disallow_helpers!
+unit_tests :allow => [:helper, :helper2] do
+  def helper
+  end
+
+  def helper2
+  end
+  
+  test("true"){}
+end
+Test::Unit::TestCase.class_eval {  @disallow_helpers = nil }

data/vendor/dust-0.1.6/test/passing_with_setup_unit_test.rb

@@ -0,0 +1,10 @@
+require File.expand_path(File.dirname(__FILE__) + "/test_helper")
+
+Test::Unit::TestCase.disallow_setup!
+unit_tests :allow => :setup do
+  def setup
+  end
+  
+  test("true"){}
+end
+Test::Unit::TestCase.class_eval {  @disallow_setup = nil }

data/vendor/dust-0.1.6/test/test_helper.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + '/../lib/dust'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: dan-manges-unit_record
 version: !ruby/object:Gem::Version 
-  version: 0.4.1
+  version: 0.9.0
 platform: ruby
 authors: 
 - Dan Manges
@@ -9,7 +9,7 @@ autorequire: unit_record
 bindir: bin
 cert_chain: []
 
-date: 2008-10-10 00:00:00 -07:00
+date: 2008-12-15 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
@@ -19,9 +19,8 @@ executables: []
 
 extensions: []
 
-extra_rdoc_files: 
-- README.rdoc
-- CHANGELOG
+extra_rdoc_files: []
+
 files: 
 - lib/active_record/connection_adapters/unit_record_adapter.rb
 - lib/unit_record/association_stubbing.rb
@@ -32,6 +31,7 @@ files:
 - lib/unit_record.rb
 - test/active_record/connection_adapters/unit_record_adapter_test.rb
 - test/db/schema.rb
+- test/sample_spec.rb
 - test/test_helper.rb
 - test/unit_record/association_stubbing_test.rb
 - test/unit_record/column_cacher_test.rb
@@ -41,18 +41,33 @@ files:
 - test/unit_record/disconnected_active_record_test.rb
 - test/unit_record/disconnected_fixtures_test.rb
 - test/unit_record/disconnected_test_case_test.rb
+- vendor/dust-0.1.6/lib/array_extension.rb
+- vendor/dust-0.1.6/lib/definition_error.rb
+- vendor/dust-0.1.6/lib/dust.rb
+- vendor/dust-0.1.6/lib/nil_extension.rb
+- vendor/dust-0.1.6/lib/object_extension.rb
+- vendor/dust-0.1.6/lib/string_extension.rb
+- vendor/dust-0.1.6/lib/symbol_extension.rb
+- vendor/dust-0.1.6/lib/test_case_extension.rb
+- vendor/dust-0.1.6/rakefile.rb
+- vendor/dust-0.1.6/test/all_tests.rb
+- vendor/dust-0.1.6/test/failing_with_helper_unit_test.rb
+- vendor/dust-0.1.6/test/failing_with_setup_unit_test.rb
+- vendor/dust-0.1.6/test/functional_test.rb
+- vendor/dust-0.1.6/test/passing_unit_test.rb
+- vendor/dust-0.1.6/test/passing_with_helper_unit_test.rb
+- vendor/dust-0.1.6/test/passing_with_helpers_unit_test.rb
+- vendor/dust-0.1.6/test/passing_with_setup_unit_test.rb
+- vendor/dust-0.1.6/test/test_helper.rb
 - CHANGELOG
-- README.rdoc
+- LICENSE
+- README.markdown
 - Rakefile
-has_rdoc: true
+has_rdoc: false
 homepage: http://unit-test-ar.rubyforge.org
 post_install_message: 
-rdoc_options: 
-- --title
-- UnitRecord
-- --main
-- README.rdoc
-- --line-numbers
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement