fablazing-cli 0.4.0__tar.gz → 0.4.1__tar.gz

{fablazing_cli-0.4.0 → fablazing_cli-0.4.1}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.1
+
+- `--sub-format` flag on matchup (repeatable) - the API capability was
+  documented but unreachable from the CLI
+- Reference: honest per-command format coverage (meta and aggregate
+  commands don't cover gage; matchup and card commands do)
+- README: troubleshooting note for interrupted pip upgrades
+
 ## 0.4.0
 
 - `fabz packages`: same-turn card pairs with lift, share, win rate and

{fablazing_cli-0.4.0 → fablazing_cli-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fablazing-cli
-Version: 0.4.0
+Version: 0.4.1
 Summary: Fablazing analytics from your terminal - Flesh and Blood matchups, meta, cards, and tournaments.
 Project-URL: Homepage, https://fablazing.com
 Author: Fablazing
@@ -58,6 +58,13 @@ one. Copy count filters work on matchup includes:
 Tables on a terminal. JSON when piped or with `--json`, CSV with `--csv`.
 Exit codes: 0 ok, 1 api error, 2 usage error, 3 quota exceeded.
 
+## Troubleshooting
+
+If an upgrade leaves `fabz` broken (interrupted pip uninstall can strand
+an empty `fablazing_cli` directory and `~ablazing_cli` backup folders):
+
+    pip install --force-reinstall fablazing-cli
+
 ## Tab completion
 
     fablazing --install-completion

{fablazing_cli-0.4.0 → fablazing_cli-0.4.1}/README.md

@@ -43,6 +43,13 @@ one. Copy count filters work on matchup includes:
 Tables on a terminal. JSON when piped or with `--json`, CSV with `--csv`.
 Exit codes: 0 ok, 1 api error, 2 usage error, 3 quota exceeded.
 
+## Troubleshooting
+
+If an upgrade leaves `fabz` broken (interrupted pip uninstall can strand
+an empty `fablazing_cli` directory and `~ablazing_cli` backup folders):
+
+    pip install --force-reinstall fablazing-cli
+
 ## Tab completion
 
     fablazing --install-completion

{fablazing_cli-0.4.0 → fablazing_cli-0.4.1}/pyproject.toml

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

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

{fablazing_cli-0.4.0 → fablazing_cli-0.4.1}/src/fablazing_cli/commands/matchup.py

@@ -11,6 +11,7 @@ def matchup(
     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"),
+    sub_formats: List[int] = typer.Option([], "--sub-format", help="Restrict to sub-format ids (repeatable), e.g. --sub-format 0 --sub-format 1 for cc without Open"),
     days: int = typer.Option(30, "--days", min=1, max=365),
     start_date: str = typer.Option(None, "--start", help="YYYY-MM-DD (overrides --days)"),
     end_date: str = typer.Option(None, "--end", help="YYYY-MM-DD"),
@@ -31,6 +32,7 @@ def matchup(
     h2 = resolve.hero_id(hero2)
     params = {
         "format": format_type,
+        "sub_formats": sub_formats or None,
         "days": days,
         "start_date": start_date,
         "end_date": end_date,

{fablazing_cli-0.4.0 → fablazing_cli-0.4.1}/src/fablazing_cli/reference.py

@@ -23,7 +23,12 @@ analytics and paper tournament results for competitive Flesh and Blood.
   different cards and are counted separately everywhere.
 - Names are accepted anywhere an id is. Ambiguous names error out and
   list the matching ids (exit code 2).
-- Formats: `cc` (default), `blitz`, `ll`, `sage`, `gage`.
+- Formats: `cc` (default), `blitz`, `ll`, `sage`, `gage` - but coverage
+  is per command. matchup, hero cards, card pov and card analytics
+  accept all five. meta snapshot/movers cover cc, blitz, ll, sage.
+  hero aggregate and meta matrix cover cc, blitz, ll only (their
+  pre-computed stores don't process the rest). gage is a tiny corpus
+  (a few hundred games total) - expect thin samples everywhere.
 
 ## Data notes
 - win_rate fields are fractions between 0 and 1.
@@ -79,9 +84,9 @@ analytics and paper tournament results for competitive Flesh and Blood.
 ## Sub-formats ("Open")
 Each format family maps to internal ids: cc = 0,1 plus Open 4; sage =
 14,15 plus Open 16; blitz = 2,3; ll = 8,11; gage = 18. All ids in a
-family are included by default. The API's matchup endpoint accepts
-`sub_formats` (repeatable int) to narrow, e.g. sub_formats=0&sub_formats=1
-for cc without Open.
+family are included by default. Narrow with repeatable `--sub-format`
+on matchup (e.g. `--sub-format 0 --sub-format 1` for cc without Open);
+the API parameter is `sub_formats`.
 
 ## Output
 - Tables on a terminal, JSON when piped or with --json (the JSON is the

fablazing_cli-0.4.0/src/fablazing_cli/__init__.py

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