X-Git-Url: https://git.madduck.net/etc/taskwarrior.git/blobdiff_plain/628b2d244b841be6494b87a14c3f78f0aa1cfc0e..80230e4e58118eaec09b0a83459b8543fbf78260:/tasklib/task.py

diff --git a/tasklib/task.py b/tasklib/task.py
index dc27460..537c792 100644
--- a/tasklib/task.py
+++ b/tasklib/task.py
@@ -78,6 +78,15 @@ class SerializingObject(object):
         not export empty-valued attributes) if the attribute
         is not iterable (e.g. list or set), in which case
         a empty iterable should be used.
+
+    Normalizing methods should hold the following contract:
+      - They are used to validate and normalize the user input.
+        Any attribute value that comes from the user (during Task
+        initialization, assignign values to Task attributes, or
+        filtering by user-provided values of attributes) is first
+        validated and normalized using the normalize_{key} method.
+      - If validation or normalization fails, normalizer is expected
+        to raise ValueError.
     """
 
     def _deserialize(self, key, value):
@@ -424,6 +433,9 @@ class Task(TaskResource):
                           for (key, value) in six.iteritems(kwargs))
         self._original_data = copy.deepcopy(self._data)
 
+        # Provide read only access to the original data
+        self.original = ReadOnlyDictView(self._original_data)
+
     def __unicode__(self):
         return self['description']