o
    (]^h
  ã                   @   sZ   d dl mZmZmZ d dlmZ ddlmZ dZdZ	dZ
edƒZG d	d
„ d
ee eƒZdS )é    )ÚGenericÚOptionalÚTypeVar)ÚDescriptioné   )ÚSelfDescribingzJon ReidzCopyright 2011 hamcrest.orgzBSD, see License.txtÚTc                   @   sX   e Zd ZdZddedee defdd„Zdededdfdd	„Z	ded
eddfdd„Z
dS )Ú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Úreturnc                 C   ó   t dƒ‚)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.pyr      s   zMatcher.matchesc                 C   r   )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_mismatchr   r   r   r   r   r   *   s   zMatcher.describe_mismatchÚmatch_descriptionc                 C   r   )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   )r   r
   r   r   r   r   r   <   s   zMatcher.describe_match)N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   Úboolr   r   r   r   r   r   r   r	      s
    r	   N)Útypingr   r   r   Zhamcrest.core.descriptionr   Zselfdescribingr   Ú
__author__Z__copyright__Z__license__r   r	   r   r   r   r   Ú<module>   s    