gecko-dev/testing/tps
Thom Chiovoloni 8b9281c90a Bug 1350135 - Fix failing TPS test_history_collision.js test r=markh
There were three issues here: The first is that the TPS's history module didn't
wait for PlacesUtils.history.remove's promise to resolve.

The second is that the SYNC_WIPE_REMOTE in the previous client would cause a
write to the clients collection, which would cause the next client to get a
"sync:collection_changed" push. This caused a sync of *only* the clients
collection upon reciept, which would prevent TPS from explicitly syncing all
engines.

The third is that TPS wasn't correctly handling the cases where logIn would
trigger a sync, which would cause a failure during the first sync of a session.
This would cause failures on other TPS tests as well.

MozReview-Commit-ID: LpqZ7Kt9fyy

--HG--
extra : rebase_source : f1d3c40e2ef4e09cce4d2ce8ae25f2c86ddfee45
2017-04-19 14:38:00 -04:00
..
config
pages
tps Bug 1350135 - Fix failing TPS test_history_collision.js test r=markh 2017-04-19 14:38:00 -04:00
.gitignore Bug 1229986 - get Sync tps tests starting again. r=whimboo 2015-12-04 12:55:57 +11:00
.hgignore Bug 1229986 - get Sync tps tests starting again. r=whimboo 2015-12-04 12:55:57 +11:00
README
create_venv.py
setup.py Bug 1291030 - Update TPS dependencies to prevent crashes for locally built firefox on Mac 10.11. r=markh 2016-08-01 17:31:33 -04:00

README

TPS is a test automation framework for Firefox Sync. See
https://developer.mozilla.org/en/TPS for documentation.

Installation
============

TPS requires several packages to operate properly. To install TPS and
required packages, use the INSTALL.sh script, provided:

  ./INSTALL.sh /path/to/create/virtualenv

This script will create a virtalenv and install TPS into it. TPS can then
be run by activating the virtualenv and executing:

  runtps --binary=/path/to/firefox


Configuration
=============
To edit the TPS configuration, do not edit config/config.json.in in the tree.
Instead, edit config.json inside your virtualenv; it will be located at
something like:

  (linux): /path/to/virtualenv/lib/python2.6/site-packages/tps-0.2.40-py2.6.egg/tps/config.json
  (win): /path/to/virtualenv/Lib/site-packages/tps-0.2.40-py2.6.egg/tps/config.json


Setting Up Test Accounts
========================

Firefox Accounts
----------------
To create a test account for using the Firefox Account authentication perform the
following steps:

1. Go to a URL like http://restmail.net/mail/%account_prefix%@restmail.net
2. Go to https://accounts.firefox.com/signup?service=sync&context=fx_desktop_v1
3. Sign in with the previous chosen email address and a password
4. Go back to the Restmail URL, reload the page
5. Search for the verification link and open that page

Now you will be able to use your setup Firefox Account for Sync.