phystack-hub-client 0.2.5__tar.gz → 0.2.7__tar.gz

{phystack_hub_client-0.2.5 → phystack_hub_client-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: phystack-hub-client
-Version: 0.2.5
+Version: 0.2.7
 Summary: Python client for PhyHub - events, actions, DataChannel, and MediaStream
 Project-URL: Homepage, https://github.com/phystack/phystack-pypi
 Project-URL: Documentation, https://docs.phystack.com
@@ -15,11 +15,12 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
-Requires-Dist: aiohttp>=3.9.0
-Requires-Dist: aiortc>=1.6.0
-Requires-Dist: numpy>=1.24.0
-Requires-Dist: opencv-python>=4.8.0
-Requires-Dist: python-socketio[asyncio-client]>=5.10.0
+Requires-Dist: aiohttp<4.0.0,>=3.9.0
+Requires-Dist: aiortc<2.0.0,>=1.6.0
+Requires-Dist: numpy<3.0.0,>=1.24.0
+Requires-Dist: opencv-python<5.0.0,>=4.8.0
+Requires-Dist: python-engineio<4.12.0,>=4.9.0
+Requires-Dist: python-socketio[asyncio-client]<5.12.0,>=5.11.0
 Provides-Extra: dev
 Requires-Dist: black>=23.0.0; extra == 'dev'
 Requires-Dist: mypy>=1.5.0; extra == 'dev'

{phystack_hub_client-0.2.5 → phystack_hub_client-0.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "phystack-hub-client"
-version = "0.2.5"
+version = "0.2.7"
 description = "Python client for PhyHub - events, actions, DataChannel, and MediaStream"
 readme = "README.md"
 license = "MIT"
@@ -22,11 +22,22 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
 ]
 dependencies = [
-    "python-socketio[asyncio_client]>=5.10.0",
-    "aiohttp>=3.9.0",
-    "aiortc>=1.6.0",
-    "opencv-python>=4.8.0",
-    "numpy>=1.24.0",
+    # Pinned to narrow ranges tested against the PhyOS hub socket.io server
+    # (socket.io 4.8.1 / engine.io 6.6.4). python-engineio 4.12+ has a bug
+    # in the WebSocket upgrade error path: _connect_websocket can pass a
+    # WebSocketError object into the packet decoder, causing
+    # "TypeError: object of type 'WebSocketError' has no len()".
+    "python-socketio[asyncio_client]>=5.11.0,<5.12.0",
+    "python-engineio>=4.9.0,<4.12.0",
+    # aiohttp 4.x is an announced future breaking release; cap below it.
+    "aiohttp>=3.9.0,<4.0.0",
+    # aiortc has had minor-version API breaks; cap at next major.
+    "aiortc>=1.6.0,<2.0.0",
+    # opencv-python 5.x is not released yet; cap at next major.
+    "opencv-python>=4.8.0,<5.0.0",
+    # numpy 2.0 was a large ABI change. Allow 2.x but cap before the next
+    # unreleased major to avoid surprise breaks.
+    "numpy>=1.24.0,<3.0.0",
 ]
 
 [project.optional-dependencies]

{phystack_hub_client-0.2.5 → phystack_hub_client-0.2.7}/src/phystack/hub_client/services/phyhub_connection.py

@@ -182,14 +182,33 @@ class PhyHubConnection:
             return self._sio
 
         mode = self.config.mode
+
+        # Debug: log versions of key libraries for connection troubleshooting
+        try:
+            import socketio as _sio_mod
+            import engineio as _eio_mod
+            import aiohttp as _aiohttp_mod
+            print(
+                f"[PhyHubConnection] Library versions: "
+                f"python-socketio={_sio_mod.__version__}, "
+                f"python-engineio={_eio_mod.__version__}, "
+                f"aiohttp={_aiohttp_mod.__version__}"
+            )
+        except Exception as _e:
+            print(f"[PhyHubConnection] Could not read lib versions: {_e}")
+
         print(f"[PhyHubConnection] Connecting to {self.config.url} ({mode.value} mode)")
+        print(f"[PhyHubConnection] Instance ID: {self.config.instance_id!r}")
+        print(f"[PhyHubConnection] Device ID: {self.config.device_id!r}")
 
+        # Enable verbose logging from socketio and engineio to trace the
+        # handshake and packet flow during connection troubleshooting.
         self._sio = socketio.AsyncClient(
             reconnection=True,
             reconnection_attempts=5,
             reconnection_delay=1,
-            logger=False,
-            engineio_logger=False,
+            logger=True,
+            engineio_logger=True,
         )
 
         self._connect_event = asyncio.Event()
@@ -198,6 +217,14 @@ class PhyHubConnection:
         async def connect() -> None:
             self._connected = True
             print("[PhyHubConnection] Connected successfully")
+            try:
+                print(
+                    f"[PhyHubConnection] Namespaces on client: {list(self._sio.namespaces)}; "
+                    f"Session ID: {self._sio.get_sid()!r}; "
+                    f"Transport: {self._sio.transport()!r}"
+                )
+            except Exception as _e:
+                print(f"[PhyHubConnection] Could not read post-connect state: {_e}")
             if self._connect_event:
                 self._connect_event.set()
 
@@ -208,7 +235,7 @@ class PhyHubConnection:
 
         @self._sio.event
         async def connect_error(data: Any) -> None:
-            print(f"[PhyHubConnection] Connection error: {data}")
+            print(f"[PhyHubConnection] Connection error: {data!r}")
             if self._connect_event:
                 self._connect_event.set()
 
@@ -224,15 +251,36 @@ class PhyHubConnection:
             auth = {"instanceId": self.config.instance_id}
             timeout = 3 if mode == ConnectionMode.SIMULATOR else 5
 
+        print(
+            f"[PhyHubConnection] Auth payload: {auth!r}; "
+            f"Connect wait_timeout={timeout}s"
+        )
+
         try:
+            print("[PhyHubConnection] Calling self._sio.connect()...")
             await self._sio.connect(
                 self.config.url,
                 auth=auth,
                 wait_timeout=timeout,
             )
+            print("[PhyHubConnection] self._sio.connect() returned successfully")
+            try:
+                print(
+                    f"[PhyHubConnection] Post-connect state: "
+                    f"connected={self._sio.connected}, "
+                    f"namespaces={list(self._sio.namespaces)}, "
+                    f"transport={self._sio.transport()!r}"
+                )
+            except Exception as _e:
+                print(f"[PhyHubConnection] Could not read post-connect state: {_e}")
 
             # Wait for connection confirmation
+            print(f"[PhyHubConnection] Waiting for connect event (timeout={timeout}s)...")
             await asyncio.wait_for(self._connect_event.wait(), timeout=float(timeout))
+            print(
+                f"[PhyHubConnection] Connect event received. "
+                f"self._connected={self._connected}"
+            )
 
             if not self._connected:
                 raise ConnectionError("Failed to connect to PhyHub")
@@ -240,9 +288,19 @@ class PhyHubConnection:
             return self._sio
 
         except asyncio.TimeoutError:
+            print(
+                "[PhyHubConnection] asyncio.TimeoutError waiting for connect event "
+                f"(timeout={timeout}s, mode={mode.value}, url={self.config.url})"
+            )
             raise ConnectionError(
                 f"Connection timeout ({mode.value} mode, url={self.config.url})"
             )
+        except Exception as _e:
+            print(
+                f"[PhyHubConnection] Exception during connect: "
+                f"{type(_e).__name__}: {_e!r}"
+            )
+            raise
 
     async def disconnect(self) -> None:
         """Disconnect from PhyHub."""