samuelcolvin/dirty-equals

Health v2 · maintenance only

Adoption not part of the score

1004 stars · 54 forks observed · 2026-09-03

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

dirty-equals is a Python library that overloads __eq__ to provide declarative, partial-match assertion helpers for unit tests. It lets you compare values against matchers like IsPositiveInt, IsStr(regex=...), IsJson, and IsNow instead of exact values.

Use cases

• assert API response fields without knowing exact values
• test database row contents declaratively
• match strings against regexes in assertions
• compare JSON strings by decoded value
• check datetimes are close to now in tests
• partially match dicts and lists in pytest

When to choose

• writing pytest unit tests that assert on API responses or DB rows
• you want readable, declarative assertions with partial matching
• you need regex, type, or fuzzy datetime comparisons inside assert statements

When to avoid

• non-Python projects
• production code where magic __eq__ semantics would be confusing
• tests requiring strict exact-value equality only

Facets

library · maturity active

testing developer-tools testing developer-tools python cross-platform pytest unit-testing assertions declarative-tests matchers

Member repositories

For agents

markdown · JSON · MCP: product_card(name="samuelcolvin/dirty-equals")