70 lines
2.4 KiB
70 lines
2.4 KiB
Installing gems for testing
|
|
===========================
|
|
|
|
Remove your .bundle/config if you've already installed Redmine without
|
|
the test dependencies. Then, run `bundle install`.
|
|
|
|
Running Tests
|
|
=============
|
|
|
|
Run `rake --tasks test` to see available tests.
|
|
Run `rake test` to run the entire test suite (except the tests for the
|
|
Apache perl module Redmine.pm and Capybara tests, see below).
|
|
|
|
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. 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. 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.
|
|
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.
|
|
|
|
Running Redmine.pm tests
|
|
========================
|
|
|
|
(work in progress)
|
|
|
|
Running the tests for the Redmine.pm perl module needs a bit more setup.
|
|
You need an Apache server with mod_perl, mod_dav_svn and Redmine.pm configured.
|
|
See: http://www.redmine.org/projects/redmine/wiki/Repositories_access_control_with_apache_mod_dav_svn_and_mod_perl
|
|
|
|
You need an empty repository accessible at http://127.0.0.1/svn/ecookbook
|
|
Then, you can run the tests with:
|
|
`ruby test\extra\redmine_pm\repository_subversion_test.rb`
|
|
|
|
If you svn server is not running on localhost, you can use the REDMINE_TEST_DAV_SERVER
|
|
environment variable to specify another host.
|
|
|
|
Running Capybara tests
|
|
======================
|
|
|
|
You need to have PhantomJS WebDriver listening on port 4444:
|
|
`phantomjs --webdriver 4444`
|
|
|
|
Capybara tests can be run with:
|
|
`rake test:ui`
|