exploitsynth 0.3.2__tar.gz → 0.3.3__tar.gz

{exploitsynth-0.3.2 → exploitsynth-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exploitsynth
-Version: 0.3.2
+Version: 0.3.3
 Summary: ExploitSynth scanner CLI — AI port-identification from your terminal
 Project-URL: Homepage, https://scan.exploitsynth.com
 Project-URL: Documentation, https://scan.exploitsynth.com/docs

{exploitsynth-0.3.2 → exploitsynth-0.3.3}/exploitsynth/__init__.py

@@ -1,3 +1,3 @@
 """ExploitSynth scanner CLI."""
 
-__version__ = "0.3.2"
+__version__ = "0.3.3"

{exploitsynth-0.3.2 → exploitsynth-0.3.3}/exploitsynth/cli.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import json
 import re
 import sys
 from pathlib import Path
@@ -63,6 +64,68 @@ def _client() -> Client:
         output.fail(str(e))
 
 
+def _resolve_scan_id(client: Client, partial: str) -> str:
+    """Accept a full UUID or the short prefix that `scans` prints (e.g. 004bafa9)."""
+    p = partial.strip()
+    if len(p) >= 32:  # already a full UUID
+        return p
+    try:
+        rows = client.list_scans(limit=100)
+    except ApiError as e:
+        output.fail(str(e))
+    matches = [str(r["id"]) for r in rows if str(r.get("id", "")).startswith(p)]
+    if not matches:
+        output.fail(f"No recent scan matching '{partial}'.")
+    if len(matches) > 1:
+        output.fail(f"'{partial}' matches several scans; use more characters.")
+    return matches[0]
+
+
+def _render_scan(
+    client: Client,
+    scan_id: str,
+    *,
+    reasoning: bool = False,
+    output_path: "Optional[Path]" = None,
+    json_output: bool = False,
+) -> None:
+    """Fetch one scan and print its results; optionally save the full payload to a file."""
+    full_id = _resolve_scan_id(client, scan_id)
+    try:
+        data = client.get_scan(full_id)
+    except ApiError as e:
+        output.fail(str(e))
+
+    if output_path is not None:
+        output_path.write_text(json.dumps(data, indent=2) + "\n")
+        output.note(f"Saved results to {output_path}")
+
+    if json_output:
+        output.emit_json(data)
+        return
+
+    scan = data["scan"]
+    results = data["results"]
+
+    header = Text()
+    header.append(scan.get("ip", "?"), style="bold white")
+    header.append(f"   {scan.get('status', '?')}", style="dim")
+    out.print(header)
+
+    if not results:
+        out.print(Text("No services identified.", style="dim"))
+    else:
+        out.print(results_table(results))
+        if reasoning:
+            for r in sorted(results, key=lambda x: x.get("port", 0)):
+                if r.get("extra_info"):
+                    out.print(Text(f"\n:{r.get('port')}  {r.get('extra_info')}", style="dim"))
+
+    if scan.get("summary"):
+        out.print(Text("\nSummary", style="bold"))
+        out.print(Text(scan["summary"], style="dim"))
+
+
 # ─────────────────────────── login ───────────────────────────
 @app.command()
 def login(
@@ -324,17 +387,24 @@ def scan(
 # ─────────────────────────── scans (list) ─────────────────────
 @app.command(name="scans")
 def list_scans(
+    scan_id: Optional[str] = typer.Argument(None, help="A scan id (full or short) to view its results; omit to list."),
     project: Optional[str] = typer.Option(None, "--project", help="Filter by project name."),
     limit: int = typer.Option(20, "--limit", "-n", help="Max rows."),
+    output_path: Optional[Path] = typer.Option(None, "--output", "-o", help="When viewing one scan, save its results as JSON here."),
     json_output: bool = JSON_OPT,
 ):
-    """List recent scans.
+    """List recent scans, or view one: `exploitsynth scans <id>`.
 
     Example:
       exploitsynth scans --json | jq '.[] | {id, status}'
     """
     output.set_json(json_output)
     client = _client()
+
+    if scan_id:
+        _render_scan(client, scan_id, output_path=output_path, json_output=json_output)
+        return
+
     try:
         rows = client.list_scans(project=project, limit=limit)
     except ApiError as e:
@@ -370,43 +440,15 @@ def list_scans(
 # ─────────────────────────── show ────────────────────────────
 @app.command()
 def show(
-    scan_id: str = typer.Argument(..., help="Scan id (full UUID)."),
+    scan_id: str = typer.Argument(..., help="Scan id (full UUID or the short prefix `scans` prints)."),
     reasoning: bool = typer.Option(False, "--reasoning", "-r", help="Include the agent's reasoning per port."),
+    output_path: Optional[Path] = typer.Option(None, "--output", "-o", help="Save the full results as JSON to this file."),
     json_output: bool = JSON_OPT,
 ):
     """Show one scan's results."""
     output.set_json(json_output)
     client = _client()
-    try:
-        data = client.get_scan(scan_id)
-    except ApiError as e:
-        output.fail(str(e))
-
-    if json_output:
-        output.emit_json(data)
-        return
-
-    scan = data["scan"]
-    results = data["results"]
-
-    header = Text()
-    header.append(scan.get("ip", "?"), style="bold white")
-    header.append(f"   {scan.get('status', '?')}", style="dim")
-    out.print(header)
-
-    if not results:
-        out.print(Text("No services identified.", style="dim"))
-    else:
-        out.print(results_table(results))
-
-        if reasoning:
-            for r in sorted(results, key=lambda x: x.get("port", 0)):
-                if r.get("extra_info"):
-                    out.print(Text(f"\n:{r.get('port')} — {r.get('extra_info')}", style="dim"))
-
-    if scan.get("summary"):
-        out.print(Text("\nSummary", style="bold"))
-        out.print(Text(scan["summary"], style="dim"))
+    _render_scan(client, scan_id, reasoning=reasoning, output_path=output_path, json_output=json_output)
 
 
 # ─────────────────────────── credits ─────────────────────────

{exploitsynth-0.3.2 → exploitsynth-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "exploitsynth"
-version = "0.3.2"
+version = "0.3.3"
 description = "ExploitSynth scanner CLI — AI port-identification from your terminal"
 readme = "README.md"
 requires-python = ">=3.9"