Текст и документы

Сравнить два текста и собрать diff

Строит unified diff двух файлов, считает добавленные и удалённые строки и умеет сохранить HTML-отчёт.

Python Windows macOS Linux Средний
Скачать diff_report.py
Описание

Что делает скрипт

Скрипт читает два текстовых файла, сравнивает строки через difflib и выводит обычный unified diff с настраиваемым контекстом. Патч можно сохранить в файл, а для просмотра в браузере доступен HTML с построчной подсветкой. Исходные файлы только читаются, код возврата помогает использовать проверку в CI.

Запуск

Быстрый старт

python diff_report.py old.txt new.txt

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python diff_report.py old.txt new.txt
  • python diff_report.py old.txt new.txt --context 5 --output changes.patch
  • python diff_report.py old.txt new.txt --html diff.html --check
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

diff_report.py

#!/usr/bin/env python3
"""Сравнение двух текстовых файлов и отчёт unified diff."""
from __future__ import annotations

import argparse
import difflib
import sys
from pathlib import Path


def diff_lines(text: str) -> list[str]:
    lines = text.splitlines(keepends=True)
    if lines and not lines[-1].endswith(("\n", "\r")):
        lines[-1] += "\n"
    return lines


def main() -> int:
    parser = argparse.ArgumentParser(description="Сравнить два текста и собрать diff")
    parser.add_argument("old", type=Path, help="Старый файл")
    parser.add_argument("new", type=Path, help="Новый файл")
    parser.add_argument("--context", type=int, default=3, help="Строк контекста")
    parser.add_argument("--output", type=Path, help="Сохранить unified diff")
    parser.add_argument("--html", type=Path, help="Сохранить HTML-отчёт")
    parser.add_argument("--encoding", default="utf-8", help="Кодировка файлов")
    parser.add_argument("--check", action="store_true", help="Код 1 при различиях")
    args = parser.parse_args()

    old_path = args.old.expanduser()
    new_path = args.new.expanduser()
    for path in (old_path, new_path):
        if not path.is_file():
            parser.error(f"Файл не найден: {path}")
    if args.context < 0:
        parser.error("--context не может быть отрицательным")

    inputs = {old_path.resolve(), new_path.resolve()}
    for target in (args.output, args.html):
        if target and target.expanduser().resolve() in inputs:
            parser.error("Отчёт не должен совпадать с входным файлом")

    old_text = old_path.read_text(encoding=args.encoding)
    new_text = new_path.read_text(encoding=args.encoding)
    old_lines = diff_lines(old_text)
    new_lines = diff_lines(new_text)

    diff = list(difflib.unified_diff(
        old_lines,
        new_lines,
        fromfile=str(old_path),
        tofile=str(new_path),
        n=args.context,
    ))
    added = sum(1 for line in diff if line.startswith("+") and not line.startswith("+++"))
    removed = sum(1 for line in diff if line.startswith("-") and not line.startswith("---"))

    if not diff:
        print("Файлы совпадают")
        return 0

    if args.output:
        target = args.output.expanduser()
        target.parent.mkdir(parents=True, exist_ok=True)
        target.write_text("".join(diff), encoding="utf-8")
        print(f"Патч сохранён: {target}", file=sys.stderr)
    else:
        print("".join(diff), end="")

    if args.html:
        html_target = args.html.expanduser()
        html_target.parent.mkdir(parents=True, exist_ok=True)
        report = difflib.HtmlDiff(wrapcolumn=80).make_file(
            old_text.splitlines(),
            new_text.splitlines(),
            fromdesc=str(old_path),
            todesc=str(new_path),
            context=True,
            numlines=args.context,
        )
        html_target.write_text(report, encoding="utf-8")
        print(f"HTML-отчёт: {html_target}", file=sys.stderr)

    print(f"Добавлено строк: {added}, удалено строк: {removed}", file=sys.stderr)
    return 1 if args.check else 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get text-diff-report
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Текст и документы

Поиск, замена, кодировки, Markdown, CSV и работа с большими текстами.