intermediate changes

ref:cde9a383711a11544ce7e107a78147fb96cc4029

1 files changed, 58 insertions, 0 deletions

diff --git a/contrib/python/PyHamcrest/src/hamcrest/core/description.py b/contrib/python/PyHamcrest/src/hamcrest/core/description.py
new file mode 100644
index 0000000000..6201b7f70f
--- /dev/null
+++ b/contrib/python/PyHamcrest/src/hamcrest/core/description.py
@@ -0,0 +1,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')