From b73cc7dccaa01778de20ade004e0c3bde2e2e36a Mon Sep 17 00:00:00 2001
From: Andreas Gohr <andi@splitbrain.org>
Date: Sat, 15 Oct 2005 13:45:45 +0200
Subject: renamed test directory

darcs-hash:20051015114545-7ad00-561552ce7e519d81146b5cb2d28203aee7c6d2ad.gz
---
 _test/README | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 _test/README

(limited to '_test/README')

diff --git a/_test/README b/_test/README
new file mode 100644
index 000000000..d651a4a82
--- /dev/null
+++ b/_test/README
@@ -0,0 +1,84 @@
+--------------------------------------------------------------------------------
+ Dokuwiki Unit Test Suite
+--------------------------------------------------------------------------------
+$Date: 2004/02/14 02:14:50 $
+
+Credits: to the WACT team - http://www.phpwact.org, from whom the basis of
+this test suite was stolen
+
+--------------------------------------------------------------------------------
+INSTALLING & SETUP
+
+1. Grab a copy of the SimpleTest unit testing framework an extract somewhere
+
+	http://www.lastcraft.com/simple_test.php
+		or
+	http://sourceforge.net/projects/simpletest
+
+2. Edit ./tests.ini
+
+	- TEST_ENABLED - set to "1" to allow the test suite to be used
+	by vistors to your site. Generally best to leave as 0 for
+	a productive site - running tests alot will hammer the server 
+	Note: you will still be able to run the tests from the command
+	line even when this is set to 0
+
+	- WEB_TEST_URL - this is for running "web tests" where SimpleTest
+	acts as a web browser and executes HTTP requests against pages.
+	Should point at your Dokuwiki URL e.g.
+	
+	http://localhost/dokuwiki
+
+	- PROXY - if you're behind a proxy, specify it here
+	Note: username / password are optional e.g.
+
+	http://proxyuser:proxypwd@proxy.yourdomain.com:8080
+
+	- REMOTE_TEST_URL - it's possible to run the full test suite
+	remotely (over HTTP) with some XML goodness. This should
+        point at the URL of the test suite you want to test
+	See the following URL for more info;
+	http://www.sitepoint.com/blogs/2004/06/15/simple-test-remote-testing/
+
+	- Simple Test
+        Update the library_path to point at the directory where you installed
+	Simple Test
+
+--------------------------------------------------------------------------------
+RUNNING THE TESTS
+
+You can run the tests in three ways. From the command line:
+
+	$ ./runtests.php -h
+
+Using a web browser;
+
+	http://localhost/dokuwiki/test/index.php
+
+As remote tests run on a remote serveri (specified in tests.ini with REMOTE_TEST_URL) and driven locally from the command line using;
+
+	$ ./remotetests.php -h
+
+
+--------------------------------------------------------------------------------
+ADDING TESTS
+
+The test cases are kept in the './cases' directory in a directory structure
+mirroring that of the Dokuwiki's
+
+Files with the extension .group.php are group tests (collections of
+one or more seperate unit test files) - there should be one group
+test per file in Dokuwiki's real directory.
+
+Individual tests files have the extension .test.php
+
+To add tests, create a .test.php file in the correct directory under ./cases
+Probably best to use one of the existing scripts as a basis
+
+The test will not be executable via one of the test runners (see above).
+
+To add it to a group of tests, modify the corresponding .group.php file.
+
+One exception to the naming convention - files named .webtest.php and
+.webgroup.php are run using SimpleTest's browser simulator.
+
-- 
cgit v1.2.3