deepctl-cmd-members 0.0.2__tar.gz

deepctl_cmd_members-0.0.2/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: deepctl-cmd-members
+Version: 0.0.2
+Summary: Members management command for deepctl
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Keywords: deepgram,cli,members,team
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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: deepctl-core>=0.1.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+
+# deepctl-cmd-members
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Members management command for deepctl
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl members` | `deepctl_cmd_members.command:MembersCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_members-0.0.2/README.md

@@ -0,0 +1,42 @@
+# deepctl-cmd-members
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Members management command for deepctl
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl members` | `deepctl_cmd_members.command:MembersCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_members-0.0.2/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "deepctl-cmd-members"
+version = "0.0.2" # x-release-please-version
+description = "Members management command for deepctl"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "Deepgram", email = "devrel@deepgram.com" }]
+maintainers = [{ name = "Deepgram", email = "devrel@deepgram.com" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+keywords = ["deepgram", "cli", "members", "team"]
+requires-python = ">=3.10"
+dependencies = [
+    "deepctl-core>=0.1.10",
+    "click>=8.0.0",
+    "rich>=13.0.0",
+    "pydantic>=2.0.0",
+]
+
+[project.scripts]
+
+[project.entry-points."deepctl.commands"]
+members = "deepctl_cmd_members.command:MembersCommand"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["deepctl_cmd_members*"]

deepctl_cmd_members-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members/__init__.py

@@ -0,0 +1 @@
+"""Members management command for deepctl."""

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members/command.py

@@ -0,0 +1,261 @@
+"""Members management command for deepctl."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from deepctl_core import (
+    AuthManager,
+    BaseCommand,
+    BaseResult,
+    Config,
+    DeepgramClient,
+)
+from rich.console import Console
+from rich.table import Table
+
+from .models import InviteInfo, MemberInfo, MembersResult
+
+console = Console()
+
+
+class MembersCommand(BaseCommand):
+    """Command for managing project members."""
+
+    name = "members"
+    help = "Manage Deepgram project members"
+    short_help = "Manage members"
+
+    requires_auth = True
+    requires_project = True
+    ci_friendly = True
+
+    examples = [
+        "dg members",
+        "dg members --list",
+        "dg members --invite user@example.com --scope member",
+        "dg members --remove MEMBER_ID",
+        "dg members --invites",
+        "dg members --revoke-invite user@example.com",
+    ]
+    agent_help = (
+        "Manage project members and invitations. "
+        "List members, invite new ones, remove existing, and manage invites. "
+        "Requires authentication and a project ID."
+    )
+
+    def get_arguments(self) -> list[dict[str, Any]]:
+        return [
+            {
+                "names": ["--list", "-l"],
+                "help": "List all project members",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--invite", "-i"],
+                "help": "Invite a member by email",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--scope"],
+                "help": "Scope for invite (e.g., member, admin)",
+                "type": str,
+                "is_option": True,
+                "default": "member",
+            },
+            {
+                "names": ["--remove", "-r"],
+                "help": "Remove a member by ID",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--invites"],
+                "help": "List pending invites",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--revoke-invite"],
+                "help": "Revoke an invite by email",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--project-id", "-p"],
+                "help": "Project ID (uses configured project if not provided)",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--yes", "-y"],
+                "help": "Skip confirmation prompts",
+                "is_flag": True,
+                "is_option": True,
+            },
+        ]
+
+    def handle(
+        self,
+        config: Config,
+        auth_manager: AuthManager,
+        client: DeepgramClient,
+        **kwargs: Any,
+    ) -> BaseResult:
+        invite_email = kwargs.get("invite")
+        remove_id = kwargs.get("remove")
+        show_invites = kwargs.get("invites", False)
+        revoke_email = kwargs.get("revoke_invite")
+        project_id = kwargs.get("project_id")
+        yes = kwargs.get("yes", False)
+
+        try:
+            if invite_email:
+                return self._invite_member(
+                    client, invite_email, kwargs.get("scope", "member"), project_id
+                )
+            elif remove_id:
+                return self._remove_member(client, remove_id, project_id, yes)
+            elif show_invites:
+                return self._list_invites(client, project_id)
+            elif revoke_email:
+                return self._revoke_invite(client, revoke_email, project_id, yes)
+            else:
+                return self._list_members(client, project_id)
+
+        except Exception as e:
+            console.print(f"[red]Error:[/red] {e}")
+            return BaseResult(status="error", message=str(e))
+
+    def _list_members(
+        self, client: DeepgramClient, project_id: str | None
+    ) -> BaseResult:
+        console.print("[blue]Fetching project members...[/blue]")
+        result = client.list_members(project_id=project_id)
+
+        members_raw = result.get("members", [])
+        if not members_raw:
+            console.print("[yellow]No members found[/yellow]")
+            return MembersResult(status="info", message="No members found")
+
+        member_models: list[MemberInfo] = []
+        table = Table(
+            title="Project Members", show_header=True, header_style="bold blue"
+        )
+        table.add_column("Name", style="green")
+        table.add_column("Email")
+        table.add_column("Scopes")
+        table.add_column("Member ID", style="dim")
+
+        for m in members_raw:
+            m_data = (
+                m
+                if isinstance(m, dict)
+                else (m.__dict__ if hasattr(m, "__dict__") else {})
+            )
+            info = MemberInfo(
+                member_id=m_data.get("member_id", ""),
+                email=m_data.get("email", ""),
+                first_name=m_data.get("first_name", ""),
+                last_name=m_data.get("last_name", ""),
+                scopes=m_data.get("scopes", []),
+            )
+            member_models.append(info)
+
+            name = f"{info.first_name} {info.last_name}".strip() or "(no name)"
+            table.add_row(
+                name,
+                info.email,
+                ", ".join(info.scopes) if info.scopes else "-",
+                info.member_id,
+            )
+
+        console.print(table)
+        console.print(f"\n[dim]{len(member_models)} member(s)[/dim]")
+
+        return MembersResult(
+            status="success", members=member_models, count=len(member_models)
+        )
+
+    def _invite_member(
+        self,
+        client: DeepgramClient,
+        email: str,
+        scope: str,
+        project_id: str | None,
+    ) -> BaseResult:
+        console.print(f"[blue]Inviting {email} with scope '{scope}'...[/blue]")
+        client.create_invite(email=email, scope=scope, project_id=project_id)
+        console.print(f"[green]Invitation sent to {email}[/green]")
+        return BaseResult(status="success", message=f"Invited {email}")
+
+    def _remove_member(
+        self,
+        client: DeepgramClient,
+        member_id: str,
+        project_id: str | None,
+        yes: bool = False,
+    ) -> BaseResult:
+        if not yes and not self.confirm(
+            f"Remove member {member_id} from the project?", default=False
+        ):
+            return BaseResult(status="cancelled", message="Cancelled by user")
+
+        console.print(f"[blue]Removing member {member_id}...[/blue]")
+        client.remove_member(member_id, project_id=project_id)
+        console.print(f"[green]Member {member_id} removed[/green]")
+        return BaseResult(status="success", message=f"Member {member_id} removed")
+
+    def _list_invites(
+        self, client: DeepgramClient, project_id: str | None
+    ) -> BaseResult:
+        console.print("[blue]Fetching pending invites...[/blue]")
+        result = client.list_invites(project_id=project_id)
+
+        invites_raw = result.get("invites", [])
+        if not invites_raw:
+            console.print("[yellow]No pending invites[/yellow]")
+            return MembersResult(status="info", message="No pending invites")
+
+        invite_models: list[InviteInfo] = []
+        table = Table(
+            title="Pending Invites", show_header=True, header_style="bold blue"
+        )
+        table.add_column("Email", style="green")
+        table.add_column("Scope")
+
+        for inv in invites_raw:
+            inv_data = (
+                inv
+                if isinstance(inv, dict)
+                else (inv.__dict__ if hasattr(inv, "__dict__") else {})
+            )
+            info = InviteInfo(
+                email=inv_data.get("email", ""),
+                scope=inv_data.get("scope", ""),
+            )
+            invite_models.append(info)
+            table.add_row(info.email, info.scope)
+
+        console.print(table)
+
+        return MembersResult(
+            status="success", invites=invite_models, count=len(invite_models)
+        )
+
+    def _revoke_invite(
+        self,
+        client: DeepgramClient,
+        email: str,
+        project_id: str | None,
+        yes: bool = False,
+    ) -> BaseResult:
+        if not yes and not self.confirm(f"Revoke invite for {email}?", default=False):
+            return BaseResult(status="cancelled", message="Cancelled by user")
+
+        console.print(f"[blue]Revoking invite for {email}...[/blue]")
+        client.delete_invite(email, project_id=project_id)
+        console.print(f"[green]Invite for {email} revoked[/green]")
+        return BaseResult(status="success", message=f"Invite for {email} revoked")

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members/models.py

@@ -0,0 +1,25 @@
+"""Models for members command."""
+
+from __future__ import annotations
+
+from deepctl_core import BaseResult
+from pydantic import BaseModel, Field
+
+
+class MemberInfo(BaseModel):
+    member_id: str = ""
+    email: str = ""
+    first_name: str = ""
+    last_name: str = ""
+    scopes: list[str] = Field(default_factory=list)
+
+
+class InviteInfo(BaseModel):
+    email: str = ""
+    scope: str = ""
+
+
+class MembersResult(BaseResult):
+    members: list[MemberInfo] = Field(default_factory=list)
+    invites: list[InviteInfo] = Field(default_factory=list)
+    count: int = 0

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: deepctl-cmd-members
+Version: 0.0.2
+Summary: Members management command for deepctl
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Keywords: deepgram,cli,members,team
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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: deepctl-core>=0.1.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+
+# deepctl-cmd-members
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Members management command for deepctl
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl members` | `deepctl_cmd_members.command:MembersCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/deepctl_cmd_members/__init__.py
+src/deepctl_cmd_members/command.py
+src/deepctl_cmd_members/models.py
+src/deepctl_cmd_members.egg-info/PKG-INFO
+src/deepctl_cmd_members.egg-info/SOURCES.txt
+src/deepctl_cmd_members.egg-info/dependency_links.txt
+src/deepctl_cmd_members.egg-info/entry_points.txt
+src/deepctl_cmd_members.egg-info/requires.txt
+src/deepctl_cmd_members.egg-info/top_level.txt

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[deepctl.commands]
+members = deepctl_cmd_members.command:MembersCommand

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members.egg-info/requires.txt

@@ -0,0 +1,4 @@
+deepctl-core>=0.1.10
+click>=8.0.0
+rich>=13.0.0
+pydantic>=2.0.0

deepctl_cmd_members-0.0.2/src/deepctl_cmd_members.egg-info/top_level.txt

@@ -0,0 +1 @@
+deepctl_cmd_members