slab-cli 0.1.0__py3-none-any.whl

slab_cli/commands/catalog.py

@@ -0,0 +1,84 @@
+"""Catalog commands — search cards, browse sets, view card details."""
+
+from __future__ import annotations
+
+import re
+
+from slab_schemas.cards import CardSearchQuery, SetSearchQuery
+
+from ..context import ctx
+from ..display import console, print_cards, print_sets, render_community_board
+from ..flags import CARD_SEARCH_FLAGS, SET_SEARCH_FLAGS, parse_flags
+from ..picker import pick_card
+from ..prompts import ask_text
+
+_UUID_RE = re.compile(r"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$")
+
+
+def cmd_search(args: list[str]) -> None:
+    """Search the card catalog by player/set/team, narrowed by the shared filter flags.
+
+    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
+
+    Sort keys: year, card_number, numbered, subject, brand, set (prefix - for descending).
+    """
+    if not args:
+        args = [ask_text("Search cards:")]
+
+    values, q = parse_flags(args, CARD_SEARCH_FLAGS)
+    values.setdefault("limit", 25)
+    result = ctx.client.search_cards(CardSearchQuery(q=q, **values))
+    print_cards(result)
+
+
+cmd_search.flags = CARD_SEARCH_FLAGS
+
+
+def cmd_sets(args: list[str]) -> None:
+    """Browse sets / products, optionally narrowed by brand, year, or sport.
+
+    Examples:
+      slab set search "sp authentic"
+      slab set search --brand "Upper Deck" --year 2025
+    """
+    values, q = parse_flags(args, SET_SEARCH_FLAGS)
+    values.setdefault("limit", 25)
+    result = ctx.client.search_sets(SetSearchQuery(q=q, **values))
+    print_sets(result)
+
+
+cmd_sets.flags = SET_SEARCH_FLAGS
+
+
+def cmd_rainbow(args: list[str]) -> None:
+    """Show every parallel (the 'rainbow') of a card. Pass a full card UUID, or a player name (or
+    nothing) to pick one interactively — no need to know the UUID. `get_parallels` resolves the
+    slot's base from whatever printing you pick, so the whole rainbow shows regardless of choice."""
+    if len(args) == 1 and _UUID_RE.match(args[0]):
+        card_uuid = args[0]
+    else:
+        card = pick_card(" ".join(args) if args else None)
+        if card is None:
+            return
+        card_uuid = card.uuid
+
+    parallels = ctx.client.get_parallels(card_uuid)
+    console.print(f"\n  [bold]Rainbow[/bold] ({len(parallels)} variants)\n")
+    for c in parallels:
+        finish = c.finish or "[bold]Base[/bold]"
+        pr = f" /{c.print_run}" if c.print_run else ""
+        attrs = f"  [{', '.join(a.name for a in c.attributes)}]" if c.attributes else ""
+        console.print(f"  {finish}{pr}{attrs}  [dim]{c.uuid[:8]}[/dim]")
+    console.print()
+
+
+def cmd_community(args: list[str]) -> None:
+    """The whole community picture — the same page the portal shows: catalog overview, an activity
+    ticker, leaderboards (most valuable, most collected, rarest owned), and popular chase sets."""
+    render_community_board(ctx.client.get_community_board())