python-pytest-ops
pytest testing patterns for Python. Triggers on: pytest, fixture, mark, parametrize, mock, conftest, test coverage, unit test, integration test, pytest.raises.
Install
npx skills add https://github.com/0xDarkMatter/claude-mods/tree/main/skills/python-pytest-ops
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install 0xdarkmatter-claude-mods@llmmart
git clone https://github.com/0xDarkMatter/claude-mods.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole 0xdarkmatter/claude-mods collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Python pytest Patterns
Modern pytest patterns for effective testing.
Basic Test Structure
import pytest
def test_basic():
"""Simple assertion test."""
assert 1 + 1 == 2
def test_with_description():
"""Descriptive name and docstring."""
result = calculate_total([1, 2, 3])
assert result == 6, "Sum should equal 6"
Fixtures
import pytest
@pytest.fixture
def sample_user():
"""Create test user."""
return {"id": 1, "name": "Test User"}
@pytest.fixture
def db_connection():
"""Fixture with setup and teardown."""
conn = create_connection()
yield conn
conn.close()
def test_user(sample_user):
"""Fixtures injected by name."""
assert sample_user["name"] == "Test User"
Fixture Scopes
@pytest.fixture(scope="function") # Default - per test
@pytest.fixture(scope="class") # Per test class
@pytest.fixture(scope="module") # Per test file
@pytest.fixture(scope="session") # Entire test run
Parametrize
@pytest.mark.parametrize("input,expected", [
(1, 2),
(2, 4),
(3, 6),
])
def test_double(input, expected):
assert double(input) == expected
# Multiple parameters
@pytest.mark.parametrize("x", [1, 2])
@pytest.mark.parametrize("y", [10, 20])
def test_multiply(x, y): # 4 test combinations
assert x * y > 0
Exception Testing
def test_raises():
with pytest.raises(ValueError) as exc_info:
raise ValueError("Invalid input")
assert "Invalid" in str(exc_info.value)
def test_raises_match():
with pytest.raises(ValueError, match=r".*[Ii]nvalid.*"):
raise ValueError("Invalid input")
Markers
@pytest.mark.skip(reason="Not implemented yet")
def test_future_feature():
pass
@pytest.mark.skipif(sys.platform == "win32", reason="Unix only")
def test_unix_feature():
pass
@pytest.mark.xfail(reason="Known bug")
def test_buggy():
assert broken_function() == expected
@pytest.mark.slow
def test_performance():
"""Custom marker - register in pytest.ini."""
pass
Mocking
from unittest.mock import Mock, patch, MagicMock
def test_with_mock():
mock_api = Mock()
mock_api.get.return_value = {"status": "ok"}
result = mock_api.get("/endpoint")
assert result["status"] == "ok"
@patch("module.external_api")
def test_with_patch(mock_api):
mock_api.return_value = {"data": []}
result = function_using_api()
mock_api.assert_called_once()
pytest-mock (Recommended)
def test_with_mocker(mocker):
mock_api = mocker.patch("module.api_call")
mock_api.return_value = {"success": True}
result = process_data()
assert result["success"]
conftest.py
# tests/conftest.py - Shared fixtures
import pytest
@pytest.fixture(scope="session")
def app():
"""Application fixture available to all tests."""
return create_app(testing=True)
@pytest.fixture
def client(app):
"""Test client fixture."""
return app.test_client()
Quick Reference
Run these inside the project env — prefix with uv run (e.g. uv run pytest -v).
Bare pytest is shown below for brevity.
| Command | Description |
|---|---|
pytest |
Run all tests |
pytest -v |
Verbose output |
pytest -x |
Stop on first failure |
pytest -k "test_name" |
Run matching tests |
pytest -m slow |
Run marked tests |
pytest --lf |
Rerun last failed |
pytest --cov=src |
Coverage report |
pytest -n auto |
Parallel (pytest-xdist) |
Additional Resources
./references/fixtures-advanced.md- Factory fixtures, autouse, conftest patterns./references/mocking-patterns.md- Mock, patch, MagicMock, side_effect./references/async-testing.md- pytest-asyncio patterns./references/coverage-strategies.md- pytest-cov, branch coverage, reports./references/integration-testing.md- Database fixtures, API testing, testcontainers./references/property-testing.md- Hypothesis framework, strategies, shrinking./references/test-architecture.md- Test pyramid, organization, isolation strategies
Scripts
./scripts/run-tests.sh- Run tests with recommended options./scripts/generate-conftest.sh- Generate conftest.py boilerplate
Assets
./assets/pytest.ini.template- Recommended pytest configuration./assets/conftest.py.template- Common fixture patterns
See Also
Related Skills:
python-typing-ops- Type-safe test codepython-async-ops- Async test patterns (pytest-asyncio)
Testing specific frameworks:
python-fastapi-ops- TestClient, API testingpython-database-ops- Database fixtures, transactions
Files (claude-mods)
-
assets
-
conftest.py.template 5.7 KB · in bundle
-
pytest.ini.template 996 B · in bundle
-
-
references
-
async-testing.md 6.6 KB
Loading… -
coverage-strategies.md 5.5 KB
Loading… -
fixtures-advanced.md 5.2 KB
Loading… -
integration-testing.md 8.2 KB
Loading… -
mocking-patterns.md 6.6 KB
Loading… -
property-testing.md 8.3 KB
Loading… -
test-architecture.md 8.7 KB
Loading…
-
-
scripts
-
generate-conftest.sh 6.4 KB
Loading… -
run-tests.sh 2 KB
Loading…
-
-
tests
-
run.sh 6.1 KB
Loading…
-
-
SKILL.md 5 KB
--- name: python-pytest-ops description: "pytest testing patterns for Python. Triggers on: pytest, fixture, mark, parametrize, mock, conftest, test coverage, unit test, integration test, pytest.raises." license: MIT compatibility: "pytest 7.0+, Python 3.9+. Some features require pytest-asyncio, pytest-mock, pytest-cov." allowed-tools: "Read Write Bash" metadata: author: claude-mods related-skills: python-typing-ops, python-async-ops --- # Python pytest Patterns Modern pytest patterns for effective testing. ## Basic Test Structure ```python import pytest def test_basic(): """Simple assertion test.""" assert 1 + 1 == 2 def test_with_description(): """Descriptive name and docstring.""" result = calculate_total([1, 2, 3]) assert result == 6, "Sum should equal 6" ``` ## Fixtures ```python import pytest @pytest.fixture def sample_user(): """Create test user.""" return {"id": 1, "name": "Test User"} @pytest.fixture def db_connection(): """Fixture with setup and teardown.""" conn = create_connection() yield conn conn.close() def test_user(sample_user): """Fixtures injected by name.""" assert sample_user["name"] == "Test User" ``` ### Fixture Scopes ```python @pytest.fixture(scope="function") # Default - per test @pytest.fixture(scope="class") # Per test class @pytest.fixture(scope="module") # Per test file @pytest.fixture(scope="session") # Entire test run ``` ## Parametrize ```python @pytest.mark.parametrize("input,expected", [ (1, 2), (2, 4), (3, 6), ]) def test_double(input, expected): assert double(input) == expected # Multiple parameters @pytest.mark.parametrize("x", [1, 2]) @pytest.mark.parametrize("y", [10, 20]) def test_multiply(x, y): # 4 test combinations assert x * y > 0 ``` ## Exception Testing ```python def test_raises(): with pytest.raises(ValueError) as exc_info: raise ValueError("Invalid input") assert "Invalid" in str(exc_info.value) def test_raises_match(): with pytest.raises(ValueError, match=r".*[Ii]nvalid.*"): raise ValueError("Invalid input") ``` ## Markers ```python @pytest.mark.skip(reason="Not implemented yet") def test_future_feature(): pass @pytest.mark.skipif(sys.platform == "win32", reason="Unix only") def test_unix_feature(): pass @pytest.mark.xfail(reason="Known bug") def test_buggy(): assert broken_function() == expected @pytest.mark.slow def test_performance(): """Custom marker - register in pytest.ini.""" pass ``` ## Mocking ```python from unittest.mock import Mock, patch, MagicMock def test_with_mock(): mock_api = Mock() mock_api.get.return_value = {"status": "ok"} result = mock_api.get("/endpoint") assert result["status"] == "ok" @patch("module.external_api") def test_with_patch(mock_api): mock_api.return_value = {"data": []} result = function_using_api() mock_api.assert_called_once() ``` ### pytest-mock (Recommended) ```python def test_with_mocker(mocker): mock_api = mocker.patch("module.api_call") mock_api.return_value = {"success": True} result = process_data() assert result["success"] ``` ## conftest.py ```python # tests/conftest.py - Shared fixtures import pytest @pytest.fixture(scope="session") def app(): """Application fixture available to all tests.""" return create_app(testing=True) @pytest.fixture def client(app): """Test client fixture.""" return app.test_client() ``` ## Quick Reference Run these inside the project env — prefix with `uv run` (e.g. `uv run pytest -v`). Bare `pytest` is shown below for brevity. | Command | Description | |---------|-------------| | `pytest` | Run all tests | | `pytest -v` | Verbose output | | `pytest -x` | Stop on first failure | | `pytest -k "test_name"` | Run matching tests | | `pytest -m slow` | Run marked tests | | `pytest --lf` | Rerun last failed | | `pytest --cov=src` | Coverage report | | `pytest -n auto` | Parallel (pytest-xdist) | ## Additional Resources - `./references/fixtures-advanced.md` - Factory fixtures, autouse, conftest patterns - `./references/mocking-patterns.md` - Mock, patch, MagicMock, side_effect - `./references/async-testing.md` - pytest-asyncio patterns - `./references/coverage-strategies.md` - pytest-cov, branch coverage, reports - `./references/integration-testing.md` - Database fixtures, API testing, testcontainers - `./references/property-testing.md` - Hypothesis framework, strategies, shrinking - `./references/test-architecture.md` - Test pyramid, organization, isolation strategies ## Scripts - `./scripts/run-tests.sh` - Run tests with recommended options - `./scripts/generate-conftest.sh` - Generate conftest.py boilerplate ## Assets - `./assets/pytest.ini.template` - Recommended pytest configuration - `./assets/conftest.py.template` - Common fixture patterns --- ## See Also **Related Skills:** - `python-typing-ops` - Type-safe test code - `python-async-ops` - Async test patterns (pytest-asyncio) **Testing specific frameworks:** - `python-fastapi-ops` - TestClient, API testing - `python-database-ops` - Database fixtures, transactions
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.