phystack-hub-client 0.2.4__tar.gz → 0.2.6__tar.gz

{phystack_hub_client-0.2.4 → phystack_hub_client-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: phystack-hub-client
-Version: 0.2.4
+Version: 0.2.6
 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.4 → phystack_hub_client-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "phystack-hub-client"
-version = "0.2.4"
+version = "0.2.6"
 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.4 → phystack_hub_client-0.2.6}/src/phystack/hub_client/__init__.py

@@ -10,6 +10,12 @@ A Python client for PhyHub that provides:
 - Settings API
 
 Usage:
+    from phystack.hub_client import connect_phy_client
+
+    client = await connect_phy_client()
+    instance = await client.get_instance()
+
+Or with context manager:
     from phystack.hub_client import PhyHubClient
 
     async with PhyHubClient.from_env() as client:
@@ -38,7 +44,7 @@ Usage:
         stream = await instance.get_media_stream(peer_twin_id)
 """
 
-from phystack.hub_client.client import PhyHubClient
+from phystack.hub_client.client import PhyHubClient, connect_phy_client
 from phystack.hub_client.types.twin_types import (
     TwinMessageResult,
     TwinMessageResultStatus,
@@ -78,6 +84,7 @@ __version__ = "0.1.0"
 __all__ = [
     # Client
     "PhyHubClient",
+    "connect_phy_client",
     # Instances
     "BaseInstance",
     "EdgeInstance",

{phystack_hub_client-0.2.4 → phystack_hub_client-0.2.6}/src/phystack/hub_client/client.py

@@ -797,3 +797,16 @@ class PhyHubClient:
     async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
         """Async context manager exit."""
         await self.disconnect()
+
+
+async def connect_phy_client() -> PhyHubClient:
+    """Connect to PhyHub in one call (matches Node.js connectPhyClient).
+
+    Reads connection config from environment variables and connects.
+
+    Returns:
+        Connected PhyHubClient instance.
+    """
+    client = PhyHubClient.from_env()
+    await client.connect()
+    return client

{phystack_hub_client-0.2.4 → phystack_hub_client-0.2.6}/src/phystack/hub_client/services/phyhub_connection.py

@@ -225,10 +225,15 @@ class PhyHubConnection:
             timeout = 3 if mode == ConnectionMode.SIMULATOR else 5
 
         try:
+            # Force WebSocket-only transport to match the Node hub client's
+            # behavior. The default polling -> WebSocket upgrade path triggers
+            # a python-engineio bug where a WebSocketError object is passed
+            # into the packet decoder on upgrade failure.
             await self._sio.connect(
                 self.config.url,
                 auth=auth,
                 wait_timeout=timeout,
+                transports=["websocket"],
             )
 
             # Wait for connection confirmation