plexus-python 0.6.1__tar.gz → 0.6.3__tar.gz

{plexus_python-0.6.1 → plexus_python-0.6.3}/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## [0.6.3] - 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
+
+- Buffer overflow now surfaces on stderr (`⚠ buffer full, dropped N oldest points`) instead
+  of going silently to `logging.warning`. Both `MemoryBuffer` and `SqliteBuffer` are covered.
+- `on_command()` late-registration warning now goes through `logging.warning()` so it is not
+  suppressed by `PLEXUS_QUIET=1`.
+- `PLEXUS_QUIET` env var is now read at call time rather than import time — setting it after
+  module load now takes effect.
+- `max_buffer_size` setter no longer directly mutates `_buffer._max_size`; routes through a
+  new `resize()` method on `BufferBackend`.
+
+### Changed
+
+- `PlexusError`, `AuthenticationError`, and `RetryConfig` are now exported from the top-level
+  `plexus` package. `from plexus import PlexusError` now works as expected.
+- `WebSocketTransport` and `read_mjpeg_frames` removed from `__all__` — both remain importable
+  via their source modules but are no longer part of the top-level public API.
+
+### Breaking
+
+- `Plexus.__init__` no longer accepts a `transport` parameter. WebSocket with automatic HTTP
+  fallback is the only send path.
+- `ThermalSource.open()` now requires an explicit hint (`"sim"`, `"mlx90640"`, `"mlx90641"`,
+  `"usb"`, or a device index). Auto-detection has been removed — it could not reliably
+  distinguish USB thermal cameras from regular webcams.
+
+## [0.6.2] - 2026-05-28 - Dependency fix
+
+### Fixed
+
+- Replaced `opencv-python` with `opencv-python-headless` in the `[video]` extra —
+  headless is the correct choice for embedded/server use and avoids pulling in Qt/GUI
+  dependencies that don't belong on Raspberry Pi or headless Linux.
+- Merged the `[thermal]` extra into `[video]`. OpenCV is needed for all video frame
+  encoding, not just thermal cameras. Install with `pip install plexus-python[video]`.
+- Synced `plexus.__version__` with `pyproject.toml` (both now `0.6.2`).
+
 ## [0.6.1] - 2026-05-28 - Thermal camera streaming
 
 ### Added

{plexus_python-0.6.1 → plexus_python-0.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plexus-python
-Version: 0.6.1
+Version: 0.6.3
 Summary: Thin Python SDK for Plexus — send telemetry in one line
 Project-URL: Homepage, https://plexus.dev
 Project-URL: Documentation, https://docs.plexus.dev
@@ -24,15 +24,14 @@ Requires-Python: >=3.10
 Requires-Dist: websocket-client>=1.7
 Provides-Extra: dev
 Requires-Dist: numpy>=1.24; extra == 'dev'
-Requires-Dist: opencv-python>=4.8; extra == 'dev'
+Requires-Dist: opencv-python-headless>=4.8; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest>=9.0.3; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
 Requires-Dist: websockets>=12; extra == 'dev'
-Provides-Extra: thermal
-Requires-Dist: numpy>=1.24; extra == 'thermal'
-Requires-Dist: opencv-python>=4.8; extra == 'thermal'
 Provides-Extra: video
+Requires-Dist: numpy>=1.24; extra == 'video'
+Requires-Dist: opencv-python-headless>=4.8; extra == 'video'
 Requires-Dist: pillow>=12.2.0; extra == 'video'
 Description-Content-Type: text/markdown
 

plexus_python-0.6.3/TODO.md

@@ -0,0 +1 @@
+# TODO

plexus_python-0.6.3/plexus/__init__.py

@@ -0,0 +1,14 @@
+"""
+Plexus — thin Python SDK for sending telemetry to the Plexus gateway.
+
+    from plexus import Plexus
+
+    px = Plexus(api_key="plx_xxx", source_id="device-001")
+    px.send("temperature", 72.5)
+"""
+
+from plexus.client import Plexus, PlexusError, AuthenticationError, read_mjpeg_frames
+from plexus.config import RetryConfig
+
+__version__ = "0.6.3"
+__all__ = ["Plexus", "PlexusError", "AuthenticationError", "RetryConfig", "read_mjpeg_frames"]

{plexus_python-0.6.1 → plexus_python-0.6.3}/plexus/_log.py

@@ -1,12 +1,10 @@
 import os
 import sys
 
-_QUIET = os.environ.get("PLEXUS_QUIET", "").lower() in ("1", "true", "yes")
-
 
 def _say(line: str) -> None:
     """Single-line status message to stderr. Skipped if PLEXUS_QUIET=1."""
-    if _QUIET:
+    if os.environ.get("PLEXUS_QUIET", "").lower() in ("1", "true", "yes"):
         return
     try:
         sys.stderr.write(f"[plexus] {line}\n")

{plexus_python-0.6.1 → plexus_python-0.6.3}/plexus/buffer.py

@@ -41,6 +41,10 @@ class BufferBackend(ABC):
     def size(self) -> int:
         """Return current number of buffered points."""
 
+    @abstractmethod
+    def resize(self, max_size: int) -> None:
+        """Update the maximum buffer capacity."""
+
     def drain(self, batch_size: int = 5000) -> Tuple[List[Dict[str, Any]], int]:
         """Remove and return the oldest batch_size points atomically.
 
@@ -97,6 +101,10 @@ class MemoryBuffer(BufferBackend):
         with self._lock:
             return len(self._buffer)
 
+    def resize(self, max_size: int) -> None:
+        with self._lock:
+            self._max_size = max_size
+
     def drain(self, batch_size: int = 5000) -> Tuple[List[Dict[str, Any]], int]:
         with self._lock:
             batch = self._buffer[:batch_size]
@@ -185,6 +193,10 @@ class SqliteBuffer(BufferBackend):
             cursor = self._conn.execute("SELECT COUNT(*) FROM points")
             return cursor.fetchone()[0]
 
+    def resize(self, max_size: int) -> None:
+        with self._lock:
+            self._max_size = max_size
+
     def drain(self, batch_size: int = 5000) -> Tuple[List[Dict[str, Any]], int]:
         """Remove and return the oldest batch_size points atomically.
 

{plexus_python-0.6.1 → plexus_python-0.6.3}/plexus/cameras/thermal.py

@@ -8,8 +8,9 @@ ThermalFrame containing a colorized JPEG image plus temperature metadata.
 Usage:
     from plexus.cameras.thermal import ThermalSource
 
-    cam = ThermalSource.open()          # auto-detect
     cam = ThermalSource.open("sim")     # simulated, no hardware
+    cam = ThermalSource.open("mlx90640")  # I2C MLX90640
+    cam = ThermalSource.open("usb")     # USB thermal at index 0
 
     while True:
         px.send_thermal_frame(cam.read_frame(), camera_id="thermal")
@@ -325,19 +326,33 @@ class MLX90641Camera(ThermalCamera):
 
 
 class ThermalSource:
-    """Factory that opens the first available thermal camera.
+    """Factory for opening a thermal camera by type.
+
+    A camera type must be specified explicitly — auto-detection is not supported
+    because USB thermal cameras and regular webcams are indistinguishable at the
+    OS level without knowing what you're looking for.
+
+    Args:
+        hint: Which camera to open. One of:
+            "sim"      — simulated 32×24 camera, no hardware required
+            "mlx90640" — MLX90640 32×24 I2C sensor (Raspberry Pi, 3.3V)
+            "mlx90641" — MLX90641 16×12 I2C sensor (Raspberry Pi, 3.3V)
+            "usb"      — USB thermal camera at device index 0
+            <int>      — USB thermal camera at a specific device index
+
+    Raises:
+        ValueError: If hint is None or unrecognised.
+        NoCameraFound: If the specified device cannot be opened.
 
     Examples:
-        ThermalSource.open()             # auto-detect
-        ThermalSource.open("sim")        # simulated
-        ThermalSource.open("mlx90640")   # force I2C MLX90640
-        ThermalSource.open("mlx90641")   # force I2C MLX90641
-        ThermalSource.open("usb")        # USB thermal at index 0
-        ThermalSource.open(2)            # USB thermal at index 2
+        cam = ThermalSource.open("sim")        # no hardware
+        cam = ThermalSource.open("mlx90640")   # I2C MLX90640
+        cam = ThermalSource.open("usb")        # USB at index 0
+        cam = ThermalSource.open(2)            # USB at index 2
     """
 
     @staticmethod
-    def open(hint: str | int | None = None) -> ThermalCamera:
+    def open(hint: str | int) -> ThermalCamera:
         if hint == "sim":
             return SimulatedThermalCamera()
         if hint == "mlx90640":
@@ -346,43 +361,7 @@ class ThermalSource:
             return MLX90641Camera()
         if hint == "usb" or isinstance(hint, int):
             return USBThermalCamera(0 if hint == "usb" else hint)
-        return ThermalSource._autodetect()
-
-    @staticmethod
-    def _autodetect() -> ThermalCamera:
-        cam = ThermalSource._try_i2c()
-        if cam:
-            return cam
-        cam = ThermalSource._try_usb()
-        if cam:
-            return cam
-        raise NoCameraFound(
-            "No thermal camera detected. Use ThermalSource.open('sim') to run without hardware."
+        raise ValueError(
+            f"Unknown camera hint {hint!r}. "
+            "Valid options: 'sim', 'mlx90640', 'mlx90641', 'usb', or a device index (int)."
         )
-
-    @staticmethod
-    def _try_i2c() -> ThermalCamera | None:
-        try:
-            import board
-            import busio
-
-            i2c = busio.I2C(board.SCL, board.SDA)
-            i2c.try_lock()
-            addrs = i2c.scan()
-            i2c.unlock()
-            if 0x33 in addrs:
-                return MLX90640Camera()
-            if 0x60 in addrs:
-                return MLX90641Camera()
-        except Exception:
-            pass
-        return None
-
-    @staticmethod
-    def _try_usb() -> ThermalCamera | None:
-        for idx in range(10):
-            try:
-                return USBThermalCamera(idx)
-            except NoCameraFound:
-                continue
-        return None

{plexus_python-0.6.1 → plexus_python-0.6.3}/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__)
@@ -187,7 +185,6 @@ class Plexus:
         max_buffer_size: int = 10000,
         persistent_buffer: bool = True,
         buffer_path: Optional[str] = None,
-        transport: str = "ws",
         ws_url: Optional[str] = None,
     ):
         self.api_key = api_key or get_api_key()
@@ -212,9 +209,6 @@ class Plexus:
         self._pil_image = None  # lazy PIL.Image import
         self._fit_warned: bool = False
 
-        if transport not in ("ws", "http"):
-            raise ValueError(f"transport must be 'ws' or 'http', got {transport!r}")
-        self.transport = transport
         self._ws_url = (ws_url or get_gateway_ws_url())
         self._ws = None  # lazily constructed in _ensure_ws()
         self._clock_offset_ms: int = 0
@@ -222,10 +216,14 @@ class Plexus:
         # Pluggable buffer backend for failed sends
         if persistent_buffer:
             self._buffer: BufferBackend = SqliteBuffer(
-                path=buffer_path, max_size=max_buffer_size
+                path=buffer_path, max_size=max_buffer_size,
+                on_overflow=self._on_buffer_overflow,
             )
         else:
-            self._buffer: BufferBackend = MemoryBuffer(max_size=max_buffer_size)
+            self._buffer: BufferBackend = MemoryBuffer(
+                max_size=max_buffer_size,
+                on_overflow=self._on_buffer_overflow,
+            )
 
         # State that drives the [plexus] stderr status line.
         self._announced_first_send = False
@@ -240,7 +238,7 @@ class Plexus:
     @max_buffer_size.setter
     def max_buffer_size(self, value):
         self._max_buffer_size = value
-        self._buffer._max_size = value
+        self._buffer.resize(value)
 
     def _get_session(self) -> _Session:
         if self._session is None:
@@ -414,27 +412,18 @@ 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()
         return self._ws
 
+    def _on_buffer_overflow(self, dropped: int) -> None:
+        _say(f"⚠ buffer full, dropped {dropped} oldest points (gateway unreachable?)")
+
     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).
 
@@ -483,8 +472,8 @@ class Plexus:
             except ImportError as e:
                 if required:
                     raise ImportError(
-                        "This frame type requires opencv-python. "
-                        "Install with: pip install opencv-python"
+                        "This frame type requires opencv-python-headless. "
+                        "Install with: pip install plexus-python[video]"
                     ) from e
         return self._cv2
 
@@ -575,9 +564,6 @@ class Plexus:
             ValueError: If frame type is not supported.
             ImportError: If a required optional dependency is missing.
         """
-        if self.transport != "ws":
-            raise PlexusError("send_video_frame requires transport='ws'")
-
         jpeg_bytes, width, height = self._encode_frame(frame, quality)
         jpeg_bytes = self._fit_to_wire(jpeg_bytes, quality)
 
@@ -611,17 +597,14 @@ class Plexus:
 
         Raises:
             PlexusError: If transport is not 'ws'.
-            ImportError: If opencv-python is not installed.
+            ImportError: If opencv-python-headless is not installed.
         """
-        if self.transport != "ws":
-            raise PlexusError("send_thermal_frame requires transport='ws'")
-
         try:
             from plexus.cameras.thermal import build_thermal_frame
         except ImportError as e:
             raise ImportError(
-                "send_thermal_frame requires opencv-python. "
-                "Install with: pip install opencv-python"
+                "send_thermal_frame requires opencv-python-headless. "
+                "Install with: pip install plexus-python[video]"
             ) from e
 
         frame = build_thermal_frame(temps, timestamp_ms=self._normalize_ts_ms(timestamp))
@@ -663,8 +646,6 @@ class Plexus:
             time.sleep(60)
             stop.set()
         """
-        if self.transport != "ws":
-            raise PlexusError("stream_camera requires transport='ws'")
         if shutil.which("ffmpeg") is None:
             raise PlexusError(
                 "FFmpeg not found. Install it: https://ffmpeg.org/download.html"
@@ -715,24 +696,21 @@ class Plexus:
         Must be called before the first send() so the command is advertised
         in the auth frame.
         """
-        if self.transport != "ws":
-            raise PlexusError("on_command requires transport='ws'")
         ws = self._ensure_ws()
         if ws.is_authenticated:
-            _say(
-                f"⚠ on_command('{name}') called after connection is already authenticated — "
+            logger.warning(
+                "on_command('%s') called after connection is already authenticated — "
                 "command will not be advertised to the dashboard until next reconnect. "
-                "Call on_command() before the first send()."
+                "Call on_command() before the first send().",
+                name,
             )
         ws.register_command(name, handler, description=description, params=params)
 
     def _send_points(self, points: List[Dict[str, Any]]) -> bool:
         """Send data points to the gateway with retry and buffering.
 
-        Path:
-        - transport='ws': try the WebSocket first; if not yet authenticated or
-          the socket fails, fall through to the HTTP path so points still land.
-        - transport='http': always POST /ingest with retries.
+        Tries WebSocket first; if not yet authenticated or the socket fails,
+        falls through to HTTP POST so points still land.
 
         Retry behavior (HTTP path):
         - Retries on: Timeout, ConnectionError, HTTP 429, HTTP 5xx
@@ -748,22 +726,21 @@ class Plexus:
         all_points = self._get_buffered_points() + points
 
         # Preferred path: WebSocket.
-        if self.transport == "ws":
-            ws = self._ensure_ws()
-            # Brief wait on first call so startup races don't dump every point
-            # into the HTTP fallback path.
-            if not ws.is_authenticated:
-                ws.wait_authenticated(timeout=min(self.timeout, 5.0))
-            if ws.send_points(all_points):
-                self._clear_buffer()
-                self._note_send(len(all_points), via="ws")
-                return True
-            # Socket unavailable → fall through to HTTP.
-            if not self._announced_http_fallback:
-                _say(
-                    f"⚠ WebSocket unavailable, falling back to POST {self.gateway_url}/ingest"
-                )
-                self._announced_http_fallback = True
+        ws = self._ensure_ws()
+        # Brief wait on first call so startup races don't dump every point
+        # into the HTTP fallback path.
+        if not ws.is_authenticated:
+            ws.wait_authenticated(timeout=min(self.timeout, 5.0))
+        if ws.send_points(all_points):
+            self._clear_buffer()
+            self._note_send(len(all_points), via="ws")
+            return True
+        # Socket unavailable → fall through to HTTP.
+        if not self._announced_http_fallback:
+            _say(
+                f"⚠ WebSocket unavailable, falling back to POST {self.gateway_url}/ingest"
+            )
+            self._announced_http_fallback = True
 
         url = f"{self.gateway_url}/ingest"
         last_error: Optional[Exception] = None

{plexus_python-0.6.1 → plexus_python-0.6.3}/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.6.1 → plexus_python-0.6.3}/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.6.1 → plexus_python-0.6.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plexus-python"
-version = "0.6.1"
+version = "0.6.3"
 description = "Thin Python SDK for Plexus — send telemetry in one line"
 readme = "README.md"
 license = "Apache-2.0"
@@ -30,13 +30,12 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-video = ["Pillow>=12.2.0"]
-# Thermal cameras: colorization + Y16/USB capture. I2C sensors additionally
-# need a board-specific driver, installed separately on the device, e.g.
-# adafruit-circuitpython-mlx90640 (these require Raspberry Pi hardware libs
-# and don't install on other platforms, so they're not listed here).
-thermal = ["opencv-python>=4.8", "numpy>=1.24"]
-dev = ["pytest>=9.0.3", "pytest-cov", "ruff", "websockets>=12", "opencv-python>=4.8", "numpy>=1.24"]
+# Video/camera support: frame encoding, thermal cameras, etc.
+# I2C thermal sensors additionally need a board-specific driver installed
+# separately on the device (e.g. adafruit-circuitpython-mlx90640 — requires
+# Raspberry Pi hardware libs and doesn't install on other platforms).
+video = ["Pillow>=12.2.0", "opencv-python-headless>=4.8", "numpy>=1.24"]
+dev = ["pytest>=9.0.3", "pytest-cov", "ruff", "websockets>=12", "opencv-python-headless>=4.8", "numpy>=1.24"]
 
 [project.scripts]
 plexus = "plexus.cli:main"
@@ -52,4 +51,4 @@ packages = ["plexus"]
 
 [tool.ruff]
 line-length = 100
-target-version = "py38"
+target-version = "py310"

{plexus_python-0.6.1 → plexus_python-0.6.3}/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.6.1 → plexus_python-0.6.3}/uv.lock

@@ -302,7 +302,7 @@ wheels = [
 ]
 
 [[package]]
-name = "opencv-python"
+name = "opencv-python-headless"
 version = "4.13.0.92"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
@@ -310,14 +310,14 @@ dependencies = [
     { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
 ]
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/fc/6f/5a28fef4c4a382be06afe3938c64cc168223016fa520c5abaf37e8862aa5/opencv_python-4.13.0.92-cp37-abi3-macosx_13_0_arm64.whl", hash = "sha256:caf60c071ec391ba51ed00a4a920f996d0b64e3e46068aac1f646b5de0326a19", size = 46247052, upload-time = "2026-02-05T07:01:25.046Z" },
-    { url = "https://files.pythonhosted.org/packages/08/ac/6c98c44c650b8114a0fb901691351cfb3956d502e8e9b5cd27f4ee7fbf2f/opencv_python-4.13.0.92-cp37-abi3-macosx_14_0_x86_64.whl", hash = "sha256:5868a8c028a0b37561579bfb8ac1875babdc69546d236249fff296a8c010ccf9", size = 32568781, upload-time = "2026-02-05T07:01:41.379Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/51/82fed528b45173bf629fa44effb76dff8bc9f4eeaee759038362dfa60237/opencv_python-4.13.0.92-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:0bc2596e68f972ca452d80f444bc404e08807d021fbba40df26b61b18e01838a", size = 47685527, upload-time = "2026-02-05T06:59:11.24Z" },
-    { url = "https://files.pythonhosted.org/packages/db/07/90b34a8e2cf9c50fe8ed25cac9011cde0676b4d9d9c973751ac7616223a2/opencv_python-4.13.0.92-cp37-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:402033cddf9d294693094de5ef532339f14ce821da3ad7df7c9f6e8316da32cf", size = 70460872, upload-time = "2026-02-05T06:59:19.162Z" },
-    { url = "https://files.pythonhosted.org/packages/02/6d/7a9cc719b3eaf4377b9c2e3edeb7ed3a81de41f96421510c0a169ca3cfd4/opencv_python-4.13.0.92-cp37-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:bccaabf9eb7f897ca61880ce2869dcd9b25b72129c28478e7f2a5e8dee945616", size = 46708208, upload-time = "2026-02-05T06:59:15.419Z" },
-    { url = "https://files.pythonhosted.org/packages/fd/55/b3b49a1b97aabcfbbd6c7326df9cb0b6fa0c0aefa8e89d500939e04aa229/opencv_python-4.13.0.92-cp37-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:620d602b8f7d8b8dab5f4b99c6eb353e78d3fb8b0f53db1bd258bb1aa001c1d5", size = 72927042, upload-time = "2026-02-05T06:59:23.389Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/17/de5458312bcb07ddf434d7bfcb24bb52c59635ad58c6e7c751b48949b009/opencv_python-4.13.0.92-cp37-abi3-win32.whl", hash = "sha256:372fe164a3148ac1ca51e5f3ad0541a4a276452273f503441d718fab9c5e5f59", size = 30932638, upload-time = "2026-02-05T07:02:14.98Z" },
-    { url = "https://files.pythonhosted.org/packages/e9/a5/1be1516390333ff9be3a9cb648c9f33df79d5096e5884b5df71a588af463/opencv_python-4.13.0.92-cp37-abi3-win_amd64.whl", hash = "sha256:423d934c9fafb91aad38edf26efb46da91ffbc05f3f59c4b0c72e699720706f5", size = 40212062, upload-time = "2026-02-05T07:02:12.724Z" },
+    { url = "https://files.pythonhosted.org/packages/79/42/2310883be3b8826ac58c3f2787b9358a2d46923d61f88fedf930bc59c60c/opencv_python_headless-4.13.0.92-cp37-abi3-macosx_13_0_arm64.whl", hash = "sha256:1a7d040ac656c11b8c38677cc8cccdc149f98535089dbe5b081e80a4e5903209", size = 46247192, upload-time = "2026-02-05T07:01:35.187Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/1e/6f9e38005a6f7f22af785df42a43139d0e20f169eb5787ce8be37ee7fcc9/opencv_python_headless-4.13.0.92-cp37-abi3-macosx_14_0_x86_64.whl", hash = "sha256:3e0a6f0a37994ec6ce5f59e936be21d5d6384a4556f2d2da9c2f9c5dc948394c", size = 32568914, upload-time = "2026-02-05T07:01:51.989Z" },
+    { url = "https://files.pythonhosted.org/packages/21/76/9417a6aef9def70e467a5bf560579f816148a4c658b7d525581b356eda9e/opencv_python_headless-4.13.0.92-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5c8cfc8e87ed452b5cecb9419473ee5560a989859fe1d10d1ce11ae87b09a2cb", size = 33703709, upload-time = "2026-02-05T10:24:46.469Z" },
+    { url = "https://files.pythonhosted.org/packages/92/ce/bd17ff5772938267fd49716e94ca24f616ff4cb1ff4c6be13085108037be/opencv_python_headless-4.13.0.92-cp37-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:0525a3d2c0b46c611e2130b5fdebc94cf404845d8fa64d2f3a3b679572a5bd22", size = 56016764, upload-time = "2026-02-05T10:26:48.904Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/b4/b7bcbf7c874665825a8c8e1097e93ea25d1f1d210a3e20d4451d01da30aa/opencv_python_headless-4.13.0.92-cp37-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:eb60e36b237b1ebd40a912da5384b348df8ed534f6f644d8e0b4f103e272ba7d", size = 35010236, upload-time = "2026-02-05T10:28:11.031Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/33/b5db29a6c00eb8f50708110d8d453747ca125c8b805bc437b289dbdcc057/opencv_python_headless-4.13.0.92-cp37-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:0bd48544f77c68b2941392fcdf9bcd2b9cdf00e98cb8c29b2455d194763cf99e", size = 60391106, upload-time = "2026-02-05T10:30:14.236Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/c3/52cfea47cd33e53e8c0fbd6e7c800b457245c1fda7d61660b4ffe9596a7f/opencv_python_headless-4.13.0.92-cp37-abi3-win32.whl", hash = "sha256:a7cf08e5b191f4ebb530791acc0825a7986e0d0dee2a3c491184bd8599848a4b", size = 30812232, upload-time = "2026-02-05T07:02:29.594Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/90/b338326131ccb2aaa3c2c85d00f41822c0050139a4bfe723cfd95455bd2d/opencv_python_headless-4.13.0.92-cp37-abi3-win_amd64.whl", hash = "sha256:77a82fe35ddcec0f62c15f2ba8a12ecc2ed4207c17b0902c7a3151ae29f37fb6", size = 40070414, upload-time = "2026-02-05T07:02:26.448Z" },
 ]
 
 [[package]]
@@ -429,7 +429,7 @@ wheels = [
 
 [[package]]
 name = "plexus-python"
-version = "0.5.2"
+version = "0.6.3"
 source = { editable = "." }
 dependencies = [
     { name = "websocket-client" },
@@ -439,27 +439,25 @@ dependencies = [
 dev = [
     { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
     { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "opencv-python" },
+    { name = "opencv-python-headless" },
     { name = "pytest" },
     { name = "pytest-cov" },
     { name = "ruff" },
     { name = "websockets" },
 ]
-thermal = [
+video = [
     { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" },
     { name = "numpy", version = "2.4.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" },
-    { name = "opencv-python" },
-]
-video = [
+    { name = "opencv-python-headless" },
     { name = "pillow" },
 ]
 
 [package.metadata]
 requires-dist = [
     { name = "numpy", marker = "extra == 'dev'", specifier = ">=1.24" },
-    { name = "numpy", marker = "extra == 'thermal'", specifier = ">=1.24" },
-    { name = "opencv-python", marker = "extra == 'dev'", specifier = ">=4.8" },
-    { name = "opencv-python", marker = "extra == 'thermal'", specifier = ">=4.8" },
+    { name = "numpy", marker = "extra == 'video'", specifier = ">=1.24" },
+    { name = "opencv-python-headless", marker = "extra == 'dev'", specifier = ">=4.8" },
+    { name = "opencv-python-headless", marker = "extra == 'video'", specifier = ">=4.8" },
     { name = "pillow", marker = "extra == 'video'", specifier = ">=12.2.0" },
     { name = "pytest", marker = "extra == 'dev'", specifier = ">=9.0.3" },
     { name = "pytest-cov", marker = "extra == 'dev'" },
@@ -467,7 +465,7 @@ requires-dist = [
     { name = "websocket-client", specifier = ">=1.7" },
     { name = "websockets", marker = "extra == 'dev'", specifier = ">=12" },
 ]
-provides-extras = ["video", "thermal", "dev"]
+provides-extras = ["video", "dev"]
 
 [[package]]
 name = "pluggy"

plexus_python-0.6.1/plexus/__init__.py

@@ -1,14 +0,0 @@
-"""
-Plexus — thin Python SDK for sending telemetry to the Plexus gateway.
-
-    from plexus import Plexus
-
-    px = Plexus(api_key="plx_xxx", source_id="device-001")
-    px.send("temperature", 72.5)
-"""
-
-from plexus.client import Plexus, read_mjpeg_frames
-from plexus.ws import WebSocketTransport
-
-__version__ = "0.5.2"
-__all__ = ["Plexus", "WebSocketTransport", "read_mjpeg_frames"]