wxcli 1.2.0__py3-none-any.whl

wxcli/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '1.2.0'
+__version_tuple__ = version_tuple = (1, 2, 0)
+
+__commit_id__ = commit_id = None

wxcli/auth.py

@@ -0,0 +1,137 @@
+import os
+import time
+import logging
+from pathlib import Path
+
+import httpx
+import typer
+
+from wxcli.config import DEFAULT_CONFIG_PATH, get_token
+from wxcli.errors import WebexError
+
+logger = logging.getLogger("wxcli")
+
+# Bounded retry policy. Opt out (scripted contexts) with WXCLI_NO_RETRY=1.
+MAX_RETRIES_429 = 3
+MAX_RETRY_AFTER_SECONDS = 30
+
+
+class WebexSession:
+    def __init__(self, token: str):
+        self._token = token
+
+    def _headers(self, content_type: str | None = None) -> dict:
+        return {
+            "Authorization": f"Bearer {self._token}",
+            "Content-Type": content_type or "application/json",
+        }
+
+    def _request(self, method: str, url: str, json=None, params=None,
+                 content_type: str | None = None) -> httpx.Response:
+        """Single HTTP path for all verbs: bounded 429/Retry-After honor +
+        one connect-error retry. WXCLI_NO_RETRY=1 disables both."""
+        retry_enabled = not os.environ.get("WXCLI_NO_RETRY")
+        retries_429 = MAX_RETRIES_429 if retry_enabled else 0
+        connect_retries = 1 if retry_enabled else 0
+        while True:
+            try:
+                response = httpx.request(
+                    method, url, headers=self._headers(content_type),
+                    json=json, params=params,
+                )
+            except (httpx.ConnectError, httpx.ConnectTimeout) as e:
+                if connect_retries:
+                    connect_retries -= 1
+                    logger.warning("Connect error on %s %s (%s) — retrying once", method, url, e)
+                    continue
+                raise
+            if response.status_code == 429 and retries_429:
+                retries_429 -= 1
+                try:
+                    delay = min(int(response.headers.get("Retry-After", 5)), MAX_RETRY_AFTER_SECONDS)
+                except ValueError:
+                    delay = 5
+                logger.warning("429 on %s %s — waiting %ss (Retry-After)", method, url, delay)
+                time.sleep(delay)
+                continue
+            return response
+
+    def _json_or_raise(self, response: httpx.Response) -> dict:
+        if not response.is_success:
+            body = None
+            try:
+                body = response.json() if response.content else None
+            except ValueError:
+                pass
+            raise WebexError(response.text, status_code=response.status_code, body=body)
+        return response.json() if response.content else {}
+
+    def rest_get(self, url: str, params=None) -> dict:
+        return self._json_or_raise(self._request("GET", url, params=params))
+
+    def rest_put(self, url: str, json=None, params=None) -> dict:
+        return self._json_or_raise(self._request("PUT", url, json=json, params=params))
+
+    def rest_post(self, url: str, json=None, params=None) -> dict:
+        return self._json_or_raise(self._request("POST", url, json=json, params=params))
+
+    def rest_patch(self, url: str, json=None, params=None, content_type: str | None = None) -> dict:
+        return self._json_or_raise(self._request("PATCH", url, json=json, params=params,
+                                                 content_type=content_type))
+
+    def rest_delete(self, url: str, params=None) -> dict:
+        return self._json_or_raise(self._request("DELETE", url, params=params))
+
+    def follow_pagination(self, url: str, params=None, item_key: str = "items"):
+        while url:
+            response = self._request("GET", url, params=params)
+            if not response.is_success:
+                raise WebexError(response.text, status_code=response.status_code)
+            data = response.json() if response.content else {}
+            yield from (data.get(item_key, []) if isinstance(data, dict) else [])
+            link = response.headers.get("Link", "")
+            url = None
+            for part in link.split(","):
+                part = part.strip()
+                if 'rel="next"' in part:
+                    url = part.split(";")[0].strip().strip("<>")
+                    break
+            params = None
+
+
+class WebexApi:
+    def __init__(self, session: WebexSession):
+        self.session = session
+
+
+def resolve_token(config_path: Path | None = DEFAULT_CONFIG_PATH) -> str | None:
+    """Resolve token: WEBEX_ACCESS_TOKEN env → WEBEX_TOKEN env → config file."""
+    token = os.environ.get("WEBEX_ACCESS_TOKEN")
+    if token:
+        return token
+    token = os.environ.get("WEBEX_TOKEN")
+    if token:
+        return token
+    if config_path:
+        return get_token(config_path)
+    return None
+
+
+def get_api(debug: bool = False) -> WebexApi:
+    """Get a configured WebexApi instance, or exit with error."""
+    if debug:
+        logging.basicConfig(level=logging.DEBUG)
+        logger.setLevel(logging.DEBUG)
+
+    token = resolve_token()
+    if not token:
+        typer.echo("Error: No token found. Run 'wxcli configure' or set WEBEX_ACCESS_TOKEN.", err=True)
+        raise typer.Exit(1)
+
+    try:
+        api = WebexApi(WebexSession(token))
+    except Exception as e:
+        typer.echo(f"Error: Failed to initialize API: {e}", err=True)
+        raise typer.Exit(1)
+
+    return api

wxcli/commands/_registry.py

@@ -0,0 +1,181 @@
+"""Registration manifest for generated command groups.
+
+Emitted by tools/generate_commands.py — do NOT edit by hand.
+main.py imports GENERATED_GROUPS and mounts each (module, group) pair;
+hand-written seams, aliases, and the dev-only fs_* block stay explicit
+in main.py. A stale entry whose module is missing fails import loudly.
+"""
+
+GENERATED_GROUPS = [
+    ("activation_email", "activation-email"),
+    ("admin_recordings", "admin-recordings"),
+    ("analytics", "analytics"),
+    ("announcement_playlists", "announcement-playlists"),
+    ("announcements", "announcements"),
+    ("archive_users", "archive-users"),
+    ("attachment_actions", "attachment-actions"),
+    ("audit_events", "audit-events"),
+    ("authorizations", "authorizations"),
+    ("auto_attendant", "auto-attendant"),
+    ("broadworks_billing_reports", "broadworks-billing-reports"),
+    ("broadworks_enterprises", "broadworks-enterprises"),
+    ("broadworks_subscribers", "broadworks-subscribers"),
+    ("broadworks_workspaces", "broadworks-workspaces"),
+    ("call_controls", "call-controls"),
+    ("call_park", "call-park"),
+    ("call_pickup", "call-pickup"),
+    ("call_queue", "call-queue"),
+    ("call_recording", "call-recording"),
+    ("call_routing", "call-routing"),
+    ("call_settings_for_me_phase_5", "call-settings-for-me-phase-5"),
+    ("caller_reputation", "caller-reputation"),
+    ("calling_service", "calling-service"),
+    ("cc_address_book", "cc-address-book"),
+    ("cc_agent_greetings", "cc-agent-greetings"),
+    ("cc_agent_summaries", "cc-agent-summaries"),
+    ("cc_agent_wellbeing", "cc-agent-wellbeing"),
+    ("cc_agents", "cc-agents"),
+    ("cc_ai_assistant", "cc-ai-assistant"),
+    ("cc_ai_feature", "cc-ai-feature"),
+    ("cc_audio_files", "cc-audio-files"),
+    ("cc_auto_csat", "cc-auto-csat"),
+    ("cc_aux_code", "cc-aux-code"),
+    ("cc_business_hour", "cc-business-hour"),
+    ("cc_call_monitoring", "cc-call-monitoring"),
+    ("cc_callbacks", "cc-callbacks"),
+    ("cc_campaign", "cc-campaign"),
+    ("cc_captures", "cc-captures"),
+    ("cc_contact_list", "cc-contact-list"),
+    ("cc_contact_number", "cc-contact-number"),
+    ("cc_data_sources", "cc-data-sources"),
+    ("cc_desktop_layout", "cc-desktop-layout"),
+    ("cc_desktop_profile", "cc-desktop-profile"),
+    ("cc_dial_number", "cc-dial-number"),
+    ("cc_dial_plan", "cc-dial-plan"),
+    ("cc_dnc", "cc-dnc"),
+    ("cc_entry_point", "cc-entry-point"),
+    ("cc_ewt", "cc-ewt"),
+    ("cc_flow", "cc-flow"),
+    ("cc_global_vars", "cc-global-vars"),
+    ("cc_holiday_list", "cc-holiday-list"),
+    ("cc_journey", "cc-journey"),
+    ("cc_legacy_flows", "cc-legacy-flows"),
+    ("cc_multimedia_profile", "cc-multimedia-profile"),
+    ("cc_notification", "cc-notification"),
+    ("cc_outdial_ani", "cc-outdial-ani"),
+    ("cc_overrides", "cc-overrides"),
+    ("cc_queue", "cc-queue"),
+    ("cc_queue_stats", "cc-queue-stats"),
+    ("cc_realtime", "cc-realtime"),
+    ("cc_resource_collection", "cc-resource-collection"),
+    ("cc_search", "cc-search"),
+    ("cc_site", "cc-site"),
+    ("cc_skill", "cc-skill"),
+    ("cc_skill_profile", "cc-skill-profile"),
+    ("cc_subscriptions", "cc-subscriptions"),
+    ("cc_summaries", "cc-summaries"),
+    ("cc_tasks", "cc-tasks"),
+    ("cc_team", "cc-team"),
+    ("cc_user_profiles", "cc-user-profiles"),
+    ("cc_users", "cc-users"),
+    ("cc_work_types", "cc-work-types"),
+    ("cdr", "cdr"),
+    ("classifications", "classifications"),
+    ("client_settings", "client-settings"),
+    ("conference", "conference"),
+    ("converged_recordings", "converged-recordings"),
+    ("cq_playlists", "cq-playlists"),
+    ("customer_assist", "customer-assist"),
+    ("data_sources", "data-sources"),
+    ("dect_devices", "dect-devices"),
+    ("device_configurations", "device-configurations"),
+    ("device_dynamic_settings", "device-dynamic-settings"),
+    ("device_settings", "device-settings"),
+    ("devices", "devices"),
+    ("domains", "domains"),
+    ("ecm", "ecm"),
+    ("emergency_services", "emergency-services"),
+    ("events", "events"),
+    ("external_voicemail", "external-voicemail"),
+    ("groups", "groups"),
+    ("guest_management", "guest-management"),
+    ("hds", "hds"),
+    ("hot_desk", "hot-desk"),
+    ("hot_desking_members", "hot-desking-members"),
+    ("hot_desking_portal", "hot-desking-portal"),
+    ("hunt_group", "hunt-group"),
+    ("hybrid_clusters", "hybrid-clusters"),
+    ("hybrid_connectors", "hybrid-connectors"),
+    ("identity_org", "identity-org"),
+    ("licenses", "licenses"),
+    ("live_monitoring", "live-monitoring"),
+    ("location_call_handling", "location-call-handling"),
+    ("location_schedules", "location-schedules"),
+    ("location_settings", "location-settings"),
+    ("location_voicemail", "location-voicemail"),
+    ("locations", "locations"),
+    ("meeting_captions", "meeting-captions"),
+    ("meeting_chats", "meeting-chats"),
+    ("meeting_invitees", "meeting-invitees"),
+    ("meeting_messages", "meeting-messages"),
+    ("meeting_participants", "meeting-participants"),
+    ("meeting_polls", "meeting-polls"),
+    ("meeting_preferences", "meeting-preferences"),
+    ("meeting_qa", "meeting-qa"),
+    ("meeting_qualities", "meeting-qualities"),
+    ("meeting_reports", "meeting-reports"),
+    ("meeting_session_types", "meeting-session-types"),
+    ("meeting_site", "meeting-site"),
+    ("meeting_slido", "meeting-slido"),
+    ("meeting_summaries", "meeting-summaries"),
+    ("meeting_tracking_codes", "meeting-tracking-codes"),
+    ("meeting_transcripts", "meeting-transcripts"),
+    ("meetings", "meetings"),
+    ("memberships", "memberships"),
+    ("messages", "messages"),
+    ("mode_management", "mode-management"),
+    ("my_call_settings", "my-call-settings"),
+    ("numbers", "numbers"),
+    ("operating_modes", "operating-modes"),
+    ("org_contacts", "org-contacts"),
+    ("org_settings", "org-settings"),
+    ("organizations", "organizations"),
+    ("paging_group", "paging-group"),
+    ("partner_admins", "partner-admins"),
+    ("partner_reports", "partner-reports"),
+    ("partner_tags", "partner-tags"),
+    ("people", "people"),
+    ("person_call_settings", "person-call-settings"),
+    ("pstn", "pstn"),
+    ("recording_report", "recording-report"),
+    ("report_templates", "report-templates"),
+    ("reports", "reports"),
+    ("resource_group_memberships", "resource-group-memberships"),
+    ("resource_groups", "resource-groups"),
+    ("roles", "roles"),
+    ("room_tabs", "room-tabs"),
+    ("rooms", "rooms"),
+    ("scim_bulk", "scim-bulk"),
+    ("scim_groups", "scim-groups"),
+    ("scim_schemas", "scim-schemas"),
+    ("scim_users", "scim-users"),
+    ("security_audit", "security-audit"),
+    ("service_apps", "service-apps"),
+    ("single_number_reach", "single-number-reach"),
+    ("team_memberships", "team-memberships"),
+    ("teams", "teams"),
+    ("ucm_profile", "ucm-profile"),
+    ("user_settings", "user-settings"),
+    ("video_mesh", "video-mesh"),
+    ("virtual_extensions", "virtual-extensions"),
+    ("virtual_line_settings", "virtual-line-settings"),
+    ("webhooks", "webhooks"),
+    ("wholesale_billing_reports", "wholesale-billing-reports"),
+    ("wholesale_provisioning", "wholesale-provisioning"),
+    ("workspace_locations", "workspace-locations"),
+    ("workspace_metrics", "workspace-metrics"),
+    ("workspace_personalization", "workspace-personalization"),
+    ("workspace_settings", "workspace-settings"),
+    ("workspaces", "workspaces"),
+    ("xapi", "xapi"),
+]

wxcli/commands/activation_email.py

@@ -0,0 +1,103 @@
+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 resolve_org_id
+
+
+app = typer.Typer(help="Manage Webex Calling activation-email.")
+
+
+@app.command("create")
+def create(
+    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"),
+):
+    """Initiate Bulk Activation Email Resend Job."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/organizations/{org_id}/jobs/sendActivationEmails"
+    if json_body:
+        body = json.loads(json_body)
+    else:
+        body = {}
+    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(
+    job_id: str = typer.Argument(help="jobId"),
+    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 Bulk Activation Email Resend Job Status."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/organizations/{org_id}/jobs/sendActivationEmails/{job_id}/status"
+    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("jobExecutionStatus", 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)
+
+
+
+@app.command("list-errors")
+def list_errors(
+    job_id: str = typer.Argument(help="jobId"),
+    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 Bulk Activation Email Resend Job Errors."""
+    api = get_api(debug=debug)
+    org_id = resolve_org_id(api.session)
+    url = f"https://webexapis.com/identity/organizations/{org_id}/jobs/sendActivationEmails/{job_id}/errors"
+    params = {}
+    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)
+
+