clean up class docstrings

Author: sid-rl

docs/conf.py

@@ -15,7 +15,6 @@
 project = "Runloop Python SDK"
 copyright = "2025, Runloop"
 author = "Runloop"
-release = "0.68.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -40,13 +39,6 @@
 
 # -- Extension configuration -------------------------------------------------
 
-# Napoleon settings
-napoleon_google_docstring = False
-napoleon_numpy_docstring = False
-napoleon_use_param = True
-napoleon_use_rtype = True
-napoleon_use_ivar = True
-
 # Autodoc settings
 autodoc_default_options = {
     "members": None,
@@ -58,5 +50,4 @@
 # Intersphinx mapping
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
-    "httpx": ("https://www.python-httpx.org", None),
 }

src/runloop_api_client/sdk/async_.py

@@ -422,12 +422,16 @@ class AsyncRunloopSDK:
     blueprints, snapshots, and storage objects. Exposes the generated async REST
     client via the ``api`` attribute for advanced use cases.
 
-    Attributes:
-        api: Direct access to the generated async REST API client.
-        devbox: High-level async interface for devbox management.
-        blueprint: High-level async interface for blueprint management.
-        snapshot: High-level async interface for snapshot management.
-        storage_object: High-level async interface for storage object management.
+    :ivar api: Direct access to the generated async REST API client
+    :vartype api: AsyncRunloop
+    :ivar devbox: High-level async interface for devbox management
+    :vartype devbox: AsyncDevboxOps
+    :ivar blueprint: High-level async interface for blueprint management
+    :vartype blueprint: AsyncBlueprintOps
+    :ivar snapshot: High-level async interface for snapshot management
+    :vartype snapshot: AsyncSnapshotOps
+    :ivar storage_object: High-level async interface for storage object management
+    :vartype storage_object: AsyncStorageObjectOps
 
     Example:
         >>> runloop = AsyncRunloopSDK()  # Uses RUNLOOP_API_KEY env var

src/runloop_api_client/sdk/async_devbox.py

@@ -60,12 +60,6 @@ class AsyncDevbox:
         ...     result = await devbox.cmd.exec(command="echo 'hello'")
         ...     print(await result.stdout())
         # Devbox is automatically shut down on exit
-
-    Attributes:
-        id: The devbox identifier.
-        cmd: Command execution interface (exec, exec_async).
-        file: File operations interface (read, write, upload, download).
-        net: Network operations interface (SSH keys, tunnels).
     """
 
     def __init__(self, client: AsyncRunloop, devbox_id: str) -> None:

src/runloop_api_client/sdk/async_execution.py

@@ -42,10 +42,6 @@ class AsyncExecution:
     Provides coroutines to poll execution state, wait for completion, and
     terminate the running process. Created by ``await devbox.cmd.exec_async()``.
 
-    Attributes:
-        execution_id: The unique execution identifier.
-        devbox_id: The devbox where the command is executing.
-
     Example:
         >>> execution = await devbox.cmd.exec_async(command="python train.py")
         >>> state = await execution.get_state()

src/runloop_api_client/sdk/devbox.py

@@ -52,17 +52,13 @@ class Devbox:
     This class provides a Pythonic, object-oriented API for interacting with devboxes,
     including command execution, file operations, networking, and lifecycle management.
 
-    The Devbox class supports context manager protocol for automatic cleanup:
+    The Devbox class supports context manager protocol for automatic cleanup.
+
+    Example:
         >>> with sdk.devbox.create(name="my-devbox") as devbox:
         ...     result = devbox.cmd.exec("echo 'hello'")
         ...     print(result.stdout())
         # Devbox is automatically shutdown on exit
-
-    Attributes:
-        id: The devbox identifier.
-        cmd: Command execution interface (exec, exec_async).
-        file: File operations interface (read, write, upload, download).
-        net: Network operations interface (SSH keys, tunnels).
     """
 
     def __init__(self, client: Runloop, devbox_id: str) -> None:

src/runloop_api_client/sdk/execution.py

@@ -41,10 +41,6 @@ class Execution:
     Provides methods to poll execution state, wait for completion, and terminate
     the running process. Created by ``devbox.cmd.exec_async()``.
 
-    Attributes:
-        execution_id: The unique execution identifier.
-        devbox_id: The devbox where the command is executing.
-
     Example:
         >>> execution = devbox.cmd.exec_async(command="python train.py")
         >>> state = execution.get_state()

src/runloop_api_client/sdk/sync.py

@@ -422,12 +422,16 @@ class RunloopSDK:
     snapshots, and storage objects. Exposes the generated REST client via the ``api``
     attribute for advanced use cases.
 
-    Attributes:
-        api: Direct access to the generated REST API client.
-        devbox: High-level interface for devbox management.
-        blueprint: High-level interface for blueprint management.
-        snapshot: High-level interface for snapshot management.
-        storage_object: High-level interface for storage object management.
+    :ivar api: Direct access to the generated REST API client
+    :vartype api: Runloop
+    :ivar devbox: High-level interface for devbox management
+    :vartype devbox: DevboxOps
+    :ivar blueprint: High-level interface for blueprint management
+    :vartype blueprint: BlueprintOps
+    :ivar snapshot: High-level interface for snapshot management
+    :vartype snapshot: SnapshotOps
+    :ivar storage_object: High-level interface for storage object management
+    :vartype storage_object: StorageObjectOps
 
     Example:
         >>> runloop = RunloopSDK()  # Uses RUNLOOP_API_KEY env var