"""bincio edit — local edit server for activity sidecar files.""" from __future__ import annotations from pathlib import Path from typing import Optional import click from rich.console import Console console = Console() @click.command() @click.option("--data-dir", default=None, help="BAS data store directory (output of bincio extract).") @click.option("--port", default=4041, show_default=True, help="Port for the edit server.") @click.option("--site-url", default="http://localhost:4321", show_default=True, help="URL of the Astro dev server (for the Back link).") @click.option("--config", "config_path", default=None, help="Path to extract_config.yaml (reads output.dir from it).") def edit( data_dir: Optional[str], port: int, site_url: str, config_path: Optional[str], ) -> None: """Start a local web UI for editing activity sidecar files. Writes sidecar .md files to /edits/ which bincio render picks up and applies at build time. Run alongside the Astro dev server: \b bincio render --serve # port 4321 (or npm run dev) bincio edit # port 4041 """ try: import uvicorn except ImportError: raise click.ClickException( "uvicorn is required for the edit server.\n" "Install with: uv add 'bincio[edit]'" ) data = _resolve_data_dir(data_dir, config_path) console.print(f"Data dir: [cyan]{data}[/cyan]") console.print(f"Edit UI: [cyan]http://localhost:{port}/edit/[/cyan]") console.print(f"Site URL: [cyan]{site_url}[/cyan]") console.print("Press [bold]Ctrl+C[/bold] to stop.\n") import bincio.edit.server as srv srv.data_dir = data srv.site_url = site_url uvicorn.run(srv.app, host="127.0.0.1", port=port, log_level="warning") def _resolve_data_dir(explicit: Optional[str], config_path: Optional[str]) -> Path: if explicit: return Path(explicit).expanduser().resolve() if config_path and Path(config_path).exists(): import yaml raw = yaml.safe_load(Path(config_path).read_text()) out = raw.get("output", {}).get("dir") if out: return Path(out).expanduser().resolve() default = Path.cwd() / "bincio_data" if default.exists(): return default raise click.UsageError( "Could not find the BAS data directory. " "Run `bincio extract` first, or pass --data-dir." )