hap-cli 0.5.0__py3-none-any.whl

hap_cli/utils/__init__.py

@@ -0,0 +1 @@
+"""Utility modules for hap-cli harness."""

hap_cli/utils/formatting.py

@@ -0,0 +1,111 @@
+"""Output formatting utilities for hap-cli."""
+
+import json
+import sys
+from typing import Any
+
+
+def output_json(data: Any) -> None:
+    """Print data as formatted JSON."""
+    print(json.dumps(data, indent=2, ensure_ascii=False, default=str))
+
+
+def output_table(rows: list[dict], columns: list[str], headers: list[str] = None) -> None:
+    """Print data as a formatted table.
+
+    Args:
+        rows: List of row dicts
+        columns: Keys to extract from each row
+        headers: Display headers (defaults to column names)
+    """
+    if headers is None:
+        headers = columns
+
+    if not rows:
+        print("(no data)")
+        return
+
+    # Calculate column widths
+    col_widths = [len(h) for h in headers]
+    str_rows = []
+    for row in rows:
+        str_row = [str(row.get(col, "")) for col in columns]
+        for i, val in enumerate(str_row):
+            # Truncate long values
+            if len(val) > 60:
+                val = val[:57] + "..."
+                str_row[i] = val
+            col_widths[i] = max(col_widths[i], len(val))
+        str_rows.append(str_row)
+
+    # Print header
+    header_line = "  ".join(h.ljust(col_widths[i]) for i, h in enumerate(headers))
+    print(header_line)
+    print("  ".join("-" * w for w in col_widths))
+
+    # Print rows
+    for str_row in str_rows:
+        line = "  ".join(val.ljust(col_widths[i]) for i, val in enumerate(str_row))
+        print(line)
+
+
+def output_kv(data: dict, keys: list[str] = None, labels: dict[str, str] = None) -> None:
+    """Print key-value pairs.
+
+    Args:
+        data: Data dict
+        keys: Keys to display (defaults to all)
+        labels: Display labels for keys
+    """
+    if keys is None:
+        keys = list(data.keys())
+    if labels is None:
+        labels = {}
+
+    max_label_len = max(len(labels.get(k, k)) for k in keys) if keys else 0
+
+    for key in keys:
+        label = labels.get(key, key)
+        value = data.get(key, "")
+        if isinstance(value, (dict, list)):
+            value = json.dumps(value, ensure_ascii=False, default=str)
+        print(f"  {label.ljust(max_label_len)}  {value}")
+
+
+def format_record_row(record: dict, controls: list[dict] = None) -> dict:
+    """Format a record row for display.
+
+    Args:
+        record: Raw record data
+        controls: Control definitions for field name mapping
+
+    Returns:
+        Formatted dict with field names as keys
+    """
+    control_map = {}
+    if controls:
+        for ctrl in controls:
+            cid = ctrl.get("controlId", "")
+            name = ctrl.get("controlName", cid)
+            control_map[cid] = name
+
+    formatted = {"rowId": record.get("rowid", record.get("rowId", ""))}
+
+    # Process cell values
+    for key, value in record.items():
+        if key in ("rowid", "rowId", "allowedit", "allowdelete"):
+            continue
+        display_key = control_map.get(key, key)
+        if isinstance(value, str) and value.startswith("["):
+            try:
+                parsed = json.loads(value)
+                if isinstance(parsed, list) and parsed:
+                    if isinstance(parsed[0], dict) and "name" in parsed[0]:
+                        value = ", ".join(item.get("name", "") for item in parsed)
+                    elif isinstance(parsed[0], dict) and "fullname" in parsed[0]:
+                        value = ", ".join(item.get("fullname", "") for item in parsed)
+            except (json.JSONDecodeError, IndexError):
+                pass
+        formatted[display_key] = value
+
+    return formatted

hap_cli/utils/options.py

@@ -0,0 +1,10 @@
+"""Reusable Click option decorators for hap-cli."""
+
+import click
+
+
+def pagination_options(f):
+    """Add --page-size and --page options to a command."""
+    f = click.option("--page-size", "-n", default=20, help="Items per page")(f)
+    f = click.option("--page", "-p", default=1, help="Page number")(f)
+    return f

hap_cli-0.5.0.dist-info/METADATA

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: hap-cli
+Version: 0.5.0
+Summary: CLI harness for MingDAO HAP - Enterprise no-code platform
+Author: hap-cli
+License: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28
+Provides-Extra: crypto
+Requires-Dist: pycryptodome>=3.15; extra == "crypto"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# hap-cli
+
+CLI harness for **MingDAO HAP** (明道云) - an enterprise no-code platform (hap).
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Login
+
+**Option A: Browser login (recommended)**
+
+```bash
+# MingDAO SaaS (default)
+hap config login
+
+# Specify server
+hap config login mingdao    # MingDAO
+hap config login nocoly     # Nocoly
+hap config login https://hap.example.com   # Self-hosted
+```
+
+Opens your browser to the MingDAO login page. Token is saved automatically after login.
+
+**Option B: Manual token**
+
+```bash
+hap config set \
+  --server https://your-mingdao-server.com \
+  --token YOUR_MD_PSS_ID_TOKEN \
+  --app-id YOUR_DEFAULT_APP_ID \
+  --project-id YOUR_PROJECT_ID
+```
+
+**Other auth commands**
+
+```bash
+hap config whoami    # Show current user info
+hap config logout    # Clear saved token
+```
+
+### 2. List worksheets
+
+```bash
+hap app worksheets
+```
+
+### 3. Query records
+
+```bash
+hap record list WORKSHEET_ID --page-size 10
+```
+
+### 4. JSON output (for automation)
+
+```bash
+hap --json record list WORKSHEET_ID
+```
+
+## Command Groups
+
+| Group | Description |
+|-------|-------------|
+| `config` | Server connection and auth |
+| `app` | Application management |
+| `worksheet` | Worksheet info, fields, views |
+| `record` | Record CRUD (list, get, create, update, delete) |
+| `workflow` | Process lifecycle (create, update, publish, trigger, rollback, config) |
+| `node` | Node management (add, delete, save config, test code/webhook/AI) |
+| `instance` | Approval & todo (approve, reject, forward, sign, batch, history) |
+| `role` | Role management and members |
+| `repl` | Interactive REPL mode |
+
+## Workflow Management
+
+```bash
+# Create a workflow
+hap workflow create --company-id CID --name "My Flow" --app-id APP_ID
+
+# Add an approval node
+hap node add PROCESS_ID --type 4 --name "Manager Approval"
+
+# Configure the node
+hap node save PROCESS_ID NODE_ID --type 4 --config '{"accounts":[...]}'
+
+# Test a code node
+hap node test-code PROCESS_ID NODE_ID --code "return 1+1"
+
+# Test a webhook node
+hap node test-webhook PROCESS_ID NODE_ID --url https://api.example.com
+
+# Publish the workflow
+hap workflow publish PROCESS_ID
+
+# Trigger it
+hap workflow trigger PROCESS_ID --source-id ROW_ID
+
+# Check version history
+hap workflow history PROCESS_ID
+
+# Rollback to previous version
+hap workflow rollback PROCESS_ID
+
+# Get/set global config
+hap workflow config-get PROCESS_ID
+hap workflow config-set PROCESS_ID --config '{"allowRevoke":true}'
+```
+
+## Approval & Todo
+
+```bash
+# Check pending task count
+hap instance todo-count
+
+# List pending approval tasks
+hap instance todo --type 4
+
+# View instance detail
+hap instance get INSTANCE_ID
+
+# Approve
+hap instance approve INSTANCE_ID --opinion "Looks good"
+
+# Reject with reason
+hap instance reject INSTANCE_ID --opinion "Need revision"
+
+# Forward to another user
+hap instance forward INSTANCE_ID --to USER_ID
+
+# Add co-signer
+hap instance sign INSTANCE_ID --to USER_ID --before
+
+# Batch approve
+hap instance batch --action 4 -s ID1 -s ID2
+
+# View execution history
+hap instance history --process-id PROCESS_ID --status 2
+```
+
+## REPL Mode
+
+```bash
+hap repl
+hap> record list WORKSHEET_ID
+hap> --json workflow list APP_ID
+hap> instance todo-count
+hap> quit
+```
+
+## API Authentication
+
+The CLI uses MingDAO's `md_pss_id` session token. Use `hap config login` for
+browser-based login, or `hap config set --token TOKEN` to set the token manually.
+
+For private deployments with encrypted API responses, install crypto support:
+
+```bash
+pip install hap-cli[crypto]
+```
+
+## More Examples
+
+```bash
+# List apps
+hap app list --project-id PROJECT_ID
+
+# Get worksheet fields
+hap worksheet fields WORKSHEET_ID
+
+# Create a record
+hap record create WORKSHEET_ID -f "c001=value1" -f "c002=value2"
+
+# Copy a workflow
+hap workflow copy PROCESS_ID --name "Copy of Flow"
+
+# Move workflow to another app
+hap workflow move PROCESS_ID TARGET_APP_ID
+
+# List code templates
+hap node code-templates --keyword "email"
+
+# Test AI node
+hap node test-ai PROCESS_ID NODE_ID --prompt "Summarize this" --model gpt-4
+
+# Terminate a stuck instance
+hap instance terminate INSTANCE_ID --yes
+
+# Retry a failed instance
+hap instance retry INSTANCE_ID
+```

hap_cli-0.5.0.dist-info/RECORD

@@ -0,0 +1,58 @@
+hap_cli/README.md,sha256=ZNa1jS9V3Ogrbf-Cj3xq_1pPfajvDwp_bzJ7P6RWQ1k,4198
+hap_cli/README_CN.md,sha256=ESKOGO1MKZYuY0nqCxVxZXx-GG4lDzOX83XUi9k15I4,16480
+hap_cli/__init__.py,sha256=MqGiKri5mDb4ODM1qGzSqZLC4zXW3ySkw12CfXM2Jhc,68
+hap_cli/context.py,sha256=KobmgGmFfz_rD6I8Vwc-vsOXz8OzxE2fh9N4knTVn8o,1101
+hap_cli/hap_cli.py,sha256=ybEVAUxuml5jRmIkekm0rTJCz40GQtOqpB2Z1zFB75c,2781
+hap_cli/commands/__init__.py,sha256=C4DTfkxROfw3HteqEF1ILMTZqdlqKueWSFYdViszbuk,39
+hap_cli/commands/ai_cmd.py,sha256=PkFyeeXFnO2IIoFvMBJy4GekdWCYQXSO_h5xpLAqnks,7883
+hap_cli/commands/app_cmd.py,sha256=9kb3F4H62C8mBKSgISGLSgx5_GaZdmT5JW1oMqXsYaA,10638
+hap_cli/commands/calendar_cmd.py,sha256=IHqhHM5k8SzWBT8sezuk_8_8AHpFdYvbmFLo25yTt1U,4739
+hap_cli/commands/chat_cmd.py,sha256=nbSmfD_MjgiDV3_repPVwTKoIUPg7FIXXX_YZgOzhqY,3211
+hap_cli/commands/config_cmd.py,sha256=PJWm3Fo8_dMDjKMbNz-uMaID6MaObrOilCs_BgR49G8,5334
+hap_cli/commands/contact_cmd.py,sha256=jMFbMUm2DCIPkCTLX-GpZgqOEB3xr5P4Syr77lFqhbg,4050
+hap_cli/commands/department_cmd.py,sha256=vrcZaqsHqAYMeLK_X0GFsPxkvroVSkJtJ12seuhPmg8,6276
+hap_cli/commands/group_cmd.py,sha256=TS7YJd30q1I8CPN66318EZB8S9T0NFobV49IPCaFdi0,4342
+hap_cli/commands/instance_cmd.py,sha256=PET6Ql-H_9BeN7252BMxutUVATE8g6VZTEHufDEX4Qc,10924
+hap_cli/commands/node_cmd.py,sha256=gMI-Q_3YRkfk0I_inlGhFsjYnnH8FLNdE3FnGQlCvp8,21872
+hap_cli/commands/optionset_cmd.py,sha256=5keMHCEjwY8oM6axFi2aaUHsL1J9yN0MGG5GClDo5qM,3114
+hap_cli/commands/page_cmd.py,sha256=yHyLTR962YY7Kcf9Fx0Im9PBspZNv8CjBwunPDTw4OI,3302
+hap_cli/commands/plugin_cmd.py,sha256=GFZSdtV7EWHgrw_zqxcxFI9ZBHTHPdg7zSLZoCR1J0U,4277
+hap_cli/commands/post_cmd.py,sha256=ESZaSAdBy7s3OR71Kr9EH8-cXZngvPBq6aFPIiNVz0I,5121
+hap_cli/commands/record_cmd.py,sha256=tgqHZPFYj1D_sC9QgzLPKZSlTkZO7EIaFZxpjI46OM0,7922
+hap_cli/commands/role_cmd.py,sha256=8mTaML0kqDSVxh135ehcYQ5X34axk_mv-xfwn9OMnpA,7054
+hap_cli/commands/workflow_cmd.py,sha256=HNE59MpscpJdbw5qc8UskTXZ0Kn-PiTjBIq_RapGy88,9710
+hap_cli/commands/worksheet_cmd.py,sha256=yA5x6J81rgegitPWmh-E-QzVRPpw783H8cfb-2qsQZA,12171
+hap_cli/core/__init__.py,sha256=QDnIob9qhieAk5igzbftGd0OXUX4M8_zLMFFqELUws4,40
+hap_cli/core/ai.py,sha256=l52glBoFF7qsCDWb7rcOI2niSFgCD6KgD-8NPGfG9yw,4024
+hap_cli/core/app.py,sha256=tUwFyF7D9Woi5lZz35-7Jnla-BzfGxmRxjZvQ8qmkI0,9177
+hap_cli/core/auth.py,sha256=-ZW0tUIPw1WFcuxnZbF3Od3yB_gpRtAPY5u_YxxoCvM,7107
+hap_cli/core/calendar_mod.py,sha256=dadJ52EGYD8ZEnJ52u2ngH9FaEjTNvN_BpJUjqL_Fvc,2966
+hap_cli/core/chat.py,sha256=fOEHC5U6HZoYrEJ0omKVTaYS8AsoTR7hAOudmCyO9DU,1740
+hap_cli/core/contact.py,sha256=2t8T3yNaWlZd20IwQEv90BCdCeynM_FMBrNSZ20xPfU,2259
+hap_cli/core/department.py,sha256=U4q4XSSmIDaw7XWQA1XVcVYc6xkpx35htuwpzwnDNFQ,3344
+hap_cli/core/flow_node.py,sha256=keDt9owCI3-pDug9B-KokvGgTHM4G_T8l20drai-dos,27747
+hap_cli/core/group.py,sha256=3_CMLy51H9bAHEG1YyVnGDlPjvjdP7Z4ojKMdvenN7Q,2347
+hap_cli/core/instance.py,sha256=tsn3Elr896Nvx5MlaI0xvM8sEbQ_vSMam8dYcOho2wQ,14868
+hap_cli/core/optionset.py,sha256=n-ZpWhnuHHhNVC1ACB4vgWaLCavb0C2jbrW7qMjsk70,2427
+hap_cli/core/page.py,sha256=Yw4XPJcWFa3_crosFtkVx_SeuyeNntKkB01QUKA7qzM,3005
+hap_cli/core/plugin.py,sha256=QAomQB4TXXeconERn2mguABvPE5TOkoovolrnU2DTJM,2170
+hap_cli/core/post.py,sha256=vRPfPTBi86ZL2UlhWJgr1XQboJLGKtFKE0-Uc7NDCYE,2700
+hap_cli/core/record.py,sha256=o9khqMNyIT4o6t25iUy49y8Bxk7DeCQ-gI5tKMeQuY4,6931
+hap_cli/core/role.py,sha256=RTwCEkv7eNOlCxCNDQhKA2GuEvCrze_tV36IOv1ctAI,6021
+hap_cli/core/session.py,sha256=3IOxX0n1gv1Dqj_PoLFDYW_c5TRB1BcfKOOA02H1-Do,11829
+hap_cli/core/workflow.py,sha256=Vr3J1NltJdoMVW0wfbo-0yF0f3EQv-kxLKGDaRKxk3k,14542
+hap_cli/core/worksheet.py,sha256=27XwUjAkWY1z5esj-Lzx2WNXdwhS75h-LqjQCCu2uJA,11625
+hap_cli/skills/SKILL.md,sha256=ZMmDdTAXXZnRKKdfj4YzNKqvKThMdTCc4GU6RibVNE4,13148
+hap_cli/skills/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hap_cli/tests/__init__.py,sha256=b98cgHISMxNQl1lnouPoZV9uhIBqnny244JDEgrzI8I,33
+hap_cli/tests/test_core.py,sha256=OqnaILD0dAErOpksJrG0qOh9NMLCM5yrXh3TiRJulPE,80516
+hap_cli/tests/test_full_e2e.py,sha256=railt06XGUTdiHTrQfqlnIvJ7fFfzdI-9sbnze67QcM,4650
+hap_cli/tests/test_integration.py,sha256=mCIUE5uZzTgkMR96XMRzuGW0A2_HdUzf9n-6lTtF8OU,32224
+hap_cli/utils/__init__.py,sha256=XztROmU5Q740_qIpVnLFdrgTmUpA0CMiLQiJLVgL5SA,43
+hap_cli/utils/formatting.py,sha256=gof19VDKPyKBzcyVor3IGcMw5K11TpNP_3MHN86yZbo,3508
+hap_cli/utils/options.py,sha256=uk4KntWKOE6HQdXOpDBVKXKdRDn-__iJjTv8eCrEEdE,318
+hap_cli-0.5.0.dist-info/METADATA,sha256=70HxPaQ8qd_myeuuHufi7Dl2Ec8kXOMqwrk79gzNZrw,5098
+hap_cli-0.5.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+hap_cli-0.5.0.dist-info/entry_points.txt,sha256=gVlKHfx3_fAhrg_Ij6HzUGIF7HPRdsc2XRj0oTFlQY8,45
+hap_cli-0.5.0.dist-info/top_level.txt,sha256=MwsuUjaUw85BEWvfAnSkgGeKh5c-dWcWDq3lUw1oZc4,8
+hap_cli-0.5.0.dist-info/RECORD,,

hap_cli-0.5.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hap_cli-0.5.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hap = hap_cli.hap_cli:main

hap_cli-0.5.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+hap_cli