Development
pytest-patterns
Python testing skill using pytest, covering fixtures, parametrize, markers, conftest, plugins, mocking, and advanced testing patterns.
PramodDutta · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add PramodDutta/qaskills --skill pytest-patternsAbout this skill
name: pytest-patterns description: Python testing skill using pytest, covering fixtures, parametrize, markers, conftest, plugins, mocking, and advanced testing patterns. license: MIT metadata: author: thetestingacademy version: 1.0.0 source: https://qaskills.sh/skills/thetestingacademy/pytest-patterns
Pytest Patterns Skill
You are an expert Python developer specializing in testing with pytest. When the user asks you to write, review, or debug pytest tests, follow these detailed instructions.
Core Principles
- Convention over configuration -- pytest discovers tests automatically by naming conventions.
- Fixtures for setup -- Use fixtures instead of setUp/tearDown methods.
- Parametrize for coverage -- Use
@pytest.mark.parametrizefor data-driven tests. - Descriptive test names -- Function names should describe the expected behavior.
- Minimal test scope -- Each test verifies one behavior.
Project Structure
project/
src/
myapp/
__init__.py
services/
user_service.py
order_service.py
models/
user.py
utils/
validators.py
tests/
__init__.py
conftest.py
unit/
__init__.py
test_user_service.py
test_validators.py
integration/
__init__.py
conftest.py
test_user_api.py
fixtures/
user_fixtures.py
pyproject.toml
pytest.ini
Configuration
# pytest.ini
[pytest]
testpaths = tests
python_files = test_*.py
python_classes = Test*
python_functions = test_*
addopts = -v --tb=short --strict-markers
markers =
slow: marks tests as slow (deselect with '-m "not slow"')
integration: marks integration tests
smoke: marks smoke tests
unit: marks unit tests
# pyproject.toml
[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "-v --tb=short --strict-markers --cov=src --cov-report=term-missing"
markers = [
"slow: marks tests as slow",
"integration: marks integration tests",
"smoke: marks smoke tests",
]
[tool.coverage.run]
source = ["src"]
omit = ["tests/*", "*/__init__.py"]
[tool.coverage.report]
fail_under = 80
show_missing = true
Fixtures
Basic Fixtures
# conftest.py
import pytest
from myapp.services.user_service import UserService
from myapp.models.user import User
@pytest.fixture
def sample_user():
"""Create a sample user for testing."""
return User(
id="user-123",
email="test@example.com",
name="Test User",
role="user",
)
@pytest.fixture
def admin_user():
"""Create an admin user for testing."""
return User(
id="admin-123",
email="admin@example.com",
name="Admin User",
role="admin",
)
@pytest.fixture
def user_service(mock_user_repo, mock_email_service):
"""Create UserService with mocked dependencies."""
return UserService(
user_repo=mock_user_repo,
email_service=mock_email_service,
)
Fixture Scopes
@pytest.fixture(scope="session")
def database_connection():
"""Create a database connection once for the entire test session."""
conn = create_connection("test_db")
yield conn
conn.close()
@pytest.fixture(scope="module")
def test_data(database_connection):
"""Seed test data once per module."""
seed_test_data(database_connection)
yield
cleanup_test_data(database_connection)
@pytest.fixture(scope="function") # default scope
def fresh_user():
"""Create a fresh user for each test function."""
return create_user(email=f"test-{uuid4()}@example.com")
@pytest.fixture(scope="class")
def shared_resource():
"""Share a resource across all methods in a test class."""
resource = create_expensive_resource()
yield resource
resource.cleanup()
Fixture Factories
@pytest.fixture
def make_user():
"""Factory fixture that creates users with custom attributes."""
created_users = []
def _make_user(
email: str = None,
name: str = "Test User",
role: str = "user",
) -> User:
user = User(
id=str(uuid4()),
email=email or f"test-{uuid4()}@example.com",
name=name,
role=role,
)
created_users.append(user)
return user
yield _make_user
# Cleanup
for user in created_users:
try:
delete_user(user.id)
except Exception:
pass
# Usage in tests
def test_admin_permissions(make_user):
admin = make_user(role="admin")
viewer = make_user(role="viewer")
assert admin.can_delete_users()
assert not viewer.can_delete_users()
Yield Fixtures (Setup/Teardown)
@pytest.fixture
def temp_file(tmp_path):
"""Create a temporary file and clean up after test."""
file_path = tmp_path / "test_data.json"
file_path.write_text('{"key": "value"}')
yield file_path
# Teardown happens automatically (tmp_path handles cleanup)
@pytest.fixture
def mock_server():
"""Start a mock HTTP server for testing."""
server = MockServer(port=8089)
server.start()
yield server
server.stop()
@pytest.fixture
def db_transaction(database_connection):
"""Wrap each test in a database transaction that rolls back."""
transaction = database_connection.begin()
yield database_connection
transaction.rollback()
Parametrize
Basic Parametrize
@pytest.mark.parametrize("email,expected", [
("user@example.com", True),
("first.last@domain.co.uk", True),
("user+tag@example.com", True),
("", False),
("not-an-email", False),
("@missing-local.com", False),
("missing-at.com", False),
])
def test_is_valid_email(email, expected):
assert is_valid_email(email) == expected
Multiple Parameters
@pytest.mark.parametrize("a,b,expected", [
(1, 2, 3),
(0, 0, 0),
(-1, 1, 0),
(100, 200, 300),
])
def
Read the complete source ↗