2ff892d87c
Add tests for ToasterTable UI table sort reverting, which can only be exercised via the browser. Check that if a table is sorted by a column, and that column is hidden, then the sort reverts to the default for the table. [YOCTO #9836] (Bitbake rev: 5b016338478d784fd048ba2baae121c3e558090c) Signed-off-by: Elliot Smith <elliot.smith@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Running Toaster's browser-based test suite
These tests require Selenium to be installed in your Python environment.
The simplest way to install this is via pip:
pip install selenium==2.53.2
Note that if you use other versions of Selenium, some of the tests (such as tests.browser.test_js_unit_tests.TestJsUnitTests) may fail, as these rely on a Selenium test report with a version-specific format.
To run tests against Chrome:
- Download chromedriver for your host OS from https://sites.google.com/a/chromium.org/chromedriver/downloads
- On *nix systems, put chromedriver on PATH
- On Windows, put chromedriver.exe in the same directory as chrome.exe
To run tests against PhantomJS (headless):
- Download and install PhantomJS: http://phantomjs.org/download.html
- On *nix systems, put phantomjs on PATH
- Not tested on Windows
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:
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
e.g. to run the test suite with phantomjs where you have phantomjs installed in /home/me/apps/phantomjs:
PATH=/home/me/apps/phantomjs/bin:$PATH TOASTER_TESTS_BROWSER=phantomjs manage.py test tests.browser