wxcli 1.2.0__py3-none-any.whl

wxcli/commands/events.py

@@ -0,0 +1,83 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+
+
+app = typer.Typer(help="Manage Webex Calling events.")
+
+
+@app.command("list")
+def cmd_list(
+    resource: str = typer.Option(None, "--resource", help="List events with a specific resource type. (use --help for choices)"),
+    type_param: str = typer.Option(None, "--type", help="Choices: created, updated, deleted, ended"),
+    actor_id: str = typer.Option(None, "--actor-id", help="List events performed by this person, by person ID."),
+    from_param: str = typer.Option(None, "--from", help="List events which occurred after a specific date and time."),
+    to: str = typer.Option(None, "--to", help="List events that occurred before a specific date and time. I"),
+    service_type: str = typer.Option(None, "--service-type", help="Choices: calling"),
+    output: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+    limit: int = typer.Option(0, "--limit", help="Max results (0=all for paginated endpoints, API default for non-paginated)"),
+    offset: int = typer.Option(0, "--offset", help="Start offset"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """List Events."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/events"
+    params = {}
+    if resource is not None:
+        params["resource"] = resource
+    if type_param is not None:
+        params["type"] = type_param
+    if actor_id is not None:
+        params["actorId"] = actor_id
+    if from_param is not None:
+        params["from"] = from_param
+    if to is not None:
+        params["to"] = to
+    if service_type is not None:
+        params["serviceType"] = service_type
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    try:
+        if limit > 0:
+            result = api.session.rest_get(url, params=params)
+            result = result or {}
+            items = result.get("items", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+        else:
+            items = list(api.session.follow_pagination(url=url, params=params, item_key="items"))
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[("ID", "id"), ("Name", "name")], limit=limit)
+
+
+
+@app.command("show")
+def show(
+    event_id: str = typer.Argument(help="eventId"),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Event Details."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/events/{event_id}"
+    try:
+        result = api.session.rest_get(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+

wxcli/commands/external_voicemail.py

@@ -0,0 +1,52 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+from wxcli.config import get_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling external-voicemail.")
+
+
+@app.command("create")
+def create(
+    id_param: str = typer.Option(..., "--id", help="Unique identifier for the user or workspace."),
+    action: str = typer.Option(None, "--action", help="(required) Choices: SET, CLEAR"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    output: str = typer.Option("id", "--output", "-o", help="Output format: id|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Set or Clear Message Waiting Indicator (MWI) Status."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/telephony/externalVoicemail/mwi"
+    params = {}
+    if id_param is not None:
+        params["id"] = id_param
+    org_id = get_org_id()
+    if org_id is not None:
+        params["orgId"] = org_id
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if action is not None:
+            body["action"] = action
+        _missing = [f for f in ['action'] if f not in body or body[f] is None]
+        if _missing:
+            typer.echo("Error: Missing required fields: " + ", ".join(_missing), err=True)
+            raise typer.Exit(1)
+    try:
+        result = api.session.rest_post(url, json=body, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    elif isinstance(result, dict) and "id" in result:
+        typer.echo(f"Created: {result['id']}")
+    elif not result or result == {}:
+        typer.echo("Created.")
+    else:
+        print_json(result)
+
+

wxcli/commands/groups.py

@@ -0,0 +1,206 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+from wxcli.config import get_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling groups.")
+
+
+@app.command("list")
+def cmd_list(
+    filter_param: str = typer.Option(None, "--filter", help="Searches the group by `displayName` with an operator and a v"),
+    attributes: str = typer.Option(None, "--attributes", help="The attributes to return."),
+    sort_by: str = typer.Option(None, "--sort-by", help="Sort the results based by group `displayName`."),
+    sort_order: str = typer.Option(None, "--sort-order", help="Sort results alphabetically by group display name, in ascend"),
+    include_members: str = typer.Option(None, "--include-members", help="Optionally return group members in the response. The maximum"),
+    start_index: str = typer.Option(None, "--start-index", help="The index to start for group pagination."),
+    count: str = typer.Option(None, "--count", help="Specifies the desired number of search results per page."),
+    output: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+    limit: int = typer.Option(0, "--limit", help="Max results (0=all for paginated endpoints, API default for non-paginated)"),
+    offset: int = typer.Option(0, "--offset", help="Start offset"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """List and Search Groups."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/groups"
+    params = {}
+    if filter_param is not None:
+        params["filter"] = filter_param
+    if attributes is not None:
+        params["attributes"] = attributes
+    if sort_by is not None:
+        params["sortBy"] = sort_by
+    if sort_order is not None:
+        params["sortOrder"] = sort_order
+    if include_members is not None:
+        params["includeMembers"] = include_members
+    if start_index is not None:
+        params["startIndex"] = start_index
+    if count is not None:
+        params["count"] = count
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    org_id = get_org_id()
+    if org_id is not None:
+        params["orgId"] = org_id
+    result = None
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    result = result or []
+    items = result.get("groups", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[('ID', 'id'), ('Display Name', 'displayName'), ('Member Count', 'memberSize')], limit=limit)
+
+
+
+@app.command("create")
+def create(
+    display_name: str = typer.Option(None, "--display-name", help="(required) A human-readable name for the Group."),
+    external_id: str = typer.Option(None, "--external-id", help="An identifier for the resource as defined by the provisionin"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    output: str = typer.Option("id", "--output", "-o", help="Output format: id|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Create a Group\n\nExample --json-body:\n  '{"schemas":["..."],"displayName":"...","externalId":"...","members":[{"value":"...","type":"..."}],"urn:scim:schemas:extension:cisco:webexidentity:2.0:Group":{"usage":"...","owners":["..."],"inheritances":["..."],"managedBy":["..."]}}'."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/groups"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if display_name is not None:
+            body["displayName"] = display_name
+        if external_id is not None:
+            body["externalId"] = external_id
+        _missing = [f for f in ['displayName'] if f not in body or body[f] is None]
+        if _missing:
+            typer.echo("Error: Missing required fields: " + ", ".join(_missing), err=True)
+            raise typer.Exit(1)
+    try:
+        result = api.session.rest_post(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    elif isinstance(result, dict) and "id" in result:
+        typer.echo(f"Created: {result['id']}")
+    elif not result or result == {}:
+        typer.echo("Created.")
+    else:
+        print_json(result)
+
+
+
+@app.command("show")
+def show(
+    group_id: str = typer.Argument(help="groupId"),
+    include_members: str = typer.Option(None, "--include-members", help="Include the members as part of the response."),
+    output: str = typer.Option("json", "--output", "-o", help="Output format: table|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Group Details."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/groups/{group_id}"
+    params = {}
+    if include_members is not None:
+        params["includeMembers"] = include_members
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    else:
+        if isinstance(result, dict):
+            print_table([result], columns=[("Key", ""), ("Value", "")], limit=0)
+        elif isinstance(result, list):
+            print_table(result, columns=[("ID", "id"), ("Name", "name")], limit=0)
+        else:
+            print_json(result)
+
+
+
+@app.command("update")
+def update(
+    group_id: str = typer.Argument(help="groupId"),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Update a Group\n\nExample --json-body:\n  '{"schemas":["..."],"Operations":[{"op":"...","path":"...","value":"..."}]}'."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/groups/{group_id}"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+    try:
+        result = api.session.rest_patch(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Updated.")
+
+
+
+@app.command("delete")
+def delete(
+    group_id: str = typer.Argument(help="groupId"),
+    force: bool = typer.Option(False, "--force", help="Skip confirmation"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Delete a Group."""
+    if not force:
+        typer.confirm(f"Delete {group_id}?", abort=True)
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/groups/{group_id}"
+    try:
+        api.session.rest_delete(url)
+    except WebexError as e:
+        handle_rest_error(e)
+    typer.echo(f"Deleted: {group_id}")
+
+
+
+@app.command("list-members")
+def list_members(
+    group_id: str = typer.Argument(help="groupId"),
+    start_index: str = typer.Option(None, "--start-index", help="The index to start for group pagination."),
+    count: str = typer.Option(None, "--count", help="Non-negative integer that specifies the desired number of se"),
+    output: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+    limit: int = typer.Option(0, "--limit", help="Max results (0=all for paginated endpoints, API default for non-paginated)"),
+    offset: int = typer.Option(0, "--offset", help="Start offset"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Group Members."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/groups/{group_id}/members"
+    params = {}
+    if start_index is not None:
+        params["startIndex"] = start_index
+    if count is not None:
+        params["count"] = count
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    result = None
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    result = result or []
+    items = result.get("members", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[('ID', 'id'), ('Display Name', 'displayName'), ('Member Count', 'memberSize')], limit=limit)
+
+

wxcli/commands/guest_management.py

@@ -0,0 +1,76 @@
+import json
+import typer
+from wxcli.auth import get_api
+from wxcli.errors import WebexError, handle_rest_error
+from wxcli.output import print_table, print_json
+
+
+app = typer.Typer(help="Manage Webex Calling guest-management.")
+
+
+@app.command("create")
+def create(
+    subject: str = typer.Option(None, "--subject", help="(required) The unique and external identifier of the guest."),
+    display_name: str = typer.Option(None, "--display-name", help="(required) The display name shown in the Webex application."),
+    json_body: str = typer.Option(None, "--json-body", help="Full JSON body (overrides other options)"),
+    output: str = typer.Option("id", "--output", "-o", help="Output format: id|json"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Create a Guest."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/guests/token"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+        if subject is not None:
+            body["subject"] = subject
+        if display_name is not None:
+            body["displayName"] = display_name
+        _missing = [f for f in ['subject', 'displayName'] if f not in body or body[f] is None]
+        if _missing:
+            typer.echo("Error: Missing required fields: " + ", ".join(_missing), err=True)
+            raise typer.Exit(1)
+    try:
+        result = api.session.rest_post(url, json=body)
+    except WebexError as e:
+        handle_rest_error(e)
+    if output == "json":
+        print_json(result)
+    elif isinstance(result, dict) and "id" in result:
+        typer.echo(f"Created: {result['id']}")
+    elif not result or result == {}:
+        typer.echo("Created.")
+    else:
+        print_json(result)
+
+
+
+@app.command("list")
+def cmd_list(
+    output: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+    limit: int = typer.Option(0, "--limit", help="Max results (0=all for paginated endpoints, API default for non-paginated)"),
+    offset: int = typer.Option(0, "--offset", help="Start offset"),
+    debug: bool = typer.Option(False, "--debug"),
+):
+    """Get Guest Count."""
+    api = get_api(debug=debug)
+    url = f"https://webexapis.com/v1/guests/count"
+    params = {}
+    if limit > 0:
+        params["max"] = limit
+    if offset > 0:
+        params["start"] = offset
+    result = None
+    try:
+        result = api.session.rest_get(url, params=params)
+    except WebexError as e:
+        handle_rest_error(e)
+    result = result or []
+    items = result.get("items", result.get("data", result if isinstance(result, list) else [])) if isinstance(result, dict) else (result if isinstance(result, list) else [])
+    if output == "json":
+        print_json(items)
+    else:
+        print_table(items, columns=[("ID", "id"), ("Name", "name")], limit=limit)
+
+