BDD with Python, Behave and WebDriver

Behave is a Python BDD plugin which makes it easy to write tests in a natural language style.
To get started, make sure you have installed Behave:

$ sudo pip install behave

You are now ready to create your first story and run it on our Selenium grid.
Run the test with:

$ behave

Example feature (features/google.feature)

Feature: testing google

  Scenario: visit google and check
     When we visit google
     Then it should have a title "Google"

Example steps (features/steps/

@when('we visit google')
def step(context):

@then('it should have a title "Google"')
def step(context):
   assert context.browser.title == "Google"

Example features/

from selenium import webdriver

def before_all(context):
    desired_capabilities = webdriver.DesiredCapabilities.FIREFOX
    desired_capabilities['version'] = 'latest'
    desired_capabilities['platform'] = 'WINDOWS'
    desired_capabilities['name'] = 'Testing Selenium with Behave'
    desired_capabilities['client_key'] = 'key'
    desired_capabilities['client_secret'] = 'secret'

    context.browser = webdriver.Remote(

def after_all(context):

Configuring capabilities

To let TestingBot know on which browser/platform you want to run your test on, you need to specify the browsername, version, OS and other optional options in the capabilities field.

driver = webdriver.Firefox()

driver = webdriver.Remote(

To see how to do this, please select a combination of browser, version and platform in the drop-down menus below.

1. Select a Platform
2. Select a Browser

Testing Internal/Staged Websites

We've built TestingBot Tunnel, to provide you with a secure way to run tests against your staged/internal webapps. Please see our TestingBot Tunnel documentation for more information about this easy to use tunneling solution.

Other Options

We offer many other test options, for example: disable video recording, specifying a custom Firefox Profile, loading Chrome/Firefox/Safari extensions, running an executable before your test starts, uploading files, ...
See our list of test options for a full list of options to customize your tests.

Besides Behave support we have documentation for Lettuce and PyUnit: