test-writer

name	test-writer
description	This skill should be used when writing or modifying Python tests. Covers pytest test execution with --reuse-db, function-style tests, factoryboy factories for models, and vcr for external API calls.

Test Writer

Overview

Write pytest tests for the Sleuth codebase following project-specific patterns.

Test Writing Workflow

When writing tests for sleuth/apps/<app>/<module>.py:

1. Find similar tests to copy

   • Look at sleuth/apps/<app>/tests/integration/test_<module>.py for patterns
   • Check other test files in same app for setup patterns

2. Identify required factories

   • Check sleuth/apps/<app>/tests/factories.py for app-specific factories
   • Most tests need OrganizationFactory + <Provider>IntegrationAuthenticationFactory
   • See sleuth/apps/organization/tests/factories.py for core factories

3. Copy existing test structure

   • Use function-style tests with @pytest.mark.asyncio for async code
   • Use vcr() context manager for external API calls
   • Follow naming: test_<function_name>_<scenario>

4. Run tests

   uv run pytest --reuse-db sleuth/apps/<app>/tests/integration/test_<module>.py
   

5. Validate code quality

   make check-types  # Fix mypy/black errors
   make lint-py