slab-cli 0.1.0__tar.gz → 0.3.0__tar.gz

{slab_cli-0.1.0 → slab_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: slab-cli
-Version: 0.1.0
+Version: 0.3.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.1.0 → slab_cli-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "slab-cli"
-version = "0.1.0"
+version = "0.3.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.1.0 → slab_cli-0.3.0}/src/slab_cli/client.py

@@ -36,7 +36,6 @@ from slab_schemas.collection import (
     CardCopyUpdate,
     CollectionResult,
     CollectionSearchQuery,
-    CollectorCreate,
     CollectorOut,
     CollectorUpdate,
 )
@@ -207,10 +206,6 @@ class SlabClient:
 
     # --- collectors ---
 
-    def create_collector(self, name: str) -> CollectorOut:
-        resp = self._request("POST", "/collectors", json=CollectorCreate(name=name).model_dump(mode="json"))
-        return CollectorOut.model_validate(resp.json())
-
     def rename_collector(self, collector_uuid: str, name: str) -> CollectorOut:
         resp = self._request(
             "PATCH", f"/collectors/{collector_uuid}", json=CollectorUpdate(name=name).model_dump(mode="json")

{slab_cli-0.1.0 → slab_cli-0.3.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.1.0 → slab_cli-0.3.0}/src/slab_cli/commands/registry.py

@@ -104,7 +104,6 @@ GROUPS: list[Group] = [
         Command("delete", "Delete a set you created", custom_sets.cmd_chase_delete),
     ]),
     Group("collector", "your identity", [
-        Command("create", "Create a collector", setup.cmd_register, "<name>"),
         Command("current", "Show the active collector", setup.cmd_whoami),
     ]),
 ]

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

@@ -0,0 +1,23 @@
+"""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]"
+        )

{slab_cli-0.1.0 → slab_cli-0.3.0}/src/slab_cli/context.py

@@ -31,15 +31,21 @@ class CliContext:
 
     @property
     def collector(self) -> str:
-        """The active collector UUID. Resolution order: SLAB_COLLECTOR env var, then the account's
-        default collector (so a solo user only needs their API key). Raises MissingCollector if
-        neither yields one. Cached per invocation."""
+        """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."""
         if self._collector:
             return self._collector
         uuid = get_collector_uuid()
         if not uuid:
-            # Solo zero-config: fall back to the calling account's default collector.
-            uuid = self.client.get_account_context().default_collector_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.1.0 → slab_cli-0.3.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.1.0 → slab_cli-0.3.0}/src/slab_cli/main.py

@@ -73,9 +73,9 @@ def main() -> None:
         console.print(f"[red]{e}[/red]")
         sys.exit(2)
     except MissingCollector:
-        console.print("[red]No collector set.[/red]")
-        console.print("  1. Run: slab collector create <your name>")
-        console.print("  2. Run: export SLAB_COLLECTOR=<uuid from step 1>")
+        console.print("[red]No collector resolved for this API key.[/red]")
+        console.print("  Your collector is created when you sign up in the portal.")
+        console.print("  Grab its UUID there, then: export SLAB_COLLECTOR=<uuid>")
         sys.exit(1)
     except ApiConnectionError as e:
         console.print(f"\n[red]{e}[/red]")

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

@@ -1,24 +0,0 @@
-"""Setup commands — register a collector, check identity."""
-
-from __future__ import annotations
-
-from ..config import get_collector_uuid
-from ..context import ctx
-from ..display import console
-from ..prompts import ask_text
-
-
-def cmd_register(args: list[str]) -> None:
-    name = " ".join(args) if args else ask_text("Collector name:")
-    collector = ctx.client.create_collector(name)
-    console.print(f"\n[green]Collector created:[/green] {collector.name}")
-    console.print(f"  UUID: {collector.uuid}")
-    console.print(f"\n  Now run: [bold]export SLAB_COLLECTOR={collector.uuid}[/bold]")
-
-
-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]No collector set. Run: slab collector create <name>[/dim]")