Metadata-Version: 2.4
Name: fablazing-cli
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
License: MIT
Keywords: analytics,cli,fab,flesh-and-blood,tcg
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: platformdirs>=4.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# fablazing-cli

Terminal client for [Fablazing](https://fablazing.com): matchup stats, meta
breakdowns, card trends and paper tournament results for Flesh and Blood.

You need an API key (Builder plan).

## Install

    pipx install fablazing-cli

or plain `pip install fablazing-cli`. On Windows without pipx:

    py -m pip install --user pipx
    py -m pipx ensurepath

This installs `fablazing` and `fabz`, same thing.

## Setup

    fabz auth set-key fbl_live_xxx
    fabz auth status

The key can also come from the `FABLAZING_API_KEY` env var.

## Usage

    fabz matchup "Dash I/O" Jarl --days 30
    fabz meta snapshot
    fabz meta movers
    fabz hero aggregate EVO001 --period 14d
    fabz card trends "Sink Below" --json
    fabz card popular --days 7 --csv > popular.csv
    fabz tournaments list --type Calling

Heroes and cards can be given by name or id. A name that matches several
cards (pitch variants share names) errors and lists the ids so you can pick
one. Copy count filters work on matchup includes:
`--include1 "sink_below_red:gte2"`.

## Output

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

## 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.
