A set of py.test fixtures to test Flask applications.
Project description
A set of py.test fixtures to test Flask extensions and applications.
Features
Plugin provides some fixtures to simplify app testing:
client - an instance of app.test_client,
client_class - client fixture for class-based tests,
config - you application config,
live_server - runs an application in the background (useful for tests with Selenium and other headless browsers),
accept_json, accept_jsonp, accept_any - accept headers suitable to use as parameters in client.
To pass options to your application use the pytest.mark.app marker:
@pytest.mark.app(debug=False)
def test_app(app):
assert not app.debug, 'Ensure the app not in debug mode'During tests execution the application has pushed context, e.g. url_for, session and other context bound objects are available without context managers:
def test_app(client):
assert client.get(url_for('myview')).status_code == 200Response object has a json property to test a view that returns a JSON response:
@api.route('/ping')
def ping():
return jsonify(ping='pong')
def test_api_ping(client):
res = client.get(url_for('api.ping'))
assert res.json == {'ping': 'pong'}If you want your tests done via Selenium or other headless browser use the live_server fixture. The server’s URL can be retrieved using the url_for function:
from flask import url_for
@pytest.mark.usefixtures('live_server')
class TestLiveServer:
def test_server_is_up_and_running(self):
res = urllib2.urlopen(url_for('index', _external=True))
assert b'OK' in res.read()
assert res.code == 200Quick Start
To start using a plugin define you application fixture in conftest.py:
from myapp import create_app
@pytest.fixture
def app():
app = create_app()
return appAnd run your test suite:
$ pip install pytest-flask
$ py.testContributing
Don’t hesitate to create a GitHub issue for any bug or suggestion.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pytest_flask-0.6.3-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 647218259f40f9a0584f89d82c6bb650ee6883bb243fe1ab64ee2bb1eaf17bde |
|
| MD5 | f5343a5b29347bfc37b3ee3a739b7d42 |
|
| BLAKE2b-256 | 9f2e902e3d1adf0e0e3875f8f84b134f8e592312c94376ac5f643d636c1b4dfe |
