Struct BinaryGolden 

pub struct BinaryGolden { /* private fields */ }

A binary-content snapshot bound to a path on disk.

Like Golden but for arbitrary byte content. Useful for verifying generated images, archives, encoded protocol frames, etc.

On mismatch, the diff is reported as byte-length deltas and a hex preview of the first differing region — not a line-based diff, because binary content has no meaningful line structure.

Set the DEV_FIXTURES_UPDATE_GOLDEN environment variable to update snapshots on intentional changes.

Example

use dev_fixtures::golden::BinaryGolden;
let dir = tempfile::tempdir().unwrap();
let path = dir.path().join("snap.bin");
std::fs::write(&path, &[0u8, 1, 2, 3]).unwrap();

let g = BinaryGolden::new(&path);
let check = g.compare("frame", &[0u8, 1, 2, 3]);
assert!(matches!(check.verdict, dev_report::Verdict::Pass));

Implementations

impl BinaryGolden

pub fn new(path: impl Into<PathBuf>) -> Self

Build a binary-golden bound to a path on disk.

pub fn path(&self) -> &Path

The path this golden is bound to.

pub fn compare(&self, name: impl AsRef<str>, actual: &[u8]) -> CheckResult

Compare actual against the stored snapshot and emit a CheckResult tagged fixtures and golden.

Verdicts mirror Golden::compare:

• Match -> Pass.
• Missing -> Skip with created tag (snapshot is written).
• Mismatch + DEV_FIXTURES_UPDATE_GOLDEN set -> Skip with updated.
• Mismatch -> Fail (Error) with regression tag, byte-length and first-diff-offset evidence.