BDD library for the py.test runner

Install pytest-bdd

pip install pytest-bdd

Example

publish_article.feature:

Scenario: Publishing the article
    Given I'm an author user
    And I have an article
    When I go to the article page
    And I press the publish button
    Then I should not see the error message
    And the article should be published  # Note: will query the database

test_publish_article.py:

from pytest_bdd import scenario, given, when, then

test_publish = scenario('publish_article.feature', 'Publishing the article')


@given('I have an article')
def article(author):
	return create_test_article(author=author)


@when('I go to the article page')
def go_to_article(article, browser):
	browser.visit(urljoin(browser.url, '/manage/articles/{0}/'.format(article.id)))


@when('I press the publish button')
def publish_article(browser):
	browser.find_by_css('button[name=publish]').first.click()


@then('I should not see the error message')
def no_error_message(browser):
    with pytest.raises(ElementDoesNotExist):
        browser.find_by_css('.message.error').first


@then('And the article should be published')
def article_is_published(article):
	article.refresh()  # Refresh the object in the SQLAlchemy session
	assert article.is_published

Subplugins

The pytest BDD has plugin support, and the main purpose of plugins (subplugins) is to provide useful and specialized fixtures.

List of known subplugins:

*  pytest-bdd-splinter -- collection of fixtures for real browser BDD testing