Initial commit

src/mirro/main.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+import argparse
+import tempfile
+import subprocess
+import shutil
+import os
+from pathlib import Path
+import time
+import uuid
+
+
+def read_file(path: Path) -> str:
+    if not path.exists():
+        return ""
+    return path.read_text(encoding="utf-8", errors="replace")
+
+def write_file(path: Path, content: str):
+    path.write_text(content, encoding="utf-8")
+
+def backup_original(original_path: Path, original_content: str, backup_dir: Path) -> Path:
+    backup_dir.mkdir(parents=True, exist_ok=True)
+    timestamp = time.strftime("%Y%m%dT%H%M%SZ", time.gmtime())
+    uid = uuid.uuid4().hex[:8]
+    backup_name = f"{original_path.name}.orig.{timestamp}.{uid}.bak"
+    backup_path = backup_dir / backup_name
+    backup_path.write_text(original_content, encoding="utf-8")
+    return backup_path
+
+def main():
+    parser = argparse.ArgumentParser(description="Safely edit a file with automatic original backup if changed.")
+    parser.add_argument("file", type=str, help="Path to file to edit")
+    parser.add_argument("--backup-dir", type=str, default=str(Path.home() / ".local/share/mirro"), help="Backup directory")
+    parser.add_argument("--editor", type=str, default=os.environ.get("EDITOR", "nano"), help="Editor to use")
+
+    args = parser.parse_args()
+
+    target = Path(args.file).expanduser().resolve()
+    backup_dir = Path(args.backup_dir).expanduser().resolve()
+    editor_cmd = args.editor.split()
+
+    # Read original
+    original_content = read_file(target)
+
+    # Temp file for editing
+    with tempfile.NamedTemporaryFile(delete=False, prefix="mirro-", suffix=target.suffix) as tf:
+        temp_path = Path(tf.name)
+    write_file(temp_path, original_content)
+
+
+    # Launch editor
+    subprocess.call(editor_cmd + [str(temp_path)])
+
+
+    # Read edited
+    edited_content = read_file(temp_path)
+    temp_path.unlink(missing_ok=True)
+
+
+    if edited_content == original_content:
+        print("file hasn't changed")
+        return
+
+    # Changed: backup original
+    backup_path = backup_original(target, original_content, backup_dir)
+    print(f"file changed; original backed up at {backup_path}")
+
+    # Overwrite target
+    target.write_text(edited_content, encoding="utf-8")
+
+if __name__ == "__main__":
+    main()