1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/testing/tps/README Wed Dec 31 06:09:35 2014 +0100 1.3 @@ -0,0 +1,42 @@ 1.4 +TPS is a test automation framework for Firefox Sync. See 1.5 +https://developer.mozilla.org/en/TPS for documentation. 1.6 + 1.7 +Installation 1.8 +============ 1.9 + 1.10 +TPS requires several packages to operate properly. To install TPS and 1.11 +required packages, use the INSTALL.sh script, provided: 1.12 + 1.13 + ./INSTALL.sh /path/to/create/virtualenv 1.14 + 1.15 +This script will create a virtalenv and install TPS into it. TPS can then 1.16 +be run by activating the virtualenv and executing: 1.17 + 1.18 + runtps --binary=/path/to/firefox 1.19 + 1.20 + 1.21 +Configuration 1.22 +============= 1.23 +To edit the TPS configuration, do not edit config/config.json.in in the tree. 1.24 +Instead, edit config.json inside your virtualenv; it will be located at 1.25 +something like: 1.26 + 1.27 + (linux): /path/to/virtualenv/lib/python2.6/site-packages/tps-0.2.40-py2.6.egg/tps/config.json 1.28 + (win): /path/to/virtualenv/Lib/site-packages/tps-0.2.40-py2.6.egg/tps/config.json 1.29 + 1.30 + 1.31 +Setting Up Test Accounts 1.32 +======================== 1.33 + 1.34 +Firefox Accounts 1.35 +---------------- 1.36 +To create a test account for using the Firefox Account authentication perform the 1.37 +following steps: 1.38 + 1.39 +1. Go to a URL like http://restmail.net/mail/%account_prefix%@restmail.net 1.40 +2. Go to https://accounts.firefox.com/signup?service=sync&context=fx_desktop_v1 1.41 +3. Sign in with the previous chosen email address and a password 1.42 +4. Go back to the Restmail URL, reload the page 1.43 +5. Search for the verification link and open that page 1.44 + 1.45 +Now you will be able to use your setup Firefox Account for Sync.