---

❓ What

zbiff is a tiny Zig-powered binary and text diff tool. It can compare files byte-by-byte or line-by-line and quickly spot differences. Perfect for text configs, binaries, or even executables.

---

✨ Features

• ⚖️ Compare text files line by line.
• ⚙️ Compare binary/executable files with context around differing bytes.
• 🎯 Detect file types automatically: text, binary, or executable.
• 🛡️ Lightweight, fast, and written entirely in Zig.

---

📦 Installation

1. Make sure you have Zig installed.

2. Clone the repository and build it:

git clone https://github.com/ordinary-hacker/zbiff.git
cd zbiff
zig build

1. That's it, enjoy! You'll find the binary at zig-out/bin/zbiff.

🚦 Usage

./zbiff <file1> <file2> [OPTIONS]

Options

• --stop-at-first Stop at the first difference instead of scanning the whole file
• -h, --help Show help message

🧪 Testing

Some automated tests are included in tests/. You can run them with:

chmod +x tests/run_tests.sh
tests/run_tests.sh

📝 Notes

• Looking forward to adding colored output, patch export, and much more!
• Also looking forward to upgrading performance through async.
• Works best on small to medium files, as the file's contents are loaded full into memory so big files could cause issues.