Updated documentation / scripts / compiled selenium scripts.
[mediagoblin-automation:mediagoblin-selenium.git] / docs / ContributingTests.txt
1 ------------------------
2 How to Contribute Tests
3 ------------------------
4 Tests can be recorded using Selenium IDE within Firefox or by generating the HTML 
5 either programmatically or by hand. Theses tests are then to be added to the 
6 TestSuite.html under tests/src. 
7
8 The current workflow then requires that you export your test case as a "Python 2 webdriver"
9 script and save it in the tests/ folder. In the future this conversion will be done by the
10 automation framework itself so only the HTML source file will need to be committed.
11
12 ------------------------
13 Things to Note
14 ------------------------
15 Don't set your base url to have a forward slash at the end. Selenium adds the forward slash
16 for you by default.
17
18 ------------------------
19 Writing Upload Tests
20 ------------------------
21 If a test makes use of local files, such as those found under the resources directory, you
22 need to edit the Selenium HTML file and replace the your specific base directory path with the
23 parameter WORKING_DIRECTORY.
24
25 Example:
26 /home/lotusecho/gmg/mediagoblin-selenium/resources/gavroche.png
27
28 Becomes
29
30 WORKING_DIRECTORY/resources/gavroche.png
31
32 When runtests.sh is run it will process that paramter and replace it with your current working
33 directory.