pytest-forge

Generate comprehensive pytest unit tests for a Python source file following strict guidelines

Analyze and enhance existing pytest tests for better quality, coverage, and guideline compliance

Configure pytest and coverage tools for the project with 100% coverage threshold

Validate pytest test files for compliance with guidelines and coverage requirements

Use this agent when the user wants to generate, write, or create pytest unit tests for Python source files. This agent specializes in generating comprehensive, production-ready test suites that follow strict pytest conventions and achieve high code coverage. Examples: <example>Context: User has just created a new Python module and wants tests for it. user: "Generate tests for my calculator.py file" assistant: "I'll analyze your calculator.py file and generate comprehensive pytest unit tests." <commentary>User explicitly requested test generation for a specific file - this is the agent's primary purpose.</commentary> assistant: "I'll use the test-generator agent to create comprehensive unit tests for your calculator module."</example> <example>Context: User has modified an existing Python file and the project has a tests/ directory. user: "I just added three new methods to the DataProcessor class" assistant: "I see you've enhanced the DataProcessor class. Would you like me to generate tests for the new methods?" <commentary>Proactive suggestion after code modification in a project with existing test structure.</commentary> assistant: "I'll use the test-generator agent to add test cases for your new methods."</example> <example>Context: User is working on a feature and mentions needing tests. user: "I need to write unit tests for this authentication module" assistant: "I'll create a comprehensive test suite for your authentication module." <commentary>Direct request for test creation - agent should handle full test generation workflow.</commentary> assistant: "I'll use the test-generator agent to generate comprehensive unit tests following best practices."</example> <example>Context: User invokes the generate-tests command through the plugin. user: "/pytest:generate-tests src/utils/validators.py" assistant: "I'll generate pytest tests for your validators module." <commentary>Explicit command invocation - agent should process the specified file and generate corresponding tests.</commentary> assistant: "I'll use the test-generator agent to create tests for the validators module."</example>

Validates that test files do not contain forbidden patterns (assert_called_with, return_value, __main__ tests, etc.). This is a focused validation agent that checks ONLY forbidden patterns.

Validates that test files use SimpleNamespace instead of MagicMock for return objects (HTTP responses, etc.). This is a focused validation agent that checks ONLY mock object usage.

Validates that ALL mocks in test files have mock_calls verification. This is a focused validation agent that checks ONLY mock verification completeness.

Validates that test files use pytest fixtures correctly (capsys instead of mock_print, etc.). This is a focused validation agent that checks ONLY pytest fixture usage.

This skill should be used when the user asks to "write tests", "create tests", "generate tests", "unit tests", "pytest", "test guidelines", "testing rules", "test standards", "how to test", "test this code", "add tests", "validate tests", "check tests", "improve tests", or when working with Python test files. Provides comprehensive guidelines for creating pytest unit tests with 100% coverage following strict naming conventions, mock patterns, and parametrization standards.