qbraid-cli 0.15.4__tar.gz → 0.16.0__tar.gz

{qbraid_cli-0.15.4/qbraid_cli.egg-info → qbraid_cli-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.15.4
+Version: 0.16.0
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License-Expression: LicenseRef-Proprietary

{qbraid_cli-0.15.4 → qbraid_cli-0.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qbraid-cli"
-version = "0.15.4"
+version = "0.16.0"
 description = "Command Line Interface for interacting with all parts of the qBraid platform."
 readme = "README.md"
 authors = [{ name = "qBraid Development Team", email = "contact@qbraid.com" }]

{qbraid_cli-0.15.4 → qbraid_cli-0.16.0}/qbraid_cli/skills/app.py

@@ -6,6 +6,7 @@ Module defining commands in the 'qbraid skills' namespace.
 
 """
 
+import json
 from enum import Enum
 from typing import Optional
 
@@ -68,6 +69,23 @@ class VisibilityOption(str, Enum):
 # =============================================================================
 
 
+def _emit_skills_json(skills) -> None:
+    """Print skills as a JSON array on stdout, and nothing else.
+
+    Agents discover most skills through `qbraid skills list` / `search` rather
+    than having them installed, so this output is a discovery surface, not a
+    convenience. The table truncates descriptions (40-50 chars), and a
+    description is exactly what an agent matches against to decide whether a
+    skill applies -- truncating it hides the words that would have triggered it.
+    JSON carries them in full.
+
+    Uses `print`, not `console.print`: Rich would interpret square brackets in a
+    description as markup and mangle the payload.
+    """
+    payload = [skill.model_dump(mode="json", by_alias=True, exclude_none=True) for skill in skills]
+    print(json.dumps(payload, indent=2))
+
+
 @skills_app.command(name="list")
 def skills_list(
     query: Optional[str] = typer.Option(None, "--query", "-q", help="Search query for skills"),
@@ -76,8 +94,12 @@ def skills_list(
         None, "--visibility", "-v", help="Filter by visibility"
     ),
     limit: int = typer.Option(20, "--limit", "-l", help="Maximum number of results"),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON array (for programmatic use)"),
 ) -> None:
-    """List available qBraid skills."""
+    """List available qBraid skills.
+
+    Pass --json for the full, untruncated records.
+    """
 
     def fetch_skills():
         from qbraid_core.services.skills import SkillsClient
@@ -88,7 +110,13 @@ def skills_list(
         return client.list_skills(query=query, tags=tag_list, visibility=vis, limit=limit)
 
     try:
-        skills = run_progress_task(fetch_skills)
+        # Skip the progress spinner for --json: Rich writes it to the same
+        # stream, and a caller piping this into a parser gets the spinner too.
+        skills = fetch_skills() if json_output else run_progress_task(fetch_skills)
+
+        if json_output:
+            _emit_skills_json(skills)
+            return
 
         console = Console()
 
@@ -128,8 +156,12 @@ def skills_list(
 def skills_search(
     query: str = typer.Argument(..., help="Search query"),
     limit: int = typer.Option(10, "--limit", "-l", help="Maximum number of results"),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON array (for programmatic use)"),
 ) -> None:
-    """Search for qBraid skills."""
+    """Search for qBraid skills.
+
+    Pass --json for the full, untruncated records.
+    """
 
     def fetch_skills():
         from qbraid_core.services.skills import SkillsClient
@@ -138,7 +170,11 @@ def skills_search(
         return client.list_skills(query=query, limit=limit)
 
     try:
-        skills = run_progress_task(fetch_skills)
+        skills = fetch_skills() if json_output else run_progress_task(fetch_skills)
+
+        if json_output:
+            _emit_skills_json(skills)
+            return
 
         console = Console()
 

{qbraid_cli-0.15.4 → qbraid_cli-0.16.0/qbraid_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.15.4
+Version: 0.16.0
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License-Expression: LicenseRef-Proprietary