diff options
Diffstat (limited to 'bitbake/lib/toaster/tests/browser/README')
-rw-r--r-- | bitbake/lib/toaster/tests/browser/README | 21 |
1 files changed, 19 insertions, 2 deletions
diff --git a/bitbake/lib/toaster/tests/browser/README b/bitbake/lib/toaster/tests/browser/README index 6b09d20d87..e841a3f12a 100644 --- a/bitbake/lib/toaster/tests/browser/README +++ b/bitbake/lib/toaster/tests/browser/README | |||
@@ -18,7 +18,7 @@ To run tests against Chrome: | |||
18 | * On Windows, put chromedriver.exe in the same directory as chrome.exe | 18 | * On Windows, put chromedriver.exe in the same directory as chrome.exe |
19 | 19 | ||
20 | To run tests against PhantomJS (headless): | 20 | To run tests against PhantomJS (headless): |
21 | 21 | --NOTE - Selenium seems to be deprecating support for this mode --- | |
22 | * Download and install PhantomJS: | 22 | * Download and install PhantomJS: |
23 | http://phantomjs.org/download.html | 23 | http://phantomjs.org/download.html |
24 | * On *nix systems, put phantomjs on PATH | 24 | * On *nix systems, put phantomjs on PATH |
@@ -43,13 +43,30 @@ Marionette driver.) | |||
43 | The test cases will instantiate a Selenium driver set by the | 43 | The test cases will instantiate a Selenium driver set by the |
44 | TOASTER_TESTS_BROWSER environment variable, or Chrome if this is not specified. | 44 | TOASTER_TESTS_BROWSER environment variable, or Chrome if this is not specified. |
45 | 45 | ||
46 | To run tests against the Selenium Firefox Docker container: | ||
47 | More explanation is located at https://wiki.yoctoproject.org/wiki/TipsAndTricks/TestingToasterWithContainers | ||
48 | * Run the Selenium container: | ||
49 | ** docker run -it --rm=true -p 5900:5900 -p 4444:4444 --name=selenium selenium/standalone-firefox-debug:2.53.0 | ||
50 | *** 5900 is the default vnc port. If you are runing a vnc server on your machine map a different port e.g. -p 6900:5900 and connect vnc client to 127.0.0.1:6900 | ||
51 | *** 4444 is the default selenium sever port. | ||
52 | * Run the tests | ||
53 | ** TOASTER_TESTS_BROWSER=http://127.0.0.1:4444/wd/hub TOASTER_TESTS_URL=http://172.17.0.1:8000 ./bitbake/lib/toaster/manage.py test --liveserver=172.17.0.1:8000 tests.browser | ||
54 | ** TOASTER_TESTS_BROWSER=remote TOASTER_REMOTE_HUB=http://127.0.0.1:4444/wd/hub ./bitbake/lib/toaster/manage.py test --liveserver=172.17.0.1:8000 tests.browser | ||
55 | *** TOASTER_REMOTE_HUB - This is the address for the Selenium Remote Web Driver hub. Assuming you ran the contianer with -p 4444:4444 it will be http://127.0.0.1:4444/wd/hub. | ||
56 | *** --liveserver=xxx tells Django to run the test server on an interface and port reachable by both host and container. | ||
57 | **** 172.17.0.1 is the default docker bridge on linux, viewable from inside and outside the contianers. Find it with "ip -4 addr show dev docker0" | ||
58 | * connect to the vnc server to see the tests if you would like | ||
59 | ** xtightvncviewer 127.0.0.1:5900 | ||
60 | ** note, you need to wait for the test container to come up before this can connect. | ||
61 | |||
46 | Available drivers: | 62 | Available drivers: |
47 | 63 | ||
48 | * chrome (default) | 64 | * chrome (default) |
49 | * firefox | 65 | * firefox |
50 | * marionette (for newer Firefoxes) | 66 | * marionette (for newer Firefoxes) |
51 | * ie | 67 | * ie |
52 | * phantomjs | 68 | * phantomjs (deprecated) |
69 | * remote | ||
53 | 70 | ||
54 | e.g. to run the test suite with phantomjs where you have phantomjs installed | 71 | e.g. to run the test suite with phantomjs where you have phantomjs installed |
55 | in /home/me/apps/phantomjs: | 72 | in /home/me/apps/phantomjs: |