diff options
Diffstat (limited to 'activerecord/RUNNING_UNIT_TESTS.rdoc')
-rw-r--r-- | activerecord/RUNNING_UNIT_TESTS.rdoc | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/activerecord/RUNNING_UNIT_TESTS.rdoc b/activerecord/RUNNING_UNIT_TESTS.rdoc new file mode 100644 index 0000000000..7e3460365b --- /dev/null +++ b/activerecord/RUNNING_UNIT_TESTS.rdoc @@ -0,0 +1,44 @@ +== 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. |