Fattoush is a package that combines lettuce, webdriver and sauce to make a tasty UI testing salad.
Fattoush provides its own test runner which invokes lettuce such that it can run in saucelabs, with support of parallel test runs.
$ fattoush --parallel=webdriver
By default Fattoush will run sets of tests in series, but there is support for running lettuce in a separate process for each webdriver configuration. Another default is that webdriver configuration should be read from environmental variables as described at http://saucelabs.com/teamcity/3. Alternatively the browser configuration can be read from a json file.
$ fattoush --config-file
Fattoush validates all json, whether from a file or from the environment, against a schema, which
can be printed from Fattoush using --print-schema. An example valid configuration can be printed
using --print-example-config.
For an example of how to run Fattoush, navigate to the test directory within this project, and run
$ fattoush --config-file chrome_local.json
Just write your lettuce tests as normal, but in your terrain file add
from fattoush import Driver, hooks
and in each step definition module you are able to add
from fattoush import Driver
The hooks module simply uses lettuce.before and lettuce.after to set up lettuce.world for each
test feature, scenario, and step, ensuring that each scenario gets a fresh webdriver session and
that each step is correctly logged.
fattoush.Driver is a subclass of WebDriver with a class method instance(step_or_scenario). Within
any step or hook you can call this class method to get the appropriate Driver instance. This driver
instance will also have a property driver_instance.sauce which provides an object inheriting
fattoush.driver.sauce.SauceInterface. This may be an instance of fattoush.driver.sauce.Sauce in
which case it will interact with sauce using its REST api as well as holding information such as
authentication credentials and publicly viewable links. If on the other hand it is an instance of
fattoush.driver.sauce.Local, calling any of the methods of this interface shall just log that it
was called, and potentially return canned information as if running in saucelabs. Which of these is
returned is dictated by whether fattoush knows that it is running against saucelabs rather than a
local selenium server.
© 2014 Mind Candy Ltd. All Rights Reserved. Licensed under the MIT License; you may not use this file except in compliance with the License. You may obtain a copy of the License at http://opensource.org/licenses/MIT.
- Page abstract class
- More hooks
- More parallel options (per feature or per scenario)