Сравнить два текста и собрать diff
Строит unified diff двух файлов, считает добавленные и удалённые строки и умеет сохранить HTML-отчёт.
Что делает скрипт
Скрипт читает два текстовых файла, сравнивает строки через 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.txtpython diff_report.py old.txt new.txt --context 5 --output changes.patchpython diff_report.py old.txt new.txt --html diff.html --check
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.