python-testing

athola 的头像作者 athola

使用pytest、夹具、模拟和TDD工作流程进行Python测试。

📖 中文导读:使用pytest、夹具、模拟和TDD工作流程进行Python测试。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: python-testing description: |

Triggers: quality-assurance, test-automation, pytest, testing, python Python testing with pytest, fixtures, mocking, and TDD workflows.

Triggers: pytest, unit tests, test fixtures, mocking, TDD, test suite, coverage, test-driven development, testing patterns, parameterized tests, unittest replacement, test coverage, pytest fixtures, async testing, test automation, pytest marks, test mocking, pytest plugins, integration tests, test discovery

Use when: writing unit tests, setting up test suites, implementing TDD, configuring pytest, creating fixtures, async testing, writing integration tests, mocking dependencies, parameterizing tests, setting up CI/CD testing

DO NOT use when: evaluating test quality - use pensive:test-review instead. DO NOT use when: infrastructure test config - use leyline:pytest-config.

Consult this skill for Python testing implementation and patterns. category: testing tags: [python, testing, pytest, tdd, test-automation, quality-assurance] tools: [test-analyzer, coverage-reporter, test-runner] usage_patterns: - testing-implementation - test-suite-setup - test-refactoring - ci-cd-integration complexity: intermediate estimated_tokens: 900 progressive_loading: true modules: - unit-testing - fixtures-and-mocking - test-infrastructure - testing-workflows - test-quality - async-testing

Table of Contents

Python Testing Hub

Testing patterns for pytest, fixtures, mocking, and TDD.

Quick Start

  1. Install pytest and dependencies:

    pip install pytest pytest-cov pytest-asyncio pytest-mock
    
  2. Configure project - Add to pyproject.toml:

    [tool.pytest.ini_options]
    testpaths = ["tests"]
    python_files = ["test_*.py"]
    addopts = "--cov=src --cov-report=html"
    
  3. Create first test - In tests/test_example.py:

    def test_basic():
        assert 1 + 1 == 2
    
  4. Run tests with coverage:

    pytest --cov=src --cov-report=html
    

When to Use

  • Writing unit tests for Python code
  • Setting up test suites and infrastructure
  • Implementing test-driven development (TDD)
  • Creating integration tests for APIs and services
  • Mocking external dependencies and services
  • Testing async code and concurrent operations

Modules

This skill provides focused modules for different testing aspects:

Core Testing

  • unit-testing - Fundamental unit testing patterns with pytest including AAA pattern, basic test structure, and exception testing
  • fixtures-and-mocking - Advanced pytest fixtures, parameterized tests, and mocking patterns for external dependencies
  • async-testing - Testing asynchronous Python code with pytest-asyncio including async fixtures and concurrent operation testing

Infrastructure & Workflow

  • test-infrastructure - Project configuration for pytest including pyproject.toml setup, test directory structure, and coverage configuration
  • testing-workflows - Running tests, CI/CD integration, and automated testing workflows

Quality

  • test-quality - Best practices, anti-patterns to avoid, and quality criteria for Python tests

Progressive Loading

Load modules based on project requirements:

  • Start with unit-testing for fundamental patterns
  • Add fixtures-and-mocking for advanced test setup
  • Include test-infrastructure when setting up new projects
  • Use testing-workflows for CI/CD integration
  • Reference test-quality for best practices
  • Apply async-testing for asynchronous code

Exit Criteria

  • Tests follow AAA pattern
  • Coverage meets project threshold (≥80%)
  • All tests independent and reproducible
  • CI/CD integration configured
  • Clear test naming and organization
  • No anti-patterns present
  • Fixtures used appropriately
  • Mocking only at boundaries

Troubleshooting

Common Issues

If tests aren't found, check that filenames match test_*.py or *_test.py. Use pytest --collect-only to verify discovery. For import errors, ensure the package is installed in editable mode (pip install -e .). If async tests fail, confirm pytest-asyncio is installed and tests use the @pytest.mark.asyncio decorator.