pytest-bdd-web 0.1.1

Description:

pytestbddweb 0.1.1

pytest plugin providing a BDD ‘language’ for web app integration-testing.


Features
Implements a simple headless browser that requests web pages according
to a URL mapping, parses web forms, and enables assertions about
the various web responses using PyQuery selectors (similar to jQuery).
Example:
Feature: Homepage functionality
Scenario: Homepage
When the user requests list home
Then response 0 status code is "200"
And response 0 element "#main_title" contains 'Welcome'

Scenario: User profile
When the user requests view user_profile
Then response 0 status code is "200"
And response 0 element "tr:contains('Balance')" contains '45.67'
And response 0 form-contains-array-outline <arrayfield> <arrayvalue>

Examples:
| arrayfield | arrayvalue |
| choices | [0 2 3] |
Requires you to provide these fixtures:


client
url_mapping


client must implement get and post methods, compatible with
Flask.test_client.
Example:
@pytest.fixture
def app():
"""Create, configure a new app instance for each test."""
"..."
return app

@pytest.fixture
def client(app):
return app.test_client()
url_mapping must be a dictionary, with keys of top-level “groups”,
and values mapping a human-readable “action” to an absolute URL in
your web app.
Example:
URL_MAPPING = {
'home': {
'list': '/',
'articles': '/latest/',
},
'user_profile': {
'view': '/user/profile/',
'update': '/user/profile/update',
},
'blog': {
'delete': '/blog/{}/delete', # {} gets filled from feature args
},
};
@pytest.fixture
def url_mapping():
return URL_MAPPING


Available When Steps

the user requests {action} {what} [args…]

Will operate on the URL looked up from the url_mapping, with
any args substituted in for occurrences of {} in the mapped
URL.
Example:
When the user requests view user_profile

the user sets-array {afield} [{avalue}]

Sets a form value on the current web page.
Example:
When the user sets-array choices [1 3 4]

the user sets-array-outline <arrayfield> <arrayvalue>

Sets a form value on the current web page.
Example:
When the user sets-array-outline <arrayfield> <arrayvalue>

Examples:
| arrayfield | arrayvalue |
| choices | [0 2 3] |

the user sets {field} “{value}”

Sets a form value on the current web page.
Example:
When the user sets fullname "Big Bob"

the user submits requests {action} {what} [args…]

Will operate on the URL looked up from the url_mapping, with
any args substituted in for occurrences of {} in the mapped
URL.
Example:
When the user submits delete blog 4ec2d70


Available Then Steps

response {response_index:d} status code is “{code:d}”

Example:
Then response 0 status code is "200"

response {response_index:d} shows element “{selector}”

Example:
Then response 0 shows element "div.success"

response {response_index:d} form-contains-array-outline <arrayfield> <arrayvalue>

Then-clause asserting about a given outline form-field having the given
outline array value.
Example:
Then response 0 form-contains-array-outline <arrayfield> <arrayvalue>

Examples:
| arrayfield | arrayvalue |
| choices | [0 2 3] |

response {response_index:d} json-has “{key}”

Example:
Then response 0 json-has "account_balance"

response {response_index:d} json-contains “{key}” “{phrase}”

Example:
Then response 0 json-contains "account_balance" "45.67"

response {response_index:d} doesn’t show element “{selector}”

Example:
Then response 0 doesn't show element "div.alert"

response {response_index:d} element “{selector}” doesn’t contain ‘{phrase}’

Example:
Then response 0 element "#username" doesn't contain 'bob'

response {response_index:d} element “{selector}” doesn’t contain-outline <contains>

Then-clause asserting about a PyQuery-selected element not containing an
outline value.
Example:
Then response 0 element "#username" doesn't contain 'bob'

response {response_index:d} element “{selector}” doesn’t contain-outline <contains>

Then-clause asserting about a PyQuery-selected element not containing an
outline value.
Example:
Then response 0 element "#response" doesn't contain-outline <contains>

Examples:
| contains |
| 0 items added |

response {response_index:d} element “{selector}” contains-outline <contains>

Then-clause asserting about a PyQuery-selected element containing an
outline value.
Example:
Then response 0 element "#username" contains-outline <contains>

Examples:
| contains |
| Bob |


Requirements
PyQuery, pytest-bdd, mechanize


Installation
You can install “pytest-bdd-web” via pip from PyPI:
$ pip install pytest-bdd-web


Contributing
Contributions are very welcome. Tests can be run with tox, please ensure
the coverage at least stays the same before you submit a pull request.


License
Distributed under the terms of the MIT license, “pytest-bdd-web” is free and open source software


Issues
If you encounter any problems, please file an issue along with a detailed description.