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

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "slab-cli"
-version = "0.2.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.2.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.2.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)