convert-docs 0.1.0__tar.gz → 0.2.0__tar.gz

{convert_docs-0.1.0 → convert_docs-0.2.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: convert-docs
-Version: 0.1.0
+Version: 0.2.0
 Summary: Recursively convert documents (pdf, docx, pptx, xlsx, ...) to Markdown via markitdown, mirroring the source folder structure into a destination folder.
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: markitdown[docx,outlook,pdf,pptx,xls,xlsx]>=0.1.5
 Description-Content-Type: text/markdown
 
@@ -14,11 +14,23 @@ structure into a destination folder.
 
 ## Install
 
+Requires [uv](https://docs.astral.sh/uv/). If you don't have it yet:
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+Then install the tool:
+
 ```bash
 uv tool install convert-docs
 ```
 
-(Or, before it's published to PyPI: `uv tool install git+https://github.com/owenljy/convert-docs`)
+No `uv`? Plain `pip` also works, as long as it's Python 3.10+: `pip install convert-docs`.
 
 ## Usage
 
@@ -34,6 +46,7 @@ Or pass flags to skip the prompts:
 convert-docs -s ~/Documents/Reports -o ~/Documents/Reports_MD
 convert-docs -e pdf,docx        # restrict which extensions get converted
 convert-docs -f                 # force re-conversion, ignoring the up-to-date skip
+convert-docs --last             # re-run with the same source/destination/extensions as last time
 ```
 
 | Flag | Description |
@@ -42,10 +55,20 @@ convert-docs -f                 # force re-conversion, ignoring the up-to-date s
 | `-o, --output` | Output directory, mirrors source structure (skips the interactive prompt) |
 | `-e, --ext` | Comma-separated extensions to convert |
 | `-f, --force` | Force re-conversion even if output `.md` already exists and is up to date |
+| `-l, --last` | Reuse the source, destination, and extensions from the last run (skips prompts; cannot be combined with `-s`/`-o`) |
 
 Files with unsupported extensions are listed at the end instead of being silently
 skipped, and any conversion failures are reported with the underlying error.
 
+### Re-running on new files
+
+Every run saves its source/destination/extensions to `~/.config/convert-docs/last_run.json`.
+Since conversion already skips files whose output is up to date, `convert-docs --last` is a
+cheap way to pick up newly added files in a folder you've converted before — run it manually
+whenever you want to sync, or wire it into a cron job / scheduled task on whatever interval
+suits you (just point it at the tool's full path, e.g. `~/.local/bin/convert-docs --last`,
+since scheduled jobs don't load your shell profile).
+
 ## Update
 
 ```bash

{convert_docs-0.1.0 → convert_docs-0.2.0}/README.md

@@ -6,11 +6,23 @@ structure into a destination folder.
 
 ## Install
 
+Requires [uv](https://docs.astral.sh/uv/). If you don't have it yet:
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+Then install the tool:
+
 ```bash
 uv tool install convert-docs
 ```
 
-(Or, before it's published to PyPI: `uv tool install git+https://github.com/owenljy/convert-docs`)
+No `uv`? Plain `pip` also works, as long as it's Python 3.10+: `pip install convert-docs`.
 
 ## Usage
 
@@ -26,6 +38,7 @@ Or pass flags to skip the prompts:
 convert-docs -s ~/Documents/Reports -o ~/Documents/Reports_MD
 convert-docs -e pdf,docx        # restrict which extensions get converted
 convert-docs -f                 # force re-conversion, ignoring the up-to-date skip
+convert-docs --last             # re-run with the same source/destination/extensions as last time
 ```
 
 | Flag | Description |
@@ -34,10 +47,20 @@ convert-docs -f                 # force re-conversion, ignoring the up-to-date s
 | `-o, --output` | Output directory, mirrors source structure (skips the interactive prompt) |
 | `-e, --ext` | Comma-separated extensions to convert |
 | `-f, --force` | Force re-conversion even if output `.md` already exists and is up to date |
+| `-l, --last` | Reuse the source, destination, and extensions from the last run (skips prompts; cannot be combined with `-s`/`-o`) |
 
 Files with unsupported extensions are listed at the end instead of being silently
 skipped, and any conversion failures are reported with the underlying error.
 
+### Re-running on new files
+
+Every run saves its source/destination/extensions to `~/.config/convert-docs/last_run.json`.
+Since conversion already skips files whose output is up to date, `convert-docs --last` is a
+cheap way to pick up newly added files in a folder you've converted before — run it manually
+whenever you want to sync, or wire it into a cron job / scheduled task on whatever interval
+suits you (just point it at the tool's full path, e.g. `~/.local/bin/convert-docs --last`,
+since scheduled jobs don't load your shell profile).
+
 ## Update
 
 ```bash

{convert_docs-0.1.0 → convert_docs-0.2.0}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "convert-docs"
-version = "0.1.0"
+version = "0.2.0"
 description = "Recursively convert documents (pdf, docx, pptx, xlsx, ...) to Markdown via markitdown, mirroring the source folder structure into a destination folder."
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = [
     "markitdown[pdf,docx,pptx,xlsx,xls,outlook]>=0.1.5",
 ]

{convert_docs-0.1.0 → convert_docs-0.2.0}/src/convert_docs/cli.py

@@ -1,6 +1,8 @@
 """Recursively convert documents to Markdown via markitdown, mirroring folder structure."""
 
 import argparse
+import json
+import os
 import sys
 from pathlib import Path
 
@@ -12,6 +14,45 @@ DEFAULT_EXTENSIONS = [
 SEPARATOR = "-" * 40
 
 
+def config_dir() -> Path:
+    base = os.environ.get("XDG_CONFIG_HOME")
+    return (Path(base) if base else Path.home() / ".config") / "convert-docs"
+
+
+def last_run_path() -> Path:
+    return config_dir() / "last_run.json"
+
+
+def save_last_run(src_dir: Path, dest_dir: Path, extensions: list) -> None:
+    path = last_run_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps({
+        "source": str(src_dir),
+        "destination": str(dest_dir),
+        "extensions": extensions,
+    }, indent=2))
+
+
+def load_last_run() -> dict:
+    path = last_run_path()
+    if not path.exists():
+        print(
+            "Error: no previous run found. Run convert-docs normally first "
+            "(with -s/-o or interactively) before using --last.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    try:
+        return json.loads(path.read_text())
+    except (json.JSONDecodeError, OSError) as exc:
+        print(f"Error: could not read saved config at {path}: {exc}", file=sys.stderr)
+        sys.exit(1)
+
+
+def parse_extensions(raw: str) -> list:
+    return [e.strip().lower().lstrip(".") for e in raw.split(",") if e.strip()]
+
+
 def strip_quotes(text: str) -> str:
     if len(text) >= 2 and text[0] == text[-1] and text[0] in ("'", '"'):
         return text[1:-1]
@@ -51,14 +92,20 @@ def parse_args(argv=None) -> argparse.Namespace:
     )
     parser.add_argument(
         "-e", "--ext",
-        default=",".join(DEFAULT_EXTENSIONS),
-        help="Comma-separated extensions to convert (default: %(default)s)",
+        default=None,
+        help=f"Comma-separated extensions to convert (default: {','.join(DEFAULT_EXTENSIONS)})",
     )
     parser.add_argument(
         "-f", "--force",
         action="store_true",
         help="Force re-conversion even if output .md already exists and is up to date",
     )
+    parser.add_argument(
+        "-l", "--last",
+        action="store_true",
+        help="Reuse the source, destination, and extensions from the last run "
+             "(skips prompts; cannot be combined with -s/-o)",
+    )
     return parser.parse_args(argv)
 
 
@@ -124,16 +171,32 @@ def convert_files(target_files: list, src_dir: Path, dest_dir: Path, force: bool
 
 def main(argv=None) -> int:
     args = parse_args(argv)
-    extensions = [e.strip().lower().lstrip(".") for e in args.ext.split(",") if e.strip()]
 
-    src_dir = resolve_source(args)
-    dest_dir = resolve_destination(args, src_dir)
+    if args.last and (args.source or args.output):
+        print("Error: --last cannot be combined with -s/--source or -o/--output.", file=sys.stderr)
+        return 1
+
+    if args.last:
+        last = load_last_run()
+        src_dir = Path(last["source"])
+        if not src_dir.is_dir():
+            print(f"Error: last-used source directory no longer exists: {src_dir}", file=sys.stderr)
+            return 1
+        src_dir = src_dir.resolve()
+        dest_dir = Path(last["destination"])
+        extensions = parse_extensions(args.ext) if args.ext else last.get("extensions", DEFAULT_EXTENSIONS)
+    else:
+        extensions = parse_extensions(args.ext) if args.ext else DEFAULT_EXTENSIONS
+        src_dir = resolve_source(args)
+        dest_dir = resolve_destination(args, src_dir)
 
     if not dest_dir.exists():
         print(f"Destination does not exist, creating: {dest_dir}")
     dest_dir.mkdir(parents=True, exist_ok=True)
     dest_dir = dest_dir.resolve()
 
+    save_last_run(src_dir, dest_dir, extensions)
+
     print(SEPARATOR)
     print(f"Source folder:      {src_dir}")
     print(f"Destination folder: {dest_dir}")