Merge pull request #240 from seperman/dev

DeepDiff 5.3.0

Author: seperman

AUTHORS.md

@@ -35,3 +35,4 @@ Authors in order of the contributions:
 - Florian Klien [flowolf](https://github.com/flowolf) for adding math_epsilon
 - Tim Klein [timjklein36](https://github.com/timjklein36) for retaining the order of multiple dictionary items added via Delta.
 - Wilhelm Schürmann[wbsch](https://github.com/wbsch) for fixing the typo with yml files.
+- [lyz-code](https://github.com/lyz-code) for adding support for regular expressions.

CHANGELOG.md

@@ -1,5 +1,6 @@
 # DeepDiff Change log
 
+- v5-3-0: add support for regular expressions
 - v5-2-3: Retaining the order of multiple dictionary items added via Delta. Fixed the typo with yml files in deep cli. Fixing Grep RecursionError where using non UTF-8 character. Allowing kwargs to be passed to to_json method.
 - v5-2-2: Fixed Delta serialization when None type is present.
 - v5-2-0: Removed Murmur3 as the preferred hashing method. Using SHA256 by default now. Added commandline for deepdiff. Added group_by. Added math_epsilon. Improved ignoring of NoneType.

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 - 2020 Sep Dehpour (Seperman) and contributors
+Copyright (c) 2014 - 2021 Sep Dehpour (Seperman) and contributors
 www.zepworks.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

README.md

@@ -1,4 +1,4 @@
-# DeepDiff v 5.2.3
+# DeepDiff v 5.3.0
 
 ![Downloads](https://img.shields.io/pypi/dm/deepdiff.svg?style=flat)
 ![Python Versions](https://img.shields.io/pypi/pyversions/deepdiff.svg?style=flat)
@@ -18,8 +18,20 @@ Tested on Python 3.6+ and PyPy3.
 
 **NOTE: The last version of DeepDiff to work on Python 3.5 was DeepDiff 5-0-2**
 
-- [Documentation](https://zepworks.com/deepdiff/5.2.3/)
+- [Documentation](https://zepworks.com/deepdiff/5.3.0/)
 
+## What is new?
+
+Deepdiff 5.3.0 comes with regular expressions in the DeepSearch and grep modules:
+
+```python
+>>> from deepdiff import grep
+>>> from pprint import pprint
+>>> obj = ["something here", {"long": "somewhere", "someone": 2, 0: 0, "somewhere": "around"}]
+>>> ds = obj | grep("some.*", use_regexp=True)
+{ 'matched_paths': ["root[1]['someone']", "root[1]['somewhere']"],
+  'matched_values': ['root[0]', "root[1]['long']"]}
+```
 
 ## Installation
 
@@ -54,13 +66,13 @@ Note: if you want to use DeepDiff via commandline, make sure to run `pip install
 
 DeepDiff gets the difference of 2 objects.
 
-> - Please take a look at the [DeepDiff docs](https://zepworks.com/deepdiff/5.2.3/diff.html)
-> - The full documentation of all modules can be found on <https://zepworks.com/deepdiff/5.2.3/>
+> - Please take a look at the [DeepDiff docs](https://zepworks.com/deepdiff/5.3.0/diff.html)
+> - The full documentation of all modules can be found on <https://zepworks.com/deepdiff/5.3.0/>
 > - Tutorials and posts about DeepDiff can be found on <https://zepworks.com/tags/deepdiff/>
 
 ## A few Examples
 
-> Note: This is just a brief overview of what DeepDiff can do. Please visit <https://zepworks.com/deepdiff/5.2.3/> for full documentation.
+> Note: This is just a brief overview of what DeepDiff can do. Please visit <https://zepworks.com/deepdiff/5.3.0/> for full documentation.
 
 ### List difference ignoring order or duplicates
 
@@ -264,8 +276,8 @@ Example:
 ```
 
 
-> - Please take a look at the [DeepDiff docs](https://zepworks.com/deepdiff/5.2.3/diff.html)
-> - The full documentation can be found on <https://zepworks.com/deepdiff/5.2.3/>
+> - Please take a look at the [DeepDiff docs](https://zepworks.com/deepdiff/5.3.0/diff.html)
+> - The full documentation can be found on <https://zepworks.com/deepdiff/5.3.0/>
 
 
 # Deep Search
@@ -297,17 +309,17 @@ And you can pass all the same kwargs as DeepSearch to grep too:
 {'matched_paths': {"root['somewhere']": 'around'}, 'matched_values': {"root['long']": 'somewhere'}}
 ```
 
-> - Please take a look at the [DeepSearch docs](https://zepworks.com/deepdiff/5.2.3/dsearch.html)
-> - The full documentation can be found on <https://zepworks.com/deepdiff/5.2.3/>
+> - Please take a look at the [DeepSearch docs](https://zepworks.com/deepdiff/5.3.0/dsearch.html)
+> - The full documentation can be found on <https://zepworks.com/deepdiff/5.3.0/>
 
 # Deep Hash
 (New in v4-0-0)
 
 DeepHash is designed to give you hash of ANY python object based on its contents even if the object is not considered hashable!
 DeepHash is supposed to be deterministic in order to make sure 2 objects that contain the same data, produce the same hash.
 
-> - Please take a look at the [DeepHash docs](https://zepworks.com/deepdiff/5.2.3/deephash.html)
-> - The full documentation can be found on <https://zepworks.com/deepdiff/5.2.3/>
+> - Please take a look at the [DeepHash docs](https://zepworks.com/deepdiff/5.3.0/deephash.html)
+> - The full documentation can be found on <https://zepworks.com/deepdiff/5.3.0/>
 
 Let's say you have a dictionary object.
 
@@ -355,8 +367,8 @@ Which you can write as:
 At first it might seem weird why DeepHash(obj)[obj] but remember that DeepHash(obj) is a dictionary of hashes of all other objects that obj contains too.
 
 
-> - Please take a look at the [DeepHash docs](https://zepworks.com/deepdiff/5.2.3/deephash.html)
-> - The full documentation can be found on <https://zepworks.com/deepdiff/5.2.3/>
+> - Please take a look at the [DeepHash docs](https://zepworks.com/deepdiff/5.3.0/deephash.html)
+> - The full documentation can be found on <https://zepworks.com/deepdiff/5.3.0/>
 
 
 # Using DeepDiff in unit tests

deepdiff/__init__.py

@@ -1,6 +1,6 @@
 """This module offers the DeepDiff, DeepSearch, grep, Delta and DeepHash classes."""
 # flake8: noqa
-__version__ = '5.2.3'
+__version__ = '5.3.0'
 import logging
 
 if __name__ == '__main__':

deepdiff/search.py

@@ -4,7 +4,9 @@
 from deepdiff.helper import OrderedSetPlus
 import logging
 
-from deepdiff.helper import strings, numbers, add_to_frozen_set, get_doc, dict_
+from deepdiff.helper import (
+    strings, numbers, add_to_frozen_set, get_doc, dict_, RE_COMPILED_TYPE
+)
 
 logger = logging.getLogger(__name__)
 
@@ -40,6 +42,8 @@ class DeepSearch(dict):
         If True, the value of the object or its children have to exactly match the item.
         If False, the value of the item can be a part of the value of the object or its children
 
+    use_regexp: Boolean, default = False
+
     **Returns**
 
         A DeepSearch object that has the matched paths and matched values.
@@ -83,6 +87,7 @@ def __init__(self,
                  verbose_level=1,
                  case_sensitive=False,
                  match_string=False,
+                 use_regexp=False,
                  **kwargs):
         if kwargs:
             raise ValueError((
@@ -104,6 +109,9 @@ def __init__(self,
             matched_paths=self.__set_or_dict(),
             matched_values=self.__set_or_dict(),
             unprocessed=[])
+        self.use_regexp = use_regexp
+        if self.use_regexp:
+            item = re.compile(item)
 
         # Cases where user wants to match exact string item
         self.match_string = match_string
@@ -135,7 +143,7 @@ def __search_obj(self,
         if obj == item:
             found = True
             # We report the match but also continue inside the match to see if there are
-            # furthur matches inside the `looped` object.
+            # further matches inside the `looped` object.
             self.__report(report_key='matched_values', key=parent, value=obj)
 
         try:
@@ -205,7 +213,8 @@ def __search_dict(self,
 
             str_item = str(item)
             if (self.match_string and str_item == new_parent_cased) or\
-               (not self.match_string and str_item in new_parent_cased):
+               (not self.match_string and str_item in new_parent_cased) or\
+               (self.use_regexp and item.search(new_parent_cased)):
                 self.__report(
                     report_key='matched_paths',
                     key=new_parent,
@@ -233,7 +242,7 @@ def __search_iterable(self,
             else:
                 thing_cased = thing.lower()
 
-            if thing_cased == item:
+            if not self.use_regexp and thing_cased == item:
                 self.__report(
                     report_key='matched_values', key=new_parent, value=thing)
             else:
@@ -248,7 +257,12 @@ def __search_str(self, obj, item, parent):
         """Compare strings"""
         obj_text = obj if self.case_sensitive else obj.lower()
 
-        if (self.match_string and item == obj_text) or (not self.match_string and item in obj_text):
+        is_matched = False
+        if self.use_regexp:
+            is_matched = item.search(obj_text)
+        elif (self.match_string and item == obj_text) or (not self.match_string and item in obj_text):
+            is_matched = True
+        if is_matched:
             self.__report(report_key='matched_values', key=parent, value=obj)
 
     def __search_numbers(self, obj, item, parent):
@@ -270,11 +284,10 @@ def __search_tuple(self, obj, item, parent, parents_ids):
 
     def __search(self, obj, item, parent="root", parents_ids=frozenset()):
         """The main search method"""
-        # import pytest; pytest.set_trace()
         if self.__skip_this(item, parent):
             return
 
-        elif isinstance(obj, strings) and isinstance(item, strings):
+        elif isinstance(obj, strings) and isinstance(item, (strings, RE_COMPILED_TYPE)):
             self.__search_str(obj, item, parent)
 
         elif isinstance(obj, strings) and isinstance(item, numbers):

docs/authors.rst

@@ -42,6 +42,8 @@ Thanks to the following people for their contributions:
 -  Florian Klien `flowolf`_ for adding math_epsilon
 -  Tim Klein `timjklein36`_ for retaining the order of multiple dictionary items added via Delta
 -  Wilhelm Schürmann `wbsch`_ for fixing the typo with yml files.
+-  `lyz_code`_ for adding support for regular expressions.
+
 
 .. _Sep Dehpour (Seperman): http://www.zepworks.com
 .. _Victor Hahn Castell: http://hahncastell.de
@@ -74,6 +76,7 @@ Thanks to the following people for their contributions:
 .. _flowolf: https://github.com/flowolf
 .. _timjklein36: https://github.com/timjklein36
 .. _wbsch: https://github.com/wbsch
+.. _lyz_code: https://github.com/lyz-code
 
 
 Back to :doc:`/index`

docs/changelog.rst

@@ -5,6 +5,7 @@ Changelog
 
 DeepDiff Changelog
 
+- v5-3-0: add support for regular expressions
 - v5-2-3: Retaining the order of multiple dictionary items added via Delta. Fixed the typo with yml files in deep cli. Fixing Grep RecursionError where using non UTF-8 character. Allowing kwargs to be passed to to_json method.
 - v5-2-2: Fixed Delta serialization when None type is present.
 - v5-2-0: Removed Murmur3 as the preferred hashing method. Using SHA256 by default now. Added commandline for deepdiff. Added group_by. Added math_epsilon. Improved ignoring of NoneType.

docs/conf.py

@@ -60,9 +60,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '5.2.3'
+version = '5.3.0'
 # The full version, including alpha/beta/rc tags.
-release = '5.2.3'
+release = '5.3.0'
 
 load_dotenv(override=True)
 DOC_VERSION = os.environ.get('DOC_VERSION', version)

docs/index.rst

@@ -4,7 +4,7 @@
    contain the root `toctree` directive.
 
 
-DeepDiff 5.2.3 documentation!
+DeepDiff 5.3.0 documentation!
 =============================
 
 *****************
@@ -35,6 +35,23 @@ DeepDiff is rigorously tested against Python 3.6, 3.7, 3.8, 3.9 and Pypy3
 
 NOTE: Python 2 is not supported any more. DeepDiff v3.3.0 was the last version to supprt Python 2.
 
+***********
+What is New
+***********
+
+Deepdiff 5.3.0 comes with regular expressions in the DeepSearch and grep modules:
+
+
+.. code:: python
+
+    >>> from deepdiff import grep
+    >>> from pprint import pprint
+    >>> obj = ["something here", {"long": "somewhere", "someone": 2, 0: 0, "somewhere": "around"}]
+    >>> ds = obj | grep("some.*", use_regexp=True)
+    { 'matched_paths': ["root[1]['someone']", "root[1]['somewhere']"],
+      'matched_values': ['root[0]', "root[1]['long']"]}
+
+
 *********
 Tutorials
 *********