rails/activerecord/RUNNING_UNIT_TESTS.rdoc
Jeremy Audet 87ac19ebbe Rewrite activerecord/RUNNING_UNIT_TESTS
`RUNNING_UNIT_TESTS` is written in an unclear and confusing manner. This commit
attempts to correct that.

Thanks to zzak and vipulnsward for feedback.
2013-05-15 11:07:47 -04:00

44 lines
1.3 KiB
Plaintext

== 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
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, it's parameters are obeyed. Otherwise, the
parameters in +test/config.example.yml+ are obeyed.
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.