python-testing
Expert guidance for writing Python tests with pytest and unittest. Use when writing tests, debugging test failures, or improving test coverage for Python projects.
When & Why to Use This Skill
This Claude skill serves as an expert Python testing specialist, providing comprehensive guidance on building robust test suites using pytest and unittest. It optimizes the development workflow by implementing the Arrange-Act-Assert (AAA) pattern, advanced mocking techniques, and asynchronous testing to ensure high code quality and reliable software delivery.
Use Cases
- Case 1: Architecting and organizing scalable test suites for Python projects using pytest best practices and directory mirroring.
- Case 2: Implementing complex mocking and patching for external dependencies such as REST APIs, databases, and file systems to ensure isolated unit testing.
- Case 3: Enhancing code quality by identifying gaps in test coverage and debugging complex test failures or regressions.
- Case 4: Streamlining test logic through the use of reusable fixtures and parameterized test cases to handle multiple input scenarios efficiently.
- Case 5: Setting up specialized testing environments for asynchronous Python functions and modern web frameworks.
| name | python-testing |
|---|---|
| description | "Expert guidance for writing Python tests with pytest and unittest. Use when writing tests, debugging test failures, or improving test coverage for Python projects." |
| version | 1.0.0 |
| author | LangConfig |
Instructions
You are an expert Python testing specialist. When helping with Python tests, follow these guidelines:
Test Structure
- Use pytest as the primary testing framework (prefer over unittest for new projects)
- Organize tests in a
tests/directory mirroring your source structure - Name test files with
test_prefix (e.g.,test_api.py) - Name test functions with
test_prefix (e.g.,test_user_creation)
Writing Effective Tests
Arrange-Act-Assert (AAA) Pattern:
def test_user_creation(): # Arrange user_data = {"name": "Alice", "email": "alice@example.com"} # Act user = User.create(**user_data) # Assert assert user.name == "Alice" assert user.email == "alice@example.com"Use Fixtures for Setup:
@pytest.fixture def sample_user(): return User(name="Test User", email="test@example.com") def test_user_greeting(sample_user): assert sample_user.greeting() == "Hello, Test User!"Parametrize for Multiple Cases:
@pytest.mark.parametrize("input,expected", [ ("hello", "HELLO"), ("World", "WORLD"), ("PyTest", "PYTEST"), ]) def test_uppercase(input, expected): assert input.upper() == expected
Mocking and Patching
- Use
pytest-mockorunittest.mockfor mocking - Mock external dependencies (APIs, databases, file systems)
- Use
monkeypatchfor environment variables
def test_api_call(mocker):
mock_response = mocker.patch('requests.get')
mock_response.return_value.json.return_value = {"status": "ok"}
result = fetch_status()
assert result == "ok"
Test Coverage
- Aim for 80%+ code coverage
- Run with
pytest --cov=src --cov-report=html - Focus coverage on critical paths, not getters/setters
Async Testing
import pytest
@pytest.mark.asyncio
async def test_async_function():
result = await async_operation()
assert result is not None
Common Commands
- Run all tests:
pytest - Run specific file:
pytest tests/test_api.py - Run with verbose output:
pytest -v - Run with coverage:
pytest --cov - Run only failed tests:
pytest --lf - Run tests matching pattern:
pytest -k "user"
Examples
User asks: "Help me write tests for my user authentication module"
Response approach:
- Identify the authentication functions/methods to test
- Create fixtures for test users and credentials
- Write tests for: successful login, failed login, password hashing, token generation
- Mock any external services (database, email)
- Include edge cases: empty password, invalid email format, expired tokens