slab-cli 0.1.0__py3-none-any.whl

slab_cli/theme.py

@@ -0,0 +1,184 @@
+"""SLAB terminal theme — the CLI's shared visual language.
+
+Mirrors the portal's retro card-collector look (`portal/src/app/globals.css`): gold **foil** as the
+hero accent over slate surfaces, green gains / red losses, uppercase pixel-style headings, rounded
+"cards". Every command should render through the `console` and factories here so the whole CLI reads
+as one system — restyle in this one file and it propagates everywhere.
+
+Building block cheat-sheet:
+- `console`            — the themed Console (import this instead of making your own).
+- `heading(t, note=)`  — a left-aligned gold uppercase section header (print it above a card).
+- `slab_table(cols)`   — a card-styled table; pass `foil=True` for the gold "hero card" border.
+- `slab_panel(body)`   — a card-styled panel (foil border by default).
+- `kv_grid(rows)`      — an aligned label/value block (replaces hand-padded strings).
+- `money / signed_money / pct_coverage` — palette-colored value formatters.
+"""
+
+from __future__ import annotations
+
+from rich import box
+from rich.console import Console, Group, RenderableType
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+from rich.theme import Theme
+
+# --- Palette (hex mirrors portal/src/app/globals.css :theme tokens) --------------------------------
+FOIL = "#f0b429"          # gold — the hero accent (foil)
+FOIL_DIM = "#b8860b"
+TEXT = "#e2e8f0"
+TEXT_DIM = "#7a8baa"
+TEXT_MUTED = "#4a5a7a"
+ACCENT = "#60a5fa"        # blue
+SUCCESS = "#34d399"       # gains
+DANGER = "#ef4444"        # losses
+BORDER = "#2a3a5c"        # slate card border
+
+# Semantic style names — reference as `[slab.foil]…[/]` in markup, or via the helpers below.
+SLAB_THEME = Theme({
+    "slab.foil": f"bold {FOIL}",
+    "slab.foil_dim": FOIL_DIM,
+    "slab.text": TEXT,
+    "slab.value": f"bold {TEXT}",
+    "slab.label": TEXT_DIM,
+    "slab.dim": TEXT_DIM,
+    "slab.muted": TEXT_MUTED,
+    "slab.accent": ACCENT,
+    "slab.gain": f"bold {SUCCESS}",
+    "slab.loss": f"bold {DANGER}",
+    "slab.heading": f"bold {FOIL}",
+    "slab.border": BORDER,
+})
+
+console = Console(theme=SLAB_THEME)
+
+# The card silhouette — rounded + thin, mirroring the portal's rounded-border cards.
+CARD_BOX = box.ROUNDED
+
+
+# --- Headers ---------------------------------------------------------------------------------------
+
+def heading(text: str, note: str | None = None) -> Text:
+    """A section header in the portal's pixel-heading style: a slim foil marker + uppercase gold
+    title, left-aligned, with an optional dim note (e.g. a count) trailing it. The marker gives every
+    titled block across the CLI the same on-theme spine. Print it on its own line above the content."""
+    t = Text()
+    t.append("▍ ", style="slab.foil")
+    t.append(text.upper(), style="slab.heading")
+    if note:
+        t.append(f"   {note}", style="slab.dim")
+    return t
+
+
+# --- Cards (tables + panels) -----------------------------------------------------------------------
+
+def slab_table(columns: list[tuple[str, dict]], *, foil: bool = False) -> Table:
+    """Build a card-styled table. `columns` is a list of `(header, column_kwargs)` — headers are
+    uppercased to match the portal's `.table-header` (uppercase, muted). `foil=True` swaps the slate
+    border for the gold "hero card" border."""
+    table = Table(
+        box=CARD_BOX,
+        border_style="slab.foil_dim" if foil else "slab.border",
+        header_style="slab.label",
+        title=None,
+        pad_edge=True,
+        expand=False,
+    )
+    for name, kwargs in columns:
+        table.add_column(name.upper(), **kwargs)
+    return table
+
+
+def slab_panel(body: RenderableType, *, foil: bool = True, title: str | None = None) -> Panel:
+    """Wrap a renderable in a card. Foil (gold) border by default — that's the "hero card" the portal
+    reserves for headline stats; pass `foil=False` for an ordinary slate card. Padding is tight
+    (no blank top/bottom line) so a card hugs its content instead of reading as a near-empty box."""
+    return Panel(
+        body,
+        box=CARD_BOX,
+        border_style="slab.foil_dim" if foil else "slab.border",
+        title=title,
+        title_align="left",
+        padding=(0, 2),
+        expand=False,  # hug content — a card sized to its data reads far better than a half-empty bar
+    )
+
+
+# --- Sections: the canonical "titled block" every multi-part output composes from -----------------
+
+def section(title: str, body: RenderableType, *, note: str | None = None, foil: bool = False) -> Group:
+    """A titled card: a blank line for rhythm, the foil-marked heading, then `body` in a slate (or
+    foil) card. THE reusable unit for command output — build every section of every command from this
+    and the whole CLI shares one spacing + heading language. Restyle here, everything follows."""
+    return Group(Text(), heading(title, note), slab_panel(body, foil=foil))
+
+
+def titled(title: str, renderable: RenderableType, *, note: str | None = None) -> Group:
+    """Like `section` but for content that draws its own frame (a `slab_table`, a chart): blank line +
+    marked heading + the renderable as-is, with no extra card around it. Use for titled tables so
+    they get the same spacing + heading as `section` cards without a double border."""
+    return Group(Text(), heading(title, note), renderable)
+
+
+def kv_grid(rows: list[tuple[str, RenderableType]], *, label_style: str = "slab.label") -> Table:
+    """An aligned two-column label/value block — the reusable replacement for hand-padded strings so
+    values always line up. Values may be plain strings, markup strings, or Rich renderables."""
+    grid = Table.grid(padding=(0, 3))
+    grid.add_column(style=label_style, justify="left")
+    grid.add_column(justify="left")
+    for label, value in rows:
+        grid.add_row(label, value)
+    return grid
+
+
+# --- Value formatters ------------------------------------------------------------------------------
+
+def money(v) -> str:
+    """`$1,234.56`, or an em-dash when absent."""
+    return f"${v:,.2f}" if v is not None else "—"
+
+
+def signed_money(v) -> str:
+    """Colored, signed money for P&L: green gain / red loss, em-dash when absent."""
+    if v is None:
+        return "[slab.dim]—[/]"
+    color = "slab.gain" if v >= 0 else "slab.loss"
+    sign = "+" if v >= 0 else "-"
+    return f"[{color}]{sign}{money(abs(float(v)))}[/]"
+
+
+def pct_coverage(pct: float) -> str:
+    """A coverage/health percentage, colored by band: green ≥75, gold ≥40, red below."""
+    color = "slab.gain" if pct >= 75 else ("slab.foil" if pct >= 40 else "slab.loss")
+    return f"[{color}]{pct:.0f}%[/]"
+
+
+_SPARK_TICKS = "▁▂▃▄▅▆▇█"
+
+
+def sparkline(values: list, *, style: str = "slab.foil", width: int = 24) -> str:
+    """A one-line trend as unicode blocks (`▁▂▅▇█`) — the compact CLI stand-in for the portal's
+    portfolio chart. Series longer than `width` are evenly downsampled (the dashboard payload's
+    embedded trend is daily, ~90 points). Returns markup, or '' when there's nothing to plot
+    (<2 points)."""
+    nums = [float(v) for v in values if v is not None]
+    if len(nums) < 2:
+        return ""
+    if len(nums) > width:
+        step = (len(nums) - 1) / (width - 1)
+        nums = [nums[round(i * step)] for i in range(width)]
+    lo, hi = min(nums), max(nums)
+    span = hi - lo
+    if not span:
+        ticks = _SPARK_TICKS[3] * len(nums)  # dead-flat: a mid line, not empty
+    else:
+        ticks = "".join(_SPARK_TICKS[min(7, int((v - lo) / span * 7))] for v in nums)
+    return f"[{style}]{ticks}[/]"
+
+
+def bar(value: float, maxv: float, width: int = 14, *, style: str = "slab.foil") -> str:
+    """A compact filled/track meter (`████····`) as a markup string — the reusable bar for
+    distributions, completion, and breakdowns. Filled cells take `style`; the track is muted."""
+    filled = round((value / maxv) * width) if maxv else 0
+    filled = max(0, min(width, filled))
+    return f"[{style}]{'█' * filled}[/][slab.muted]{'·' * (width - filled)}[/]"

slab_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,70 @@
+Metadata-Version: 2.3
+Name: slab-cli
+Version: 0.1.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
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+Requires-Dist: inquirerpy>=0.3
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# slab-cli
+
+A terminal client for the [slab](https://api.slab.dev-jeb.com) trading-card API — browse the
+catalog, price cards against real sales comps, and track your own collection from the command line.
+
+```bash
+pip install slab-cli
+```
+
+This installs the `slab` command.
+
+## Setup
+
+The CLI talks to the hosted slab API. You need an **API key** — mint one from the
+[slab portal](https://app.slab.dev-jeb.com) (sign in → **API Keys** → create). Then:
+
+```bash
+export SLAB_API_KEY=sk_live_...        # your key (required)
+# optional:
+export SLAB_API_URL=https://api.slab.dev-jeb.com   # default; override for a self-hosted API
+export SLAB_COLLECTOR=<collector-uuid>             # your active collector, reused across commands
+```
+
+## Quickstart
+
+```bash
+# Catalog + pricing (no collector needed)
+slab card search --subject "Connor Bedard"      # find cards
+slab card price <card-uuid>                      # fair-market value from sales comps
+slab card comps <card-uuid>                      # the underlying recent sales
+slab set "OPC Platinum"                          # a set's sealed FMV + top cards
+
+# Your collection
+slab collector create                            # one-time: create your collector profile
+slab collection add                              # add an owned copy (grade, cost, acquisition)
+slab collection cost                             # log grading/shipping costs on a copy
+slab break new                                   # record a box/case break
+slab collection dashboard                        # portfolio value, cost basis, P&L
+slab collection search                           # search + filter your copies
+```
+
+Run `slab` with no arguments for the full command list, or `slab <group>` (e.g. `slab collection`)
+to see a group's verbs.
+
+## Configuration reference
+
+| Env var         | Purpose                                    | Default                          |
+| --------------- | ------------------------------------------ | -------------------------------- |
+| `SLAB_API_KEY`  | API key for authentication (**required**)  | —                                |
+| `SLAB_API_URL`  | Base URL of the slab API                   | `https://api.slab.dev-jeb.com`   |
+| `SLAB_COLLECTOR`| Active collector UUID, reused per command  | —                                |
+
+## What it depends on
+
+Requests and responses are typed against [`slab-schemas`](https://pypi.org/project/slab-schemas/) —
+the same pydantic wire contract the API itself uses — so the CLI and API can never drift.
+
+Requires Python 3.13+.

slab_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+slab_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+slab_cli/banner.py,sha256=Y8daw7PNgC2LL4Gp0CDtqPNzEYAMEpWN5WqpKmMY8NU,3690
+slab_cli/client.py,sha256=QzRW0qqd_yf3DF7GytMkPuApu9cshvE2fFuYyKYhRwg,15928
+slab_cli/commands/__init__.py,sha256=Mzy3oCKEj9ldoTSekQhaIpaSEVr8AmN05ogV1MqmQnM,237
+slab_cli/commands/breaks.py,sha256=hV-wghXIxjIZWghFtPmIt2iCDeEGy85tHx4C2flcZPo,5553
+slab_cli/commands/catalog.py,sha256=cCBFFcz6n-cMXE_nd7l8_iHXP0EBr5JGPOoc6LqS9gw,3092
+slab_cli/commands/collection.py,sha256=dwqBemFtpDaYRNn2U2SwryMap3tQvUiBspkZzTk1BR4,28429
+slab_cli/commands/custom_sets.py,sha256=lQVOqKlppTVduPbMQ5Y524jS9RnI3zGjqfMxTt7Ml6c,18639
+slab_cli/commands/export.py,sha256=Gqv1q0bsB1AyI--_N-k2GsIWwvl_DZqTCz08CkR37QI,5236
+slab_cli/commands/lots.py,sha256=btRzZdxINbsgRFdGwednaTp5fkUMX0iq52vFgVf5v2w,4969
+slab_cli/commands/pricing.py,sha256=bW_c23DF0MKueU73eGLUrIdc2w7Xi9FlwivlQGvJKng,14522
+slab_cli/commands/registry.py,sha256=amLA2_jpLIutam3HGiKhKZgk17z9-4RsP1PBaDDeIHw,7323
+slab_cli/commands/setup.py,sha256=sI3ML7KJNMpjWg4qUVNAgUXYwvlPs8KMAl7zaN-01hA,848
+slab_cli/config.py,sha256=k-g0LNd1QZL_bq_fdPtI-_gp928kt7ECeMEk8AzeUpE,546
+slab_cli/context.py,sha256=bv8M7qw0GAObBlmG0pY7iAWVtDf9LRTvVfoG4HNvPBw,1634
+slab_cli/display.py,sha256=zC5OlI-9_XmfFTMAh-nv-oyYS5Eqtj2X_41B1_LjHAU,49269
+slab_cli/flags.py,sha256=q7o4EEPCkGu4w4VXgoY2ZOGybeV0r5IdCB61fS8KCBI,8550
+slab_cli/help.py,sha256=ByGAY9ncvnzU8AlkXeFdkvIOFAZn_2yMLrgLnssZUTI,3706
+slab_cli/main.py,sha256=FRqPAJZ3wbI18BKfO3xFIwr_U5-izeo0qRbGEHI6nC4,3623
+slab_cli/paging.py,sha256=P02o6GY3ewB8Xnj-8EAGddKnWspil8T1-qC13lpOC1c,1825
+slab_cli/picker.py,sha256=-8emLfy7TsKnHhEKQAA27o-9nQiBUy02btWSZ0flQwI,3248
+slab_cli/prompts.py,sha256=vy4dwuL3ed3V5Yqn9QbX9SpYUUXMNw56WX8PymLXGFE,23452
+slab_cli/sources.py,sha256=rmmA6CTBfZP6IrTRvbGqC5Hd53Eo_LRXPQInXDeCE_M,890
+slab_cli/theme.py,sha256=AxeadKoij-KzN_vyQB08yKzYOeleK71A7c2tAu3ffzA,8084
+slab_cli-0.1.0.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
+slab_cli-0.1.0.dist-info/entry_points.txt,sha256=R5AFsQ2rL_F_OKAT75PeytsSHtl3BR4eTK8fpJR0yr0,45
+slab_cli-0.1.0.dist-info/METADATA,sha256=WrqhEAItcTm1jgm4LhEuU7PO_7DikLPmelemEpme3JY,2904
+slab_cli-0.1.0.dist-info/RECORD,,

slab_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.30
+Root-Is-Purelib: true
+Tag: py3-none-any

slab_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+slab = slab_cli.main:main
+