/usr/share/pyshared/hamcrest/core/description.py is in python-hamcrest 1.8.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 55 56 57 58 | __author__ = "Jon Reid"
__copyright__ = "Copyright 2011 hamcrest.org"
__license__ = "BSD, see License.txt"
class Description(object):
"""A description of a :py:class:`~hamcrest.core.matcher.Matcher`.
A :py:class:`~hamcrest.core.matcher.Matcher` will describe itself to a
description which can later be used for reporting.
"""
def append_text(self, text):
"""Appends some plain text to the description.
:returns: ``self``, for chaining
"""
raise NotImplementedError('append_text')
def append_description_of(self, value):
"""Appends description of given value to this description.
If the value implements
:py:meth:`~hamcrest.core.selfdescribing.SelfDescribing.describe_to`,
then it will be used.
:returns: ``self``, for chaining
"""
raise NotImplementedError('append_description_of')
def append_value(self, value):
"""Appends an arbitary value to the description.
**Deprecated:** Call
:py:meth:`~hamcrest.core.description.Description.append_description_of`
instead.
:returns: ``self``, for chaining
"""
raise NotImplementedError('append_value')
def append_list(self, start, separator, end, list):
"""Appends a list of objects to the description.
:param start: String that will begin the list description.
:param separator: String that will separate each object in the
description.
:param end: String that will end the list description.
:param list: List of objects to be described.
:returns: ``self``, for chaining
"""
raise NotImplementedError('append_list')
|