summaryrefslogtreecommitdiffstats
path: root/doc/RUNNING_TESTS
diff options
context:
space:
mode:
authorJean-Philippe Lang <jp_lang@yahoo.fr>2012-06-12 19:14:06 +0000
committerJean-Philippe Lang <jp_lang@yahoo.fr>2012-06-12 19:14:06 +0000
commit12ea96066bb4837a3a136fdc24be24c96775b77e (patch)
tree87402401eae295c0cff17aa1c1e4eab8d7c20039 /doc/RUNNING_TESTS
parent13dced9d769951a3bdffc95dc6ccf638b850241a (diff)
downloadredmine-12ea96066bb4837a3a136fdc24be24c96775b77e.tar.gz
redmine-12ea96066bb4837a3a136fdc24be24c96775b77e.zip
Doc cleanup.
git-svn-id: svn+ssh://rubyforge.org/var/svn/redmine/trunk@9825 e93f8b46-1217-0410-a6f0-8f06a7374b81
Diffstat (limited to 'doc/RUNNING_TESTS')
-rw-r--r--doc/RUNNING_TESTS23
1 files changed, 15 insertions, 8 deletions
diff --git a/doc/RUNNING_TESTS b/doc/RUNNING_TESTS
index 40448a949..9032f3534 100644
--- a/doc/RUNNING_TESTS
+++ b/doc/RUNNING_TESTS
@@ -2,36 +2,43 @@ Installing gems for testing
===========================
Remove your .bundle/config if you've already installed Redmine without
-the test dependencies.
-Then, run `bundle install`.
+the test dependencies. Then, run `bundle install`.
Running Tests
=============
Run `rake --tasks test` to see available tests.
-`rake test` will run the entire testsuite.
-You can run `ruby test/unit/issue_test.rb` for an each test.
+Run `rake test` to run the entire test suite (note that this will drop
+and recreate your test database)
+
+You can run `ruby test/unit/issue_test.rb` for running a single test case.
Before running tests, you need to configure both development
and test databases.
Creating test repositories
-===================
+==========================
Redmine supports a wide array of different version control systems.
To test the support, a test repository needs to be created for each of those.
Run `rake --tasks test:scm:setup` for a list of available test-repositories or
-run `rake test:scm:setup:all` to set up all of them
+run `rake test:scm:setup:all` to set up all of them. The repositories are
+unpacked into {redmine_root}/tmp/test.
+
+If the test repositories are not present, the tests that need them will be
+skipped.
Creating a test ldap database
=============================
Redmine supports using LDAP for user authentications. To test LDAP
with Redmine, load the LDAP export from test/fixtures/ldap/test-ldap.ldif
-into a testing LDAP server. Test that the ldap server can be accessed
+into a testing LDAP server. Make sure that the LDAP server can be accessed
at 127.0.0.1 on port 389.
-Setting up the test ldap server is beyond the scope of this documentation.
+Setting up the test LDAP server is beyond the scope of this documentation.
The OpenLDAP project provides a simple LDAP implementation that should work
good as a test server.
+
+If the LDAP is not available, the tests that need it will be skipped.