aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/python/PyHamcrest/hamcrest/library/collection/is_empty.py
blob: bc99b633730454a162ea8eea957446ad57b4d69d (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
from hamcrest.core.base_matcher import BaseMatcher

__author__ = "Chris Rose"
__copyright__ = "Copyright 2012 hamcrest.org"
__license__ = "BSD, see License.txt"


class IsEmpty(BaseMatcher):

    def matches(self, item, mismatch_description=None):
        try:
            if len(item) == 0:
                return True

            if mismatch_description:
                mismatch_description \
                    .append_text('has %d item(s)' % len(item))

        except TypeError:
            if mismatch_description:
                mismatch_description \
                    .append_text('does not support length')

            return False

    def describe_to(self, description):
        description.append_text('an empty collection')


def empty():
    """
    This matcher matches any collection-like object that responds to the
    __len__ method, and has a length of 0.
    """
    return IsEmpty()