bookai-cli 0.1.0__py3-none-any.whl

bookai_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,73 @@
+Metadata-Version: 2.5
+Name: bookai-cli
+Version: 0.1.0
+Summary: Command-line client for the bookai group-sales back office API
+Requires-Python: >=3.9
+Requires-Dist: click<9,>=8
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8; extra == 'dev'
+Requires-Dist: respx<1,>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# bookai-cli
+
+Command-line client for the bookai group-sales back office API — manage venue
+pricing and view confirmed orders from the terminal or a script, instead of
+clicking through the admin web app.
+
+This is a thin HTTP client: it talks only to the public, authenticated JSON
+API and contains no business logic or backend code.
+
+## Install
+
+```bash
+pip install bookai-cli
+```
+
+## Authenticate
+
+Ask a venue admin to create an API key for you from the back office (Settings
+→ API Keys), then set it as an environment variable:
+
+```bash
+export GROUPSALES_API_KEY=gsk_...
+```
+
+Or pass it per-command with `--api-key`. By default the CLI talks to
+`https://b2b.bookai.now`; override with `--base-url` or `GROUPSALES_BASE_URL`
+if you're pointed at a different environment.
+
+Global options (`--api-key`, `--base-url`, `--json`) go **before** the
+subcommand: `bookai --json venues list`, not `bookai venues list --json`.
+
+## Usage
+
+```bash
+bookai venues list
+
+bookai pricing list <venue_id>
+bookai pricing get <venue_id> <rule_id>
+bookai pricing set <venue_id> --min-group 10 --max-group 50 --min-price 20 --max-price 30
+bookai pricing set <venue_id> --min-group 10 --max-group 50 --min-price 20 --max-price 30 \
+    --source acme-isv --external-id acme-rule-42   # tag a rule as synced from an external system
+bookai pricing update <venue_id> <rule_id> --min-group 10 --max-group 50 --min-price 18 --max-price 28
+bookai pricing delete <venue_id> <rule_id>
+
+bookai orders list
+bookai orders list --page 2
+```
+
+Add `--json` anywhere for machine-readable output instead of a table — useful
+for piping into `jq` or scripting in CI.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+Tests are fully offline (HTTP is mocked via `respx`) — no server or database
+required.

bookai_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+groupsales_cli/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+groupsales_cli/__main__.py,sha256=ikSFgOBVrGD7Zmz6noNhKucKtmAoWgiIqDR3LeRTf9w,1194
+groupsales_cli/client.py,sha256=OhhYThXudxmL0e_C6DBVA9HzOyXARBqdmcvyfSRgcK0,2601
+groupsales_cli/output.py,sha256=ygODLIn36tFnbSsb3bmIPnwaW7TGJ65Uev6AKAwwpTA,2173
+groupsales_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+groupsales_cli/commands/orders.py,sha256=SIfjo8gDAWMmJupbH1UVJWj-vD-du40e-Jf43YU6-ro,666
+groupsales_cli/commands/pricing.py,sha256=AKtBihsPTwNMKludRLU1X6Ocn5Ch5r8RzOMr7qCj0dQ,3659
+groupsales_cli/commands/venues.py,sha256=zcIh74wmE2pl-E0kVRNLJoCpC0UzuQ1xfZicZv0DF3M,475
+bookai_cli-0.1.0.dist-info/METADATA,sha256=AmH_BcQ9f-3otdFydCkEGcnhj6v-3okB9NyEXNMN-Vs,2162
+bookai_cli-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+bookai_cli-0.1.0.dist-info/entry_points.txt,sha256=0svn_dXDJ6nH3LJenLaETCM3WKBLKRsMJiMYWNHRDAo,55
+bookai_cli-0.1.0.dist-info/RECORD,,

bookai_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

bookai_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bookai = groupsales_cli.__main__:cli

groupsales_cli/__init__.py

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

groupsales_cli/__main__.py

@@ -0,0 +1,32 @@
+"""bookai -- CLI client for the bookai group-sales back office API."""
+
+import click
+
+from groupsales_cli import __version__
+from groupsales_cli.client import DEFAULT_BASE_URL
+from groupsales_cli.commands.orders import orders
+from groupsales_cli.commands.pricing import pricing
+from groupsales_cli.commands.venues import venues
+
+
+@click.group()
+@click.option("--api-key", envvar="GROUPSALES_API_KEY", default=None,
+              help="API key (or set GROUPSALES_API_KEY).")
+@click.option("--base-url", envvar="GROUPSALES_BASE_URL", default=DEFAULT_BASE_URL, show_default=True,
+              help="Back office API base URL (or set GROUPSALES_BASE_URL).")
+@click.option("--json", "as_json", is_flag=True, default=False,
+              help="Print raw JSON instead of a table.")
+@click.version_option(__version__, prog_name="bookai")
+@click.pass_context
+def cli(ctx: click.Context, api_key: str | None, base_url: str, as_json: bool):
+    """bookai: manage venues, pricing, and orders from the command line."""
+    ctx.obj = {"api_key": api_key, "base_url": base_url, "json": as_json}
+
+
+cli.add_command(venues)
+cli.add_command(pricing)
+cli.add_command(orders)
+
+
+if __name__ == "__main__":
+    cli()

groupsales_cli/client.py

@@ -0,0 +1,75 @@
+"""Thin HTTP client for the bookai group-sales back office API.
+
+Talks only to the public, authenticated JSON API over `Authorization: Bearer
+<api key>` -- this package never imports anything from the private backend
+repo (services/models/routers), which is what makes it safe to publish this
+CLI publicly while the backend stays closed.
+"""
+
+import click
+import httpx
+
+DEFAULT_BASE_URL = "https://b2b.bookai.now"
+
+
+class ApiError(click.ClickException):
+    """click prints .format_message() to stderr and exits 1 -- integrators
+    see a clean message, never a Python traceback."""
+
+    def __init__(self, status_code: int, detail: str):
+        super().__init__(f"API error {status_code}: {detail}")
+        self.status_code = status_code
+
+
+class Client:
+    def __init__(self, base_url: str, api_key: str):
+        self._http = httpx.Client(
+            base_url=base_url,
+            headers={"Authorization": f"Bearer {api_key}"},
+            timeout=10,
+        )
+
+    def request(self, method: str, path: str, **kwargs):
+        try:
+            resp = self._http.request(method, path, **kwargs)
+        except httpx.RequestError as exc:
+            raise click.ClickException(f"Could not reach {self._http.base_url}: {exc}") from exc
+        if resp.status_code >= 400:
+            raise ApiError(resp.status_code, _error_detail(resp))
+        if resp.status_code == 204 or not resp.content:
+            return None
+        return resp.json()
+
+    def get(self, path: str, params: dict | None = None):
+        return self.request("GET", path, params=params)
+
+    def post(self, path: str, json: dict):
+        return self.request("POST", path, json=json)
+
+    def put(self, path: str, json: dict):
+        return self.request("PUT", path, json=json)
+
+    def delete(self, path: str):
+        return self.request("DELETE", path)
+
+
+def _error_detail(resp: httpx.Response) -> str:
+    try:
+        data = resp.json()
+    except ValueError:
+        return resp.text or resp.reason_phrase
+    detail = data.get("detail") if isinstance(data, dict) else None
+    if isinstance(detail, str):
+        return detail
+    if isinstance(detail, list):  # FastAPI 422 validation errors
+        return "; ".join(f"{'.'.join(str(p) for p in d.get('loc', []))}: {d.get('msg')}" for d in detail)
+    return str(data)
+
+
+def build_client(ctx: click.Context) -> Client:
+    api_key = ctx.obj["api_key"]
+    if not api_key:
+        raise click.ClickException(
+            "No API key set. Pass --api-key or set the GROUPSALES_API_KEY environment variable."
+        )
+    return Client(ctx.obj["base_url"], api_key)

groupsales_cli/commands/orders.py

@@ -0,0 +1,21 @@
+import click
+
+from groupsales_cli.client import build_client
+from groupsales_cli.output import render
+
+
+@click.group()
+def orders():
+    """View confirmed orders."""
+
+
+@orders.command("list")
+@click.option("--page", type=int, default=1, show_default=True)
+@click.pass_context
+def list_orders(ctx: click.Context, page: int):
+    """List confirmed orders (paginated)."""
+    client = build_client(ctx)
+    data = client.get("/admin/orders", params={"page": page})
+    columns = ["id", "group_name", "contact_email", "group_size", "channel", "total_price", "status",
+               "created_at_local"]
+    render(data, ctx.obj["json"], title="Orders", columns=columns)

groupsales_cli/commands/pricing.py

@@ -0,0 +1,99 @@
+import click
+
+from groupsales_cli.client import build_client
+from groupsales_cli.output import render
+
+_RULE_OPTIONS = [
+    click.option("--min-group", type=int, required=True, help="Minimum group size this rule applies to."),
+    click.option("--max-group", type=int, required=True, help="Maximum group size this rule applies to."),
+    click.option("--min-price", type=float, required=True, help="Price floor per person."),
+    click.option("--max-price", type=float, required=True, help="Price ceiling per person."),
+    click.option("--event-id", default=None, help="Scope this rule to one event instead of the whole venue."),
+    click.option("--source", default="app", show_default=True, help="Origin tag, e.g. a 3P vendor name."),
+    click.option("--external-id", default=None, help="3P upsert key -- ignored while --source is 'app'."),
+]
+
+
+def _add_rule_options(f):
+    for option in reversed(_RULE_OPTIONS):
+        f = option(f)
+    return f
+
+
+def _rule_body(min_group, max_group, min_price, max_price, event_id, source, external_id) -> dict:
+    return {
+        "min_group": min_group,
+        "max_group": max_group,
+        "min_price": min_price,
+        "max_price": max_price,
+        "event_id": event_id,
+        "source": source,
+        "external_id": external_id,
+    }
+
+
+_RULE_COLUMNS = ["id", "min_group", "max_group", "min_price", "max_price", "event_id", "source", "external_id"]
+
+
+@click.group()
+def pricing():
+    """Manage per-venue pricing rules."""
+
+
+@pricing.command("list")
+@click.argument("venue_id")
+@click.pass_context
+def list_pricing(ctx: click.Context, venue_id: str):
+    """List pricing rules for a venue."""
+    client = build_client(ctx)
+    data = client.get(f"/admin/venues/{venue_id}/pricing")
+    render(data, ctx.obj["json"], title=f"Pricing rules -- {venue_id}", columns=_RULE_COLUMNS)
+
+
+@pricing.command("get")
+@click.argument("venue_id")
+@click.argument("rule_id")
+@click.pass_context
+def get_pricing(ctx: click.Context, venue_id: str, rule_id: str):
+    """Show one pricing rule."""
+    client = build_client(ctx)
+    data = client.get(f"/admin/venues/{venue_id}/pricing/{rule_id}")
+    render(data, ctx.obj["json"], columns=_RULE_COLUMNS)
+
+
+@pricing.command("set")
+@click.argument("venue_id")
+@_add_rule_options
+@click.pass_context
+def set_pricing(ctx: click.Context, venue_id: str, min_group, max_group, min_price, max_price,
+                 event_id, source, external_id):
+    """Create a new pricing rule."""
+    client = build_client(ctx)
+    body = _rule_body(min_group, max_group, min_price, max_price, event_id, source, external_id)
+    data = client.post(f"/admin/venues/{venue_id}/pricing", json=body)
+    render(data, ctx.obj["json"], columns=_RULE_COLUMNS)
+
+
+@pricing.command("update")
+@click.argument("venue_id")
+@click.argument("rule_id")
+@_add_rule_options
+@click.pass_context
+def update_pricing(ctx: click.Context, venue_id: str, rule_id: str, min_group, max_group, min_price, max_price,
+                    event_id, source, external_id):
+    """Replace an existing pricing rule."""
+    client = build_client(ctx)
+    body = _rule_body(min_group, max_group, min_price, max_price, event_id, source, external_id)
+    data = client.put(f"/admin/venues/{venue_id}/pricing/{rule_id}", json=body)
+    render(data, ctx.obj["json"], columns=_RULE_COLUMNS)
+
+
+@pricing.command("delete")
+@click.argument("venue_id")
+@click.argument("rule_id")
+@click.pass_context
+def delete_pricing(ctx: click.Context, venue_id: str, rule_id: str):
+    """Delete a pricing rule."""
+    client = build_client(ctx)
+    client.delete(f"/admin/venues/{venue_id}/pricing/{rule_id}")
+    click.echo(f"Deleted {rule_id}")

groupsales_cli/commands/venues.py

@@ -0,0 +1,18 @@
+import click
+
+from groupsales_cli.client import build_client
+from groupsales_cli.output import render
+
+
+@click.group()
+def venues():
+    """Manage venues."""
+
+
+@venues.command("list")
+@click.pass_context
+def list_venues(ctx: click.Context):
+    """List venues visible to this API key's account."""
+    client = build_client(ctx)
+    data = client.get("/admin/venues")
+    render(data, ctx.obj["json"], title="Venues", columns=["id", "name", "city_name", "state", "country"])

groupsales_cli/output.py

@@ -0,0 +1,59 @@
+"""Rendering: a rich table for humans, raw JSON for --json / scripts -- the
+CLI's integrators range from non-technical staff to CI pipelines, so both
+need to be first-class, not one bolted onto the other."""
+
+import json as json_lib
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+_console = Console()
+
+
+def render(data, as_json: bool, title: str | None = None, columns: list[str] | None = None) -> None:
+    """columns curates which fields show in table view (order matters) --
+    without it every JSON key becomes a column, which is unreadable once a
+    resource has a nested/long field (e.g. Venue.branding, Order.lines).
+    --json always returns the full record regardless of columns."""
+    if as_json:
+        click.echo(json_lib.dumps(data, indent=2, default=str))
+        return
+    if data is None:
+        click.echo("OK")
+        return
+    if isinstance(data, list):
+        _render_list(data, title, columns)
+    elif isinstance(data, dict) and isinstance(data.get("items"), list):
+        _render_list(data["items"], title, columns)
+        click.echo(f"page {data.get('page')}/{data.get('total_pages')} ({data.get('total')} total)")
+    else:
+        _render_list([data], title, columns)
+
+
+def _render_list(rows: list, title: str | None, columns: list[str] | None) -> None:
+    if not rows:
+        click.echo("(none)")
+        return
+    cols = columns or list(rows[0].keys())
+    table = Table(title=title)
+    for col in cols:
+        if col == "id":
+            # Never truncate or wrap the row's own id -- it's the handle a
+            # follow-up get/update/delete command needs verbatim, unlike
+            # every other column here, where losing a few characters to an
+            # ellipsis is a fine, normal CLI table tradeoff.
+            table.add_column(col, no_wrap=True)
+        else:
+            table.add_column(col, overflow="fold")
+    for row in rows:
+        table.add_row(*(_cell(row.get(col)) for col in cols))
+    _console.print(table)
+
+
+def _cell(value) -> str:
+    if value is None:
+        return ""
+    if isinstance(value, (dict, list)):
+        return json_lib.dumps(value)
+    return str(value)