summaryrefslogtreecommitdiffstats
path: root/bitbake/lib/toaster/tests/browser/README
diff options
context:
space:
mode:
authorElliot Smith <elliot.smith@intel.com>2016-03-31 19:55:43 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2016-04-01 07:14:58 +0100
commitf859a3d40e91e64d4b5292cefd880075a27ddaf9 (patch)
tree31b65d409869857c513a1286459fa6e7d45812c2 /bitbake/lib/toaster/tests/browser/README
parent965c72c38b966ae78a012040159375cec6106eac (diff)
downloadpoky-f859a3d40e91e64d4b5292cefd880075a27ddaf9.tar.gz
bitbake: toaster: tests Migrate to Selenium for UI tests
Create a new folder for Selenium tests. Add a new base Selenium testcase class and a helper which instantiates a webdriver for a given browser. Add a sample Selenium test case which can be used as a template for creating new tests. (Bitbake rev: b7a377aa2ab36390d619e2a0436ccb4b8d186c23) Signed-off-by: Elliot Smith <elliot.smith@intel.com> Signed-off-by: Michael Wood <michael.g.wood@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake/lib/toaster/tests/browser/README')
-rw-r--r--bitbake/lib/toaster/tests/browser/README41
1 files changed, 41 insertions, 0 deletions
diff --git a/bitbake/lib/toaster/tests/browser/README b/bitbake/lib/toaster/tests/browser/README
new file mode 100644
index 0000000000..63e8169c16
--- /dev/null
+++ b/bitbake/lib/toaster/tests/browser/README
@@ -0,0 +1,41 @@
1# Running Toaster's browser-based test suite
2
3These tests require Selenium to be installed in your Python environment.
4
5The simplest way to install this is via pip:
6
7 pip install selenium
8
9Alternatively, if you used pip to install the libraries required by Toaster,
10selenium will already be installed.
11
12To run tests against Chrome:
13
14* Download chromedriver for your host OS from
15 https://code.google.com/p/chromedriver/downloads/list
16* On *nix systems, put chromedriver on PATH
17* On Windows, put chromedriver.exe in the same directory as chrome.exe
18
19To run tests against PhantomJS (headless):
20
21* Download and install PhantomJS:
22 http://phantomjs.org/download.html
23* On *nix systems, put phantomjs on PATH
24* Not tested on Windows
25
26Firefox should work without requiring additional software to be installed.
27
28The test case will instantiate a Selenium driver set by the
29TOASTER_TESTS_BROWSER environment variable, or Chrome if this is not specified.
30
31Available drivers:
32
33* chrome (default)
34* firefox
35* ie
36* phantomjs
37
38e.g. to run the test suite with phantomjs where you have phantomjs installed
39in /home/me/apps/phantomjs:
40
41PATH=/home/me/apps/phantomjs/bin:$PATH TOASTER_TESTS_BROWSER=phantomjs manage.py test tests.browser