From 01385447262362241e0881e6d296291a4a91f4c8 Mon Sep 17 00:00:00 2001
From: Victor Hahn <victor.hahn@flexoptix.net>
Date: Fri, 19 Aug 2016 17:41:35 +0200
Subject: [PATCH] Prepare for multiple result formats, move text result to
 separate object

---
 .gitignore         |   2 ++
 deepdiff/diff.py   |  50 ++++++++++++++++++---------------------------
 deepdiff/helper.py |  24 ++++++++++++++++++++++
 refdesign.odt      | Bin 0 -> 20450 bytes
 4 files changed, 46 insertions(+), 30 deletions(-)
 create mode 100644 refdesign.odt

diff --git a/.gitignore b/.gitignore
index d8731f78..bed0daa2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -60,3 +60,5 @@ target/
 # Editor / IDE files
 *.swp
 .idea/
+.~lock*
+
diff --git a/deepdiff/diff.py b/deepdiff/diff.py
index ef42e662..e5cb836c 100644
--- a/deepdiff/diff.py
+++ b/deepdiff/diff.py
@@ -8,7 +8,7 @@
 from deepdiff.contenthash import DeepHash
 
 
-class DeepDiff(RemapDict):
+class DeepDiff(ResultDict):
 
     r"""
     **DeepDiff**
@@ -287,34 +287,24 @@ def __init__(self, t1, t2,
             raise ValueError(("The following parameter(s) are not valid: %s\n"
                               "The valid parameters are ignore_order, report_repetition, significant_digits,"
                               "exclude_paths, exclude_types and verbose_level.") % ', '.join(kwargs.keys()))
+
         self.ignore_order = ignore_order
         self.report_repetition = report_repetition
         self.exclude_paths = set(exclude_paths)
         self.exclude_types = set(exclude_types)
         self.exclude_types_tuple = tuple(exclude_types)  # we need tuple for checking isinstance
-        self.verbose_level = verbose_level
         self.hashes = {}
 
         if significant_digits is not None and significant_digits < 0:
             raise ValueError("significant_digits must be None or a non-negative integer")
         self.significant_digits = significant_digits
 
-        self.update({"type_changes": {}, "dictionary_item_added": self.__set_or_dict(),
-                     "dictionary_item_removed": self.__set_or_dict(),
-                     "values_changed": {}, "unprocessed": [], "iterable_item_added": {}, "iterable_item_removed": {},
-                     "attribute_added": self.__set_or_dict(), "attribute_removed": self.__set_or_dict(),
-                     "set_item_removed": set([]),
-                     "set_item_added": set([]), "repetition_change": {}})
+        self.result_text = ResultDict(verbose_level)
 
         self.__diff(t1, t2, parents_ids=frozenset({id(t1)}))
 
-        empty_keys = [k for k, v in getattr(self, items)() if not v]
-
-        for k in empty_keys:
-            del self[k]
-
-    def __set_or_dict(self):
-        return {} if self.verbose_level >= 2 else set()
+        self.result_text.cleanup()   # clean up text-style result dictionary
+        self.update(self.result_text)  # use text style result as default view
 
     def __extend_result_list(self, keys, parent, report_obj, print_as_attribute=False, obj=None):
         """
@@ -345,13 +335,13 @@ def __extend_result_list(self, keys, parent, report_obj, print_as_attribute=Fals
                     report_obj.add(key_in_report)
 
     def __unprocessed(self, parent, t1, t2):
-        self['unprocessed'].append("%s: %s and %s" % (parent, t1, t2))
+        self.result_text['unprocessed'].append("%s: %s and %s" % (parent, t1, t2))
 
     def __values_changed(self, parent, t1, t2, diff=None):
         if diff is not None:
-            self["values_changed"][parent] = RemapDict(old_value=t1, new_value=t2, diff=diff)
+            self.result_text["values_changed"][parent] = RemapDict(old_value=t1, new_value=t2, diff=diff)
         else:
-            self["values_changed"][parent] = RemapDict(old_value=t1, new_value=t2)
+            self.result_text["values_changed"][parent] = RemapDict(old_value=t1, new_value=t2)
 
     @staticmethod
     def __add_to_frozen_set(parents_ids, item_id):
@@ -413,11 +403,11 @@ def __diff_dict(self, t1, t2, parent, parents_ids=frozenset({}), print_as_attrib
 
         if t_keys_added:
             self.__extend_result_list(keys=t_keys_added, parent=parent,
-                                      report_obj=self[item_added_key], print_as_attribute=print_as_attribute, obj=t2)
+                                      report_obj=self.result_text[item_added_key], print_as_attribute=print_as_attribute, obj=t2)
 
         if t_keys_removed:
             self.__extend_result_list(keys=t_keys_removed, parent=parent,
-                                      report_obj=self[item_removed_key], print_as_attribute=print_as_attribute, obj=t1)
+                                      report_obj=self.result_text[item_removed_key], print_as_attribute=print_as_attribute, obj=t1)
 
         self.__diff_common_children(
             t1, t2, t_keys_intersect, print_as_attribute, parents_ids, parent, parent_text)
@@ -459,11 +449,11 @@ def __diff_set(self, t1, t2, parent="root"):
 
         if items_removed:
             self.__extend_result_list(
-                keys=items_removed, parent=parent, report_obj=self["set_item_removed"])
+                keys=items_removed, parent=parent, report_obj=self.result_text["set_item_removed"])
 
         if items_added:
             self.__extend_result_list(
-                keys=items_added, parent=parent, report_obj=self["set_item_added"])
+                keys=items_added, parent=parent, report_obj=self.result_text["set_item_added"])
 
     def __diff_iterable(self, t1, t2, parent="root", parents_ids=frozenset({})):
         """Difference of iterables except dictionaries, sets and strings."""
@@ -493,9 +483,9 @@ def __diff_iterable_subscriptable(self, t1, t2, parent="root", parents_ids=froze
                 self.__diff(x, y, "%s[%s]" % (parent, i), parents_ids_added)
 
         if len(indices_added):
-            self.__extend_result_list(indices_added, parent, self["iterable_item_added"], obj=t2)
+            self.__extend_result_list(indices_added, parent, self.result_text["iterable_item_added"], obj=t2)
         if len(indices_removed):
-            self.__extend_result_list(indices_removed, parent, self["iterable_item_removed"], obj=t1)
+            self.__extend_result_list(indices_removed, parent, self.result_text["iterable_item_removed"], obj=t1)
 
 
     def __diff_str(self, t1, t2, parent):
@@ -581,7 +571,7 @@ def __diff_iterable_with_contenthash(self, t1, t2, parent):
                         new_indexes=t2_indexes,
                         value=t1_item_and_index.item
                     )}
-                    self['repetition_change'].update(repetition_change)
+                    self.result_text['repetition_change'].update(repetition_change)
 
         else:
             items_added = {"%s[%s]" % (parent, t2_hashtable[hash_value].indexes[0]): t2_hashtable[
@@ -590,8 +580,8 @@ def __diff_iterable_with_contenthash(self, t1, t2, parent):
             items_removed = {"%s[%s]" % (parent, t1_hashtable[hash_value].indexes[0]): t1_hashtable[
                 hash_value].item for hash_value in hashes_removed}
 
-        self["iterable_item_removed"].update(items_removed)
-        self["iterable_item_added"].update(items_added)
+        self.result_text["iterable_item_removed"].update(items_removed)
+        self.result_text["iterable_item_added"].update(items_added)
 
     def __diff_numbers(self, t1, t2, parent):
         """Diff Numbers"""
@@ -616,9 +606,9 @@ def __diff_numbers(self, t1, t2, parent):
     def __diff_types(self, t1, t2, parent):
         """Diff types"""
 
-        self["type_changes"][parent] = RemapDict(old_type=type(t1), new_type=type(t2))
-        if self.verbose_level:
-            self["type_changes"][parent].update(old_value=t1, new_value=t2)
+        self.result_text["type_changes"][parent] = RemapDict(old_type=type(t1), new_type=type(t2))
+        if self.result_text.verbose_level:
+            self.result_text["type_changes"][parent].update(old_value=t1, new_value=t2)
 
     def __diff(self, t1, t2, parent="root", parents_ids=frozenset({})):
         """The main diff method"""
diff --git a/deepdiff/helper.py b/deepdiff/helper.py
index 084864ed..0a677701 100644
--- a/deepdiff/helper.py
+++ b/deepdiff/helper.py
@@ -114,3 +114,27 @@ def __getitem__(self, old_key):
             return self.get(new_key)
         else:  # pragma: no cover
             raise KeyError(new_key)
+
+
+class ResultDict(RemapDict):
+    def __init__(self, verbose_level):
+        """
+        Initialize a result dict.
+        """
+        self.verbose_level = verbose_level
+
+        self.update({"type_changes": {}, "dictionary_item_added": self.__set_or_dict(),
+                     "dictionary_item_removed": self.__set_or_dict(),
+                     "values_changed": {}, "unprocessed": [], "iterable_item_added": {}, "iterable_item_removed": {},
+                     "attribute_added": self.__set_or_dict(), "attribute_removed": self.__set_or_dict(),
+                     "set_item_removed": set([]),
+                     "set_item_added": set([]), "repetition_change": {}})
+
+    def cleanup(self):
+        empty_keys = [k for k, v in getattr(self, items)() if not v]
+
+        for k in empty_keys:
+            del self[k]
+
+    def __set_or_dict(self):
+        return {} if self.verbose_level >= 2 else set()
diff --git a/refdesign.odt b/refdesign.odt
new file mode 100644
index 0000000000000000000000000000000000000000..7155d65cdebd3cbc7f1f3ad295a863a86d06bf98
GIT binary patch
literal 20450
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
L0kHgu@doh#dy3%`

literal 0
HcmV?d00001