Fix build and EDITOR parsing, add recursive option

Author: roryrjb

README.md

@@ -1,3 +1,87 @@
-# emv
-
-A Python re-write of [vimv](https://github.com/thameera/vimv).
+# emv
+
+A Python re-write of [vimv](https://github.com/thameera/vimv) — bulk rename files by editing their names in your preferred text editor.
+
+## Installation
+
+```bash
+pip install .
+```
+
+Or install in development mode:
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+### Basic — rename files in the current directory
+
+```bash
+emv
+```
+
+This lists all files in the current directory. Edit the names in your editor, save, and close. `emv` renames each file whose name changed.
+
+### Rename specific files
+
+```bash
+emv file1.txt file2.txt image.png
+```
+
+Only the specified files are shown for renaming.
+
+### Recursive mode
+
+```bash
+emv -r
+```
+
+Walks the full directory tree and lists all files with their relative paths. Renaming a path can also **move** a file into a different directory.
+
+### Example workflow
+
+```
+$ ls
+photos/
+  001.jpg
+  002.jpg
+  003.jpg
+
+$ emv photos/*.jpg
+# Editor opens with:
+#   photos/001.jpg
+#   photos/002.jpg
+#   photos/003.jpg
+
+# Edit to:
+#   photos/vacation_001.jpg
+#   photos/vacation_002.jpg
+#   photos/vacation_003.jpg
+
+# Save & close → output:
+# 3 files renamed.
+```
+
+If you add or remove lines (so the number of names doesn't match the original), the operation is aborted with a warning. If a destination file already exists, that file is skipped.
+
+## Editor selection
+
+By default, `emv` opens Notepad. To use a different editor, set the `EDITOR` environment variable:
+
+```bash
+# VS Code (wait flag so the CLI waits for you to close the tab)
+set EDITOR=code -w
+emv
+
+# Vim
+set EDITOR=vim
+emv
+
+# Editor with a quoted path containing spaces
+set EDITOR="C:\Program Files\Notepad++\notepad++.exe" -multiInst
+emv
+```
+
+The value of `EDITOR` is parsed safely to handle quoted paths and command-line flags.

cli.py

@@ -1,4 +1,4 @@
-from emv.emv import main
+from emv import main
 
 if __name__ == "__main__":
-    main()
+    main()

emv/__init__.py

@@ -0,0 +1,77 @@
+import argparse
+import os
+import shlex
+import tempfile
+import subprocess
+import sys
+
+__version__ = "1.1.0"
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Bulk rename files via a text editor.")
+    parser.add_argument(
+        "-V",
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+    parser.add_argument(
+        "-r",
+        "--recursive",
+        action="store_true",
+        help="Recursively list files in the current directory tree.",
+    )
+    parser.add_argument("files", nargs="*", help="Files to rename.")
+    args = parser.parse_args()
+
+    files = args.files
+
+    with tempfile.NamedTemporaryFile(
+        mode="w+t", delete=False, encoding="utf-8"
+    ) as tmpfile:
+        filenames_file = tmpfile.name
+
+        if files:
+            src = files
+        elif args.recursive:
+            src = []
+            for root, _, filenames in os.walk("."):
+                for f in filenames:
+                    path = os.path.relpath(os.path.join(root, f), ".")
+                    src.append(path.replace(os.sep, "/"))
+            src.sort()
+        else:
+            src = [f for f in os.listdir(".") if os.path.isfile(f)]
+        tmpfile.write("\n".join(src))
+
+    editor = os.environ.get("EDITOR", "notepad.exe")
+    editor_cmd = shlex.split(editor) + [filenames_file]
+    subprocess.call(editor_cmd)
+
+    with open(filenames_file, "r", encoding="utf-8") as tmpfile:
+        dest = tmpfile.read().splitlines()
+
+    os.remove(filenames_file)
+
+    if len(src) != len(dest):
+        print(
+            "WARN: Number of files changed. Did you delete a line by accident? Aborting..",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    count = 0
+    for s, d in zip(src, dest):
+        if s != d:
+            dd = os.path.dirname(d)
+
+            if dd:
+                os.makedirs(dd, exist_ok=True)
+            if os.path.exists(d):
+                print(f"SKIP: '{d}' already exists, skipping.", file=sys.stderr)
+                continue
+            os.rename(s, d)
+            count += 1
+
+    print(f"{count} files renamed.")

emv/emv.py

@@ -12,7 +12,7 @@
     packages=find_packages(),
     entry_points={
         "console_scripts": [
-            "emv=emv.emv:main",
+            "emv=emv:main",
         ],
     },
     zip_safe=False,