hap-cli 0.5.0__py3-none-any.whl

hap_cli/commands/role_cmd.py

@@ -0,0 +1,221 @@
+"""CLI commands for role management."""
+
+import json
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import role as role_mod
+from hap_cli.utils.formatting import output_json, output_kv, output_table
+
+
+@click.group()
+def role():
+    """Role management."""
+    pass
+
+
+@role.command("list")
+@click.argument("app_id", default="")
+@pass_context
+def role_list(ctx, app_id):
+    """List roles for an application."""
+    try:
+        session = ctx.get_session()
+        aid = app_id or session.default_app_id
+        if not aid:
+            raise click.UsageError("App ID required.")
+        roles = role_mod.get_roles(session, aid)
+        ctx.output(
+            roles,
+            lambda d: output_table(
+                d,
+                ["roleId", "name", "permissionWay", "description"],
+                ["Role ID", "Name", "Permission", "Description"],
+            ),
+        )
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("create")
+@click.argument("app_id")
+@click.option("--name", "-n", required=True, help="Role name")
+@click.option("--desc", "-d", default="", help="Description")
+@click.option(
+    "--permission", "-p", default=10, type=int,
+    help="Permission type: 0=custom, 10=readonly, 50=member, 100=admin",
+)
+@pass_context
+def role_create(ctx, app_id, name, desc, permission):
+    """Create a new role."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.create_role(session, app_id, name, desc, permission)
+        ctx.output(data, lambda d: click.echo(f"Created role: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("delete")
+@click.argument("app_id")
+@click.argument("role_id")
+@click.option("--move-to", "-m", default="", help="Move members to this role ID")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def role_delete(ctx, app_id, role_id, move_to, yes):
+    """Delete a role."""
+    try:
+        if not yes:
+            click.confirm(f"Delete role {role_id}?", abort=True)
+        session = ctx.get_session()
+        data = role_mod.delete_role(session, app_id, role_id, move_to)
+        ctx.output(data, lambda d: click.echo(f"Deleted role."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("add-member")
+@click.argument("app_id")
+@click.argument("role_id")
+@click.option("--user", "-u", multiple=True, help="User ID to add")
+@click.option("--dept", "-d", multiple=True, help="Department ID to add")
+@pass_context
+def role_add_member(ctx, app_id, role_id, user, dept):
+    """Add members to a role."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.add_role_members(
+            session, app_id, role_id,
+            user_ids=list(user) if user else None,
+            department_ids=list(dept) if dept else None,
+        )
+        ctx.output(data, lambda d: click.echo("Members added."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("remove-member")
+@click.argument("app_id")
+@click.argument("role_id")
+@click.option("--user", "-u", multiple=True, help="User ID to remove")
+@click.option("--dept", "-d", multiple=True, help="Department ID to remove")
+@pass_context
+def role_remove_member(ctx, app_id, role_id, user, dept):
+    """Remove members from a role."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.remove_role_members(
+            session, app_id, role_id,
+            user_ids=list(user) if user else None,
+            department_ids=list(dept) if dept else None,
+        )
+        ctx.output(data, lambda d: click.echo("Members removed."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("permissions")
+@click.argument("app_id")
+@click.argument("role_id")
+@pass_context
+def role_permissions(ctx, app_id, role_id):
+    """Get role detail including permissions."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.get_role_detail(session, app_id, role_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("set-permissions")
+@click.argument("app_id")
+@click.argument("role_id")
+@click.option("--permissions", "-P", default="", help="Permissions as JSON string")
+@click.option("--permission-way", type=int, default=0, help="Permission type: 0=custom, 10=readonly, 50=member, 100=admin")
+@pass_context
+def role_set_permissions(ctx, app_id, role_id, permissions, permission_way):
+    """Edit role permissions."""
+    try:
+        session = ctx.get_session()
+        perms = json.loads(permissions) if permissions else None
+        data = role_mod.edit_role(
+            session, app_id, role_id,
+            permission_way=permission_way, permissions=perms,
+        )
+        ctx.output(data, lambda d: click.echo("Permissions updated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("rename")
+@click.argument("app_id")
+@click.argument("role_id")
+@click.option("--name", "-n", required=True, help="New role name")
+@pass_context
+def role_rename(ctx, app_id, role_id, name):
+    """Rename a role."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.rename_role(session, app_id, role_id, name)
+        ctx.output(data, lambda d: click.echo(f"Role renamed to: {name}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("apply")
+@click.argument("app_id")
+@click.argument("role_id")
+@pass_context
+def role_apply(ctx, app_id, role_id):
+    """Apply to join a role."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.apply_role(session, app_id, role_id)
+        ctx.output(data, lambda d: click.echo("Role application submitted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("approve")
+@click.argument("app_id")
+@click.argument("role_id")
+@click.argument("account_id")
+@pass_context
+def role_approve(ctx, app_id, role_id, account_id):
+    """Approve a user's role application."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.approve_role_apply(session, app_id, role_id, account_id)
+        ctx.output(data, lambda d: click.echo("Application approved."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("reject")
+@click.argument("app_id")
+@click.argument("role_id")
+@click.argument("account_id")
+@pass_context
+def role_reject(ctx, app_id, role_id, account_id):
+    """Reject a user's role application."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.reject_role_apply(session, app_id, role_id, account_id)
+        ctx.output(data, lambda d: click.echo("Application rejected."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@role.command("pending")
+@click.argument("app_id")
+@pass_context
+def role_pending(ctx, app_id):
+    """Get users with pending role applications."""
+    try:
+        session = ctx.get_session()
+        data = role_mod.get_pending_role_users(session, app_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)

hap_cli/commands/workflow_cmd.py

@@ -0,0 +1,284 @@
+"""CLI commands for workflow process lifecycle management."""
+
+import json
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import workflow as wf_mod
+from hap_cli.utils.formatting import output_json, output_table, output_kv
+
+
+@click.group()
+def workflow():
+    """Workflow process lifecycle management."""
+    pass
+
+
+@workflow.command("list")
+@click.argument("app_id", default="")
+@click.option("--keyword", "-k", default="", help="Search keyword")
+@click.option("--enabled/--disabled", default=None, help="Filter by status")
+@click.option("--page-size", "-n", default=50, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def workflow_list(ctx, app_id, keyword, enabled, page_size, page):
+    """List workflows in an application."""
+    try:
+        session = ctx.get_session()
+        aid = app_id or session.default_app_id
+        if not aid:
+            raise click.UsageError("App ID required.")
+        result = wf_mod.get_process_list(
+            session, aid, keyword=keyword,
+            page_index=page, page_size=page_size,
+        )
+        ctx.output(
+            result,
+            lambda d: output_table(
+                d.get("data", []),
+                ["id", "name", "enabled", "child"],
+                ["Process ID", "Name", "Enabled", "Sub-processes"],
+            ),
+        )
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("get")
+@click.argument("process_id")
+@pass_context
+def workflow_get(ctx, process_id):
+    """Get workflow process details."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.get_process_by_id(session, process_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("create")
+@click.option("--company-id", "-c", required=True, help="Organization/project ID")
+@click.option("--name", "-n", required=True, help="Process name")
+@click.option("--app-id", "-a", default="", help="Related app ID")
+@click.option("--type", "start_type", default=1, type=int,
+              help="Trigger type: 1=worksheet, 5=scheduled, 6=date")
+@click.option("--desc", "-d", default="", help="Description")
+@pass_context
+def workflow_create(ctx, company_id, name, app_id, start_type, desc):
+    """Create a new workflow process."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.create_process(
+            session, company_id, name,
+            relation_id=app_id,
+            start_event_app_type=start_type,
+            explain=desc,
+        )
+        ctx.output(data, lambda d: click.echo(f"Created workflow: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("update")
+@click.argument("process_id")
+@click.option("--name", "-n", default="", help="New name")
+@click.option("--desc", "-d", default="", help="New description")
+@click.option("--icon-color", default="", help="Icon color hex")
+@pass_context
+def workflow_update(ctx, process_id, name, desc, icon_color):
+    """Update workflow process info."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.update_process(
+            session, process_id, name=name, explain=desc, icon_color=icon_color,
+        )
+        ctx.output(data, lambda d: click.echo("Workflow updated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("delete")
+@click.argument("process_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def workflow_delete(ctx, process_id, yes):
+    """Delete a workflow process."""
+    try:
+        if not yes:
+            click.confirm(f"Delete workflow {process_id}?", abort=True)
+        session = ctx.get_session()
+        data = wf_mod.delete_process(session, process_id)
+        ctx.output(data, lambda d: click.echo("Workflow deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("copy")
+@click.argument("process_id")
+@click.option("--name", "-n", required=True, help="Name for the copy")
+@click.option("--sub-process", is_flag=True, help="Include sub-processes")
+@pass_context
+def workflow_copy(ctx, process_id, name, sub_process):
+    """Copy/clone a workflow process."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.copy_process(session, process_id, name, sub_process)
+        ctx.output(data, lambda d: click.echo(f"Copied: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("move")
+@click.argument("process_id")
+@click.argument("target_app_id")
+@pass_context
+def workflow_move(ctx, process_id, target_app_id):
+    """Move workflow to another application."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.move_process(session, process_id, target_app_id)
+        ctx.output(data, lambda d: click.echo("Workflow moved."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("publish")
+@click.argument("process_id")
+@click.option("--disable", is_flag=True, help="Disable instead of publish")
+@pass_context
+def workflow_publish(ctx, process_id, disable):
+    """Publish (enable) or disable a workflow."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.publish(session, process_id, is_publish=not disable)
+        action = "Disabled" if disable else "Published"
+        ctx.output(data, lambda d: click.echo(f"{action} workflow."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("rollback")
+@click.argument("process_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def workflow_rollback(ctx, process_id, yes):
+    """Rollback to previous version."""
+    try:
+        if not yes:
+            click.confirm(f"Rollback workflow {process_id}?", abort=True)
+        session = ctx.get_session()
+        data = wf_mod.rollback_version(session, process_id)
+        ctx.output(data, lambda d: click.echo("Rolled back to previous version."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("history")
+@click.argument("process_id")
+@click.option("--page-size", "-n", default=20, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def workflow_history(ctx, process_id, page_size, page):
+    """Get workflow version history."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.get_version_history(session, process_id, page, page_size)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("config-get")
+@click.argument("process_id")
+@pass_context
+def workflow_config_get(ctx, process_id):
+    """Get workflow global configuration."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.get_process_config(session, process_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("config-set")
+@click.argument("process_id")
+@click.option("--config", "-c", required=True, help="JSON config string")
+@pass_context
+def workflow_config_set(ctx, process_id, config):
+    """Save workflow global configuration (JSON string)."""
+    try:
+        session = ctx.get_session()
+        config_dict = json.loads(config)
+        data = wf_mod.save_process_config(session, process_id, config_dict)
+        ctx.output(data, lambda d: click.echo("Config saved."))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("trigger")
+@click.argument("process_id")
+@click.option("--source-id", "-s", default="", help="Source record ID")
+@pass_context
+def workflow_trigger(ctx, process_id, source_id):
+    """Trigger/start a workflow by process ID."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.start_process_by_id(session, process_id, source_id)
+        ctx.output(data, lambda d: click.echo(f"Triggered: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("trigger-pbp")
+@click.argument("process_id")
+@click.option("--app-id", "-a", required=True, help="Application ID")
+@click.option("--trigger-id", default="", help="Trigger ID")
+@click.option("--title", default="", help="Instance title")
+@pass_context
+def workflow_trigger_pbp(ctx, process_id, app_id, trigger_id, title):
+    """Trigger a PBP (Packaged Business Process) workflow."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.start_process_by_pbp(
+            session, process_id, app_id, trigger_id, title,
+        )
+        ctx.output(data, lambda d: click.echo(f"PBP triggered: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("groups")
+@click.argument("app_id", default="")
+@pass_context
+def workflow_groups(ctx, app_id):
+    """List workflow groups."""
+    try:
+        session = ctx.get_session()
+        aid = app_id or session.default_app_id
+        if not aid:
+            raise click.UsageError("App ID required.")
+        data = wf_mod.get_group_list(session, aid)
+        ctx.output(
+            data,
+            lambda d: output_table(d, ["id", "name"], ["Group ID", "Name"]),
+        )
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@workflow.command("stats")
+@click.option("--company-id", "-c", required=True, help="Organization ID")
+@pass_context
+def workflow_stats(ctx, company_id):
+    """Get workflow usage statistics."""
+    try:
+        session = ctx.get_session()
+        data = wf_mod.get_process_use_count(session, company_id)
+        ctx.output(data, lambda d: output_kv(d))
+    except Exception as e:
+        ctx.handle_error(e)