Skip to content

Commit 538717f

Browse files
committed
DeepDiff 6 docs
1 parent a157021 commit 538717f

File tree

4 files changed

+34
-50
lines changed

4 files changed

+34
-50
lines changed

README.md

Lines changed: 9 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -18,24 +18,13 @@ Tested on Python 3.6+ and PyPy3.
1818

1919
## What is new?
2020

21-
DeepDiff 5-8-2
22-
Fixing dependency for Py3.6
21+
DeepDiff 6-0-0
2322

24-
DeepDiff 5-8-1 includes bug fixes:
25-
- Fixed test suite for 32bit systems (https://github.com/seperman/deepdiff/issues/302) by [Louis-Philippe Véronneau](https://github.com/baldurmen)
26-
- Fixed the issue when using `ignore_order=True` and `group_by` simultaneously
27-
- Added the support for diffing object properties (`@property`) (https://github.com/seperman/deepdiff/issues/312)
28-
- Better support of diffing private variables
23+
- [Exclude obj callback strict](https://github.com/seperman/deepdiff/pull/320/files) parameter is added to DeepDiff by Mikhail Khviyuzov [mskhviyu](https://github.com/mskhviyu).
24+
- A fix for diffing using `iterable_compare_func` with nested objects by [dtorres-sf](https://github.com/dtorres-sf) who originally contributed this feature.
25+
- Temporarily we are publishing DeepDiff under `DeepDiff6` on pypi until further notice.
2926

30-
DeepDiff 5-8-0 includes bug fixes and improvements:
31-
32-
- Fixed the bug with delta randomly not producing the same results when `ignore_order=True` (https://github.com/seperman/deepdiff/issues/277)
33-
- Display detailed pretty when verbose by [Yael Mintz](https://github.com/yaelmi3)
34-
- Allow ordered-set version 4.1.x by [Tal Amuyal](https://github.com/TalAmuyal)
35-
- Removing extra logging when key is not found in DeepHash (https://github.com/seperman/deepdiff/issues/293)
36-
- Fixed error when comparing non-utf8 byte strings with ignore_order=True(https://github.com/seperman/deepdiff/issues/292)
37-
- Fixed Tests fail after 2022-05-14 (https://github.com/seperman/deepdiff/issues/255)
38-
- Fixed [TypeError is thrown when comparing bool and str](https://github.com/seperman/deepdiff/issues/275)
27+
Note: There are no breaking changes in DeepDiff 6 compared to the latest DeepDiff 5 releases.
3928

4029
## Installation
4130

@@ -47,7 +36,10 @@ If you want to use DeepDiff from commandline:
4736

4837
`pip install "deepdiff6[cli]"`
4938

50-
> Note: prior to DeepDiff 6, we used `pip install deepdiff` to install DeepDiff. DeepDiff 6 is being published with a different package name on Pypi temporarily until further notice.
39+
40+
> Note: Prior to DeepDiff 6, it was published under DeepDiff name on pypi.
41+
> DeepDiff 6 is being published under DeepDiff6 package name on Pypi temporarily until further notice.
42+
5143

5244
### Importing
5345

docs/diff_doc.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,10 @@ exclude_obj_callback: function, default = None
5656
A function that takes the object and its path and returns a Boolean. If True is returned, the object is excluded from the results, otherwise it is included.
5757
This is to give the user a higher level of control than one can achieve via exclude_paths, exclude_regex_paths or other means.
5858

59+
exclude_obj_callback_strict: function, default = None
60+
:ref:`exclude_obj_callback_strict_label`
61+
A function that works the same way as exclude_obj_callback, but excludes elements from the result only if the function returns True for both elements
62+
5963
get_deep_distance: Boolean, default = False
6064
:ref:`get_deep_distance_label` will get you the deep distance between objects. The distance is a number between 0 and 1 where zero means there is no diff between the 2 objects and 1 means they are very different. Note that this number should only be used to compare the similarity of 2 objects and nothing more. The algorithm for calculating this number may or may not change in the future releases of DeepDiff.
6165

docs/ignore_types_or_values.rst

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -272,8 +272,14 @@ exclude_obj_callback: function, default = None
272272
>>> DeepDiff(t1, t2, exclude_obj_callback=exclude_obj_callback)
273273
{}
274274

275+
276+
.. _exclude_obj_callback_strict_label:
277+
278+
Exclude Obj Callback Strict
279+
---------------------------
280+
275281
exclude_obj_callback_strict: function, default = None
276-
A function works the same way as exclude_obj_callback, but excludes elements from the result only if the function returns True for both elements
282+
A function that works the same way as exclude_obj_callback, but excludes elements from the result only if the function returns True for both elements
277283

278284
>>> def exclude_obj_callback_strict(obj, path):
279285
... return True if isinstance(obj, int) and obj > 10 else False

docs/index.rst

Lines changed: 14 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -31,37 +31,18 @@ The DeepDiff library includes the following modules:
3131
What is New
3232
***********
3333

34-
DeepDiff 5-8-2
34+
DeepDiff 6-0-0
3535
--------------
36+
- :ref:`exclude_obj_callback_strict_label`
37+
parameter is added to DeepDiff by Mikhail Khviyuzov
38+
`mskhviyu <https://github.com/mskhviyu>`__.
39+
- A fix for diffing using ``iterable_compare_func`` with nested objects
40+
by `dtorres-sf <https://github.com/dtorres-sf>`__ who originally
41+
contributed this feature.
42+
- Temporarily we are publishing DeepDiff under ``DeepDiff6`` on pypi
43+
until further notice.
3644

37-
Fixing dependency for Py3.6
38-
39-
New In DeepDiff 5-8-1
40-
---------------------
41-
42-
DeepDiff 5-8-1 includes bug fixes: - Fixed test suite for 32bit systems
43-
(https://github.com/seperman/deepdiff/issues/302) by `Louis-Philippe
44-
Véronneau`_ - Fixed the issue when using ``ignore_order=True`` and
45-
``group_by`` simultaneously - Added the support for diffing object
46-
properties (``@property``)
47-
(https://github.com/seperman/deepdiff/issues/312) - Better support of
48-
diffing private variables
49-
50-
.. _Louis-Philippe Véronneau: https://github.com/baldurmen
51-
52-
New In DeepDiff 5-8-0
53-
---------------------
54-
55-
DeepDiff 5-8-0 includes bug fixes and improvements:
56-
57-
- Fixed the bug with delta randomly not producing the same results when `ignore_order=True`
58-
- Display detailed pretty when verbose
59-
- Allow ordered-set version 4.1.x
60-
- Removing extra logging when key is not found in DeepHash
61-
- Fixed error when comparing non-utf8 byte strings with ignore_order=True
62-
- Fixed Tests fail after 2022-05-14
63-
- Fixed TypeError is thrown when comparing bool and str
64-
45+
Note: There are no breaking changes in DeepDiff 6 compared to the latest DeepDiff 5 releases.
6546

6647
*********
6748
Tutorials
@@ -83,8 +64,9 @@ If you want to use DeepDiff from commandline::
8364

8465
Read about DeepDiff optimizations at :ref:`optimizations_label`
8566

86-
Note: prior to DeepDiff 6, we used pip install deepdiff to install DeepDiff::
87-
DeepDiff 6 is being published with a different package name on Pypi temporarily until further notice.
67+
.. note:: Prior to DeepDiff 6, it was published under DeepDiff name on pypi.
68+
69+
DeepDiff 6 is being published under DeepDiff6 package name on Pypi temporarily until further notice.
8870

8971

9072
Importing
@@ -99,7 +81,7 @@ Importing
9981
>>> from deepdiff import extract # For extracting a path from an object
10082
10183
102-
Note: if you want to use DeepDiff via commandline, make sure to run::
84+
.. note:: if you want to use DeepDiff via commandline, make sure to run::
10385
pip install "deepdiff6[cli]"
10486

10587
Then you can access the commands via:

0 commit comments

Comments
 (0)