Function _diff_text

src/_pytest/assertion/compare_text.py:41–86

Yield the explanation for the diff between text. Unless --verbose is used this will skip leading and trailing characters which are identical to keep the diff minimal.

(
    left: str, right: str, highlighter: _HighlightFunc, verbose: int = 0
)

def _diff_text(
    left: str, right: str, highlighter: _HighlightFunc, verbose: int = 0
) -> Iterator[str]:
    class="st">"""Yield the explanation for the diff between text.

    Unless --verbose is used this will skip leading and trailing
    characters which are identical to keep the diff minimal.
    class="st">"""
    from difflib import ndiff

    if verbose < 1:
        i = 0  class="cm"># just in case left or right has zero length
        for i in range(min(len(left), len(right))):
            if left[i] != right[i]:
                break
        if i > 42:
            i -= 10  class="cm"># Provide some context
            yield fclass="st">"Skipping {i} identical leading characters in diff, use -v to show"
            left = left[i:]
            right = right[i:]
        if len(left) == len(right):
            for i in range(len(left)):
                if left[-i] != right[-i]:
                    break
            if i > 42:
                i -= 10  class="cm"># Provide some context
                yield (
                    fclass="st">"Skipping {i} identical trailing "
                    class="st">"characters in diff, use -v to show"
                )
                left = left[:-i]
                right = right[:-i]
    keepends = True
    if left.isspace() or right.isspace():
        left = repr(str(left))
        right = repr(str(right))
        yield class="st">"Strings contain only whitespace, escaping them using repr()"
    class="cm"># class="st">"right" is the expected base against which we compare class="st">"left",
    class="cm"># see https://github.com/pytest-dev/pytest/issues/3333
    yield from highlighter(
        class="st">"\n".join(
            line.strip(class="st">"\n")
            for line in ndiff(right.splitlines(keepends), left.splitlines(keepends))
        ),
        lexer=class="st">"diff",
    ).splitlines()


def _notin_text(term: str, text: str, verbose: int = 0) -> Iterator[str]: