1563b05f2e
Task 0.5 of clean-analyst-bootstrap. Greenfield rewrite — no fallback, no aliases. Existing dev environments lose their cached PAT and must re-authenticate. Env var renames (hard cutover): - DA_CONFIG_DIR -> AGNES_CONFIG_DIR - DA_SERVER -> AGNES_SERVER - DA_SERVER_URL -> AGNES_SERVER_URL (test-only stale ref, not in spec) - DA_NO_UPDATE_CHECK -> AGNES_NO_UPDATE_CHECK - DA_LOCAL_DIR -> AGNES_LOCAL_DIR - DA_TOKEN -> AGNES_TOKEN - DA_STREAM_RETRIES -> AGNES_STREAM_RETRIES Config dir rename: ~/.config/da/ -> ~/.config/agnes/ (across code, comments, docstrings, error messages, install templates, dev scripts). Stale `da X` references in CLI source (and adjacent app/, tests/): swept docstrings, comments, help text, and error messages where the verb survives the rewrite (init, pull, push, catalog, status, diagnose, auth, admin, skills, query, schema, describe, explore, disk-info, snapshot, login, logout, whoami, server, setup) and replaced `da X` with `agnes X`. Intentionally kept `da sync`, `da fetch`, `da analyst`, `da metrics` — those verbs are removed in later tasks; the legacy strings will be detected by `_LEGACY_STRINGS` (added in Task 2). Test fixes: - TestCLIVersion now asserts output starts with `agnes ` (was `da `). Test results: 2675 passed, 25 skipped (full pytest run, excluding 9 pre-existing test_db.py / test_user_management.py / test_e2e_extract.py / test_cli_binary_rename.py failures unrelated to this rename).
39 lines
1.3 KiB
Python
39 lines
1.3 KiB
Python
"""`agnes describe <table>` — schema + sample rows (spec §4.1)."""
|
|
|
|
import json as json_lib
|
|
import typer
|
|
from cli.v2_client import api_get_json, V2ClientError
|
|
|
|
describe_app = typer.Typer(help="Show schema + sample rows for a table")
|
|
|
|
|
|
@describe_app.callback(invoke_without_command=True)
|
|
def describe(
|
|
ctx: typer.Context,
|
|
table_id: str = typer.Argument(...),
|
|
n: int = typer.Option(5, "-n", "--rows", help="Sample rows count"),
|
|
json: bool = typer.Option(False, "--json"),
|
|
):
|
|
"""Show schema + sample rows for a table."""
|
|
if ctx.invoked_subcommand is not None:
|
|
return
|
|
try:
|
|
sch = api_get_json(f"/api/v2/schema/{table_id}")
|
|
sam = api_get_json(f"/api/v2/sample/{table_id}", n=n)
|
|
except V2ClientError as e:
|
|
typer.echo(f"Error: describe failed: {e}", err=True)
|
|
raise typer.Exit(5 if e.status_code >= 500 else 8 if e.status_code == 403 else 2)
|
|
|
|
if json:
|
|
typer.echo(json_lib.dumps({"schema": sch, "sample": sam}, indent=2, default=str))
|
|
return
|
|
|
|
typer.echo(f"Table: {sch['table_id']}")
|
|
typer.echo("")
|
|
typer.echo("Schema:")
|
|
for c in sch.get("columns", []):
|
|
typer.echo(f" {c['name']:30s} {c['type']}")
|
|
typer.echo("")
|
|
typer.echo(f"Sample ({len(sam.get('rows', []))} rows):")
|
|
for row in sam.get("rows", []):
|
|
typer.echo(f" {row}")
|