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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fablazing-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: Fablazing analytics from your terminal - Flesh and Blood matchups, meta, cards, and tournaments.
 Project-URL: Homepage, https://fablazing.com
 Author: Fablazing

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

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

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

{fablazing_cli-0.1.0 → fablazing_cli-0.1.1}/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.1.1}/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.1.1}/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.1.1}/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.1.1}/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"