| # 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 |
| |
| Alternatively, if you used pip to install the libraries required by Toaster, |
| selenium will already be installed. |
| |
| 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 |