py-tardiff 0.1

Compare two tarballs and emit a markdown diff report.

tardiff

Compare two tarballs and emit a markdown diff report.

Reports:

• Files present only in A (removed in B)
• Files present only in B (added in B)
• Files in both whose size changed (with absolute and percentage delta)
• Per-tarball totals (file count + total bytes) and the net delta

Supported formats: .tar, .tar.gz/.tgz, .tar.bz2/.tbz2, .tar.xz/.txz (compression is auto-detected).

Install

From PyPI:

pip install py-tardiff

(The distribution name on PyPI is py-tardiff; the import name and CLI are both tardiff.)

From source:

pip install .

Or run without installing, using a one-off environment:

pipx run --spec py-tardiff tardiff OLD.tar.gz NEW.tar.gz

Usage

tardiff OLD.tar.gz NEW.tar.gz              # writes diff.md
tardiff OLD.tar.gz NEW.tar.gz -o report.md # custom output path
python -m tardiff OLD.tar.gz NEW.tar.gz    # equivalent

A short summary is printed to stderr so the command composes in pipelines:

Wrote diff.md: -3 +5 ~12 files, Δ +4096 B

Library use

from pathlib import Path
from tardiff import read_tar, compute_diff, render_report

a = read_tar(Path("old.tar.gz"))
b = read_tar(Path("new.tar.gz"))
diff = compute_diff(a, b)
print(render_report(a, b, diff))

Status

Could be lots better. Filters, ignore small changes, file content diffs, etc.

— Kurt

License

MIT — see LICENSE.