5933fdc789
Give bot-bottle a real distribution path so new users can install
without cloning the repo:
- pyproject.toml: full project metadata, a `bot-bottle` console-script
entry point (bot_bottle.cli:main), and package-data for the runtime
assets (Dockerfiles, egress entrypoint, netpool defaults, macos init).
Still zero runtime pip dependencies.
- install.sh: POSIX, sudo-free, idempotent bootstrapper — checks Python
>= 3.11, creates ~/.bot-bottle/{agents,bottles,contrib}, installs via
pipx (pip --user fallback), then runs `bot-bottle doctor`.
- `bot-bottle doctor`: new store-free subcommand reporting Python
version, backend availability (reuses is_backend_available rather than
hardcoding Docker), and config-dir presence. Exits non-zero when a hard
prerequisite is unmet.
- PRD prd-new-install-script and unit tests for doctor, the packaging
contract, and the install script.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
60 lines
2.3 KiB
Python
60 lines
2.3 KiB
Python
"""CLI subcommand registry.
|
|
|
|
One module per `bot-bottle <command>`, each exposing a `cmd_<name>(argv)`
|
|
handler. This package `__init__` maps command names to their handlers
|
|
**lazily**: a short-lived CLI run dispatches exactly one command, so
|
|
importing all twelve handlers (and their transitive deps — backend,
|
|
manifest, orchestrator, …) up front is wasted work. Each COMMANDS value is
|
|
a thin wrapper that imports its handler's module on first call. Shared CLI
|
|
helpers (`constants`, `tui`) stay one level up in the `cli` package.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from importlib import import_module
|
|
from typing import Callable
|
|
|
|
# command name -> "<submodule>:<handler attr>". Kept as strings so building
|
|
# the registry imports nothing; the module loads only when dispatched.
|
|
_HANDLERS: dict[str, str] = {
|
|
"active": "active:cmd_active",
|
|
"backend": "backend:cmd_backend",
|
|
"cleanup": "cleanup:cmd_cleanup",
|
|
"commit": "commit:cmd_commit",
|
|
"doctor": "doctor:cmd_doctor",
|
|
"edit": "edit:cmd_edit",
|
|
"help": "help:cmd_help",
|
|
"init": "init:cmd_init",
|
|
"list": "list:cmd_list",
|
|
"login": "login:cmd_login",
|
|
"resume": "resume:cmd_resume",
|
|
"start": "start:cmd_start",
|
|
"supervise": "supervise:cmd_supervise",
|
|
}
|
|
|
|
|
|
def _lazy(spec: str) -> Callable[[list[str]], "int | None"]:
|
|
"""Wrap a `<module>:<attr>` handler so its module is imported only when
|
|
the command is actually dispatched, not when the registry is built."""
|
|
module, attr = spec.split(":")
|
|
|
|
def run(argv: list[str]) -> "int | None":
|
|
handler = getattr(import_module(f".{module}", __name__), attr)
|
|
return handler(argv)
|
|
|
|
run.__name__ = attr
|
|
return run
|
|
|
|
|
|
COMMANDS = {name: _lazy(spec) for name, spec in _HANDLERS.items()}
|
|
|
|
# Commands that manage host prerequisites (or are otherwise store-free) and
|
|
# must run before — or without — a migrated DB. `backend` provisions/probes
|
|
# the host (TAP pool, /dev/kvm, firecracker) and never opens the store, so
|
|
# gating it on the schema breaks preflight on a fresh CI runner where stdin
|
|
# isn't a TTY and the migration prompt can't be answered. `help` and `login`
|
|
# likewise never touch the store.
|
|
NO_MIGRATION_COMMANDS = frozenset({"backend", "doctor", "help", "login"})
|
|
|
|
__all__ = ["COMMANDS", "NO_MIGRATION_COMMANDS"]
|