python-testing

name	python-testing
description	Python testing patterns with pytest, fixtures, TDD, mocking, async and integration tests. Use when writing or auditing a Python test suite.
globs	**/*.py
alwaysApply	false
category	testing
tags	["python","testing","pytest","tdd","test-automation","quality-assurance"]
tools	[]
usage_patterns	["testing-implementation","test-suite-setup","test-refactoring","ci-cd-integration"]
complexity	intermediate
model_hint	standard
estimated_tokens	900
progressive_loading	true
modules	["modules/unit-testing.md","modules/fixtures-and-mocking.md","modules/test-infrastructure.md","modules/testing-workflows.md","modules/test-quality.md","modules/async-testing.md"]

Python Testing Hub

Testing standards for pytest configuration, fixture management, and TDD implementation.

Table of Contents

1. Quick Start
2. When to Use
3. Modules

Quick Start

1. Dependencies: pip install pytest pytest-cov pytest-asyncio pytest-mock
2. Configuration: Add the following to pyproject.toml:

   [tool.pytest.ini_options]
   testpaths = ["tests"]
   addopts = "--cov=src"
   

3. Verification: Run pytest to confirm discovery of files matching test_*.py.

When To Use

• Constructing unit and integration tests for Python 3.9+ projects.
• Isolating external dependencies using pytest-mock or custom monkeypatching.
• Validating asynchronous logic with pytest-asyncio markers and event loop management.
• Configuring project-wide coverage thresholds and reporting.

When NOT To Use

• Evaluating test quality - use pensive:test-review instead
• Infrastructure test config - use leyline:pytest-config

Modules

This skill uses modular loading to manage the system prompt budget.

Core Implementation

• See modules/unit-testing.md - AAA (Arrange-Act-Assert) pattern, basic test structure, and exception validation.
• See modules/fixtures-and-mocking.md - Request-scoped fixtures, parameterization, and boundary mocking.
• See modules/async-testing.md - Coroutine testing, async fixtures, and concurrency validation.

Infrastructure & Workflow

• See modules/test-infrastructure.md - Directory standards, conftest.py management, and coverage tools.
• See modules/testing-workflows.md - Local execution patterns and GitHub Actions integration.

Standards

• See modules/test-quality.md - Identification of common anti-patterns like broad exception catching or shared state between tests.