cleaned up underscore prefixes: renamed sync and async modules, and added protocol interface for devbox cmd/file/net

Author: sid-rl

src/runloop_api_client/sdk/__init__.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
-from ._sync import RunloopSDK, DevboxClient, SnapshotClient, BlueprintClient, StorageObjectClient
-from ._async import (
+from .sync import RunloopSDK, DevboxClient, SnapshotClient, BlueprintClient, StorageObjectClient
+from .async_ import (
     AsyncRunloopSDK,
     AsyncDevboxClient,
     AsyncSnapshotClient,
@@ -22,26 +22,29 @@
 from .async_execution_result import AsyncExecutionResult
 
 __all__ = [
+    # Main SDK entry points
     "RunloopSDK",
     "AsyncRunloopSDK",
-    "Devbox",
+    # Management interfaces
     "DevboxClient",
-    "Execution",
-    "ExecutionResult",
-    "Blueprint",
+    "AsyncDevboxClient",
     "BlueprintClient",
-    "Snapshot",
+    "AsyncBlueprintClient",
     "SnapshotClient",
-    "StorageObject",
+    "AsyncSnapshotClient",
     "StorageObjectClient",
+    "AsyncStorageObjectClient",
+    # Resource classes
+    "Devbox",
     "AsyncDevbox",
-    "AsyncDevboxClient",
+    "Execution",
     "AsyncExecution",
+    "ExecutionResult",
     "AsyncExecutionResult",
+    "Blueprint",
     "AsyncBlueprint",
-    "AsyncBlueprintClient",
+    "Snapshot",
     "AsyncSnapshot",
-    "AsyncSnapshotClient",
+    "StorageObject",
     "AsyncStorageObject",
-    "AsyncStorageObjectClient",
 ]

src/runloop_api_client/sdk/_async.py src/runloop_api_client/sdk/async_.pysrc/runloop_api_client/sdk/_async.py renamed to src/runloop_api_client/sdk/async_.py

@@ -104,7 +104,7 @@ async def create_devbox(
         timeout: float | Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> "AsyncDevbox":
-        from ._async import AsyncDevboxClient
+        from .async_ import AsyncDevboxClient
 
         devbox_client = AsyncDevboxClient(self._client)
         return await devbox_client.create_from_blueprint_id(

src/runloop_api_client/sdk/async_blueprint.py

@@ -14,6 +14,7 @@
 from .._types import Body, Omit, Query, Headers, Timeout, NotGiven, FileTypes, omit, not_given
 from .._client import AsyncRunloop
 from ._helpers import LogCallback
+from .protocols import AsyncFileInterface, AsyncCommandInterface, AsyncNetworkInterface
 from .._streaming import AsyncStream
 from ..lib.polling import PollingConfig
 from .async_execution import AsyncExecution, _AsyncStreamingGroup
@@ -221,15 +222,15 @@ async def close(self) -> None:
         await self.shutdown()
 
     @property
-    def cmd(self) -> "_AsyncCommandInterface":
+    def cmd(self) -> AsyncCommandInterface:
         return _AsyncCommandInterface(self)
 
     @property
-    def file(self) -> "_AsyncFileInterface":
+    def file(self) -> AsyncFileInterface:
         return _AsyncFileInterface(self)
 
     @property
-    def net(self) -> "_AsyncNetworkInterface":
+    def net(self) -> AsyncNetworkInterface:
         return _AsyncNetworkInterface(self)
 
     # ------------------------------------------------------------------ #

src/runloop_api_client/sdk/async_devbox.py

@@ -132,7 +132,7 @@ async def create_devbox(
         timeout: float | Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> "AsyncDevbox":
-        from ._async import AsyncDevboxClient
+        from .async_ import AsyncDevboxClient
 
         devbox_client = AsyncDevboxClient(self._client)
         return await devbox_client.create_from_snapshot(

src/runloop_api_client/sdk/async_snapshot.py

@@ -104,7 +104,7 @@ def create_devbox(
         timeout: float | Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> "Devbox":
-        from ._sync import DevboxClient
+        from .sync import DevboxClient
 
         devbox_client = DevboxClient(self._client)
         return devbox_client.create_from_blueprint_id(

src/runloop_api_client/sdk/blueprint.py

@@ -15,6 +15,7 @@
 from .._client import Runloop
 from ._helpers import LogCallback
 from .execution import Execution, _StreamingGroup
+from .protocols import FileInterface, CommandInterface, NetworkInterface
 from .._streaming import Stream
 from ..lib.polling import PollingConfig
 from .execution_result import ExecutionResult
@@ -313,15 +314,15 @@ def close(self) -> None:
         self.shutdown()
 
     @property
-    def cmd(self) -> "_CommandInterface":
+    def cmd(self) -> CommandInterface:
         return _CommandInterface(self)
 
     @property
-    def file(self) -> "_FileInterface":
+    def file(self) -> FileInterface:
         return _FileInterface(self)
 
     @property
-    def net(self) -> "_NetworkInterface":
+    def net(self) -> NetworkInterface:
         return _NetworkInterface(self)
 
     # --------------------------------------------------------------------- #