jeeg 2.6.0__tar.gz → 2.7.0__tar.gz

{jeeg-2.6.0 → jeeg-2.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jeeg
-Version: 2.6.0
+Version: 2.7.0
 Summary: Type a task in plain words and it runs. No AI model, no account, no cloud: 400+ everyday tasks that work offline.
 Author: asrbmy
 License: MIT
@@ -22,7 +22,7 @@ Requires-Dist: qrcode[pil]; extra == "extras"
 Requires-Dist: psutil; extra == "extras"
 Dynamic: license-file
 
-# JeeG 2.6.0 - How It Works
+# JeeG 2.7.0 - How It Works
 
 ![JeeG in a terminal](docs/demo.gif)
 
@@ -31,13 +31,13 @@ JeeG finds the matching script in the `scripts` folder and runs it.
 
 - Pure Python 3.9+, nothing to install. Works on Windows, macOS and Linux.
 - Light: about 16 MB of memory, about 65 ms per command, nothing running in the background (except reminders and alarms you set yourself).
-- 431 ready-made tasks. You can add your own by dropping in a file.
+- 440 ready-made tasks. You can add your own by dropping in a file.
 
 ---
 
 ## 1. Quick start
 
-0. Easiest: `pip install jeeg`, then `jeeg setup`. (Or use the folder, below.)
+0. Easiest: `pipx install jeeg` (or `pip install jeeg`), then `jeeg setup`. (Or use the folder, below.)
 1. Install Python 3.9 or newer (python.org). Unzip this folder anywhere.
 2. Open a terminal in the folder and run:
 
@@ -259,6 +259,16 @@ Optional extras for a few of these: `pip install pyzipper pyyaml`.
 | Help yourself | `learn` (tour), `doctor fix`, short forms like `pwd` and `mail` |
 | Privacy | `privacy` lists the few tasks that can go online; see `PRIVACY.md` and `SECURITY.md` |
 
+### New in version 2.7
+
+| Area | Examples |
+|---|---|
+| For other programs | `jeeg --json gst 2500 18`, `jeeg --output result.txt gst 2500 18` |
+| First run | the tour is offered once; `misses export` shares what JeeG did not understand |
+| Money | `lend 500 to ravi`, `borrow 300 from asha`, `ledger`, `settle ravi` |
+| Dates | `add warranty laptop 12 mar 2027`, `add vehicle due insurance bike 15 dec 2026`, `add vaccine asha polio 12 nov 2026`, `what is due` |
+| Personal | `weight 72.5 kg`, `add book Atomic Habits`, `books` |
+
 ## 6. Adding your own task
 
 1. Create a file in `scripts/` named after the task, for example `open_notes_app.py`. The file name is what people will say ("open notes app"), so use words, joined by underscores.
@@ -294,6 +304,15 @@ Helpers you can use inside Python scripts (from `_lib.py`): `args_text()` (the w
 
 ---
 
+## Share a plugin
+
+A plugin is one `.py` file. Make a starter with `jeeg plugin new my_task`, edit it, and try it. To share it:
+
+1. Keep it to the standard library, one file, under 200 KB, and make it say honestly what it does in `# desc:`.
+2. Put it in `library/`, run `python tools/make_library_index.py`, and open a pull request (or use the "Share a plugin" issue template and paste the file).
+3. Others can then add it with `jeeg plugin get my_task`. JeeG checks the fingerprint and shows what the plugin says it does before installing.
+
+
 ## 7. Safety summary
 
 - Dangerous tasks always ask first (see step 6).
@@ -303,7 +322,7 @@ Helpers you can use inside Python scripts (from `_lib.py`): `args_text()` (the w
 - Critical system processes cannot be killed with `kill process`.
 - No task sends your files or personal data anywhere. Web tasks only open a page in your browser.
 
-Security notes (version 2.6.0): only safe link types are opened, archives cannot write outside their folder, backups are validated before import, your data folder is private to you on Mac/Linux, over-long or control-character input is refused, and unexpected errors show one plain line (`JEEG_DEBUG=1` for details). Plugins and `--dir` folders run with your permissions, so only use ones you trust.
+Security notes (version 2.7.0): only safe link types are opened, archives cannot write outside their folder, backups are validated before import, your data folder is private to you on Mac/Linux, over-long or control-character input is refused, and unexpected errors show one plain line (`JEEG_DEBUG=1` for details). Plugins and `--dir` folders run with your permissions, so only use ones you trust.
 
 ## 8. Troubleshooting
 
@@ -329,8 +348,9 @@ Optional extras: `pip install pillow psutil pypdf qrcode[pil]` (screenshots, pro
     python tests/test_cmds.py            update, plugins, setup, completion, the local web page, new tasks
     python tests/test_v26.py             plugin library, sharing, tracking, file tasks, doctor fix, tour
     python tests/test_privacy.py         which files can use the network, documented addresses
+    python tests/test_v27.py             --json/--output, first-run tour, new tasks, speed guard
 
-The folder includes `.github/workflows/test.yml`. If you put this project on GitHub, it runs all seven test files, and builds and installs the pip package, on Windows, macOS and Linux with Python 3.9 and 3.12 on every change, which is the easiest way to find problems on systems you do not have at hand.
+The folder includes `.github/workflows/test.yml`. If you put this project on GitHub, it runs all eight test files, and builds and installs the pip package, on Windows, macOS and Linux with Python 3.9 and 3.12 on every change, which is the easiest way to find problems on systems you do not have at hand.
 
 ## 10. What was and was not tested
 

{jeeg-2.6.0 → jeeg-2.7.0}/README.md

@@ -1,4 +1,4 @@
-# JeeG 2.6.0 - How It Works
+# JeeG 2.7.0 - How It Works
 
 ![JeeG in a terminal](docs/demo.gif)
 
@@ -7,13 +7,13 @@ JeeG finds the matching script in the `scripts` folder and runs it.
 
 - Pure Python 3.9+, nothing to install. Works on Windows, macOS and Linux.
 - Light: about 16 MB of memory, about 65 ms per command, nothing running in the background (except reminders and alarms you set yourself).
-- 431 ready-made tasks. You can add your own by dropping in a file.
+- 440 ready-made tasks. You can add your own by dropping in a file.
 
 ---
 
 ## 1. Quick start
 
-0. Easiest: `pip install jeeg`, then `jeeg setup`. (Or use the folder, below.)
+0. Easiest: `pipx install jeeg` (or `pip install jeeg`), then `jeeg setup`. (Or use the folder, below.)
 1. Install Python 3.9 or newer (python.org). Unzip this folder anywhere.
 2. Open a terminal in the folder and run:
 
@@ -235,6 +235,16 @@ Optional extras for a few of these: `pip install pyzipper pyyaml`.
 | Help yourself | `learn` (tour), `doctor fix`, short forms like `pwd` and `mail` |
 | Privacy | `privacy` lists the few tasks that can go online; see `PRIVACY.md` and `SECURITY.md` |
 
+### New in version 2.7
+
+| Area | Examples |
+|---|---|
+| For other programs | `jeeg --json gst 2500 18`, `jeeg --output result.txt gst 2500 18` |
+| First run | the tour is offered once; `misses export` shares what JeeG did not understand |
+| Money | `lend 500 to ravi`, `borrow 300 from asha`, `ledger`, `settle ravi` |
+| Dates | `add warranty laptop 12 mar 2027`, `add vehicle due insurance bike 15 dec 2026`, `add vaccine asha polio 12 nov 2026`, `what is due` |
+| Personal | `weight 72.5 kg`, `add book Atomic Habits`, `books` |
+
 ## 6. Adding your own task
 
 1. Create a file in `scripts/` named after the task, for example `open_notes_app.py`. The file name is what people will say ("open notes app"), so use words, joined by underscores.
@@ -270,6 +280,15 @@ Helpers you can use inside Python scripts (from `_lib.py`): `args_text()` (the w
 
 ---
 
+## Share a plugin
+
+A plugin is one `.py` file. Make a starter with `jeeg plugin new my_task`, edit it, and try it. To share it:
+
+1. Keep it to the standard library, one file, under 200 KB, and make it say honestly what it does in `# desc:`.
+2. Put it in `library/`, run `python tools/make_library_index.py`, and open a pull request (or use the "Share a plugin" issue template and paste the file).
+3. Others can then add it with `jeeg plugin get my_task`. JeeG checks the fingerprint and shows what the plugin says it does before installing.
+
+
 ## 7. Safety summary
 
 - Dangerous tasks always ask first (see step 6).
@@ -279,7 +298,7 @@ Helpers you can use inside Python scripts (from `_lib.py`): `args_text()` (the w
 - Critical system processes cannot be killed with `kill process`.
 - No task sends your files or personal data anywhere. Web tasks only open a page in your browser.
 
-Security notes (version 2.6.0): only safe link types are opened, archives cannot write outside their folder, backups are validated before import, your data folder is private to you on Mac/Linux, over-long or control-character input is refused, and unexpected errors show one plain line (`JEEG_DEBUG=1` for details). Plugins and `--dir` folders run with your permissions, so only use ones you trust.
+Security notes (version 2.7.0): only safe link types are opened, archives cannot write outside their folder, backups are validated before import, your data folder is private to you on Mac/Linux, over-long or control-character input is refused, and unexpected errors show one plain line (`JEEG_DEBUG=1` for details). Plugins and `--dir` folders run with your permissions, so only use ones you trust.
 
 ## 8. Troubleshooting
 
@@ -305,8 +324,9 @@ Optional extras: `pip install pillow psutil pypdf qrcode[pil]` (screenshots, pro
     python tests/test_cmds.py            update, plugins, setup, completion, the local web page, new tasks
     python tests/test_v26.py             plugin library, sharing, tracking, file tasks, doctor fix, tour
     python tests/test_privacy.py         which files can use the network, documented addresses
+    python tests/test_v27.py             --json/--output, first-run tour, new tasks, speed guard
 
-The folder includes `.github/workflows/test.yml`. If you put this project on GitHub, it runs all seven test files, and builds and installs the pip package, on Windows, macOS and Linux with Python 3.9 and 3.12 on every change, which is the easiest way to find problems on systems you do not have at hand.
+The folder includes `.github/workflows/test.yml`. If you put this project on GitHub, it runs all eight test files, and builds and installs the pip package, on Windows, macOS and Linux with Python 3.9 and 3.12 on every change, which is the easiest way to find problems on systems you do not have at hand.
 
 ## 10. What was and was not tested
 

{jeeg-2.6.0 → jeeg-2.7.0}/jeeg.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jeeg
-Version: 2.6.0
+Version: 2.7.0
 Summary: Type a task in plain words and it runs. No AI model, no account, no cloud: 400+ everyday tasks that work offline.
 Author: asrbmy
 License: MIT
@@ -22,7 +22,7 @@ Requires-Dist: qrcode[pil]; extra == "extras"
 Requires-Dist: psutil; extra == "extras"
 Dynamic: license-file
 
-# JeeG 2.6.0 - How It Works
+# JeeG 2.7.0 - How It Works
 
 ![JeeG in a terminal](docs/demo.gif)
 
@@ -31,13 +31,13 @@ JeeG finds the matching script in the `scripts` folder and runs it.
 
 - Pure Python 3.9+, nothing to install. Works on Windows, macOS and Linux.
 - Light: about 16 MB of memory, about 65 ms per command, nothing running in the background (except reminders and alarms you set yourself).
-- 431 ready-made tasks. You can add your own by dropping in a file.
+- 440 ready-made tasks. You can add your own by dropping in a file.
 
 ---
 
 ## 1. Quick start
 
-0. Easiest: `pip install jeeg`, then `jeeg setup`. (Or use the folder, below.)
+0. Easiest: `pipx install jeeg` (or `pip install jeeg`), then `jeeg setup`. (Or use the folder, below.)
 1. Install Python 3.9 or newer (python.org). Unzip this folder anywhere.
 2. Open a terminal in the folder and run:
 
@@ -259,6 +259,16 @@ Optional extras for a few of these: `pip install pyzipper pyyaml`.
 | Help yourself | `learn` (tour), `doctor fix`, short forms like `pwd` and `mail` |
 | Privacy | `privacy` lists the few tasks that can go online; see `PRIVACY.md` and `SECURITY.md` |
 
+### New in version 2.7
+
+| Area | Examples |
+|---|---|
+| For other programs | `jeeg --json gst 2500 18`, `jeeg --output result.txt gst 2500 18` |
+| First run | the tour is offered once; `misses export` shares what JeeG did not understand |
+| Money | `lend 500 to ravi`, `borrow 300 from asha`, `ledger`, `settle ravi` |
+| Dates | `add warranty laptop 12 mar 2027`, `add vehicle due insurance bike 15 dec 2026`, `add vaccine asha polio 12 nov 2026`, `what is due` |
+| Personal | `weight 72.5 kg`, `add book Atomic Habits`, `books` |
+
 ## 6. Adding your own task
 
 1. Create a file in `scripts/` named after the task, for example `open_notes_app.py`. The file name is what people will say ("open notes app"), so use words, joined by underscores.
@@ -294,6 +304,15 @@ Helpers you can use inside Python scripts (from `_lib.py`): `args_text()` (the w
 
 ---
 
+## Share a plugin
+
+A plugin is one `.py` file. Make a starter with `jeeg plugin new my_task`, edit it, and try it. To share it:
+
+1. Keep it to the standard library, one file, under 200 KB, and make it say honestly what it does in `# desc:`.
+2. Put it in `library/`, run `python tools/make_library_index.py`, and open a pull request (or use the "Share a plugin" issue template and paste the file).
+3. Others can then add it with `jeeg plugin get my_task`. JeeG checks the fingerprint and shows what the plugin says it does before installing.
+
+
 ## 7. Safety summary
 
 - Dangerous tasks always ask first (see step 6).
@@ -303,7 +322,7 @@ Helpers you can use inside Python scripts (from `_lib.py`): `args_text()` (the w
 - Critical system processes cannot be killed with `kill process`.
 - No task sends your files or personal data anywhere. Web tasks only open a page in your browser.
 
-Security notes (version 2.6.0): only safe link types are opened, archives cannot write outside their folder, backups are validated before import, your data folder is private to you on Mac/Linux, over-long or control-character input is refused, and unexpected errors show one plain line (`JEEG_DEBUG=1` for details). Plugins and `--dir` folders run with your permissions, so only use ones you trust.
+Security notes (version 2.7.0): only safe link types are opened, archives cannot write outside their folder, backups are validated before import, your data folder is private to you on Mac/Linux, over-long or control-character input is refused, and unexpected errors show one plain line (`JEEG_DEBUG=1` for details). Plugins and `--dir` folders run with your permissions, so only use ones you trust.
 
 ## 8. Troubleshooting
 
@@ -329,8 +348,9 @@ Optional extras: `pip install pillow psutil pypdf qrcode[pil]` (screenshots, pro
     python tests/test_cmds.py            update, plugins, setup, completion, the local web page, new tasks
     python tests/test_v26.py             plugin library, sharing, tracking, file tasks, doctor fix, tour
     python tests/test_privacy.py         which files can use the network, documented addresses
+    python tests/test_v27.py             --json/--output, first-run tour, new tasks, speed guard
 
-The folder includes `.github/workflows/test.yml`. If you put this project on GitHub, it runs all seven test files, and builds and installs the pip package, on Windows, macOS and Linux with Python 3.9 and 3.12 on every change, which is the easiest way to find problems on systems you do not have at hand.
+The folder includes `.github/workflows/test.yml`. If you put this project on GitHub, it runs all eight test files, and builds and installs the pip package, on Windows, macOS and Linux with Python 3.9 and 3.12 on every change, which is the easiest way to find problems on systems you do not have at hand.
 
 ## 10. What was and was not tested
 

{jeeg-2.6.0 → jeeg-2.7.0}/jeeg.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ scripts/__init__.py
 scripts/_astro.py
 scripts/_backup.py
 scripts/_dates.py
+scripts/_dues.py
 scripts/_files.py
 scripts/_info.py
 scripts/_lib.py
@@ -42,6 +43,7 @@ scripts/backup_info.py
 scripts/battery_status.py
 scripts/binary_hex.py
 scripts/bmi_calculator.py
+scripts/borrow_money.py
 scripts/breach_check.py
 scripts/budget_report.py
 scripts/bulk_rename.py
@@ -159,6 +161,7 @@ scripts/kill_port.py
 scripts/kill_process.py
 scripts/large_files.py
 scripts/large_folders.py
+scripts/lend_money.py
 scripts/life_report.py
 scripts/list_links.py
 scripts/list_routines.py
@@ -335,6 +338,7 @@ scripts/random_choice.py
 scripts/random_fact.py
 scripts/random_number.py
 scripts/rd_maturity.py
+scripts/reading_list.py
 scripts/reading_time.py
 scripts/recent_files.py
 scripts/recipe_lookup.py
@@ -378,6 +382,7 @@ scripts/set_brightness.py
 scripts/set_budget.py
 scripts/set_timer.py
 scripts/set_volume.py
+scripts/settle_ledger.py
 scripts/shopping_add.py
 scripts/shopping_clear.py
 scripts/shopping_list.py
@@ -390,6 +395,7 @@ scripts/show_desktop.py
 scripts/show_env_variables.py
 scripts/show_expenses.py
 scripts/show_ip.py
+scripts/show_ledger.py
 scripts/show_path.py
 scripts/show_reminders.py
 scripts/show_time.py
@@ -443,14 +449,18 @@ scripts/uppercase_text.py
 scripts/url_decode.py
 scripts/url_encode.py
 scripts/usb_devices.py
+scripts/vaccine_tracker.py
+scripts/vehicle_dues.py
 scripts/volume_down.py
 scripts/volume_up.py
+scripts/warranty_tracker.py
 scripts/water_log.py
 scripts/water_reminder.py
 scripts/weather_report.py
 scripts/week_number.py
 scripts/weekday_of.py
 scripts/weekly_summary.py
+scripts/weight_log.py
 scripts/wifi_info.py
 scripts/wiki_summary.py
 scripts/word_frequency.py
@@ -464,4 +474,5 @@ tests/test_parsers.py
 tests/test_privacy.py
 tests/test_routing.py
 tests/test_security.py
-tests/test_v26.py
+tests/test_v26.py
+tests/test_v27.py

{jeeg-2.6.0 → jeeg-2.7.0}/jeeg.py

@@ -27,6 +27,8 @@ Options:
     --dir PATH   extra scripts folder (repeatable; also TASK_SCRIPTS_DIR)
     -y, --yes    do not ask before risky tasks
     --dry-run    show what would run, run nothing
+    --json       print the result as JSON (task, exit code, output) for other programs
+    --output F   save what the task prints to a new file F (never overwrites)
     --timeout S  stop a script after S seconds
 
 Script header (first 15 lines of any script, comment style of that language):
@@ -55,7 +57,7 @@ import sys
 import time
 from pathlib import Path
 
-__version__ = "2.6.0"
+__version__ = "2.7.0"
 
 HERE = Path(__file__).resolve().parent
 def _state_dir() -> Path:
@@ -633,16 +635,38 @@ def log_miss(query: str, why: str) -> None:
     _append_line("misses.log", f"{time.strftime('%Y-%m-%d %H:%M')}\t{why}\t{query}", keep=200, limit=100_000)
 
 
-def cmd_misses() -> int:
+def cmd_misses(sub: str = "") -> int:
+    f = STATE / "misses.log"
+    if sub == "clear":
+        try:
+            f.unlink()
+        except OSError:
+            pass
+        print("Cleared the list of missed phrases.")
+        return 0
     try:
-        lines = (STATE / "misses.log").read_text(encoding="utf-8").splitlines()[-20:]
+        lines = f.read_text(encoding="utf-8").splitlines()
     except OSError:
         lines = []
+    if sub == "export":
+        if not lines:
+            print("Nothing missed so far, so there is nothing to export.")
+            return 1
+        dst = Path.cwd() / "jeeg-misses.txt"
+        if dst.exists():
+            print(f"{dst} already exists; move it first.")
+            return 1
+        rows = [l.split("\t")[-1] for l in lines[-100:]]
+        dst.write_text("Phrases JeeG did not understand (newest last).\nREAD AND EDIT BEFORE SHARING: remove anything personal such as names or numbers.\n"
+                       "Share them as a GitHub issue ('A phrase JeeG did not understand') so they can be taught.\n\n" + "\n".join(rows) + "\n", encoding="utf-8")
+        print(f"Wrote {len(rows)} phrase(s) to {dst}. Nothing was sent anywhere; check the file, then share what you are comfortable with.")
+        return 0
     if not lines:
         print("Nothing missed so far.")
         return 0
     print("Phrases that matched nothing (or were ambiguous). Teach one with:  alias add <short> = <task words>")
-    for l in lines:
+    print("To help improve JeeG: 'misses export' writes them to a file you can review and share; 'misses clear' empties the list.")
+    for l in lines[-20:]:
         print("  " + l.replace("\t", "  "))
     return 0
 
@@ -844,12 +868,27 @@ def run_entry(e: dict, args: list[str], opt: dict) -> int:
         return 0
     safe_preview = any(a.lower() in {"preview", "dry-run", "dryrun"} for a in args)
     if e["confirm"] and not opt["yes"] and not safe_preview:
-        if not sys.stdin.isatty():
+        if not sys.stdin.isatty() or opt.get("quiet"):
             print(f"!! '{label}' needs confirmation; re-run with --yes.")
             return 3
         if input(f"Run '{label}'? [y/N] ").strip().lower() not in {"y", "yes"}:
             print("Cancelled.")
             return 3
+    if opt.get("quiet"):                      # --json / --output: capture what the task prints, no headers
+        t0 = time.perf_counter()
+        try:
+            r = subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8", errors="replace",
+                               timeout=opt["timeout"], stdin=subprocess.DEVNULL)
+            rc, text = r.returncode, (r.stdout or "") + (r.stderr or "")
+        except subprocess.TimeoutExpired:
+            rc, text = 1, f"{label} timed out after {opt['timeout']}s.\n"
+        except OSError as ex:
+            rc, text = 1, f"could not start {label}: {ex}\n"
+        dt = time.perf_counter() - t0
+        log_run(e, rc, dt)
+        opt.setdefault("_tasks", []).append({"name": e["name"], "args": list(args), "exit": rc, "seconds": round(dt, 3)})
+        sys.stdout.write(text if text.endswith("\n") or not text else text + "\n")
+        return 0 if rc == 0 else 1
     print(f">> {label}" + (f"  ({' '.join(args)})" if args else ""))
     t0 = time.perf_counter()
     try:
@@ -934,7 +973,7 @@ def run_query(query: str, entries: list[dict], opt: dict) -> int:
                 return run_query(alt, entries, opt)
         near = did_you_mean(query, entries)
         log_miss(query, "no match")
-        if near and sys.stdin.isatty():
+        if near and sys.stdin.isatty() and not opt.get("quiet"):
             ans = input(f"No exact match. Did you mean '{near[0]}'? [y/N] ").strip().lower()
             if ans in {"y", "yes"}:
                 if len(query.split()) <= 3 and query.lower() not in RESERVED:
@@ -1084,8 +1123,8 @@ def handle(line: str, dirs, opt) -> int | None:
         return cmd_explain(q, entries)
     if low in {"privacy", "what goes online", "network tasks"}:
         return cmd_privacy(entries)
-    if low == "misses":
-        return cmd_misses()
+    if low in {"misses", "misses export", "misses clear"}:
+        return cmd_misses(low.split()[1] if " " in low else "")
     if low == "stats":
         return cmd_stats()
     if low == "doctor":
@@ -1115,8 +1154,55 @@ def handle(line: str, dirs, opt) -> int | None:
     return run_query(expand_alias(q), entries, opt)
 
 
+def offer_tour(dirs, opt) -> None:
+    """The very first time JeeG starts in a terminal, offer the guided tour once."""
+    marker = STATE / ".toured"
+    try:
+        if marker.exists() or not (sys.stdin.isatty() and sys.stdout.isatty()):
+            return
+        _ensure_state()
+        marker.write_text("1", encoding="utf-8")                    # ask only once, whatever the answer
+        ans = input("First time here? Take the 1-minute tour? [Y/n] ").strip().lower()
+        if ans in {"", "y", "yes"}:
+            handle("learn", dirs, opt)
+    except (OSError, EOFError, KeyboardInterrupt):
+        print()
+
+
+def run_captured(line: str, dirs, opt) -> int:
+    """--json / --output: run one line, collect the text, and write it as JSON or to a file."""
+    import contextlib
+    import io
+    buf = io.StringIO()
+    with contextlib.redirect_stdout(buf):
+        rc = handle(line, dirs, opt)
+    rc = 0 if rc is None else rc
+    text = buf.getvalue()
+    if opt["json"]:
+        text = json.dumps({"jeeg": __version__, "input": line, "tasks": opt.get("_tasks", []), "exit": rc, "output": text.rstrip("\n")},
+                          indent=2, ensure_ascii=False) + "\n"
+    if opt["out"]:
+        dest = Path(opt["out"]).expanduser()
+        try:
+            if "\0" in str(dest) or dest.is_dir() or not dest.parent.is_dir():
+                raise OSError("that is not a usable file path")
+            if dest.exists():
+                raise OSError(f"{dest} already exists (JeeG never overwrites; choose another name)")
+            if len(text) > 5_000_000:
+                raise OSError("the output is too large")
+            with open(dest, "x", encoding="utf-8", newline="\n") as fh:
+                fh.write(text)
+        except OSError as ex:
+            print(f"Could not save the output: {ex}")
+            return 1
+        print(f"Saved to {dest}")
+    else:
+        sys.stdout.write(text)
+    return rc
+
+
 def main(argv: list[str]) -> int:
-    opt = {"yes": False, "dry": False, "timeout": None}
+    opt = {"yes": False, "dry": False, "timeout": None, "json": False, "out": None, "quiet": False}
     cli_dirs, words, i = [], [], 0
     while i < len(argv):
         a = argv[i]
@@ -1124,6 +1210,12 @@ def main(argv: list[str]) -> int:
             opt["yes"] = True
         elif a == "--dry-run":
             opt["dry"] = True
+        elif a == "--json":
+            opt["json"] = opt["quiet"] = True
+        elif a == "--output" and i + 1 < len(argv):
+            i += 1
+            opt["out"] = argv[i]
+            opt["quiet"] = True
         elif a == "--dir" and i + 1 < len(argv):
             i += 1
             cli_dirs.append(argv[i])
@@ -1151,8 +1243,13 @@ def main(argv: list[str]) -> int:
         return 1
 
     if words:
+        if opt["quiet"]:
+            return run_captured(" ".join(words), dirs, opt)
         rc = handle(" ".join(words), dirs, opt)
         return 0 if rc is None else rc
+    if opt["quiet"]:
+        print("--json and --output need a task, for example:  jeeg --json gst 2500 18")
+        return 1
 
     try:
         import readline  # noqa: F401  (arrow-key history where available)
@@ -1160,6 +1257,7 @@ def main(argv: list[str]) -> int:
         pass
     n = len(load_index(dirs))
     print(f"JeeG {__version__} - {n} tasks. Say what to do ('list' for help, 'exit' to quit).")
+    offer_tour(dirs, opt)
     nudge_backup()
     while True:
         try:

jeeg-2.7.0/scripts/_dues.py

@@ -0,0 +1,75 @@
+"""Things with a due date (warranties, vehicle papers, vaccines). Not a task."""
+import datetime
+import re
+
+from _dates import parse_date
+from _lib import fail
+from _store import load, save
+
+ADD_RE = re.compile(r"^\s*(?:add|new|save|set|log|renew|record)\b\s*", re.I)
+LIST_RE = re.compile(r"\b(show|list|when|soon|expir\w*|which|what)\b", re.I)
+
+
+def _split(text):
+    """'laptop 12 mar 2027' -> ('laptop', date): the longest tail that reads as a date."""
+    words = text.split()
+    for i in range(1, len(words)):
+        d = parse_date(" ".join(words[i:]))
+        if d:
+            return " ".join(words[:i]).strip(" ,-:").lower(), d
+    return None, None
+
+
+def handle(store, noun, text, drop, example):
+    """One command for add / show / remove. Prints the result."""
+    t = text.strip()
+    items = load(store, [])
+    rm = re.match(r"^\s*(?:remove|delete|forget|clear)\s+(.+)$", t, re.I)
+    if rm:
+        key = " ".join(x for x in rm.group(1).lower().split() if x not in drop)
+        hit = [i for i in items if key and (key in i["name"] or i["name"] in key)]
+        if len(hit) != 1:
+            fail(f"Say which one to remove: {', '.join(i['name'] for i in items) or '(nothing saved yet)'}")
+        items.remove(hit[0])
+        save(store, items)
+        print(f"Removed {hit[0]['name']}.")
+        return
+    is_add = bool(ADD_RE.match(t))
+    body = " ".join(x for x in ADD_RE.sub("", t).split() if x.lower() not in drop)
+    name, d = _split(body) if body else (None, None)
+    if is_add or (name and d and not LIST_RE.search(t)):
+        if not name or not d:
+            fail(f"Usage: add {noun} <what> <date>   e.g. add {noun} {example}")
+        if len(name) > 60:
+            fail("That name is too long.")
+        if len(items) >= 300:
+            fail("That is a lot of entries; remove some first.")
+        items = [i for i in items if i["name"] != name]
+        items.append({"name": name, "date": d.isoformat()})
+        save(store, items)
+        left = (d - datetime.date.today()).days
+        print(f"Saved {name}: {d:%d %b %Y} ({'in ' + str(left) + ' day(s)' if left >= 0 else 'already ' + str(-left) + ' day(s) ago'}).")
+        return
+    if not items:
+        fail(f"Nothing saved yet. Example:  add {noun} {example}")
+    today = datetime.date.today()
+    print(f"{noun.capitalize()} entries, soonest first:")
+    for i in sorted(items, key=lambda x: x["date"]):
+        left = (datetime.date.fromisoformat(i["date"]) - today).days
+        tag = "OVERDUE" if left < 0 else "soon" if left <= 30 else ""
+        when = f"{-left} day(s) ago" if left < 0 else f"in {left} day(s)"
+        print(f"  {i['name']:<26}{i['date']}  {when:<16}{tag}")
+
+
+def due_soon(store, within):
+    """[(name, days_left)] for notifications."""
+    out = []
+    today = datetime.date.today()
+    for i in load(store, []):
+        try:
+            k = (datetime.date.fromisoformat(i["date"]) - today).days
+        except (KeyError, ValueError):
+            continue
+        if k <= within:
+            out.append((i["name"], k))
+    return out

jeeg-2.7.0/scripts/borrow_money.py

@@ -0,0 +1,25 @@
+# keywords: borrow, borrowed, borrow money, i borrowed, i owe, took loan from, money borrowed
+# desc: Note money you borrowed from someone (borrow 300 from asha)
+# category: money
+# usage: borrow <amount> from <name>
+# rawargs: yes
+# private: yes
+# patterns: ^\s*borrow\b ;; \bi\s+borrowed\b ;; \btook\s+(a\s+)?loan\s+from\b
+# priority: 2
+import re, time
+from _lib import args_text, fail
+from _store import load, save
+t = args_text()
+m = re.search(r"(?<![\w.])(\d[\d,]*(?:\.\d{1,2})?)(?![\w])", t)
+if not m: fail("Usage: borrow <amount> from <name>   e.g. borrow 300 from asha")
+amt = float(m.group(1).replace(",", ""))
+rest = (t[:m.start()] + " " + t[m.end():])
+rest = re.sub(r"\b(?:borrow|borrowed|i|rs\.?|inr|rupees?|money|took|loan|from|for|a|the)\b|[₹$]", " ", rest, flags=re.I).split()
+if not rest or not 0 < amt <= 1e9: fail("Usage: borrow <amount> from <name>   e.g. borrow 300 from asha")
+name, note = rest[0].lower()[:30], " ".join(rest[1:])[:60]
+led = load("ledger.json", {})
+p = led.setdefault(name, {"balance": 0.0, "log": []})
+p["balance"] = round(p["balance"] - amt, 2); p["log"] = (p["log"] + [[time.strftime("%Y-%m-%d"), -amt, note]])[-50:]
+save("ledger.json", led)
+b = p["balance"]
+print(f"Noted: you owe {name} {amt:,.2f}. " + (f"Total you owe {name}: {-b:,.2f}." if b < 0 else f"{name} now owes you {b:,.2f}." if b > 0 else "All settled."))

{jeeg-2.6.0 → jeeg-2.7.0}/scripts/git_log.py

@@ -1,5 +1,7 @@
 # keywords: git log, commits, history, recent commits, commit history, last commits
 # desc: Show the last 10 git commits
 # category: developer
+# patterns: ^\s*git\s+log\b ;; \b(recent|last)\s+commits\b
+# priority: 1
 from _lib import call
 raise SystemExit(call(['git', 'log', '-10', '--oneline', '--graph', '--decorate']))

jeeg-2.7.0/scripts/lend_money.py

@@ -0,0 +1,25 @@
+# keywords: lend, lent, lend money, i lent, gave loan to, money lent, owes me
+# desc: Note money you lent to someone (lend 500 to ravi for lunch)
+# category: money
+# usage: lend <amount> to <name> [note]
+# rawargs: yes
+# private: yes
+# patterns: ^\s*lend\b ;; \bi\s+lent\b ;; \bgave\s+(a\s+)?loan\s+to\b
+# priority: 2
+import re, time
+from _lib import args_text, fail
+from _store import load, save
+t = args_text()
+m = re.search(r"(?<![\w.])(\d[\d,]*(?:\.\d{1,2})?)(?![\w])", t)
+if not m: fail("Usage: lend <amount> to <name> [note]   e.g. lend 500 to ravi for lunch")
+amt = float(m.group(1).replace(",", ""))
+rest = (t[:m.start()] + " " + t[m.end():])
+rest = re.sub(r"\b(?:lend|lent|i|rs\.?|inr|rupees?|money|gave|loan|to|for|a|the)\b|[₹$]", " ", rest, flags=re.I).split()
+if not rest or not 0 < amt <= 1e9: fail("Usage: lend <amount> to <name> [note]   e.g. lend 500 to ravi for lunch")
+name, note = rest[0].lower()[:30], " ".join(rest[1:])[:60]
+led = load("ledger.json", {})
+p = led.setdefault(name, {"balance": 0.0, "log": []})
+p["balance"] = round(p["balance"] + amt, 2); p["log"] = (p["log"] + [[time.strftime("%Y-%m-%d"), amt, note]])[-50:]
+save("ledger.json", led)
+b = p["balance"]
+print(f"Noted: {name} owes you {amt:,.2f}. " + (f"Total {name} owes you: {b:,.2f}." if b > 0 else f"You now owe {name} {-b:,.2f}." if b < 0 else "All settled."))