Previously, we didn't specify a specific version of Selenium. When upgrading to Python 3 and installing Selenium to work with it, the JS unit test broke, as the report format produced by Selenium had changed. Modify the test so that it works with the latest Selenium report format. Add a note to the README that the given Selenium version should be used to prevent unexpected test failures. (Bitbake rev: 571c2b70d3c123614618672ce7532bb5f4c36630) Signed-off-by: Elliot Smith <elliot.smith@intel.com> Signed-off-by: Ed Bartosh <ed.bartosh@linux.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://code.google.com/p/chromedriver/downloads/list
- 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
Firefox should work without requiring additional software to be installed.
The test case 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
- 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