hap-cli 0.5.0__py3-none-any.whl

hap_cli/commands/page_cmd.py

@@ -0,0 +1,102 @@
+"""CLI commands for custom page management."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import page as page_mod
+from hap_cli.utils.formatting import output_json, output_table
+
+
+@click.group()
+def page():
+    """Custom page management."""
+    pass
+
+
+@page.command("copy")
+@click.argument("app_id")
+@click.argument("page_id")
+@click.option("--name", "-n", required=True, help="Name for the copied page")
+@pass_context
+def page_copy(ctx, app_id, page_id, name):
+    """Copy a custom page."""
+    try:
+        session = ctx.get_session()
+        data = page_mod.copy_page(session, app_id, page_id, name)
+        ctx.output(data, lambda d: click.echo(f"Page copied: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@page.command("authorize")
+@click.argument("app_id")
+@click.argument("page_id")
+@click.option("--role-id", "-r", required=True, help="Role ID to authorize")
+@pass_context
+def page_authorize(ctx, app_id, page_id, role_id):
+    """Add an authorization to a custom page."""
+    try:
+        session = ctx.get_session()
+        data = page_mod.add_authorize(session, app_id, page_id, role_id)
+        ctx.output(data, lambda d: click.echo(f"Authorization added: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@page.command("permissions")
+@click.argument("app_id")
+@click.argument("page_id")
+@pass_context
+def page_permissions(ctx, app_id, page_id):
+    """Get authorizations for a custom page."""
+    try:
+        session = ctx.get_session()
+        data = page_mod.get_authorizes(session, app_id, page_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@page.command("edit-permission")
+@click.argument("app_id")
+@click.argument("page_id")
+@click.argument("authorize_id")
+@click.option("--status", "-s", required=True, type=int, help="Status value")
+@pass_context
+def page_edit_permission(ctx, app_id, page_id, authorize_id, status):
+    """Edit the status of a page authorization."""
+    try:
+        session = ctx.get_session()
+        data = page_mod.edit_authorize_status(session, app_id, page_id, authorize_id, status)
+        ctx.output(data, lambda d: click.echo("Permission updated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@page.command("delete-permission")
+@click.argument("app_id")
+@click.argument("page_id")
+@click.argument("authorize_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def page_delete_permission(ctx, app_id, page_id, authorize_id, yes):
+    """Delete a page authorization."""
+    try:
+        if not yes:
+            click.confirm(f"Delete authorization {authorize_id}?", abort=True)
+        session = ctx.get_session()
+        data = page_mod.delete_authorize(session, app_id, page_id, authorize_id)
+        ctx.output(data, lambda d: click.echo("Permission deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@page.command("component-types")
+@pass_context
+def page_component_types(ctx):
+    """Show available custom page component types."""
+    rows = [{"type": k, "description": v} for k, v in page_mod.PAGE_COMPONENT_TYPES.items()]
+    ctx.output(
+        rows,
+        lambda d: output_table(d, ["type", "description"], ["Component Type", "Description"]),
+    )

hap_cli/commands/plugin_cmd.py

@@ -0,0 +1,133 @@
+"""CLI commands for plugin management."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import plugin as plugin_mod
+from hap_cli.utils.formatting import output_json, output_kv
+
+
+@click.group()
+def plugin():
+    """Plugin management."""
+    pass
+
+
+@plugin.command("list")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", default=1, help="Page number")
+@pass_context
+def plugin_list(ctx, project_id, page_size, page):
+    """List plugins."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = plugin_mod.get_plugins(session, pid, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@plugin.command("get")
+@click.argument("plugin_id")
+@pass_context
+def plugin_get(ctx, plugin_id):
+    """Get plugin detail."""
+    try:
+        session = ctx.get_session()
+        data = plugin_mod.get_plugin_detail(session, plugin_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@plugin.command("create")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--name", "-n", required=True, help="Plugin name")
+@click.option("--desc", "-d", default="", help="Description")
+@pass_context
+def plugin_create(ctx, project_id, name, desc):
+    """Create a new plugin."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = plugin_mod.create_plugin(session, pid, name, description=desc)
+        ctx.output(data, lambda d: click.echo(f"Plugin created: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@plugin.command("edit")
+@click.argument("plugin_id")
+@click.option("--name", "-n", default="", help="New name")
+@click.option("--desc", "-d", default="", help="New description")
+@pass_context
+def plugin_edit(ctx, plugin_id, name, desc):
+    """Edit plugin name and/or description."""
+    try:
+        session = ctx.get_session()
+        data = plugin_mod.edit_plugin(session, plugin_id, name=name, description=desc)
+        ctx.output(data, lambda d: click.echo("Plugin updated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@plugin.command("delete")
+@click.argument("plugin_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def plugin_delete(ctx, plugin_id, yes):
+    """Delete a plugin."""
+    try:
+        if not yes:
+            click.confirm(f"Delete plugin {plugin_id}?", abort=True)
+        session = ctx.get_session()
+        data = plugin_mod.remove_plugin(session, plugin_id)
+        ctx.output(data, lambda d: click.echo("Plugin deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@plugin.command("release")
+@click.argument("plugin_id")
+@pass_context
+def plugin_release(ctx, plugin_id):
+    """Release a new version of a plugin."""
+    try:
+        session = ctx.get_session()
+        data = plugin_mod.release_plugin(session, plugin_id)
+        ctx.output(data, lambda d: click.echo(f"Plugin released: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@plugin.command("rollback")
+@click.argument("plugin_id")
+@click.argument("version_id")
+@pass_context
+def plugin_rollback(ctx, plugin_id, version_id):
+    """Rollback a plugin to a specific version."""
+    try:
+        session = ctx.get_session()
+        data = plugin_mod.rollback_plugin(session, plugin_id, version_id)
+        ctx.output(data, lambda d: click.echo(f"Plugin rolled back to {version_id}."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@plugin.command("history")
+@click.argument("plugin_id")
+@pass_context
+def plugin_history(ctx, plugin_id):
+    """Get plugin release history."""
+    try:
+        session = ctx.get_session()
+        data = plugin_mod.get_release_history(session, plugin_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)

hap_cli/commands/post_cmd.py

@@ -0,0 +1,155 @@
+"""CLI commands for feed/post management."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import post as post_mod
+from hap_cli.utils.formatting import output_json, output_kv
+
+
+@click.group()
+def post():
+    """Feed and post management."""
+    pass
+
+
+@post.command("list")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--type", "post_type", default=0, type=int, help="Post type")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", default=1, help="Page number")
+@pass_context
+def post_list(ctx, project_id, post_type, page_size, page):
+    """List feed posts."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = post_mod.get_post_list(session, pid, post_type=post_type, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("get")
+@click.argument("post_id")
+@pass_context
+def post_get(ctx, post_id):
+    """Get post detail."""
+    try:
+        session = ctx.get_session()
+        data = post_mod.get_post_detail(session, post_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("create")
+@click.option("--project-id", "-p", default="", help="Project/org ID")
+@click.option("--type", "post_type", default=0, type=int, help="Post type")
+@click.option("--message", "-m", required=True, help="Post content")
+@click.option("--scope", default=0, type=int, help="Visibility scope")
+@pass_context
+def post_create(ctx, project_id, post_type, message, scope):
+    """Create a new post."""
+    try:
+        session = ctx.get_session()
+        pid = project_id or session.default_project_id
+        if not pid:
+            raise click.UsageError("Project ID required.")
+        data = post_mod.add_post(session, pid, post_type, message, scope=scope)
+        ctx.output(data, lambda d: click.echo(f"Post created: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("update")
+@click.argument("post_id")
+@click.option("--message", "-m", required=True, help="New content")
+@pass_context
+def post_update(ctx, post_id, message):
+    """Update a post."""
+    try:
+        session = ctx.get_session()
+        data = post_mod.edit_post(session, post_id, message)
+        ctx.output(data, lambda d: click.echo("Post updated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("delete")
+@click.argument("post_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def post_delete(ctx, post_id, yes):
+    """Delete a post."""
+    try:
+        if not yes:
+            click.confirm(f"Delete post {post_id}?", abort=True)
+        session = ctx.get_session()
+        data = post_mod.remove_post(session, post_id)
+        ctx.output(data, lambda d: click.echo("Post deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("comment")
+@click.argument("post_id")
+@click.option("--message", "-m", required=True, help="Comment content")
+@click.option("--reply-id", default="", help="Reply to comment ID")
+@pass_context
+def post_comment(ctx, post_id, message, reply_id):
+    """Add a comment to a post."""
+    try:
+        session = ctx.get_session()
+        data = post_mod.add_comment(session, post_id, message, reply_id=reply_id)
+        ctx.output(data, lambda d: click.echo("Comment added."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("comments")
+@click.argument("post_id")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", default=1, help="Page number")
+@pass_context
+def post_comments(ctx, post_id, page_size, page):
+    """List comments for a post."""
+    try:
+        session = ctx.get_session()
+        data = post_mod.get_comments(session, post_id, page_index=page, page_size=page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("like")
+@click.argument("post_id")
+@pass_context
+def post_like(ctx, post_id):
+    """Like or unlike a post."""
+    try:
+        session = ctx.get_session()
+        data = post_mod.like_post(session, post_id)
+        ctx.output(data, lambda d: click.echo("Like toggled."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@post.command("top")
+@click.argument("post_id")
+@click.option("--remove", is_flag=True, help="Remove from top")
+@pass_context
+def post_top(ctx, post_id, remove):
+    """Pin or unpin a post to top."""
+    try:
+        session = ctx.get_session()
+        if remove:
+            data = post_mod.remove_top_post(session, post_id)
+            ctx.output(data, lambda d: click.echo("Post unpinned."))
+        else:
+            data = post_mod.add_top_post(session, post_id)
+            ctx.output(data, lambda d: click.echo("Post pinned."))
+    except Exception as e:
+        ctx.handle_error(e)

hap_cli/commands/record_cmd.py

@@ -0,0 +1,228 @@
+"""CLI commands for record CRUD operations."""
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import record as rec_mod
+from hap_cli.utils.formatting import output_json, output_kv, format_record_row
+
+
+@click.group()
+def record():
+    """Record CRUD operations."""
+    pass
+
+
+@record.command("list")
+@click.argument("worksheet_id")
+@click.option("--view-id", "-v", default="", help="View ID")
+@click.option("--page-size", "-n", default=20, help="Records per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@click.option("--keywords", "-k", default="", help="Search keywords")
+@click.option("--sort", "-s", default="", help="Sort by field ID")
+@click.option("--asc", is_flag=True, help="Sort ascending")
+@pass_context
+def record_list(ctx, worksheet_id, view_id, page_size, page, keywords, sort, asc):
+    """Query records with filtering and pagination."""
+    try:
+        session = ctx.get_session()
+        result = rec_mod.get_records(
+            session, worksheet_id, view_id,
+            page_size=page_size, page_index=page,
+            keywords=keywords, sort_id=sort, is_asc=asc,
+        )
+        ctx.output(
+            result,
+            lambda d: _print_records(d),
+        )
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+def _print_records(result):
+    """Print records in human-readable format."""
+    records = result.get("data", [])
+    count = result.get("count", 0)
+    click.echo(f"Total: {count} records\n")
+    if not records:
+        click.echo("(no records)")
+        return
+    for i, rec in enumerate(records):
+        formatted = format_record_row(rec)
+        rid = formatted.pop("rowId", "?")
+        click.echo(f"── Record {i + 1} [{rid}] ──")
+        for k, v in formatted.items():
+            if v:
+                click.echo(f"  {k}: {v}")
+        click.echo()
+
+
+@record.command("get")
+@click.argument("worksheet_id")
+@click.argument("row_id")
+@click.option("--view-id", "-v", default="", help="View ID")
+@pass_context
+def record_get(ctx, worksheet_id, row_id, view_id):
+    """Get a single record by ID."""
+    try:
+        session = ctx.get_session()
+        data = rec_mod.get_record(session, worksheet_id, row_id, view_id)
+        ctx.output(data, lambda d: output_kv(format_record_row(d)))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("create")
+@click.argument("worksheet_id")
+@click.option("--field", "-f", multiple=True, help="Field value: CONTROL_ID=VALUE")
+@click.option("--no-workflow", is_flag=True, help="Don't trigger workflows")
+@pass_context
+def record_create(ctx, worksheet_id, field, no_workflow):
+    """Create a new record. Use -f CONTROL_ID=VALUE for each field."""
+    try:
+        session = ctx.get_session()
+        controls = _parse_fields(field)
+        data = rec_mod.create_record(
+            session, worksheet_id, controls,
+            trigger_workflow=not no_workflow,
+        )
+        ctx.output(data, lambda d: click.echo(f"Created: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("update")
+@click.argument("worksheet_id")
+@click.argument("row_id")
+@click.option("--field", "-f", multiple=True, help="Field value: CONTROL_ID=VALUE")
+@click.option("--no-workflow", is_flag=True, help="Don't trigger workflows")
+@pass_context
+def record_update(ctx, worksheet_id, row_id, field, no_workflow):
+    """Update a record. Use -f CONTROL_ID=VALUE for each field."""
+    try:
+        session = ctx.get_session()
+        controls = _parse_fields(field)
+        data = rec_mod.update_record(
+            session, worksheet_id, row_id, controls,
+            trigger_workflow=not no_workflow,
+        )
+        ctx.output(data, lambda d: click.echo(f"Updated: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("delete")
+@click.argument("worksheet_id")
+@click.argument("row_ids", nargs=-1, required=True)
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def record_delete(ctx, worksheet_id, row_ids, yes):
+    """Delete records by IDs."""
+    try:
+        if not yes:
+            click.confirm(f"Delete {len(row_ids)} record(s)?", abort=True)
+        session = ctx.get_session()
+        data = rec_mod.delete_records(session, worksheet_id, list(row_ids))
+        ctx.output(data, lambda d: click.echo(f"Deleted {len(row_ids)} record(s)."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("discussions")
+@click.argument("worksheet_id")
+@click.argument("row_id")
+@click.option("--page-size", "-n", default=20, help="Discussions per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def record_discussions(ctx, worksheet_id, row_id, page_size, page):
+    """Get discussions for a record."""
+    try:
+        session = ctx.get_session()
+        data = rec_mod.get_discussions(
+            session, row_id, source_type=7,
+            page_index=page, page_size=page_size,
+        )
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("add-discussion")
+@click.argument("worksheet_id")
+@click.argument("row_id")
+@click.option("--message", "-m", required=True, help="Discussion message")
+@click.option("--app-id", default="", help="Application ID")
+@pass_context
+def record_add_discussion(ctx, worksheet_id, row_id, message, app_id):
+    """Add a discussion/comment to a record."""
+    try:
+        session = ctx.get_session()
+        data = rec_mod.add_discussion(
+            session, row_id, message, source_type=7, app_id=app_id,
+        )
+        ctx.output(data, lambda d: click.echo(f"Discussion added."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("delete-discussion")
+@click.argument("discussion_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def record_delete_discussion(ctx, discussion_id, yes):
+    """Delete a discussion/comment."""
+    try:
+        if not yes:
+            click.confirm(f"Delete discussion {discussion_id}?", abort=True)
+        session = ctx.get_session()
+        data = rec_mod.remove_discussion(session, discussion_id, source_type=7)
+        ctx.output(data, lambda d: click.echo(f"Discussion deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("pivot")
+@click.argument("worksheet_id")
+@click.option("--view-id", "-v", default="", help="View ID")
+@click.option("--app-id", default="", help="Application ID")
+@pass_context
+def record_pivot(ctx, worksheet_id, view_id, app_id):
+    """Get pivot table / report data for a worksheet."""
+    try:
+        session = ctx.get_session()
+        data = rec_mod.get_pivot_data(
+            session, worksheet_id, view_id=view_id, app_id=app_id,
+        )
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@record.command("logs")
+@click.argument("worksheet_id")
+@click.argument("row_id")
+@click.option("--page-size", "-n", default=50, help="Logs per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def record_logs(ctx, worksheet_id, row_id, page_size, page):
+    """Get operation logs for a record."""
+    try:
+        session = ctx.get_session()
+        data = rec_mod.get_record_logs(
+            session, worksheet_id, row_id,
+            page_index=page, page_size=page_size,
+        )
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+def _parse_fields(fields: tuple) -> list[dict]:
+    """Parse -f CONTROL_ID=VALUE pairs into controls list."""
+    controls = []
+    for f in fields:
+        if "=" not in f:
+            raise click.UsageError(f"Invalid field format: {f}. Use CONTROL_ID=VALUE")
+        cid, value = f.split("=", 1)
+        controls.append({"controlId": cid.strip(), "value": value.strip()})
+    return controls