hap-cli 0.6.10__tar.gz → 0.7.0__tar.gz

{hap_cli-0.6.10 → hap_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.6.10
+Version: 0.7.0
 Summary: CLI harness for MingDAO HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0
@@ -71,7 +71,7 @@ hap auth logout        # clear the saved token
 
 ```bash
 hap auth list-my-orgs                # current org marked with *
-hap auth switch-org ORG_ID           # switch the saved current org
+hap auth set-current-org ORG_ID           # switch the saved current org
 hap app list                         # uses the saved current org
 hap app list --org-id ORG_ID         # explicit override
 
@@ -80,7 +80,7 @@ hap app select APP_ID
 hap app unselect                     # clear it
 ```
 
-`hap auth switch-org` only changes the default organization. The default app
+`hap auth set-current-org` only changes the default organization. The default app
 is managed independently with `hap app select` / `hap app unselect`.
 
 ### 3. Explore worksheets and records
@@ -117,7 +117,7 @@ discover every subcommand.
 | `auth logout` | Clear the saved auth token |
 | `auth whoami` | Show current user and current organization |
 | `auth list-my-orgs` | List every org for the current account (current marked `*`) |
-| `auth switch-org ORG_ID` | Switch the saved current organization |
+| `auth set-current-org ORG_ID` | Switch the saved current organization |
 
 ### app — application management
 
@@ -264,6 +264,14 @@ discover every subcommand.
 | `icon search` | Search icons by Chinese/English keyword (OR across terms, more matches rank higher); no keyword lists all |
 | `icon list` | List every icon with its keywords |
 
+### upload — file upload
+
+| Command | Description |
+|---|---|
+| `upload [SOURCES...]` | Upload local paths or http(s) URLs to the file store; prints neutral uploaded-file descriptors (fileID/key/url/serverName/filePath/fileName/fileExt/originalFileName/fileSize) |
+
+> A cross-feature capability — the same descriptors can be attached to a worksheet Attachment field, a chat message, a post, a calendar event, or a comment. Use `--files '[{"name":"cover.png","url":"https://..."}]'` to set display names; `--worksheet-id` / `--app-id` refine upload-token routing.
+
 ### config — local CLI settings
 
 | Command | Description |
@@ -291,7 +299,7 @@ Every command that needs an `--app-id` resolves it in this order:
 2. The default app saved by `hap app select`;
 3. Otherwise the command exits with an error suggesting `hap app select APP_ID`.
 
-`hap auth switch-org` changes the default *organization* only — it does not
+`hap auth set-current-org` changes the default *organization* only — it does not
 touch the default app.
 
 ## REPL mode

{hap_cli-0.6.10/hap_cli → hap_cli-0.7.0}/README.md

@@ -42,7 +42,7 @@ hap auth logout        # clear the saved token
 
 ```bash
 hap auth list-my-orgs                # current org marked with *
-hap auth switch-org ORG_ID           # switch the saved current org
+hap auth set-current-org ORG_ID           # switch the saved current org
 hap app list                         # uses the saved current org
 hap app list --org-id ORG_ID         # explicit override
 
@@ -51,7 +51,7 @@ hap app select APP_ID
 hap app unselect                     # clear it
 ```
 
-`hap auth switch-org` only changes the default organization. The default app
+`hap auth set-current-org` only changes the default organization. The default app
 is managed independently with `hap app select` / `hap app unselect`.
 
 ### 3. Explore worksheets and records
@@ -88,7 +88,7 @@ discover every subcommand.
 | `auth logout` | Clear the saved auth token |
 | `auth whoami` | Show current user and current organization |
 | `auth list-my-orgs` | List every org for the current account (current marked `*`) |
-| `auth switch-org ORG_ID` | Switch the saved current organization |
+| `auth set-current-org ORG_ID` | Switch the saved current organization |
 
 ### app — application management
 
@@ -235,6 +235,14 @@ discover every subcommand.
 | `icon search` | Search icons by Chinese/English keyword (OR across terms, more matches rank higher); no keyword lists all |
 | `icon list` | List every icon with its keywords |
 
+### upload — file upload
+
+| Command | Description |
+|---|---|
+| `upload [SOURCES...]` | Upload local paths or http(s) URLs to the file store; prints neutral uploaded-file descriptors (fileID/key/url/serverName/filePath/fileName/fileExt/originalFileName/fileSize) |
+
+> A cross-feature capability — the same descriptors can be attached to a worksheet Attachment field, a chat message, a post, a calendar event, or a comment. Use `--files '[{"name":"cover.png","url":"https://..."}]'` to set display names; `--worksheet-id` / `--app-id` refine upload-token routing.
+
 ### config — local CLI settings
 
 | Command | Description |
@@ -262,7 +270,7 @@ Every command that needs an `--app-id` resolves it in this order:
 2. The default app saved by `hap app select`;
 3. Otherwise the command exits with an error suggesting `hap app select APP_ID`.
 
-`hap auth switch-org` changes the default *organization* only — it does not
+`hap auth set-current-org` changes the default *organization* only — it does not
 touch the default app.
 
 ## REPL mode

hap_cli-0.7.0/app_live_tests/__init__.py

@@ -0,0 +1,11 @@
+"""Repeatable live smoke tests for the hap-app-editor skill.
+
+This is a top-level, stdlib-only package (no ``test_*.py`` files, so the
+default pytest run never collects it — mirror of ``live_tests/``). It
+drives the *real* editor entry point (``python3 -m scripts apply`` inside
+the skill) plus the ``hap`` binary for setup/assertions, against a
+persistent test app that it creates on first run and reuses thereafter.
+
+    python3 -m app_live_tests smoke          # run all scenarios
+    python3 -m app_live_tests cleanup        # delete the persistent app
+"""

hap_cli-0.7.0/app_live_tests/__main__.py

@@ -0,0 +1,32 @@
+"""``python -m app_live_tests <smoke|cleanup> ...`` dispatch."""
+from __future__ import annotations
+
+import sys
+
+_USAGE = (
+    "usage: python -m app_live_tests <command>\n"
+    "  smoke [--case worksheet|field|view]   run live scenarios on the persistent app\n"
+    "  cleanup                               delete the persistent test app\n"
+)
+
+
+def main(argv: list[str] | None = None) -> int:
+    argv = list(sys.argv[1:] if argv is None else argv)
+    if not argv or argv[0] in ("-h", "--help"):
+        print(_USAGE)
+        return 0 if argv else 1
+    cmd, rest = argv[0], argv[1:]
+    if cmd == "smoke":
+        from app_live_tests.smoke import main as run
+        return run(rest)
+    if cmd == "cleanup":
+        from app_live_tests import state
+        app_id = state.delete_app()
+        print(f"deleted {app_id}" if app_id else "no persistent app to delete")
+        return 0
+    print(f"unknown command: {cmd}\n{_USAGE}", file=sys.stderr)
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

hap_cli-0.7.0/app_live_tests/config.py

@@ -0,0 +1,20 @@
+"""Paths and binary config for the app_live_tests harness."""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+# The installed CLI (PATH lookup by default; override with HAP_BIN).
+HAP_BIN = os.environ.get("HAP_BIN", "hap")
+
+# Python used to invoke the editor skill (defaults to the running one).
+PYTHON_BIN = os.environ.get("HAP_EDITOR_PYTHON", "")  # "" -> sys.executable
+
+_PKG_DIR = Path(__file__).resolve().parent
+REPO_ROOT = _PKG_DIR.parent
+SKILL_DIR = REPO_ROOT / "skills" / "hap-app-editor"
+
+STATE_DIR = _PKG_DIR / "state"
+STATE_FILE = STATE_DIR / "current_app.json"
+
+TIMEOUT = int(os.environ.get("HAP_EDITOR_TIMEOUT", "120"))

hap_cli-0.7.0/app_live_tests/harness.py

@@ -0,0 +1,73 @@
+"""Subprocess helpers: drive the ``hap`` binary and the editor skill.
+
+``hap(...)`` runs the CLI in --json mode and returns the parsed payload.
+``editor(...)`` runs ``python3 -m scripts <args>`` inside the skill
+directory — the exact entry point a user invokes — and returns
+(returncode, stdout, stderr).
+"""
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+import tempfile
+import time
+from pathlib import Path
+from typing import Any
+
+from app_live_tests import config
+
+_TRANSIENT = ("SSLError", "SSLEOFError", "UNEXPECTED_EOF", "Max retries",
+              "Connection aborted", "timed out", "RemoteDisconnected")
+
+
+def hap(args: list[str], *, check: bool = True) -> Any:
+    """Run ``hap --json <args>``; return parsed JSON (unwrapped if enveloped).
+
+    Retries a few times on transient network failures.
+    """
+    argv = [config.HAP_BIN, "--json", *args]
+    for attempt in range(1, 4):
+        proc = subprocess.run(argv, capture_output=True, text=True,
+                              timeout=config.TIMEOUT)
+        blob = f"{proc.stdout}\n{proc.stderr}"
+        if proc.returncode == 0 or not any(m in blob for m in _TRANSIENT):
+            break
+        if attempt < 3:
+            time.sleep(1.5 * attempt)
+    if check and proc.returncode != 0:
+        raise RuntimeError(f"hap {' '.join(args)} failed: "
+                           f"{proc.stderr.strip() or proc.stdout.strip()}")
+    text = proc.stdout.strip()
+    if not text:
+        return {}
+    try:
+        data = json.loads(text)
+    except json.JSONDecodeError:
+        return {"_raw": text}
+    if isinstance(data, dict) and "data" in data and set(data.keys()) <= {
+        "data", "state", "exception", "success", "error_code", "code",
+    }:
+        return data["data"]
+    return data
+
+
+def editor(args: list[str]) -> tuple[int, str, str]:
+    """Run the editor skill (``python -m scripts <args>``) in the skill dir."""
+    py = config.PYTHON_BIN or sys.executable
+    argv = [py, "-m", "scripts", *args]
+    proc = subprocess.run(argv, capture_output=True, text=True,
+                          cwd=str(config.SKILL_DIR), timeout=config.TIMEOUT)
+    return proc.returncode, proc.stdout, proc.stderr
+
+
+def editor_apply(spec: dict) -> tuple[int, str, str]:
+    """Write a spec to a temp file and ``editor apply`` it."""
+    with tempfile.NamedTemporaryFile(
+            "w", suffix=".edit.json", delete=False, encoding="utf-8") as fh:
+        json.dump(spec, fh, ensure_ascii=False)
+        path = fh.name
+    try:
+        return editor(["apply", path])
+    finally:
+        Path(path).unlink(missing_ok=True)