philiprehberger-dir-snapshot 0.2.0

Filesystem state snapshots with diff comparison

philiprehberger-dir-snapshot

Filesystem state snapshots with diff comparison.

Installation

pip install philiprehberger-dir-snapshot

Usage

Take a Snapshot

from philiprehberger_dir_snapshot import snapshot

snap = snapshot("./src")
print(f"Found {len(snap.files)} files")

Compare Snapshots

before = snapshot("./src")
# ... make changes ...
after = snapshot("./src")

diff = before.diff(after)
print(diff.summary())

for f in diff.added:
    print(f"+ {f.path}")
for f in diff.removed:
    print(f"- {f.path}")
for f in diff.modified:
    print(f"~ {f.path}")

Save and Load

# Save to JSON
before.to_json("snapshot.json")

# Load later
from philiprehberger_dir_snapshot import Snapshot
restored = Snapshot.from_json("snapshot.json")

Options

# Include only Python files
snap = snapshot("./src", include=["*.py"])

# Exclude build artifacts
snap = snapshot(".", exclude=["__pycache__", "*.pyc", ".git"])

# Use faster hashing (or disable with "none")
snap = snapshot(".", hash_mode="md5")

API

• snapshot(path, hash_mode="sha256", include=None, exclude=None) — Create a snapshot
• Snapshot.diff(other) — Compare two snapshots, returns SnapshotDiff
• Snapshot.to_json(path) / Snapshot.from_json(path) — Serialize/deserialize
• SnapshotDiff.summary() — Human-readable diff summary

Development

pip install -e .
python -m pytest tests/ -v

License

MIT