fablazing-cli 0.1.1__tar.gz → 0.2.1__tar.gz

fablazing_cli-0.2.1/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 0.2.1
+
+- Matchup: when no card clears the tech-card significance bar (common in
+  close matchups), show the closest candidates with their scores instead
+  of an empty section
+
+## 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.1 → fablazing_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fablazing-cli
-Version: 0.1.1
+Version: 0.2.1
 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.1 → fablazing_cli-0.2.1}/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.1 → fablazing_cli-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fablazing-cli"
-version = "0.1.1"
+version = "0.2.1"
 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.1/src/fablazing_cli/__init__.py

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

{fablazing_cli-0.1.1 → fablazing_cli-0.2.1}/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.1 → fablazing_cli-0.2.1}/src/fablazing_cli/commands/matchup.py

@@ -92,12 +92,29 @@ def matchup(
                     c.get("card_id", ""),
                     pct(c.get("frequency")),
                     pct(c.get("win_rate")),
-                    f"+{c.get('wilson_improvement', 0) * 100:.1f}%",
+                    f"{c.get('wilson_improvement', 0) * 100:+.1f}%",
                     c.get("match_count", ""),
                 ]
                 for c in tech[:top]
             ]
             tables.append((f"{name} - tech cards (Wilson outperformers)", ["Card", "Freq", "WR", "Wilson delta", "Matches"], tech_rows))
+        candidates = data.get(f"{deck_key}_tech_candidates")
+        if not tech and candidates:
+            cand_rows = [
+                [
+                    c.get("card_id", ""),
+                    pct(c.get("frequency")),
+                    pct(c.get("win_rate")),
+                    f"{c.get('wilson_improvement', 0) * 100:+.1f}%",
+                    c.get("match_count", ""),
+                ]
+                for c in candidates[:top]
+            ]
+            tables.append((
+                f"{name} - tech candidates (none met the significance bar)",
+                ["Card", "Freq", "WR", "Wilson delta", "Matches"],
+                cand_rows,
+            ))
 
     game_length = data.get("game_length") or {}
     turns = game_length.get("turns") or {}

{fablazing_cli-0.1.1 → fablazing_cli-0.2.1}/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.1 → fablazing_cli-0.2.1}/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).
@@ -31,8 +33,15 @@ analytics and paper tournament results for competitive Flesh and Blood.
   Teklovossen) are stored under their base hero id, with transform stats
   in deck1_transform / deck2_transform.
 - Tech cards are Wilson-scored against the matchup baseline, so a lucky
-  streak on a small sample doesn't make the list.
+  streak on a small sample doesn't make the list. In close matchups no
+  card may clear the bar - then `tech_candidates` lists the closest
+  near-misses with their scores, explicitly marked below-threshold.
 - 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 +50,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.1/src/fablazing_cli/__init__.py

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