runloop_api_client 1.29.0__tar.gz → 1.30.0__tar.gz

runloop_api_client-1.30.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.30.0"
+}

{runloop_api_client-1.29.0 → runloop_api_client-1.30.0}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.30.0 (2026-08-20)
+
+Full Changelog: [v1.29.0...v1.30.0](https://github.com/runloopai/api-client-python/compare/v1.29.0...v1.30.0)
+
+### Features
+
+* **devboxes:** use optimistic create endpoint ([#829](https://github.com/runloopai/api-client-python/issues/829)) ([3f47b22](https://github.com/runloopai/api-client-python/commit/3f47b2256189b1aca4c4137134df2643dd3d7ca5))
+
+
+### Chores
+
+* **internal:** allow the mock server port to be set with STAINLESS_MOCK_PORT ([b7a3d87](https://github.com/runloopai/api-client-python/commit/b7a3d87997538ff6d4658df77d68177f83811eb3))
+
 ## 1.29.0 (2026-08-20)
 
 Full Changelog: [v1.28.0...v1.29.0](https://github.com/runloopai/api-client-python/compare/v1.28.0...v1.29.0)

{runloop_api_client-1.29.0 → runloop_api_client-1.30.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.29.0
+Version: 1.30.0
 Summary: The official Python library for the runloop API
 Project-URL: Homepage, https://github.com/runloopai/api-client-python
 Project-URL: Repository, https://github.com/runloopai/api-client-python

{runloop_api_client-1.29.0 → runloop_api_client-1.30.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "1.29.0"
+version = "1.30.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"

{runloop_api_client-1.29.0 → runloop_api_client-1.30.0}/src/runloop_api_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runloop_api_client"
-__version__ = "1.29.0"  # x-release-please-version
+__version__ = "1.30.0"  # x-release-please-version

{runloop_api_client-1.29.0 → runloop_api_client-1.30.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -500,30 +500,41 @@ class DevboxesResource(SyncAPIResource):
             PollingTimeout: If polling times out before devbox is running
             RunloopError: If devbox enters a non-running terminal state
         """
-        # Pass all create_args to the underlying create method
-        devbox = self.create(
-            blueprint_id=blueprint_id,
-            blueprint_name=blueprint_name,
-            code_mounts=code_mounts,
-            entrypoint=entrypoint,
-            environment_variables=environment_variables,
-            file_mounts=file_mounts,
-            gateways=gateways,
-            launch_parameters=launch_parameters,
-            mcp=mcp,
-            metadata=metadata,
-            mounts=mounts,
-            name=name,
-            secrets=secrets,
-            snapshot_id=snapshot_id,
-            tunnel=tunnel,
-            extra_headers=extra_headers,
-            extra_query=extra_query,
-            extra_body=extra_body,
-            timeout=timeout,
-            idempotency_key=idempotency_key,
+        devbox = self._post(
+            "/v1/devboxes/create_and_await_running",
+            body=maybe_transform(
+                {
+                    "blueprint_id": blueprint_id,
+                    "blueprint_name": blueprint_name,
+                    "code_mounts": code_mounts,
+                    "entrypoint": entrypoint,
+                    "environment_variables": environment_variables,
+                    "file_mounts": file_mounts,
+                    "gateways": gateways,
+                    "launch_parameters": launch_parameters,
+                    "mcp": mcp,
+                    "metadata": metadata,
+                    "mounts": mounts,
+                    "name": name,
+                    "secrets": secrets,
+                    "snapshot_id": snapshot_id,
+                    "tunnel": tunnel,
+                },
+                devbox_create_params.DevboxCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=DevboxView,
         )
 
+        if devbox.status == "running":
+            return devbox
+
         return self.await_running(
             devbox.id,
             polling_config=polling_config,
@@ -2071,30 +2082,41 @@ class AsyncDevboxesResource(AsyncAPIResource):
             RunloopError: If devbox enters a non-running terminal state
         """
 
-        # Pass all create_args, relevant request args to the underlying create method
-        devbox = await self.create(
-            blueprint_id=blueprint_id,
-            blueprint_name=blueprint_name,
-            code_mounts=code_mounts,
-            entrypoint=entrypoint,
-            environment_variables=environment_variables,
-            file_mounts=file_mounts,
-            gateways=gateways,
-            launch_parameters=launch_parameters,
-            mcp=mcp,
-            metadata=metadata,
-            mounts=mounts,
-            name=name,
-            secrets=secrets,
-            snapshot_id=snapshot_id,
-            tunnel=tunnel,
-            extra_headers=extra_headers,
-            extra_query=extra_query,
-            extra_body=extra_body,
-            timeout=timeout,
-            idempotency_key=idempotency_key,
+        devbox = await self._post(
+            "/v1/devboxes/create_and_await_running",
+            body=await async_maybe_transform(
+                {
+                    "blueprint_id": blueprint_id,
+                    "blueprint_name": blueprint_name,
+                    "code_mounts": code_mounts,
+                    "entrypoint": entrypoint,
+                    "environment_variables": environment_variables,
+                    "file_mounts": file_mounts,
+                    "gateways": gateways,
+                    "launch_parameters": launch_parameters,
+                    "mcp": mcp,
+                    "metadata": metadata,
+                    "mounts": mounts,
+                    "name": name,
+                    "secrets": secrets,
+                    "snapshot_id": snapshot_id,
+                    "tunnel": tunnel,
+                },
+                devbox_create_params.DevboxCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=DevboxView,
         )
 
+        if devbox.status == "running":
+            return devbox
+
         return await self.await_running(
             devbox.id,
             polling_config=polling_config,

{runloop_api_client-1.29.0 → runloop_api_client-1.30.0}/tests/api_resources/test_devboxes.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import os
 from typing import Any, cast
-from unittest.mock import Mock, patch
+from unittest.mock import Mock, AsyncMock, patch
 
 import httpx
 import pytest
@@ -1452,9 +1452,9 @@ class TestDevboxes:
             state_transitions=[],
         )
 
-        with patch.object(client.devboxes, "create") as mock_create:
+        with patch.object(client.devboxes, "_post") as mock_post:
             with patch.object(client.devboxes, "await_running") as mock_await:
-                mock_create.return_value = mock_devbox_creating
+                mock_post.return_value = mock_devbox_creating
                 mock_await.return_value = mock_devbox_running
 
                 result = client.devboxes.create_and_await_running(
@@ -1463,9 +1463,34 @@ class TestDevboxes:
 
                 assert result.id == "test_id"
                 assert result.status == "running"
-                mock_create.assert_called_once()
+                assert mock_post.call_args.args[0] == "/v1/devboxes/create_and_await_running"
+                assert mock_post.call_args.kwargs["body"]["name"] == "test"
                 mock_await.assert_called_once_with("test_id", polling_config=None)
 
+    @parametrize
+    def test_method_create_and_await_running_optimistic_success(self, client: Runloop) -> None:
+        """Test create_and_await_running returns a running response without polling."""
+
+        mock_devbox_running = DevboxView(
+            id="test_id",
+            status="running",
+            capabilities=[],
+            create_time_ms=1234567890,
+            launch_parameters=LaunchParameters(resource_size_request="X_SMALL"),
+            metadata={},
+            state_transitions=[],
+        )
+
+        with patch.object(client.devboxes, "_post") as mock_post:
+            with patch.object(client.devboxes, "await_running") as mock_await:
+                mock_post.return_value = mock_devbox_running
+
+                result = client.devboxes.create_and_await_running(name="test")
+
+                assert result.status == "running"
+                assert mock_post.call_args.args[0] == "/v1/devboxes/create_and_await_running"
+                mock_await.assert_not_called()
+
     @parametrize
     def test_method_create_and_await_running_with_config(self, client: Runloop) -> None:
         """Test create_and_await_running with custom polling configuration"""
@@ -1492,9 +1517,9 @@ class TestDevboxes:
 
         config = PollingConfig(interval_seconds=0.1, max_attempts=10)
 
-        with patch.object(client.devboxes, "create") as mock_create:
+        with patch.object(client.devboxes, "_post") as mock_post:
             with patch.object(client.devboxes, "await_running") as mock_await:
-                mock_create.return_value = mock_devbox_creating
+                mock_post.return_value = mock_devbox_creating
                 mock_await.return_value = mock_devbox_running
 
                 result = client.devboxes.create_and_await_running(
@@ -1514,8 +1539,8 @@ class TestDevboxes:
         mock_response.status_code = 400
         mock_error = APIStatusError("Bad request", response=mock_response, body=None)
 
-        with patch.object(client.devboxes, "create") as mock_create:
-            mock_create.side_effect = mock_error
+        with patch.object(client.devboxes, "_post") as mock_post:
+            mock_post.side_effect = mock_error
 
             with pytest.raises(APIStatusError, match="Bad request"):
                 client.devboxes.create_and_await_running(
@@ -1536,9 +1561,9 @@ class TestDevboxes:
             state_transitions=[],
         )
 
-        with patch.object(client.devboxes, "create") as mock_create:
+        with patch.object(client.devboxes, "_post") as mock_post:
             with patch.object(client.devboxes, "await_running") as mock_await:
-                mock_create.return_value = mock_devbox_creating
+                mock_post.return_value = mock_devbox_creating
                 mock_await.side_effect = RunloopError("Devbox entered non-running terminal state: failed")
 
                 with pytest.raises(RunloopError, match="Devbox entered non-running terminal state: failed"):
@@ -1739,6 +1764,51 @@ class TestAsyncDevboxes:
         "async_client", [False, True, {"http_client": "aiohttp"}], indirect=True, ids=["loose", "strict", "aiohttp"]
     )
 
+    @parametrize
+    async def test_method_create_and_await_running_success(self, async_client: AsyncRunloop) -> None:
+        mock_devbox_creating = DevboxView(
+            id="test_id",
+            status="provisioning",
+            capabilities=[],
+            create_time_ms=1234567890,
+            launch_parameters=LaunchParameters(resource_size_request="X_SMALL"),
+            metadata={},
+            state_transitions=[],
+        )
+        mock_devbox_running = mock_devbox_creating.model_copy(update={"status": "running"})
+
+        with patch.object(async_client.devboxes, "_post", new_callable=AsyncMock) as mock_post:
+            with patch.object(async_client.devboxes, "await_running", new_callable=AsyncMock) as mock_await:
+                mock_post.return_value = mock_devbox_creating
+                mock_await.return_value = mock_devbox_running
+
+                result = await async_client.devboxes.create_and_await_running(name="test")
+
+                assert result.status == "running"
+                assert mock_post.call_args.args[0] == "/v1/devboxes/create_and_await_running"
+                mock_await.assert_awaited_once_with("test_id", polling_config=None)
+
+    @parametrize
+    async def test_method_create_and_await_running_optimistic_success(self, async_client: AsyncRunloop) -> None:
+        mock_devbox_running = DevboxView(
+            id="test_id",
+            status="running",
+            capabilities=[],
+            create_time_ms=1234567890,
+            launch_parameters=LaunchParameters(resource_size_request="X_SMALL"),
+            metadata={},
+            state_transitions=[],
+        )
+
+        with patch.object(async_client.devboxes, "_post", new_callable=AsyncMock) as mock_post:
+            with patch.object(async_client.devboxes, "await_running", new_callable=AsyncMock) as mock_await:
+                mock_post.return_value = mock_devbox_running
+
+                result = await async_client.devboxes.create_and_await_running(name="test")
+
+                assert result.status == "running"
+                mock_await.assert_not_awaited()
+
     @parametrize
     async def test_method_create(self, async_client: AsyncRunloop) -> None:
         devbox = await async_client.devboxes.create()

runloop_api_client-1.29.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.29.0"
-}