README.md in gridium-1.1.6 vs README.md in gridium-1.1.7

- old
+ new

@@ -215,9 +215,27 @@ The supported log levels in selenium are OFF, SEVERE, WARNING, INFO, DEBUG, ALL To open the firehose to selenium's logging (https://github.com/SeleniumHQ/selenium/wiki/Logging): 1. Set `config.selenium_log_level = 'ALL'` to set each type of selenium logging (browser, driver, client, server) to 'ALL' 2. Set `config.log_level = :debug` to have them picked up by gridium's logger. + +## Testing with docker +Gridium's unit tests are run in docker using selenium grid and some helper images: +* gprestes/the-internet +* yetanotherlucas/mustadio + +The bin folder contains helper scripts to setup and teardown the docker containers: +* `bin/pull`: Use this to pull the latest docker images prior to starting. +* `bin/start`: Use this to start up all the docker containers. + * `dev mode`: -d switch to map your local gridium (via $GRIDIUMPATH) to the gridium container + * `$GRIDIUMPATH`: set this to point at your Gridium repo -> export GRIDIUMPATH="/path/to/gridium" +* `bin/cleanup`: Use this to cleanup any dangling containers afterward. + +Once the containers are running, you can shell into the gridium container to kick off tests: +`docker exec -it gridium_gridium_1 /bin/bash` +`rake spec` +If a test does not pass, modify the spec locally and rerun it inside the gridium container again. Repeat until green. + ## Elements Elements are the building blocks of page objects. Elements are anything that a user, or a test would care about on the page. To create a new Element, you will need three things: * Element Name - A human readable string used to identify the element to the tester. Used primarily in the log file. * Locator Type - `:css` `:xpath` `:link` `:link_text` `:id` `:class` `:class_name` `:name` `:tag_name` are all valid.