Thanks to visit codestin.com
Credit goes to github.com

Skip to content

bpo-37004: Documented asymmetry of string arguments in difflib.SequenceMatcher for ratio method #13482

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Aug 7, 2019
Merged

bpo-37004: Documented asymmetry of string arguments in difflib.SequenceMatcher for ratio method #13482

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a590a97
Warning that SequenceMatcher.ratio() is not commutative
sweeneyde May 22, 2019
a6ab363
Rephrased SequenceMatcher warning and changed example
sweeneyde May 22, 2019
8f2aab8
removed trailing whitespace
sweeneyde May 22, 2019
0683a5f
📜🤖 Added by blurb_it.
blurb-it[bot] May 22, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions Doc/library/difflib.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -543,6 +543,16 @@ The :class:`SequenceMatcher` class has this constructor:
to try :meth:`quick_ratio` or :meth:`real_quick_ratio` first to get an
upper bound.

.. note::

Caution: The result of a :meth:`ratio` call may depend on the order of
the arguments. For instance::

>>> SequenceMatcher(None, 'tide', 'diet').ratio()
0.25
>>> SequenceMatcher(None, 'diet', 'tide').ratio()
0.5


.. method:: quick_ratio()

Expand Down
1 change: 1 addition & 0 deletions Misc/NEWS.d/next/Documentation/2019-05-22-04-30-07.bpo-37004.BRgxrt.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
In the documentation for difflib, a note was added explicitly warning that the results of SequenceMatcher's ratio method may depend on the order of the input strings.