bookai-cli 0.1.0__tar.gz

bookai_cli-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+.idea/
+.venv/
+.env
+.env.*
+!.env.example
+data/db.json
+__pycache__/
+*.pyc
+*.egg-info/
+/cli/dist/
+/cli/build/
+data/
+.coverage
+/coverage.json

bookai_cli-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,60 @@
+# 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/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bookai-cli"
+version = "0.1.0"
+description = "Command-line client for the bookai group-sales back office API"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "click>=8,<9",
+    "httpx>=0.27,<1",
+    "rich>=13",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8,<9",
+    "respx>=0.21,<1",
+]
+
+[project.scripts]
+bookai = "groupsales_cli.__main__:cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/groupsales_cli"]

bookai_cli-0.1.0/src/groupsales_cli/__init__.py

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

bookai_cli-0.1.0/src/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()

bookai_cli-0.1.0/src/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)

bookai_cli-0.1.0/src/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)

bookai_cli-0.1.0/src/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}")

bookai_cli-0.1.0/src/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"])

bookai_cli-0.1.0/src/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)

bookai_cli-0.1.0/tests/conftest.py

@@ -0,0 +1,7 @@
+import pytest
+from click.testing import CliRunner
+
+
+@pytest.fixture
+def runner():
+    return CliRunner()

bookai_cli-0.1.0/tests/test_orders.py

@@ -0,0 +1,13 @@
+from groupsales_cli.__main__ import cli
+
+BASE_URL = "https://test.example"
+
+
+def test_orders_list(runner, respx_mock):
+    respx_mock.get(f"{BASE_URL}/admin/orders", params={"page": "1"}).respond(
+        json={"items": [{"id": "o1", "group_name": "Test Group"}], "page": 1, "total_pages": 1, "total": 1}
+    )
+    result = runner.invoke(cli, ["--api-key", "k", "--base-url", BASE_URL, "orders", "list"])
+    assert result.exit_code == 0
+    assert "o1" in result.output
+    assert "page 1/1" in result.output

bookai_cli-0.1.0/tests/test_pricing.py

@@ -0,0 +1,55 @@
+from groupsales_cli.__main__ import cli
+
+BASE_URL = "https://test.example"
+_BASE_ARGS = ["--api-key", "k", "--base-url", BASE_URL]
+
+_RULE = {
+    "id": "r1", "venue_id": "amnh", "min_group": 5, "max_group": 20,
+    "min_price": 10.0, "max_price": 20.0, "event_id": None, "source": "app", "external_id": None,
+}
+
+
+def test_pricing_list(runner, respx_mock):
+    respx_mock.get(f"{BASE_URL}/admin/venues/amnh/pricing").respond(json=[_RULE])
+    result = runner.invoke(cli, [*_BASE_ARGS, "pricing", "list", "amnh"])
+    assert result.exit_code == 0
+    assert "r1" in result.output
+
+
+def test_pricing_set_sends_bearer_auth_and_all_fields(runner, respx_mock):
+    route = respx_mock.post(f"{BASE_URL}/admin/venues/amnh/pricing").respond(status_code=201, json=_RULE)
+    result = runner.invoke(cli, [
+        *_BASE_ARGS, "pricing", "set", "amnh",
+        "--min-group", "5", "--max-group", "20", "--min-price", "10", "--max-price", "20",
+        "--source", "acme-isv", "--external-id", "ext-42",
+    ])
+    assert result.exit_code == 0, result.output
+    assert route.called
+    request = route.calls.last.request
+    assert request.headers["authorization"] == "Bearer k"
+    body = request.content
+    assert b'"source":"acme-isv"' in body or b'"source": "acme-isv"' in body
+
+
+def test_pricing_delete(runner, respx_mock):
+    respx_mock.delete(f"{BASE_URL}/admin/venues/amnh/pricing/r1").respond(status_code=204)
+    result = runner.invoke(cli, [*_BASE_ARGS, "pricing", "delete", "amnh", "r1"])
+    assert result.exit_code == 0
+    assert "Deleted r1" in result.output
+
+
+def test_api_error_shows_clean_message_not_a_traceback(runner, respx_mock):
+    respx_mock.get(f"{BASE_URL}/admin/venues/other/pricing").respond(
+        status_code=404, json={"detail": "Venue not found"}
+    )
+    result = runner.invoke(cli, [*_BASE_ARGS, "pricing", "list", "other"])
+    assert result.exit_code != 0
+    assert "Venue not found" in result.output
+    assert "Traceback" not in result.output
+
+
+def test_json_flag_prints_raw_json(runner, respx_mock):
+    respx_mock.get(f"{BASE_URL}/admin/venues/amnh/pricing").respond(json=[_RULE])
+    result = runner.invoke(cli, ["--api-key", "k", "--base-url", BASE_URL, "--json", "pricing", "list", "amnh"])
+    assert result.exit_code == 0
+    assert '"id": "r1"' in result.output

bookai_cli-0.1.0/tests/test_venues.py

@@ -0,0 +1,21 @@
+from groupsales_cli.__main__ import cli
+
+BASE_URL = "https://test.example"
+
+
+def test_list_venues(runner, respx_mock):
+    respx_mock.get(f"{BASE_URL}/admin/venues").respond(
+        json=[{"id": "amnh", "name": "American National AI History Museum"}]
+    )
+    result = runner.invoke(cli, ["--api-key", "k", "--base-url", BASE_URL, "venues", "list"])
+    assert result.exit_code == 0
+    assert "amnh" in result.output
+
+
+def test_missing_api_key_fails_clean_not_with_a_traceback(runner, respx_mock):
+    result = runner.invoke(
+        cli, ["--base-url", BASE_URL, "venues", "list"], env={"GROUPSALES_API_KEY": ""},
+    )
+    assert result.exit_code != 0
+    assert "GROUPSALES_API_KEY" in result.output
+    assert "Traceback" not in result.output