Fixtures

Fixture	Use for	CSRF handling
`client`	GET requests, public endpoints	Not needed
`csrf_client`	POST, PUT, DELETE requests	Automatic

Fixture

Use for

CSRF handling

client

GET requests, public endpoints

Not needed

csrf_client

POST, PUT, DELETE requests

Automatic

def test_public_page(client): """GET requests use the basic client.""" response = client.get('/health') assert response.status_code == 200 def test_create_item(csrf_client): """POST/PUT/DELETE use csrf_client — the token is automatic.""" response = csrf_client.post('/api/items', json={'name': 'Test'}) assert response.status_code == 201

Adding your own

Extend conftest.py for data several tests need.

tests/conftest.py

import pytest
from models import User, Item

@pytest.fixture
def authenticated_user(app):
    """Create and login a test user."""
    with app.app_context():
        user = User(email='test@example.com', active=True)
        db.session.add(user)
        db.session.commit()

        with app.test_client() as client:
            with client.session_transaction() as sess:
                sess['_user_id'] = user.id
            yield client

@pytest.fixture
def sample_items(app):
    """Create sample items for testing."""
    with app.app_context():
        items = [Item(name=f'Item {i}') for i in range(3)]
        db.session.add_all(items)
        db.session.commit()
        return items

A fixture that holds one app.app_context() open across requests from several test clients resolves every request to the first user loaded. See Test database for why, and the shape that avoids it.

Get started

Building the UI

Backend

Features

Tooling

Testing

Deployment

Adding your own

​Adding your own

Adding your own