runloop_api_client 0.68.0__tar.gz → 0.69.0__tar.gz

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/.gitignore

@@ -23,4 +23,7 @@ htmlcov/
 coverage.json
 coverage-summary.json
 *.cover
-.pytest_cache/
+.pytest_cache/
+
+# Docs
+site/

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

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

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.69.0 (2025-11-21)
+
+Full Changelog: [v0.68.0...v0.69.0](https://github.com/runloopai/api-client-python/compare/v0.68.0...v0.69.0)
+
+### Features
+
+* **blueprints:** blueprints create_and_await_build_complete now take in build_context and named_build_context arguments ([#681](https://github.com/runloopai/api-client-python/issues/681)) ([1febe28](https://github.com/runloopai/api-client-python/commit/1febe28e2cadb23eae0cc411922646ce7b8875d3))
+* **devbox:** unify api for devbox mounts ([01c7d14](https://github.com/runloopai/api-client-python/commit/01c7d14091961822d7fe706d6fa7528b6607f87a))
+* **docs:** add documentation for the object oriented sdk, rendered with sphinx ([#677](https://github.com/runloopai/api-client-python/issues/677)) ([e8d1053](https://github.com/runloopai/api-client-python/commit/e8d1053edd15c07f8e8099e9736f97e5fd72fcfb))
+* **storage-objects:** Add upload_from_dir helper method ([#680](https://github.com/runloopai/api-client-python/issues/680)) ([be5d99e](https://github.com/runloopai/api-client-python/commit/be5d99ef9983a64658c38ae5e0364122d11b86c4))
+
+
+### Documentation
+
+* restructured sync vs async sdk and resources, added support for more type references ([#679](https://github.com/runloopai/api-client-python/issues/679)) ([6af891e](https://github.com/runloopai/api-client-python/commit/6af891e0b87d038b5b61a683fdf410df94f495b6))
+
 ## 0.68.0 (2025-11-19)
 
 Full Changelog: [v0.67.0...v0.68.0](https://github.com/runloopai/api-client-python/compare/v0.67.0...v0.68.0)

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 0.68.0
+Version: 0.69.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-0.68.0 → runloop_api_client-0.69.0}/README-SDK.md

@@ -356,6 +356,8 @@ devbox.await_suspended()
 devbox.shutdown()
 ```
 
+> **State-waiting behavior:** In the synchronous SDK, `runloop.devbox.from_id()` and `devbox.resume()` block until the devbox reaches the `running` state, and `devbox.suspend()` blocks until the devbox is `suspended`. The async counterparts return immediately; call `await_running()` / `await_suspended()` explicitly if you need to wait for the state transition.
+
 #### Context Manager Support
 
 Devboxes support context managers for automatic cleanup:

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "0.68.0"
+version = "0.69.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"
@@ -64,6 +64,12 @@ dev = [
     "uuid-utils>=0.11.0",
     "pytest-cov>=7.0.0",
 ]
+docs = [
+    "furo>=2025.9.25",
+    "sphinx>=7.4.7",
+    "sphinx-autodoc-typehints>=2.3.0",
+    "sphinx-toolbox>=4.0.0",
+]
 pydantic-v1 = [
     "pydantic>=1.9.0, <2",
 ]

{runloop_api_client-0.68.0 → runloop_api_client-0.69.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__ = "0.68.0"  # x-release-please-version
+__version__ = "0.69.0"  # x-release-please-version

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/src/runloop_api_client/resources/blueprints.py

@@ -1,5 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-# isort: skip_file
 
 from __future__ import annotations
 
@@ -15,8 +14,7 @@ from ..types import (
     blueprint_create_from_inspection_params,
 )
 from .._types import NOT_GIVEN, Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
-from .._utils import maybe_transform, async_maybe_transform
-from .._utils._validation import ValidationNotification
+from .._utils import is_given, maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
@@ -31,6 +29,7 @@ from .._exceptions import RunloopError
 from ..lib.polling import PollingConfig, poll_until
 from .._base_client import AsyncPaginator, make_request_options
 from ..lib.polling_async import async_poll_until
+from .._utils._validation import ValidationNotification
 from ..types.blueprint_view import BlueprintView
 from ..types.blueprint_preview_view import BlueprintPreviewView
 from ..types.inspection_source_param import InspectionSourceParam
@@ -79,7 +78,7 @@ def _validate_file_mounts(file_mounts: Optional[Dict[str, str]] | Omit) -> Valid
 
     note = ValidationNotification()
 
-    if file_mounts is omit or file_mounts is None:
+    if file_mounts is None or not is_given(file_mounts):
         return note
 
     total_size_bytes = 0
@@ -327,11 +326,13 @@ class BlueprintsResource(SyncAPIResource):
         base_blueprint_id: Optional[str] | Omit = omit,
         base_blueprint_name: Optional[str] | Omit = omit,
         build_args: Optional[Dict[str, str]] | Omit = omit,
+        build_context: Optional[blueprint_create_params.BuildContext] | Omit = omit,
         code_mounts: Optional[Iterable[CodeMountParameters]] | Omit = omit,
         dockerfile: Optional[str] | Omit = omit,
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
+        named_build_contexts: Optional[Dict[str, blueprint_create_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -365,11 +366,13 @@ class BlueprintsResource(SyncAPIResource):
             base_blueprint_id=base_blueprint_id,
             base_blueprint_name=base_blueprint_name,
             build_args=build_args,
+            build_context=build_context,
             code_mounts=code_mounts,
             dockerfile=dockerfile,
             file_mounts=file_mounts,
             launch_parameters=launch_parameters,
             metadata=metadata,
+            named_build_contexts=named_build_contexts,
             secrets=secrets,
             services=services,
             system_setup_commands=system_setup_commands,
@@ -978,11 +981,13 @@ class AsyncBlueprintsResource(AsyncAPIResource):
         base_blueprint_id: Optional[str] | Omit = omit,
         base_blueprint_name: Optional[str] | Omit = omit,
         build_args: Optional[Dict[str, str]] | Omit = omit,
+        build_context: Optional[blueprint_create_params.BuildContext] | Omit = omit,
         code_mounts: Optional[Iterable[CodeMountParameters]] | Omit = omit,
         dockerfile: Optional[str] | Omit = omit,
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
+        named_build_contexts: Optional[Dict[str, blueprint_create_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -1016,11 +1021,13 @@ class AsyncBlueprintsResource(AsyncAPIResource):
             base_blueprint_id=base_blueprint_id,
             base_blueprint_name=base_blueprint_name,
             build_args=build_args,
+            build_context=build_context,
             code_mounts=code_mounts,
             dockerfile=dockerfile,
             file_mounts=file_mounts,
             launch_parameters=launch_parameters,
             metadata=metadata,
+            named_build_contexts=named_build_contexts,
             secrets=secrets,
             services=services,
             system_setup_commands=system_setup_commands,

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -231,7 +231,7 @@ class DevboxesResource(SyncAPIResource):
 
           metadata: User defined metadata to attach to the devbox for organization.
 
-          mounts: A list of file system mounts to be included in the Devbox.
+          mounts: A list of mounts to be included in the Devbox.
 
           name: (Optional) A user specified name to give the Devbox.
 
@@ -1769,7 +1769,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
 
           metadata: User defined metadata to attach to the devbox for organization.
 
-          mounts: A list of file system mounts to be included in the Devbox.
+          mounts: A list of mounts to be included in the Devbox.
 
           name: (Optional) A user specified name to give the Devbox.
 

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/src/runloop_api_client/sdk/_helpers.py

@@ -39,11 +39,11 @@ T = TypeVar("T")
 def filter_params(params: Mapping[str, Any], type_filter: Type[T]) -> T:
     """Filter params dict to only include keys defined in the given TypedDict type.
 
-    Args:
-        params: Dictionary or TypedDict of parameters to filter
-        type_filter: TypedDict class to filter against
-
-    Returns:
-        Filtered dictionary matching the TypedDict structure
+    :param params: Dictionary or TypedDict of parameters to filter
+    :type params: Mapping[str, Any]
+    :param type_filter: TypedDict class to filter against
+    :type type_filter: Type[T]
+    :return: Filtered dictionary matching the TypedDict structure
+    :rtype: T
     """
     return {k: v for k, v in params.items() if k in type_filter.__annotations__}  # type: ignore[return-value]

{runloop_api_client-0.68.0 → runloop_api_client-0.69.0}/src/runloop_api_client/sdk/_types.py

@@ -68,7 +68,7 @@ class SDKDevboxCreateParams(DevboxCreateParams, LongPollingRequestOptions):
     pass
 
 
-class SDKDevboxExtraCreateParams(DevboxBaseCreateParams, LongPollingRequestOptions):
+class SDKDevboxCreateFromImageParams(DevboxBaseCreateParams, LongPollingRequestOptions):
     pass