summaryrefslogtreecommitdiffstats
path: root/bitbake/lib/toaster/tests/browser/README
blob: 63e8169c166f603318c63a647bf079a892586dac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 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