Test database

Tests run against a separate test database, configured for you. Each test starts fresh:

Before each test

Tables are created.

After each test

Tables are dropped and the engine is disposed.

One test cannot affect another.

A fixture mistake that is easy to misread

Flask-Login caches the current user on g for the lifetime of an application context. A fixture that holds one app.app_context() open across requests from several test clients resolves every request to the first user loaded. Seed your data inside a context, then make requests outside it:

@pytest.fixture
def seeded(app):
    with app.app_context():
        db.session.add(User(email='a@example.com'))
        db.session.commit()
    # context closed before the test makes any request
    return app

This one is easy to misdiagnose. The symptom is an authorization test that passes for the first user and fails for the second, with no visible difference between them.

Get started

Tutorial: build a Kanban app

Building the UI

Backend

Features

Tooling

Testing

Deployment

A fixture mistake that is easy to misread

​A fixture mistake that is easy to misread

A fixture mistake that is easy to misread