rails/activerecord/RUNNING_UNIT_TESTS.rdoc

== Setup

If you don't have the environment set make sure to read

    http://edgeguides.rubyonrails.org/contributing_to_ruby_on_rails.html#testing-active-record

== Running the Tests

You can run a particular test file from the command line, e.g.

  $ ruby -Itest test/cases/base_test.rb

To run a specific test:

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

You can run with a database other than the default you set in test/config.yml, using the ARCONN
environment variable:

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

You can run all the tests for a given database via rake:

  $ rake test_mysql

The 'rake test' task will run all the tests for mysql, mysql2, sqlite3 and postgresql.

== Custom Config file

By default, the config file is expected to be at the path test/config.yml. You can specify a
custom location with the ARCONFIG environment variable.
revises RUNNING_UNIT_TESTS to delegate stuff to the contributing guide 2012-07-13 17:52:22 +00:00			`== Setup`
Initial git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2004-11-24 01:04:44 +00:00
revises RUNNING_UNIT_TESTS to delegate stuff to the contributing guide 2012-07-13 17:52:22 +00:00			`If you don't have the environment set make sure to read`
Add note about needing mysql superuser for unit tests. 2012-07-13 17:24:48 +00:00
Corrected link anchor and added colons for continuity 2013-02-19 16:11:42 +00:00			`http://edgeguides.rubyonrails.org/contributing_to_ruby_on_rails.html#testing-active-record`
Initial git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2004-11-24 01:04:44 +00:00
revises RUNNING_UNIT_TESTS to delegate stuff to the contributing guide 2012-07-13 17:52:22 +00:00			`== Running the Tests`
Initial git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2004-11-24 01:04:44 +00:00
Refactor Active Record test connection setup. Please see the RUNNING_UNIT_TESTS file for details, but essentially you can now configure things in test/config.yml. You can also run tests directly via the command line, e.g. ruby path/to/test.rb (no rake needed, uses default db connection from test/config.yml). This will help us fix the CI by enabling us to isolate the different Rails versions to different databases. 2011-06-04 22:19:17 +00:00			`You can run a particular test file from the command line, e.g.`
Initial git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2004-11-24 01:04:44 +00:00
Update the RUNNING_UNIT_TESTS file 2011-06-09 08:11:26 +00:00			`$ ruby -Itest test/cases/base_test.rb`
Initial git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2004-11-24 01:04:44 +00:00
Refactor Active Record test connection setup. Please see the RUNNING_UNIT_TESTS file for details, but essentially you can now configure things in test/config.yml. You can also run tests directly via the command line, e.g. ruby path/to/test.rb (no rake needed, uses default db connection from test/config.yml). This will help us fix the CI by enabling us to isolate the different Rails versions to different databases. 2011-06-04 22:19:17 +00:00			`To run a specific test:`
Initial git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2004-11-24 01:04:44 +00:00
Update the RUNNING_UNIT_TESTS file 2011-06-09 08:11:26 +00:00			`$ ruby -Itest test/cases/base_test.rb -n test_something_works`
Initial git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2004-11-24 01:04:44 +00:00
Refactor Active Record test connection setup. Please see the RUNNING_UNIT_TESTS file for details, but essentially you can now configure things in test/config.yml. You can also run tests directly via the command line, e.g. ruby path/to/test.rb (no rake needed, uses default db connection from test/config.yml). This will help us fix the CI by enabling us to isolate the different Rails versions to different databases. 2011-06-04 22:19:17 +00:00			`You can run with a database other than the default you set in test/config.yml, using the ARCONN`
			`environment variable:`
Deletes trailing whitespaces (over text files only find * -type f -exec sed 's/[ \t]*$//' -i {} \;) 2010-08-14 05:13:00 +00:00
Update the RUNNING_UNIT_TESTS file 2011-06-09 08:11:26 +00:00			`$ ARCONN=postgresql ruby -Itest test/cases/base_test.rb`
Added change_table for migrations (Jeff Dean) [#71 state:resolved] 2008-05-03 16:29:47 +00:00
Refactor Active Record test connection setup. Please see the RUNNING_UNIT_TESTS file for details, but essentially you can now configure things in test/config.yml. You can also run tests directly via the command line, e.g. ruby path/to/test.rb (no rake needed, uses default db connection from test/config.yml). This will help us fix the CI by enabling us to isolate the different Rails versions to different databases. 2011-06-04 22:19:17 +00:00			`You can run all the tests for a given database via rake:`
Fixed a few Oracle issues: Allows Oracle's odd date handling to still work consistently within #to_xml, Passes test that hardcode insert statement by dropping the :id column, Updated RUNNING_UNIT_TESTS with Oracle instructions, Corrects method signature for #exec #5294 [schoenm@earthlink.net] git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4552 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2006-07-05 02:54:19 +00:00
Update the RUNNING_UNIT_TESTS file 2011-06-09 08:11:26 +00:00			`$ rake test_mysql`
Fixed a few Oracle issues: Allows Oracle's odd date handling to still work consistently within #to_xml, Passes test that hardcode insert statement by dropping the :id column, Updated RUNNING_UNIT_TESTS with Oracle instructions, Corrects method signature for #exec #5294 [schoenm@earthlink.net] git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@4552 5ecf4fe2-1ee6-0310-87b1-e25e094e27de 2006-07-05 02:54:19 +00:00
Update the RUNNING_UNIT_TESTS file 2011-06-09 08:11:26 +00:00			`The 'rake test' task will run all the tests for mysql, mysql2, sqlite3 and postgresql.`
Print out information about whether the identity map is on or off when running unit tests 2011-06-09 19:15:34 +00:00
revises RUNNING_UNIT_TESTS to delegate stuff to the contributing guide 2012-07-13 17:52:22 +00:00			`== Custom Config file`
Add support for using an ARCONFIG environment variable to specify the location of the config.yml file for running the tests 2011-06-12 18:08:16 +00:00
			`By default, the config file is expected to be at the path test/config.yml. You can specify a`
			`custom location with the ARCONFIG environment variable.`