aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/python/PyHamcrest/src/hamcrest/library/collection/isdict_containing.py
blob: f24a119cd59c215bdc713b97e99add70c76ec1ca (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
from hamcrest.core.base_matcher import BaseMatcher 
from hamcrest.core.helpers.hasmethod import hasmethod 
from hamcrest.core.helpers.wrap_matcher import wrap_matcher 
 
__author__ = "Jon Reid" 
__copyright__ = "Copyright 2011 hamcrest.org" 
__license__ = "BSD, see License.txt" 
 
 
class IsDictContaining(BaseMatcher): 
 
    def __init__(self, key_matcher, value_matcher): 
        self.key_matcher = key_matcher 
        self.value_matcher = value_matcher 
 
    def _matches(self, dictionary): 
        if hasmethod(dictionary, 'items'): 
            for key, value in dictionary.items(): 
                if self.key_matcher.matches(key) and self.value_matcher.matches(value): 
                    return True 
        return False 
 
    def describe_to(self, description): 
        description.append_text('a dictionary containing [')        \ 
                    .append_description_of(self.key_matcher)        \ 
                    .append_text(': ')                              \ 
                    .append_description_of(self.value_matcher)      \ 
                    .append_text(']') 
 
 
def has_entry(key_match, value_match): 
    """Matches if dictionary contains key-value entry satisfying a given pair 
    of matchers. 
 
    :param key_match: The matcher to satisfy for the key, or an expected value 
        for :py:func:`~hamcrest.core.core.isequal.equal_to` matching. 
    :param value_match: The matcher to satisfy for the value, or an expected 
        value for :py:func:`~hamcrest.core.core.isequal.equal_to` matching. 
 
    This matcher iterates the evaluated dictionary, searching for any key-value 
    entry that satisfies ``key_match`` and ``value_match``. If a matching entry 
    is found, ``has_entry`` is satisfied. 
 
    Any argument that is not a matcher is implicitly wrapped in an 
    :py:func:`~hamcrest.core.core.isequal.equal_to` matcher to check for 
    equality. 
 
    Examples:: 
 
        has_entry(equal_to('foo'), equal_to(1)) 
        has_entry('foo', 1) 
 
    """ 
    return IsDictContaining(wrap_matcher(key_match), wrap_matcher(value_match))