Function _start_background_proxy

uncommon_route/cli.py:335–369

(
    *,
    port: int,
    host: str,
    upstream: str | None = None,
    composition_config: str = "",
)

def _start_background_proxy(
    *,
    port: int,
    host: str,
    upstream: str | None = None,
    composition_config: str = "",
) -> tuple[bool, str]:
    _DATA_DIR.mkdir(parents=True, exist_ok=True, mode=0o700)
    if _PID_FILE.exists():
        try:
            old_pid = int(_PID_FILE.read_text().strip())
        except ValueError:
            _PID_FILE.unlink(missing_ok=True)
        else:
            try:
                os.kill(old_pid, 0)
                return False, f"Already running (PID {old_pid}). Stop first: uncommon-route stop"
            except OSError:
                _PID_FILE.unlink(missing_ok=True)

    cmd = [sys.executable, "-m", "uncommon_route.cli", "serve", "--port", str(port), "--host", host]
    if upstream:
        cmd.extend(["--upstream", upstream])
    if composition_config:
        cmd.extend(["--composition-config", composition_config])

    with open(_LOG_FILE, "a") as lf:
        proc = subprocess.Popen(
            cmd,
            stdout=lf,
            stderr=subprocess.STDOUT,
            start_new_session=True,
        )
    _PID_FILE.write_text(str(proc.pid))
    return True, f"Started in background (PID {proc.pid})"


def _parse_flags(args: list[str], known_flags: dict[str, bool]) -> tuple[dict[str, str | bool], list[str]]: