tl;dr Equals is a stricter version of Mock.Any.
Equals allows you to assert certain equality constraints between python objects during testing. There are times where we don't want to assert absolute equality, e.g. we need to ensure two lists have the same elements, but don't care about order. This was designed specifically for usage with Mock and dobles.
Full Documentation is available at http://equals.readthedocs.org/en/latest/.
from mock import Mock
from equals import any_dict
test_object = Mock()
test_object.method({'bob': 'barker'})
test_object.method.assert_called_with(any_dict)
from dobles import expect
from equals import any_string
class TestClass(object):
def method(self, arg):
return arg
test_object = TestClass()
expect(test_object).method.with_args(any_string.containing('bob'))
test_object.method('bob barker')
NOTE: These are examples, each of these examples illustrates a way that equals could be used while writing unit tests.
from equals import any_string
any_string.containing('abc') == '123 abc 456'
any_string.starting_with('abc') == 'abcdef'
any_string.ending_with('abc') == '123abc'
any_string.matching('^abc$') == 'abc'
from equals import any_number any_number.less_than(5) == 4 any_number.less_than_or_equal_to(5) == 5 any_number.greater_than(4) == 5 any_number.greater_than_or_equal_to(5) == 5 any_number.between(1, 3) == 2
from equals import any_dict
any_dict.containing(1, 2) == {1: 2, 2:3, 4:5}
any_dict.containing(foo='bar') == {
'foo': 'bar',
'bob': 'barker'
}
any_dict.not_containing(1, foo=5) == {'foo':3, 4:5}
from equals import any_iterable any_iterable.containing(1, 2, 3) == [1, 2, 3, 4, 5] any_iterable.containing_only(1, 2, 3) == [2, 3, 1] any_iterable.not_containing(1, 2) == [3, 4] any_iterable.with_length(2) == [3, 4]
from equals import anything
anything == None
anything == True
anything == {1: 1}
anything_true == 'dd'
anything_false == ''
instance_of(dict) == {}
anything.with_attrs(foo='bar', bob='barker') == Dummy('bar', 'barker')
instance_of(Dummy).with_attrs(foo='bar', bob='barker') == Dummy('bar', 'barker')
>> pip install equals
Source code is available at https://github.com/smartfastlabs/equals.
To install the dependencies on a fresh clone of the repository, run make bootstrap.
To run the test suite, run make test.
To build the documentation locally, run make docs.