Added more killserver calls in Makefile (for error conditions)
[mediagoblin-automation:mediagoblin-selenium.git] / README.txt
1 ------------------------
2 Dependencies
3 ------------------------
4 To record new tests Firefox and Selenium IDE are recommended but not required.
5
6 To run this test suite requires python and pip (which installs selenium).
7
8 To run this test suite on a local instance (the default when running make) all of the 
9 Mediagoblin dependencies must also be installed. Check the Deploying Mediagoblin 
10 section that pertains to your release 
11 (ex: http://mediagoblin.readthedocs.org/en/v0.4.1/siteadmin/deploying.html).
12
13 ------------------------
14 Running the Suite
15 ------------------------
16 To automatically run the tests on a new pre-setup instance (in a virtualenv):
17         make
18
19
20 ------------------------
21 Optional / Dangerous Run Methods
22 ------------------------
23 To run the tests on a remote test instance it's best to run it via Selenium IDE
24 by opening up tests/src/TestSuite.html and setting the URL manually there. AVOID THIS
25 unless you know what you're doing as these tests create and destroy data. Some notes:
26     You will have to replace the WORKING_DIRECTORY string in the upload test cases
27     to have them work.
28     You will have to manually set up the test data from data.ini (until a stand-alone
29     setup tool is made).
30     
31
32 To run your scripts on a local DEVELOPMENT instance that you already have running:
33         make runtests
34