plexus-python 0.7.0__tar.gz → 0.7.1__tar.gz

{plexus_python-0.7.0 → plexus_python-0.7.1}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.7.1] - 2026-06-02 - Remove install_id / source_id auto-suffix
+
+### Changed
+
+- Removed `install_id` from the device auth frame and `WebSocketTransport`.
+- Removed server-side source_id auto-suffix handling (`on_source_id_assigned` callback, `set_source_id` persistence).
+- Removed `get_install_id` and `set_source_id` from `plexus.config`.
+
 ## [0.7.0] - 2026-05-29 - SDK hardening
 
 ### Fixed

{plexus_python-0.7.0 → plexus_python-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plexus-python
-Version: 0.7.0
+Version: 0.7.1
 Summary: Thin Python SDK for Plexus — send telemetry in one line
 Project-URL: Homepage, https://plexus.dev
 Project-URL: Documentation, https://docs.plexus.dev

{plexus_python-0.7.0 → plexus_python-0.7.1}/plexus/__init__.py

@@ -10,5 +10,5 @@ Plexus — thin Python SDK for sending telemetry to the Plexus gateway.
 from plexus.client import Plexus, PlexusError, AuthenticationError, read_mjpeg_frames
 from plexus.config import RetryConfig
 
-__version__ = "0.7.0"
+__version__ = "0.7.1"
 __all__ = ["Plexus", "PlexusError", "AuthenticationError", "RetryConfig", "read_mjpeg_frames"]

{plexus_python-0.7.0 → plexus_python-0.7.1}/plexus/client.py

@@ -55,9 +55,7 @@ from plexus.config import (
     get_endpoint,
     get_gateway_url,
     get_gateway_ws_url,
-    get_install_id,
     get_source_id,
-    set_source_id,
 )
 
 logger = logging.getLogger(__name__)
@@ -414,9 +412,7 @@ class Plexus:
             api_key=self.api_key,
             source_id=self.source_id,
             ws_url=self._ws_url,
-            install_id=get_install_id(),
             agent_version=__version__,
-            on_source_id_assigned=self._on_source_id_assigned,
             on_clock_synced=self._on_clock_synced,
         )
         self._ws.start()
@@ -428,16 +424,6 @@ class Plexus:
     def _on_clock_synced(self, offset_ms: int) -> None:
         self._clock_offset_ms = offset_ms
 
-    def _on_source_id_assigned(self, assigned: str) -> None:
-        """Callback from WebSocketTransport when the gateway returns an
-        auto-suffixed source_id. Persists it so subsequent runs (and the HTTP
-        fallback path in this process) use the assigned name directly."""
-        self.source_id = assigned
-        try:
-            set_source_id(assigned)
-        except Exception as e:  # pragma: no cover - persistence failure is non-fatal
-            logger.debug("failed to persist assigned source_id: %s", e)
-
     def _encode_frame(self, frame, quality: int) -> Tuple[bytes, int, int]:
         """Normalize any supported frame type to (jpeg_bytes, width, height).
 

{plexus_python-0.7.0 → plexus_python-0.7.1}/plexus/config.py

@@ -145,54 +145,6 @@ def get_source_id() -> Optional[str]:
     return source_id
 
 
-def get_install_id() -> str:
-    """Get the device install ID, generating one if not set.
-
-    The install_id is a stable per-installation UUID. It is generated lazily
-    on first run (NOT at image-build time) so that cloned SD-card images
-    naturally get distinct install_ids on their first boot. The gateway uses
-    it to tell "same device reconnecting" from "different device claiming the
-    same name" when resolving source_id collisions.
-
-    Resolution order:
-      1. ``PLEXUS_INSTALL_ID`` env var — lets ephemeral containers (Fly
-         machines, CI runners, Kubernetes pods) pin a stable identity
-         across restarts when the config filesystem is ephemeral. Without
-         this, every redeploy generates a new install_id and the gateway
-         auto-suffixes the source_id to avoid a collision with the prior
-         install ("gw-001" → "gw-001_2" → "gw-001_3"…).
-      2. ``install_id`` in the on-disk config.
-      3. Newly-generated UUID, persisted to config.
-    """
-    env_id = os.environ.get("PLEXUS_INSTALL_ID", "").strip()
-    if env_id:
-        return env_id
-
-    config = load_config()
-    install_id = config.get("install_id")
-
-    if not install_id:
-        import uuid
-        install_id = uuid.uuid4().hex
-        config["install_id"] = install_id
-        save_config(config)
-
-    return install_id
-
-
-def set_source_id(source_id: str) -> None:
-    """Persist an updated source_id to the config file.
-
-    Called by the SDK when the gateway returns an auto-suffixed name so the
-    assigned name is stable across reconnects.
-    """
-    config = load_config()
-    if config.get("source_id") == source_id:
-        return
-    config["source_id"] = source_id
-    save_config(config)
-
-
 def get_persistent_buffer() -> bool:
     """Get persistent buffer setting. Default True (store-and-forward enabled)."""
     config = load_config()

{plexus_python-0.7.0 → plexus_python-0.7.1}/plexus/ws.py

@@ -89,11 +89,9 @@ class WebSocketTransport:
         source_id: str,
         ws_url: str,
         *,
-        install_id: str = "",
         agent_version: str = "0.0.0",
         platform: str = "python-sdk",
         auto_reconnect: bool = True,
-        on_source_id_assigned: Optional[Callable[[str], None]] = None,
         on_clock_synced: Optional[Callable[[int], None]] = None,
     ):
         if not api_key:
@@ -103,12 +101,10 @@ class WebSocketTransport:
 
         self.api_key = api_key
         self.source_id = source_id
-        self.install_id = install_id
         self.ws_url = _ensure_device_path(ws_url)
         self.agent_version = agent_version
         self.platform = platform
         self.auto_reconnect = auto_reconnect
-        self._on_source_id_assigned = on_source_id_assigned
         self._on_clock_synced = on_clock_synced
 
         self._commands: Dict[str, _RegisteredCommand] = {}
@@ -278,16 +274,13 @@ class WebSocketTransport:
             self._ws = ws
 
         # 1. Send device_auth
-        desired_source_id = self.source_id
         auth = {
             "type": "device_auth",
             "api_key": self.api_key,
-            "source_id": desired_source_id,
+            "source_id": self.source_id,
             "platform": self.platform,
             "agent_version": self.agent_version,
         }
-        if self.install_id:
-            auth["install_id"] = self.install_id
         if self._commands:
             auth["commands"] = [c.to_manifest() for c in self._commands.values()]
         ws.send(json.dumps(auth))
@@ -312,22 +305,6 @@ class WebSocketTransport:
                 except Exception as e:
                     logger.debug("on_clock_synced callback raised: %s", e)
 
-        # The gateway may return a different source_id if the desired name
-        # was already claimed by another install — adopt the assigned value
-        # so all subsequent frames (heartbeats, future reconnects) use it.
-        assigned = msg.get("source_id")
-        if isinstance(assigned, str) and assigned and assigned != self.source_id:
-            logger.info(
-                "plexus ws source_id auto-suffixed: requested=%s assigned=%s",
-                desired_source_id, assigned,
-            )
-            self.source_id = assigned
-            if self._on_source_id_assigned is not None:
-                try:
-                    self._on_source_id_assigned(assigned)
-                except Exception as e:  # pragma: no cover - callback errors must not break auth
-                    logger.debug("on_source_id_assigned callback raised: %s", e)
-
         was_reconnect = self._backoff_attempt > 0
         self._authenticated.set()
         self._backoff_attempt = 0

{plexus_python-0.7.0 → plexus_python-0.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plexus-python"
-version = "0.7.0"
+version = "0.7.1"
 description = "Thin Python SDK for Plexus — send telemetry in one line"
 readme = "README.md"
 license = "Apache-2.0"

{plexus_python-0.7.0 → plexus_python-0.7.1}/tests/test_ws.py

@@ -126,7 +126,6 @@ def test_auth_handshake_and_telemetry(gateway):
         api_key="plx_test_abc",
         source_id="drone-001",
         ws_url=_url(gateway.port),
-        install_id="install-A",
         agent_version="9.9.9",
     )
     t.start()
@@ -137,7 +136,7 @@ def test_auth_handshake_and_telemetry(gateway):
         assert gateway.auth_frame["type"] == "device_auth"
         assert gateway.auth_frame["api_key"] == "plx_test_abc"
         assert gateway.auth_frame["source_id"] == "drone-001"
-        assert gateway.auth_frame["install_id"] == "install-A"
+        assert "install_id" not in gateway.auth_frame
         assert gateway.auth_frame["platform"] == "python-sdk"
         assert gateway.auth_frame["agent_version"] == "9.9.9"
         # commands is omitted when none registered
@@ -256,78 +255,6 @@ def test_handler_exception_returns_error(gateway):
         t.stop()
 
 
-def test_install_id_omitted_when_empty():
-    # Default install_id="" should not leak an empty install_id field into
-    # the auth frame — that keeps the wire shape identical for legacy SDK
-    # builds that don't set one.
-    g = _StubGateway()
-    g.start()
-    try:
-        t = WebSocketTransport(
-            api_key="plx_test_abc",
-            source_id="drone-001",
-            ws_url=_url(g.port),
-        )
-        t.start()
-        try:
-            assert t.wait_authenticated(timeout=3)
-            assert "install_id" not in g.auth_frame
-        finally:
-            t.stop()
-    finally:
-        g.stop()
-
-
-def test_server_assigned_source_id_is_adopted():
-    # Simulate the auto-suffix path: SDK asks for "drone-01", the gateway
-    # returns "drone-01_2" in the authenticated frame. The transport must
-    # adopt the assigned name and fire the on_source_id_assigned callback.
-    g = _StubGateway(assigned_source_id="drone-01_2")
-    g.start()
-    try:
-        seen: List[str] = []
-        t = WebSocketTransport(
-            api_key="plx_test_abc",
-            source_id="drone-01",
-            ws_url=_url(g.port),
-            install_id="install-B",
-            on_source_id_assigned=lambda s: seen.append(s),
-        )
-        t.start()
-        try:
-            assert t.wait_authenticated(timeout=3)
-            assert t.source_id == "drone-01_2"
-            assert seen == ["drone-01_2"]
-        finally:
-            t.stop()
-    finally:
-        g.stop()
-
-
-def test_same_assigned_source_id_does_not_fire_callback():
-    # Happy path — gateway returns the same name. No callback, source_id unchanged.
-    g = _StubGateway()  # echoes whatever was sent
-    g.start()
-    try:
-        seen: List[str] = []
-        t = WebSocketTransport(
-            api_key="plx_test_abc",
-            source_id="drone-01",
-            ws_url=_url(g.port),
-            install_id="install-A",
-            on_source_id_assigned=lambda s: seen.append(s),
-        )
-        t.start()
-        try:
-            assert t.wait_authenticated(timeout=3)
-            assert t.source_id == "drone-01"
-            assert seen == []
-        finally:
-            t.stop()
-    finally:
-        g.stop()
-
-
 def test_ensure_device_path():
     from plexus.ws import _ensure_device_path
     assert _ensure_device_path("wss://foo") == "wss://foo/ws/device"

{plexus_python-0.7.0 → plexus_python-0.7.1}/uv.lock

@@ -429,7 +429,7 @@ wheels = [
 
 [[package]]
 name = "plexus-python"
-version = "0.6.2"
+version = "0.7.1"
 source = { editable = "." }
 dependencies = [
     { name = "websocket-client" },