[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1593/8267] bitbake: toaster-tests: define capabilities for latest Firefox driver

[Emmanuele Bassi <ebassi src gnome org>]

commit 05f82e8f127c52a261218d8f88db5e0bdac3b248
Author: Elliot Smith <elliot smith intel com>
Date:   Wed Jul 20 17:37:03 2016 +0100

    bitbake: toaster-tests: define capabilities for latest Firefox driver
    
    For the latest Firefox versions, WebDriver requires a download of a
    separate binary and an additional capability to be defined on it.
    
    Modify our tests so that when "marionette" is set as the browser,
    this capability is defined on the Firefox driver. Also add a note to the
    README about the additional installation steps required.
    
    (Bitbake rev: f6011d986f9a573a39e7b98af0aefe6cc88461ad)
    
    Signed-off-by: Elliot Smith <elliot smith intel com>
    Signed-off-by: Michael Wood <michael g wood intel com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 bitbake/lib/toaster/tests/browser/README |   19 +++++++++++++++++--
 1 files changed, 17 insertions(+), 2 deletions(-)
---
diff --git a/bitbake/lib/toaster/tests/browser/README b/bitbake/lib/toaster/tests/browser/README
index f57154e..969f06c 100644
--- a/bitbake/lib/toaster/tests/browser/README
+++ b/bitbake/lib/toaster/tests/browser/README
@@ -24,15 +24,30 @@ To run tests against PhantomJS (headless):
 * On *nix systems, put phantomjs on PATH
 * Not tested on Windows
 
-Firefox should work without requiring additional software to be installed.
+To run tests against Firefox, you may need to install the Marionette driver,
+depending on how new your version of Firefox is. One clue that you need to do
+this is if you see an exception like:
 
-The test case will instantiate a Selenium driver set by the
+  selenium.common.exceptions.WebDriverException: Message: The browser
+  appears to have exited before we could connect. If you specified
+  a log_file in the FirefoxBinary constructor, check it for details.
+
+See https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette/WebDriver
+for installation instructions. Ensure that the Marionette executable (renamed
+as wires on Linux or wires.exe on Windows) is on your PATH; and use "marionette"
+as the browser string passed via TOASTER_TESTS_BROWSER (see below).
+
+(Note: The Toaster tests have been checked against Firefox 47 with the
+Marionette driver.)
+
+The test cases will instantiate a Selenium driver set by the
 TOASTER_TESTS_BROWSER environment variable, or Chrome if this is not specified.
 
 Available drivers:
 
 * chrome (default)
 * firefox
+* marionette (for newer Firefoxes)
 * ie
 * phantomjs