slab-cli 0.2.0__tar.gz → 0.4.0__tar.gz

{slab_cli-0.2.0 → slab_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: slab-cli
-Version: 0.2.0
+Version: 0.4.0
 Summary: CLI for the slab trading-card API — catalog, collect, and track your cards from the terminal.
 Author: dev_jeb
 Requires-Dist: slab-schemas>=0.1.0

{slab_cli-0.2.0 → slab_cli-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "slab-cli"
-version = "0.2.0"
+version = "0.4.0"
 description = "CLI for the slab trading-card API — catalog, collect, and track your cards from the terminal."
 readme = "README.md"
 authors = [{name = "dev_jeb"}]

{slab_cli-0.2.0 → slab_cli-0.4.0}/src/slab_cli/commands/catalog.py

@@ -21,10 +21,14 @@ def cmd_search(args: list[str]) -> None:
     The same flags work on `slab collection search` — learn them once.
 
     Examples:
-      slab card search McDavid --rookie
-      slab card search Bedard --year 2025 --numbered
-      slab card search --brand "Upper Deck" --base --limit 50
-      slab card search --team "Minnesota Wild" --auto
+      slab card search McDavid --rookie                 # free text + one filter
+      slab card search Bedard --year 2025 --numbered    # season + serial-numbered only
+      slab card search --team Bruins --team Leafs        # any-of: either team
+      slab card search --brand "Upper Deck" --run-min 1 --run-max 99   # print-run range
+      slab card search McDavid --auto --parallel --sort -year   # stack modifiers, newest first
+      slab card search --subset "Young Guns" --rookie --limit 50
+
+    Every flag combines with AND; repeat an any-of flag (--team, --brand, --finish…) to widen it.
 
     Sort keys: year, card_number, numbered, subject, brand, set (prefix - for descending).
     """

slab_cli-0.4.0/src/slab_cli/commands/setup.py

@@ -0,0 +1,51 @@
+"""Setup commands — check identity.
+
+Collectors are NOT created here. Your account and its collector are provisioned when you sign up
+in the portal; the CLI just consumes the API key and collector UUID you get there. SLAB_COLLECTOR
+is required and explicit — the CLI does not guess a collector from the account, so you must set it
+to the UUID you copy from the portal (Settings).
+"""
+
+from __future__ import annotations
+
+from slab_schemas.account import MeOut
+
+from ..config import get_collector_uuid
+from ..context import ctx
+from ..display import console
+
+
+def cmd_whoami(args: list[str]) -> None:
+    """Show the active collector — and VALIDATE it against your account. SLAB_COLLECTOR is just a
+    string until it's checked, so this resolves it against the account behind your API key and
+    prints the collector's name. A wrong or stale UUID is caught HERE (with the list of collectors
+    you actually own) instead of surfacing later as a cryptic 'collector not found' mid-command."""
+    me = ctx.client.get_account_context()
+    names = {c.uuid: c.name for c in me.collectors}
+    uuid = get_collector_uuid()
+
+    if not uuid:
+        console.print("[yellow]SLAB_COLLECTOR is not set.[/yellow]")
+        _print_collectors(me, names)
+        return
+
+    name = names.get(uuid)
+    if name is None:
+        console.print(f"[red]SLAB_COLLECTOR is {uuid},[/red]")
+        console.print("[red]but that isn't a collector on this account.[/red]")
+        _print_collectors(me, names)
+        return
+
+    console.print(f"Active collector: [bold]{name}[/bold]  [dim]{uuid}[/dim]")
+
+
+def _print_collectors(me: MeOut, names: dict[str, str]) -> None:
+    """List the account's real collectors (marking the default) so the user knows what to set."""
+    if not names:
+        console.print("[dim]This account has no collectors yet.[/dim]")
+        return
+    console.print("[dim]Collectors on this account:[/dim]")
+    for c in me.collectors:
+        tag = " [dim](default)[/dim]" if c.uuid == me.default_collector_uuid else ""
+        console.print(f"  [bold]{c.name}[/bold]{tag}  [dim]{c.uuid}[/dim]")
+    console.print("[dim]Set one:  export SLAB_COLLECTOR=<uuid>[/dim]")

{slab_cli-0.2.0 → slab_cli-0.4.0}/src/slab_cli/context.py

@@ -5,11 +5,8 @@ calling _client()/_require_collector() themselves."""
 
 from __future__ import annotations
 
-import sys
-
 from .client import SlabClient
 from .config import get_api_key, get_base_url, get_collector_uuid
-from .display import console
 
 
 class MissingCollector(Exception):
@@ -31,21 +28,13 @@ class CliContext:
 
     @property
     def collector(self) -> str:
-        """The active collector UUID. Resolution order: SLAB_COLLECTOR env var, then — for a
-        single-collector (`collector`) account only — the account's default collector, so a solo
-        user needs just their API key. A `developer` account owns many collectors (one per
-        end-user), so there is NO safe default: it must set SLAB_COLLECTOR explicitly, or this
-        raises MissingCollector. Cached per invocation."""
+        """The active collector UUID, from the SLAB_COLLECTOR env var. Required and explicit — the
+        CLI does not guess or auto-resolve a collector from the account. Copy your collector's UUID
+        from the portal (Settings) and set SLAB_COLLECTOR to it; if it's unset this raises
+        MissingCollector. Cached per invocation."""
         if self._collector:
             return self._collector
         uuid = get_collector_uuid()
-        if not uuid:
-            # No explicit collector. Only a single-collector account may zero-config fall back to
-            # its default; a developer account has no unambiguous default and must set one.
-            me = self.client.get_account_context()
-            if me.account.account_type == "developer":
-                raise MissingCollector
-            uuid = me.default_collector_uuid
         if not uuid:
             raise MissingCollector
         self._collector = uuid

{slab_cli-0.2.0 → slab_cli-0.4.0}/src/slab_cli/help.py

@@ -66,9 +66,25 @@ def render_command_help(group: Group, command: Command) -> None:
         for f in flags:
             grid.add_row(f"    {f.usage()}", f.help)
         console.print(grid)
+        _render_query_grammar()
     console.print()
 
 
+def _render_query_grammar() -> None:
+    """A generic primer on how the search grammar composes — printed under every command's flag
+    table. It describes the mechanics (free text, any-of, ranges, AND), never specific flags, so it
+    stays true no matter how the flag list evolves."""
+    console.print(Text.from_markup(
+        "\n  [slab.label]Writing a query[/]"
+        "\n    [slab.dim]Bare words are a free-text search (player, set…).[/]"
+        "\n    [slab.dim]Flags narrow it, and every flag you add combines with AND.[/]"
+        "\n    [slab.dim]Repeat an 'any-of' flag to match several values:[/] "
+        "[slab.value]--team Bruins --team Leafs[/]"
+        "\n    [slab.dim]Pair a[/] [slab.value]--…-min[/] [slab.dim]with its[/] [slab.value]--…-max[/] "
+        "[slab.dim]for a range:[/] [slab.value]--run-min 1 --run-max 99[/]"
+    ))
+
+
 def render_root_help() -> None:
     """`slab` — the whole command surface, grouped by noun. The discovery home."""
     console.print(BANNER)

{slab_cli-0.2.0 → slab_cli-0.4.0}/src/slab_cli/main.py

@@ -8,6 +8,7 @@ one group; `slab <group> <command> --help` explains a single command.
 
 from __future__ import annotations
 
+import re
 import sys
 
 from .client import ApiConnectionError, ApiError
@@ -19,6 +20,16 @@ from .help import render_command_help, render_group_help, render_root_help
 
 _HELP_FLAGS = ("-h", "--help", "help")
 
+# assert_owned's 404 detail for an unknown/unowned collector is exactly "collector <uuid> not found".
+# Distinct from copy/break/lot not-found details ("copy X not found for collector Y"), which name a
+# parent collector but don't start with it — so anchoring to the start avoids false positives.
+_MISSING_COLLECTOR_RE = re.compile(r"^collector \S+ not found$")
+
+
+def _is_missing_collector(detail: str | None) -> bool:
+    """True when a 404 detail means the active collector itself is unknown to this account."""
+    return bool(detail and _MISSING_COLLECTOR_RE.match(detail))
+
 
 def _run(args: list[str]) -> int:
     """Resolve `args` against the registry and run the command. Returns a process exit code."""
@@ -82,7 +93,14 @@ def main() -> None:
         console.print("[dim]  Check that the API is running and SLAB_API_URL is correct.[/dim]")
         sys.exit(1)
     except ApiError as e:
-        if e.status == 404:
+        if e.status == 404 and _is_missing_collector(e.detail):
+            # The active collector (SLAB_COLLECTOR) doesn't resolve to a live collector on this
+            # account. This otherwise surfaces mid-flow (e.g. picking Gift → fetching prior sources)
+            # as a cryptic "Not found" — point the user at the fix instead.
+            console.print("[red]Your active collector wasn't found for this account.[/red]")
+            console.print("  See which one the CLI is using:  [bold]slab collector current[/bold]")
+            console.print("  Then set SLAB_COLLECTOR to a collector UUID from the portal (Settings).")
+        elif e.status == 404:
             console.print(f"[yellow]Not found: {e.detail}[/yellow]")
         elif e.status == 401:
             console.print("[red]Unauthorized — check your SLAB_API_KEY.[/red]")

slab_cli-0.2.0/src/slab_cli/commands/setup.py

@@ -1,23 +0,0 @@
-"""Setup commands — check identity.
-
-Collectors are NOT created here. Your account and its collector are provisioned when you sign up
-in the portal; the CLI just consumes the API key and collector UUID you get there. When
-SLAB_COLLECTOR is unset the CLI falls back to your account's default collector (see context.py),
-so a solo user only needs their API key.
-"""
-
-from __future__ import annotations
-
-from ..config import get_collector_uuid
-from ..display import console
-
-
-def cmd_whoami(args: list[str]) -> None:
-    uuid = get_collector_uuid()
-    if uuid:
-        console.print(f"Active collector: [bold]{uuid}[/bold]")
-    else:
-        console.print(
-            "[dim]SLAB_COLLECTOR not set — the CLI will use your account's default collector.\n"
-            "Find your collector UUID and API key in the portal.[/dim]"
-        )