move onboarding

Author: Lash-L

docs/onboarding.md

@@ -9,10 +9,10 @@ If this is a brand new vacuum, it is still a good idea to set it up once in the
 Run onboarding from a second machine, not from the machine hosting the local server:
 
 ```bash
-uv run start_onboarding --server api-roborock.example.com
+uv run start_onboarding.py --server api-roborock.example.com
 ```
 
-`uv run onboarding.py --server api-roborock.example.com` still works as a compatibility wrapper.
+This is a standalone script — you can copy `start_onboarding.py` to any machine and run it with just `uv`.
 
 The guided CLI will:
 
@@ -41,7 +41,7 @@ The only required CLI flag is `--server`. The script will prompt for anything mi
 You can still pass them explicitly if you prefer:
 
 ```bash
-uv run start_onboarding --server api-roborock.example.com --ssid "My Wifi" --password "Password123" --timezone "America/New_York" --cst EST5EDT,M3.2.0,M11.1.0 --country-domain us
+uv run start_onboarding.py --server api-roborock.example.com --ssid "My Wifi" --password "Password123" --timezone "America/New_York" --cst EST5EDT,M3.2.0,M11.1.0 --country-domain us
 ```
 
 `server` should be your real stack hostname, usually the same `api-...` hostname you use for `/admin`.

onboarding.py

@@ -25,7 +25,6 @@ dev = [
 
 [project.scripts]
 roborock-local-server = "roborock_local_server.__main__:main"
-start_onboarding = "roborock_local_server.onboarding_cli:main"
 
 [build-system]
 requires = ["hatchling"]

pyproject.toml

@@ -1,4 +1,14 @@
-"""Guided remote onboarding CLI for pairing vacuums through the main server."""
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.11"
+# dependencies = ["pycryptodome>=3.20,<4"]
+# ///
+"""Guided remote onboarding CLI for pairing vacuums through the main server.
+
+This is a standalone script. Copy it to any machine and run:
+
+    uv run start_onboarding.py --server api-roborock.example.com
+"""
 
 from __future__ import annotations
 
@@ -538,3 +548,6 @@ def main(argv: list[str] | None = None) -> int:
         print(f"Error: {exc}", file=sys.stderr)
         return 1
 
+
+if __name__ == "__main__":
+    raise SystemExit(main())

…/roborock_local_server/onboarding_cli.py start_onboarding.pysrc/roborock_local_server/onboarding_cli.py renamed to start_onboarding.py src/roborock_local_server/onboarding_cli.py renamed to start_onboarding.py

@@ -3,6 +3,9 @@
 
 
 ROOT = Path(__file__).resolve().parents[1]
+root_str = str(ROOT)
+if root_str not in sys.path:
+    sys.path.insert(0, root_str)
 SRC = ROOT / "src"
 src_str = str(SRC)
 if src_str not in sys.path:

tests/conftest.py

@@ -4,7 +4,7 @@
 
 import pytest
 
-from roborock_local_server.onboarding_cli import GuidedOnboardingConfig, run_guided_onboarding
+from start_onboarding import GuidedOnboardingConfig, run_guided_onboarding
 
 
 class FakeApi:
@@ -97,7 +97,7 @@ def test_guided_onboarding_happy_path(monkeypatch: pytest.MonkeyPatch, config: G
     answers = iter(["1", ""])
     monkeypatch.setattr("builtins.input", lambda prompt="": next(answers))
     monkeypatch.setattr(
-        "roborock_local_server.onboarding_cli.poll_session_until_progress",
+        "start_onboarding.poll_session_until_progress",
         lambda *args, **kwargs: next(poll_results),
     )
 
@@ -177,7 +177,7 @@ def test_guided_onboarding_handles_extra_cycles(monkeypatch: pytest.MonkeyPatch,
     answers = iter(["1", "", "", ""])
     monkeypatch.setattr("builtins.input", lambda prompt="": next(answers))
     monkeypatch.setattr(
-        "roborock_local_server.onboarding_cli.poll_session_until_progress",
+        "start_onboarding.poll_session_until_progress",
         lambda *args, **kwargs: next(poll_results),
     )
 
@@ -247,7 +247,7 @@ def test_guided_onboarding_timeout_can_retry_without_restart(
     answers = iter(["1", "", "retry", ""])
     monkeypatch.setattr("builtins.input", lambda prompt="": next(answers))
     monkeypatch.setattr(
-        "roborock_local_server.onboarding_cli.poll_session_until_progress",
+        "start_onboarding.poll_session_until_progress",
         lambda *args, **kwargs: next(poll_results),
     )
 
@@ -307,7 +307,7 @@ def test_guided_onboarding_duplicate_names_still_selects_requested_device(
     answers = iter(["2", ""])
     monkeypatch.setattr("builtins.input", lambda prompt="": next(answers))
     monkeypatch.setattr(
-        "roborock_local_server.onboarding_cli.poll_session_until_progress",
+        "start_onboarding.poll_session_until_progress",
         lambda *args, **kwargs: next(poll_results),
     )