pytest-deepassert
A pytest plugin for enhanced assertion reporting with detailed diffs
Decision gist · record as of 2026-08-14
Yes, with conditions. Install if you regularly debug test failures on complex nested data and want clearer diffs without rewriting assertions. The low install friction and permissive license make it a safe experiment. However, the aging maintenance status (283 days since last release, 11 stars) means the project has limited community traction and may not receive timely fixes; use it in projects where you can tolerate slower response to issues. The opt-in flag design means you can enable it selectively without affecting existing test suites.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires pytest 6.0+ and Python 3.8+; the plugin is opt-in via the --deepassert flag and does not activate by default.
- Low friction: pure Python wheel with only three runtime dependencies (deepdiff, pytest, typing-extensions).
- Maintenance status is aging—last release was 283 days ago and the project has 11 stars—so expect infrequent updates and limited community validation.
License · maintenance · safety
MIT (permissive) — MIT license (permissive): you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.
last release 2025-11-04 (283 days) · last repo commit 2025-11-04 · 11 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 133,296 downloads/mo, #11,522 on PyPI
Alternatives
Verify before relying
pip install pytest-deepassert
# In your test file:
import pytest
def test_example():
expected = {"name": "Alice", "age": 30}
actual = {"name": "Bob", "age": 30}
assert expected == actual
# Run with: pytest --deepassert your_test.py- How well does the plugin handle pytest.approx() and mock.ANY in practice across different data nesting levels?
- What is the performance impact on test suites with very large nested structures?
- Are there known limitations or edge cases with custom comparator utilities beyond what the description lists?
What it is and what it does
pytest-deepassert is a pytest plugin that intercepts assertion failures and replaces the default comparison output with structured, readable diffs generated by deepdiff. When you enable it with the --deepassert flag, any failed assertion on complex data structures—dictionaries, lists, nested objects, custom types—shows you exactly which fields differ, what values changed, and where items were added or removed, rather than dumping a wall of text that requires manual parsing.
The plugin is designed as an opt-in enhancement: it does not interfere with normal pytest behavior unless you explicitly pass --deepassert at runtime. It handles basic types (int, string, float, bool), collections (dict, list, tuple, set, frozenset), and advanced types (OrderedDict, NamedTuple, custom objects), and claims to work with pytest.approx() and mock.ANY for flexible comparisons. The implementation depends on deepdiff for the heavy lifting, pytest for the plugin interface, and typing-extensions for compatibility.
Use it for
- Debugging test failures on API responses or database records where only a few nested fields differ from expected.
- Comparing large configuration dictionaries or JSON payloads where visual diff clarity matters more than raw output.
- Testing mock objects with ANY placeholders or approximate float comparisons that standard assertions struggle to report clearly.
- Reducing time spent reading assertion diffs in CI logs by getting a structured, path-based view of what changed.
- Validating complex domain objects or data transfer objects where the structure is deeply nested and changes are subtle.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
Install if you regularly debug test failures on complex nested data and want clearer diffs without rewriting assertions. The low install friction and permissive license make it a safe experiment. However, the aging maintenance status (283 days since last release, 11 stars) means the project has limited community traction and may not receive timely fixes; use it in projects where you can tolerate slower response to issues. The opt-in flag design means you can enable it selectively without affecting existing test suites.
Install
pytest-deepassert on PyPI
Before you install
Low friction: pure Python wheel with only three runtime dependencies (deepdiff, pytest, typing-extensions). Maintenance status is aging—last release was 283 days ago and the project has 11 stars—so expect infrequent updates and limited community validation.
Requires pytest 6.0+ and Python 3.8+; the plugin is opt-in via the --deepassert flag and does not activate by default.
License in practice
MIT license (permissive): you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.
Quickstart
pip install pytest-deepassert
# In your test file:
import pytest
def test_example():
expected = {"name": "Alice", "age": 30}
actual = {"name": "Bob", "age": 30}
assert expected == actual
# Run with: pytest --deepassert your_test.pyVerify before relying
- How well does the plugin handle pytest.approx() and mock.ANY in practice across different data nesting levels?
- What is the performance impact on test suites with very large nested structures?
- Are there known limitations or edge cases with custom comparator utilities beyond what the description lists?
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesdeepdiffpytesttyping-extensions |
| Maintenance | Aging 283 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 133,296 / month, #11,522 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaFramework :: PytestIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: DebuggersTopic :: Software Development :: Testing |
Evidence: pytest_deepassert-0.3.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “detailed test failure output”
- pytest-deepassertA pytest plugin that replaces standard assertion failures with…
- testtoolstesttools extends Python's standard unittest framework with custom…
- pytest-html-reporterGenerates static HTML test reports from pytest test runs, with…
Give your agent the search over MCP, or paste the wish link into any chat.
More Testing packages
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
virtualenv creates isolated Python environments where packages can be installed independently without affecting the system Python or other projects.
Coverage.py measures which lines of Python code are executed during test runs, reporting coverage percentages and identifying untested code paths.
Install it if you want to measure test completeness or enforce coverage thresholds in your project.
pytest-asyncio is a pytest plugin that enables writing and running async test functions using the asyncio library, allowing developers to await code directly within test cases.
Install it if you write tests for any asyncio-based code.
A pytest plugin that generates test reports in Common Test Report Format (CTRF) as JSON, compatible with pytest-xdist and pytest-playwright for distributed and browser-based testing.
Install it if you need CTRF-formatted test output for CI/CD integration or cross-tool reporting.
See also pytest-assume · pytest-clarity · re-assert · pytest-check · deepdiff · deepdiff6 · pytest-parametrization · pytest-unordered · asserts · snob-lib