bearcli 1.0.0__py3-none-any.whl

bearcli/actions.py

@@ -0,0 +1,71 @@
+"""Write actions via Bear's x-callback-url scheme.
+
+The database stays strictly read-only; all mutations go through Bear's own
+URL API (which launches the app if needed). Calls are fire-and-forget — Bear
+gives no result back — so callers verify outcomes by re-reading the database.
+"""
+
+from __future__ import annotations
+
+import subprocess
+import time
+from collections.abc import Callable
+from urllib.parse import quote, urlencode
+
+BASE_URL = "bear://x-callback-url/"
+
+
+def call_bear(action: str, foreground: bool = False, **params: str | None) -> None:
+    query = urlencode({k: v for k, v in params.items() if v is not None}, quote_via=quote)
+    # -g keeps Bear in the background instead of stealing focus.
+    cmd = ["open", f"{BASE_URL}{action}?{query}"] if foreground else ["open", "-g", f"{BASE_URL}{action}?{query}"]
+    subprocess.run(cmd, check=True)
+
+
+def create_note(title: str, text: str | None = None, tags: list[str] | None = None) -> None:
+    call_bear(
+        "create",
+        title=title,
+        text=text,
+        tags=",".join(tags) if tags else None,
+        open_note="no",
+        show_window="no",
+    )
+
+
+def add_text(note_id: str, text: str, mode: str = "append") -> None:
+    call_bear("add-text", id=note_id, text=text, mode=mode, open_note="no", show_window="no")
+
+
+def add_file(note_id: str, filename: str, file_b64: str) -> None:
+    call_bear("add-file", id=note_id, filename=filename, file=file_b64, mode="append", open_note="no", show_window="no")
+
+
+def rename_tag(name: str, new_name: str) -> None:
+    call_bear("rename-tag", name=name, new_name=new_name, show_window="no")
+
+
+def delete_tag(name: str) -> None:
+    call_bear("delete-tag", name=name, show_window="no")
+
+
+def open_note(note_id: str, new_window: bool = False) -> None:
+    call_bear("open-note", foreground=True, id=note_id, new_window="yes" if new_window else "no")
+
+
+def trash_note(note_id: str) -> None:
+    call_bear("trash", id=note_id, show_window="no")
+
+
+def archive_note(note_id: str) -> None:
+    call_bear("archive", id=note_id, show_window="no")
+
+
+def wait_for(predicate: Callable[[], bool], timeout: float = 6.0, interval: float = 0.3) -> bool:
+    """Poll until predicate() is true; Bear applies URL actions asynchronously."""
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        if predicate():
+            return True
+        time.sleep(interval)
+    return predicate()