fablazing-cli 0.1.0__tar.gz → 0.2.0__tar.gz

fablazing_cli-0.2.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.2.0
+
+- `fabz meta matrix`: matchup matrix for the top-N heroes (win rate +
+  sample size per pairing) in a single API call
+- `fabz auth status` now shows quota: used/remaining today, reset time,
+  burst limit
+- Aggregated endpoints report `data_through` and their refresh schedule;
+  documented which commands are realtime vs daily in the reference
+
+## 0.1.1
+
+- Default API URL fixed to https://api.fablazingdata.com/api/v1
+- Tab completion for hero names (after `--install-completion`)
+- One-time first-run tip about installing completion
+
+## 0.1.0
+
+- First release: matchup, meta, hero, card, tournaments, auth, reference
+- Table/JSON/CSV output, name-to-id resolution, shell completion support

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fablazing-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Fablazing analytics from your terminal - Flesh and Blood matchups, meta, cards, and tournaments.
 Project-URL: Homepage, https://fablazing.com
 Author: Fablazing
@@ -65,3 +65,10 @@ Exit codes: 0 ok, 1 api error, 2 usage error, 3 quota exceeded.
 ## Reference
 
 `fablazing reference` prints the full command and data reference.
+
+## Versioning
+
+Semver. The JSON output shape (`schema_version`, `meta`, `data`), exit
+codes, and existing command names/flags only change with a major version
+bump. New commands and new response fields can appear in minor versions.
+See CHANGELOG.md.

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/README.md

@@ -50,3 +50,10 @@ Exit codes: 0 ok, 1 api error, 2 usage error, 3 quota exceeded.
 ## Reference
 
 `fablazing reference` prints the full command and data reference.
+
+## Versioning
+
+Semver. The JSON output shape (`schema_version`, `meta`, `data`), exit
+codes, and existing command names/flags only change with a major version
+bump. New commands and new response fields can appear in minor versions.
+See CHANGELOG.md.

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fablazing-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "Fablazing analytics from your terminal - Flesh and Blood matchups, meta, cards, and tournaments."
 readme = "README.md"
 requires-python = ">=3.10"

fablazing_cli-0.2.0/src/fablazing_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/commands/auth.py

@@ -33,11 +33,14 @@ def set_url(url: str = typer.Argument(..., help="API base URL (for self-hosted/d
 
 @app.command()
 def status():
-    """Verify the configured key against the API."""
+    """Verify the key and show today's usage and limits."""
     key = api_key()
     if not key:
         fail("no API key configured. Run: fablazing auth set-key")
-    masked = key[:15] + "..."
-    heroes = client.get("/heroes")
-    count = heroes.get("meta", {}).get("count", "?")
-    console.print(f"[green]OK[/green] key {masked} against {api_url()} ({count} heroes visible)")
+    data = client.get("/me")["data"]
+    console.print(f"[green]OK[/green] key {data.get('key_prefix', '?')}... against {api_url()}")
+    console.print(
+        f"today: {data.get('used_today', '?')}/{data.get('daily_quota', '?')} requests used, "
+        f"{data.get('remaining_today', '?')} left, resets {data.get('resets_at_utc', '?')}"
+    )
+    console.print(f"burst limit: {data.get('burst_per_minute', '?')} requests/minute")

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/commands/hero.py

@@ -25,7 +25,7 @@ def list_heroes(
 
 @app.command()
 def show(
-    hero: str = typer.Argument(..., help="Hero id or name"),
+    hero: str = typer.Argument(..., help="Hero id or name", autocompletion=resolve.complete_hero),
     json_: bool = typer.Option(False, "--json"),
     csv_: bool = typer.Option(False, "--csv"),
 ):
@@ -44,7 +44,7 @@ def show(
 
 @app.command()
 def aggregate(
-    hero: str = typer.Argument(..., help="Hero id or name"),
+    hero: str = typer.Argument(..., help="Hero id or name", autocompletion=resolve.complete_hero),
     format_type: str = typer.Option("cc", "--format"),
     source: str = typer.Option("online", "--source", help="online | paper"),
     period: str = typer.Option("14d", "--period", help="7d | 14d | 30d"),

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/commands/matchup.py

@@ -8,8 +8,8 @@ from ..output import emit, pct, set_mode
 
 
 def matchup(
-    hero1: str = typer.Argument(..., help="Deck 1 hero (id or name)"),
-    hero2: str = typer.Argument(..., help="Deck 2 hero (id or name)"),
+    hero1: str = typer.Argument(..., help="Deck 1 hero (id or name)", autocompletion=resolve.complete_hero),
+    hero2: str = typer.Argument(..., help="Deck 2 hero (id or name)", autocompletion=resolve.complete_hero),
     format_type: str = typer.Option("cc", "--format"),
     days: int = typer.Option(30, "--days", min=1, max=365),
     start_date: str = typer.Option(None, "--start", help="YYYY-MM-DD (overrides --days)"),

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/commands/meta.py

@@ -74,3 +74,41 @@ def movers(
         tables=[("Movers", ["Hero", "ID", "Trend", "Change", "Now", "Avg"], rows)],
         summary=[f"[bold]Meta movers[/bold] - {format_type}/{source}, last {days}d, by {sort_by}"],
     )
+
+
+@app.command()
+def matrix(
+    format_type: str = typer.Option("cc", "--format"),
+    source: str = typer.Option("online", "--source"),
+    period: str = typer.Option("14d", "--period", help="7d | 14d | 30d"),
+    top: int = typer.Option(10, "--top", min=2, max=40, help="How many heroes"),
+    json_: bool = typer.Option(False, "--json"),
+    csv_: bool = typer.Option(False, "--csv"),
+):
+    """Matchup matrix for the top-N most played heroes: win rate and sample
+    size for every pairing, one API call."""
+    set_mode(json_, csv_)
+    payload = client.get(
+        "/meta/matrix",
+        {"format": format_type, "source": source, "period": period, "top": top},
+    )
+    heroes = payload["data"]["heroes"]
+    ids = [h["hero_id"] for h in heroes]
+
+    columns = ["Hero", "Games"] + ids
+    rows = []
+    for h in heroes:
+        cells = []
+        for opp in ids:
+            m = h["matchups"].get(opp)
+            cells.append(f"{m['win_rate'] * 100:.0f}%/{m['total_matches']}" if m else "-")
+        name = h.get("hero_name", h["hero_id"])
+        label = name if len(name) <= 22 else name[:20] + ".."
+        rows.append([f"{label} ({h['hero_id']})", h.get("total_matches", "")] + cells)
+
+    meta_info = payload.get("meta", {})
+    summary = [
+        f"[bold]Matchup matrix[/bold] - {format_type}/{source}/{period}, top {top}, "
+        f"cells are row-hero WR / games (data through {str(meta_info.get('data_through', '?'))[:10]})"
+    ]
+    emit(payload, tables=[("Matrix", columns, rows)], summary=summary)

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/config.py

@@ -6,7 +6,7 @@ from pathlib import Path
 from platformdirs import user_cache_dir, user_config_dir
 
 APP_NAME = "fablazing"
-DEFAULT_API_URL = "https://fablazing.com/api/v1"
+DEFAULT_API_URL = "https://api.fablazingdata.com/api/v1"
 
 
 def config_path() -> Path:

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/main.py

@@ -1,10 +1,14 @@
 """Fablazing CLI entry point. `fablazing` and `fabz` both land here."""
+import os
+import sys
+
 import typer
 
 from . import __version__
 from .commands import auth, card, hero, meta, tournaments
 from .commands.matchup import matchup
-from .output import console
+from .config import load_config, save_config
+from .output import console, err_console
 from .reference import REFERENCE
 
 app = typer.Typer(
@@ -17,6 +21,27 @@ app = typer.Typer(
     context_settings={"help_option_names": ["-h", "--help"]},
 )
 
+@app.callback()
+def _main():
+    _completion_tip()
+
+
+def _completion_tip():
+    """One-time hint about tab completion. Skipped during shell completion
+    itself and when not on a terminal."""
+    if any(k.endswith("_COMPLETE") for k in os.environ):
+        return
+    cfg = load_config()
+    if cfg.get("completion_tip_shown") or not sys.stderr.isatty():
+        return
+    err_console.print(
+        "[dim]tip: run `fablazing --install-completion` once to enable tab "
+        "completion (takes effect in a new terminal)[/dim]"
+    )
+    cfg["completion_tip_shown"] = True
+    save_config(cfg)
+
+
 app.add_typer(auth.app, name="auth")
 app.add_typer(hero.app, name="hero")
 app.add_typer(meta.app, name="meta")

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/reference.py

@@ -7,12 +7,14 @@ Terminal client for the Fablazing API: matchup stats, meta breakdowns, card
 analytics and paper tournament results for competitive Flesh and Blood.
 `fablazing` and `fabz` are the same binary.
 
-## Auth
+## Auth and limits
 - `fablazing auth set-key fbl_live_...` stores your key, or set the
   FABLAZING_API_KEY env var.
-- `fablazing auth status` checks it.
-- Keys have a daily quota and a per-minute limit. Hitting either exits
-  with code 3.
+- `fablazing auth status` shows usage: requests used/left today, reset
+  time, burst limit.
+- Standard keys: 2000 requests/day, 60/minute (per-key overrides exist).
+  Every response carries X-RateLimit-Limit / -Remaining / -Reset headers.
+  Exceeding a limit exits with code 3 and a Retry-After.
 
 ## IDs and formats
 - Hero ids look like `EVO001` (set code + number).
@@ -33,6 +35,11 @@ analytics and paper tournament results for competitive Flesh and Blood.
 - Tech cards are Wilson-scored against the matchup baseline, so a lucky
   streak on a small sample doesn't make the list.
 - Tournament standings and decklists come from official paper events.
+- Freshness: `matchup` queries live match data (ingested every ~5
+  minutes). Meta snapshot/movers and card trends/popular are daily
+  aggregates (previous day processed at 03:00 / 02:00 UTC) - their
+  responses carry `data_through` in meta so you can see exactly how
+  fresh the numbers are.
 
 ## Commands
 - `fablazing matchup EVO001 "Jarl" --days 30`
@@ -41,6 +48,8 @@ analytics and paper tournament results for competitive Flesh and Blood.
   cards only, not equipment). `--no-dynamics` skips game length stats.
 - `fablazing meta snapshot --format cc --days 14`
 - `fablazing meta movers --days 14`
+- `fablazing meta matrix --top 10` - win rate + sample size for every
+  pairing of the top-N heroes, in one call (never loop matchup for this)
 - `fablazing hero list` / `hero show EVO001`
 - `fablazing hero aggregate EVO001 --period 14d --source online`
 - `fablazing card search "sink"` / `card show sink_below_red`

{fablazing_cli-0.1.0 → fablazing_cli-0.2.0}/src/fablazing_cli/resolve.py

@@ -61,6 +61,23 @@ def hero_id(text: str) -> str:
     fail(f"ambiguous hero '{text}' - did you mean: {options}", 2)
 
 
+def complete_hero(incomplete: str):
+    """Tab completion for hero arguments. Reads the local cache only; a
+    completer must never hit the network or it makes TAB feel broken."""
+    path = cache_path(_HEROES_CACHE_FILE)
+    try:
+        heroes = json.loads(path.read_text(encoding="utf-8"))["heroes"]
+    except (OSError, ValueError, KeyError):
+        return
+    query = incomplete.lower()
+    for h in heroes:
+        name = h.get("hero_name", "")
+        if name.lower().startswith(query):
+            yield (name, h["hero_id"])
+        elif h["hero_id"].lower().startswith(query):
+            yield (h["hero_id"], name)
+
+
 def card_id(text: str, allow_spec: bool = False) -> str:
     """Resolve a card name or id; optionally preserve a :gte2-style suffix."""
     candidate = text.strip()

fablazing_cli-0.1.0/src/fablazing_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"