o

(]^h
�@sZdd
lm
Z
mZmZ
ddlmZ
ddlmZ
dZdZ	dZ
ed�
ZGd	d
�d
e
ee�ZdS)�)�Generic�Optional�TypeVar)
�Description�
)
�SelfDescribingzJon ReidzCopyright 2011 hamcrest.orgzBSD, see License.txt�
Tc@sXeZ
dZd
Zd
dedeedefdd�Zdededdfdd	�Z	ded
eddfdd�Z
dS)�Matchera�
A matcher over acceptable values.

    A matcher is able to describe itself to give feedback when it fails.

    Matcher implementations should *not* directly implement this protocol.
    Instead, *extend* the :py:class:`~hamcrest.core.base_matcher.BaseMatcher`
    class, which will ensure that the
    :py:class:`~hamcrest.core.matcher.Matcher` API can grow to support new
    features and remain compatible with all
    :py:class:`~hamcrest.core.matcher.Matcher` implementations.

    N�item�mismatch_description�returncC�td
�
�
)a�
Evaluates the matcher for argument item.

        If a mismatch is detected and argument ``mismatch_description`` is
        provided, it will generate a description of why the matcher has not
        accepted the item.

        :param item: The object against which the matcher is evaluated.
        :param mismatch_description:
        :returns: ``True`` if ``item`` matches, otherwise ``False``.

        �matches�
�NotImplementedError��selfr
r�r�7/usr/lib/python3/dist-packages/hamcrest/core/matcher.pyrszMatcher.matchescCr
)a�
Generates a description of why the matcher has not accepted the
        item.

        The description will be part of a larger description of why a matching
        failed, so it should be concise.

        This method assumes that ``matches(item)`` is ``False``, but will not
        check this.

        :param item: The item that the
            :py:class:`~hamcrest.core.matcher.Matcher` has rejected.
        :param mismatch_description: The description to be built or appended
            to.

        �describe_mismatchrrrrrr*szMatcher.describe_mismatch�match_descriptioncCr
)a�
Generates a description of why the matcher has accepted the item.

        The description may be part of a larger description of why a matching
        failed, so it should be concise.

        This method assumes that ``matches(item)`` is ``True``, but will not
        check this.

        :param item: The item that the
            :py:class:`~hamcrest.core.matcher.Matcher` has accepted.
        :param match_description: The description to be built or appended to.

        �describe_matchr)rr
rrrrr<szMatcher.describe_match)
N)�__name__�
__module__�__qualname__�__doc__rrr�boolrrrrrrrr	s


r	N)
�typingrrr�hamcrest.core.descriptionr�selfdescribingr�
__author__�
__copyright__�__license__rr	rrrr�<module>
s