| # 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 |