| Current File : //usr/lib/python3/dist-packages/hamcrest/core/__pycache__/matcher.cpython-312.pyc |
�
���eh
� �j � d dl mZmZmZ d dlmZ ddlmZ dZdZ dZ
ed� Z G d � d
ee e� Z y ) � )�Generic�Optional�TypeVar)� Description� )�SelfDescribingzJon ReidzCopyright 2011 hamcrest.orgzBSD, see License.txt�Tc �T � e Zd ZdZd
dedee defd�Zdededdfd�Z dededdfd �Z
y) �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 � � 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
s �7/usr/lib/python3/dist-packages/hamcrest/core/matcher.pyr zMatcher.matches s � � "�)�,�,� c � � t d� �)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 s r r zMatcher.describe_mismatch* s � � "�"5�6�6r �match_descriptionc � � t d� �)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 s r r zMatcher.describe_match< s � � "�"2�3�3r )N) �__name__�
__module__� __qualname__�__doc__r r r �boolr r r � r r r r s[ � � � -�A� -�X�k�5J� -�VZ� -� 7�a� 7�{� 7�t� 7�$4�1� 4�� 4�� 4r r N)
�typingr r r �hamcrest.core.descriptionr �selfdescribingr �
__author__�
__copyright__� __license__r r r! r r �<module>r( s; �� -� -� 1� *�
�
�-�
�$� � �C�L��<4�g�a�j�.� <4r