Introduction
Doing dirty (but extremely useful) things with equals.
Documentation for version: v0.8.0
dirty-equals is a python library that (mis)uses the __eq__
method to make python code (generally unit tests)
more declarative and therefore easier to read and write.
dirty-equals can be used in whatever context you like, but it comes into its own when writing unit tests for applications where you're commonly checking the response to API calls and the contents of a database.
Usage¶
Here's a trivial example of what dirty-equals can do:
from dirty_equals import IsPositive
assert 1 == IsPositive
assert -2 == IsPositive # this will fail!
Not that interesting yet!, but consider the following unit test code using dirty-equals:
from dirty_equals import IsJson, IsNow, IsPositiveInt, IsStr
def test_user_endpoint(client: 'HttpClient', db_conn: 'Database'):
client.post('/users/create/', data=...)
user_data = db_conn.fetchrow('select * from users')
assert user_data == {
'id': IsPositiveInt,
'username': 'samuelcolvin',
'avatar_file': IsStr(regex=r'/[a-z0-9\-]{10}/example\.png'),
'settings_json': IsJson({'theme': 'dark', 'language': 'en'}),
'created_ts': IsNow(delta=3),
}
Without dirty-equals, you'd have to compare individual fields and/or modify some fields before comparison - the test would not be declarative or as clear.
dirty-equals can do so much more than that, for example:
IsPartialDict
lets you compare a subset of a dictionaryIsStrictDict
lets you confirm order in a dictionaryIsList
andIsTuple
lets you compare partial lists and tuples, with or without order constraints- nesting any of these types inside any others
IsInstance
lets you simply confirm the type of an object- You can even use boolean operators
|
and&
to combine multiple conditions - and much more...
Installation¶
Simply:
dirty-equals requires Python 3.8+.