aboutsummaryrefslogtreecommitdiffstats
path: root/activerecord/RUNNING_UNIT_TESTS.rdoc
diff options
context:
space:
mode:
authorYuki Nishijima <mail@yukinishijima.net>2013-02-03 15:49:48 +0900
committerYuki Nishijima <mail@yukinishijima.net>2013-02-03 15:49:48 +0900
commitc8a25386d39d49d9ce5135a413f19c416456299e (patch)
tree6b580d882fb5163ea094110b5b3e92bdbc58b1f3 /activerecord/RUNNING_UNIT_TESTS.rdoc
parentecd004e6586cbd379739eb21015b22360287f057 (diff)
downloadrails-c8a25386d39d49d9ce5135a413f19c416456299e.tar.gz
rails-c8a25386d39d49d9ce5135a413f19c416456299e.tar.bz2
rails-c8a25386d39d49d9ce5135a413f19c416456299e.zip
Put .rdoc at the end of the files named RUNNING_UNIT_TESTS
So that they are printed nicely on GitHub.
Diffstat (limited to 'activerecord/RUNNING_UNIT_TESTS.rdoc')
-rw-r--r--activerecord/RUNNING_UNIT_TESTS.rdoc31
1 files changed, 31 insertions, 0 deletions
diff --git a/activerecord/RUNNING_UNIT_TESTS.rdoc b/activerecord/RUNNING_UNIT_TESTS.rdoc
new file mode 100644
index 0000000000..bdd8834dcb
--- /dev/null
+++ b/activerecord/RUNNING_UNIT_TESTS.rdoc
@@ -0,0 +1,31 @@
+== 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.