scoped docstrings for public modules, classes and methods

Author: sid-rl

src/runloop_api_client/sdk/async_.py

@@ -12,15 +12,19 @@
 
 
 class AsyncBlueprint:
-    """
-    Async wrapper around blueprint operations.
-    """
+    """Asynchronous wrapper around a blueprint resource."""
 
     def __init__(
         self,
         client: AsyncRunloop,
         blueprint_id: str,
     ) -> None:
+        """Initialize the wrapper.
+
+        Args:
+            client: Generated AsyncRunloop client.
+            blueprint_id: Blueprint ID returned by the API.
+        """
         self._client = client
         self._id = blueprint_id
 
@@ -30,12 +34,25 @@ def __repr__(self) -> str:
 
     @property
     def id(self) -> str:
+        """Return the blueprint ID.
+
+        Returns:
+            str: Unique blueprint ID.
+        """
         return self._id
 
     async def get_info(
         self,
         **options: Unpack[RequestOptions],
     ) -> BlueprintView:
+        """Retrieve the latest blueprint details.
+
+        Args:
+            **options: Optional request configuration.
+
+        Returns:
+            BlueprintView: API response describing the blueprint.
+        """
         return await self._client.blueprints.retrieve(
             self._id,
             **options,
@@ -45,6 +62,14 @@ async def logs(
         self,
         **options: Unpack[RequestOptions],
     ) -> BlueprintBuildLogsListView:
+        """Retrieve build logs for the blueprint.
+
+        Args:
+            **options: Optional request configuration.
+
+        Returns:
+            BlueprintBuildLogsListView: Log entries for the most recent build.
+        """
         return await self._client.blueprints.logs(
             self._id,
             **options,
@@ -54,6 +79,14 @@ async def delete(
         self,
         **options: Unpack[LongRequestOptions],
     ) -> object:
+        """Delete the blueprint.
+
+        Args:
+            **options: Optional long-running request configuration.
+
+        Returns:
+            object: API response acknowledging deletion.
+        """
         return await self._client.blueprints.delete(
             self._id,
             **options,
@@ -63,6 +96,14 @@ async def create_devbox(
         self,
         **params: Unpack[SDKDevboxExtraCreateParams],
     ) -> "AsyncDevbox":
+        """Create a devbox derived from the blueprint.
+
+        Args:
+            **params: Creation parameters to forward to the devbox API.
+
+        Returns:
+            AsyncDevbox: Wrapper bound to the running devbox.
+        """
         devbox_view = await self._client.devboxes.create_and_await_running(
             blueprint_id=self._id,
             **params,