aboutsummaryrefslogblamecommitdiffstats
path: root/activerecord/RUNNING_UNIT_TESTS.rdoc
blob: 7e3460365b67c1ecd7cfbd0baa23dbd371b1ca1b (plain) (tree)
1
2
3
4
5
6
7
        
 

                                                                                                         
 
                    
 




                                                      
 
                                       
 

                                                                        
 
                                 
 
                                                                               
 




                                     
 


                                                                               
 
              
 

                                                                               
 



                                                                               
 

                                                                          
== Setup

If you don't have an environment for running tests, read
http://edgeguides.rubyonrails.org/contributing_to_ruby_on_rails.html#setting-up-a-development-environment

== Running the Tests

To run a specific test:

  $ ruby -Itest test/cases/base_test.rb -n method_name

To run a set of tests:

  $ ruby -Itest test/cases/base_test.rb

You can also run tests that depend upon a specific database backend. For
example:

  $ bundle exec rake test_sqlite3

Simply executing <tt>bundle exec rake test</tt> is equivalent to the following:

  $ bundle exec rake test:mysql
  $ bundle exec rake test:mysql2
  $ bundle exec rake test:postgresql
  $ bundle exec rake test:sqlite3
  $ bundle exec rake test:sqlite3_mem

There should be tests available for each database backend listed in the {Config
File}[rdoc-label:label-Config+File]. (the exact set of available tests is
defined in +Rakefile+)

== Config File

If +test/config.yml+ is present, then its parameters are obeyed; otherwise, the
parameters in +test/config.example.yml+ are.

You can override the +connections:+ parameter in either file using the +ARCONN+
(Active Record CONNection) environment variable:

  $ ARCONN=postgresql ruby -Itest test/cases/base_test.rb

You can specify a custom location for the config file using the +ARCONFIG+
environment variable.