safefile 0.1.0

Transactional file modifications – atomic, rollback on failure

safefile

Atomic, transactional file modifications – automatic rollback on failure.

Protect your files from being left corrupted or inconsistent if your script crashes.

Wrap file-changing code in a with transaction(...) block. If an exception occurs, all protected files are instantly restored to their previous state.

Installation

pip install safefile

Quick start

from safefile import transaction

# Basic protection (copy strategy)
with transaction("config.yaml", "data.csv"):
    update_config("config.yaml")
    update_data("data.csv")
    # If anything crashes, both files roll back.

How it works

• On entering the block, a backup of each existing file is created (using a safe copy).
• If the block completes without an exception, the backups are deleted – changes are committed.
• If an exception is raised, the original files are restored from the backups; newly created files are removed.

License

MIT