runloop-api-client 0.1.0a3__py3-none-any.whl

runloop_minus_api_minus_client/resources/devboxes/devboxes.py

@@ -0,0 +1,560 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List
+
+import httpx
+
+from .logs import (
+    LogsResource,
+    AsyncLogsResource,
+    LogsResourceWithRawResponse,
+    AsyncLogsResourceWithRawResponse,
+    LogsResourceWithStreamingResponse,
+    AsyncLogsResourceWithStreamingResponse,
+)
+from ...types import devbox_list_params, devbox_create_params
+from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._utils import (
+    maybe_transform,
+    async_maybe_transform,
+)
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ..._base_client import (
+    make_request_options,
+)
+from ...types.devbox_view import DevboxView
+from ...types.devbox_list_view import DevboxListView
+from ...types.devbox_execution_detail_view import DevboxExecutionDetailView
+
+__all__ = ["DevboxesResource", "AsyncDevboxesResource"]
+
+
+class DevboxesResource(SyncAPIResource):
+    @cached_property
+    def logs(self) -> LogsResource:
+        return LogsResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> DevboxesResourceWithRawResponse:
+        return DevboxesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> DevboxesResourceWithStreamingResponse:
+        return DevboxesResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        code_handle: str | NotGiven = NOT_GIVEN,
+        entrypoint: str | NotGiven = NOT_GIVEN,
+        environment_variables: Dict[str, str] | NotGiven = NOT_GIVEN,
+        setup_commands: List[str] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxView:
+        """Create a Devbox with the specified configuration.
+
+        The Devbox will be created in
+        the 'pending' state and will transition to 'running' once it is ready.
+
+        Args:
+          code_handle: (Optional) Id of a code handle to mount to devbox.
+
+          entrypoint: (Optional) When specified, the Devbox will run this script as its main
+              executable. The devbox lifecycle will be bound to entrypoint, shutting down when
+              the process is complete.
+
+          environment_variables: (Optional) Environment variables used to configure your Devbox.
+
+          setup_commands: (Optional) List of commands needed to set up your Devbox. Examples might include
+              fetching a tool or building your dependencies. Runloop will look optimize these
+              steps for you.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/v1/devboxes",
+            body=maybe_transform(
+                {
+                    "code_handle": code_handle,
+                    "entrypoint": entrypoint,
+                    "environment_variables": environment_variables,
+                    "setup_commands": setup_commands,
+                },
+                devbox_create_params.DevboxCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxView,
+        )
+
+    def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxView:
+        """Get a devbox by id.
+
+        If the devbox does not exist, a 404 is returned.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            f"/v1/devboxes/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxView,
+        )
+
+    def list(
+        self,
+        *,
+        status: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxListView:
+        """List all devboxes or filter by status.
+
+        If no status is provided, all devboxes
+        are returned.
+
+        Args:
+          status: Filter by status
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get(
+            "/v1/devboxes",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"status": status}, devbox_list_params.DevboxListParams),
+            ),
+            cast_to=DevboxListView,
+        )
+
+    def execute_sync(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxExecutionDetailView:
+        """
+        Synchronously execute a command on a devbox
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            f"/v1/devboxes/{id}/execute_sync",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxExecutionDetailView,
+        )
+
+    def shutdown(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxView:
+        """Shutdown a running devbox by id.
+
+        This will take the devbox out of service.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            f"/v1/devboxes/{id}/shutdown",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxView,
+        )
+
+
+class AsyncDevboxesResource(AsyncAPIResource):
+    @cached_property
+    def logs(self) -> AsyncLogsResource:
+        return AsyncLogsResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AsyncDevboxesResourceWithRawResponse:
+        return AsyncDevboxesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncDevboxesResourceWithStreamingResponse:
+        return AsyncDevboxesResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        code_handle: str | NotGiven = NOT_GIVEN,
+        entrypoint: str | NotGiven = NOT_GIVEN,
+        environment_variables: Dict[str, str] | NotGiven = NOT_GIVEN,
+        setup_commands: List[str] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxView:
+        """Create a Devbox with the specified configuration.
+
+        The Devbox will be created in
+        the 'pending' state and will transition to 'running' once it is ready.
+
+        Args:
+          code_handle: (Optional) Id of a code handle to mount to devbox.
+
+          entrypoint: (Optional) When specified, the Devbox will run this script as its main
+              executable. The devbox lifecycle will be bound to entrypoint, shutting down when
+              the process is complete.
+
+          environment_variables: (Optional) Environment variables used to configure your Devbox.
+
+          setup_commands: (Optional) List of commands needed to set up your Devbox. Examples might include
+              fetching a tool or building your dependencies. Runloop will look optimize these
+              steps for you.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/v1/devboxes",
+            body=await async_maybe_transform(
+                {
+                    "code_handle": code_handle,
+                    "entrypoint": entrypoint,
+                    "environment_variables": environment_variables,
+                    "setup_commands": setup_commands,
+                },
+                devbox_create_params.DevboxCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxView,
+        )
+
+    async def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxView:
+        """Get a devbox by id.
+
+        If the devbox does not exist, a 404 is returned.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            f"/v1/devboxes/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxView,
+        )
+
+    async def list(
+        self,
+        *,
+        status: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxListView:
+        """List all devboxes or filter by status.
+
+        If no status is provided, all devboxes
+        are returned.
+
+        Args:
+          status: Filter by status
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._get(
+            "/v1/devboxes",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform({"status": status}, devbox_list_params.DevboxListParams),
+            ),
+            cast_to=DevboxListView,
+        )
+
+    async def execute_sync(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxExecutionDetailView:
+        """
+        Synchronously execute a command on a devbox
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            f"/v1/devboxes/{id}/execute_sync",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxExecutionDetailView,
+        )
+
+    async def shutdown(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxView:
+        """Shutdown a running devbox by id.
+
+        This will take the devbox out of service.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            f"/v1/devboxes/{id}/shutdown",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxView,
+        )
+
+
+class DevboxesResourceWithRawResponse:
+    def __init__(self, devboxes: DevboxesResource) -> None:
+        self._devboxes = devboxes
+
+        self.create = to_raw_response_wrapper(
+            devboxes.create,
+        )
+        self.retrieve = to_raw_response_wrapper(
+            devboxes.retrieve,
+        )
+        self.list = to_raw_response_wrapper(
+            devboxes.list,
+        )
+        self.execute_sync = to_raw_response_wrapper(
+            devboxes.execute_sync,
+        )
+        self.shutdown = to_raw_response_wrapper(
+            devboxes.shutdown,
+        )
+
+    @cached_property
+    def logs(self) -> LogsResourceWithRawResponse:
+        return LogsResourceWithRawResponse(self._devboxes.logs)
+
+
+class AsyncDevboxesResourceWithRawResponse:
+    def __init__(self, devboxes: AsyncDevboxesResource) -> None:
+        self._devboxes = devboxes
+
+        self.create = async_to_raw_response_wrapper(
+            devboxes.create,
+        )
+        self.retrieve = async_to_raw_response_wrapper(
+            devboxes.retrieve,
+        )
+        self.list = async_to_raw_response_wrapper(
+            devboxes.list,
+        )
+        self.execute_sync = async_to_raw_response_wrapper(
+            devboxes.execute_sync,
+        )
+        self.shutdown = async_to_raw_response_wrapper(
+            devboxes.shutdown,
+        )
+
+    @cached_property
+    def logs(self) -> AsyncLogsResourceWithRawResponse:
+        return AsyncLogsResourceWithRawResponse(self._devboxes.logs)
+
+
+class DevboxesResourceWithStreamingResponse:
+    def __init__(self, devboxes: DevboxesResource) -> None:
+        self._devboxes = devboxes
+
+        self.create = to_streamed_response_wrapper(
+            devboxes.create,
+        )
+        self.retrieve = to_streamed_response_wrapper(
+            devboxes.retrieve,
+        )
+        self.list = to_streamed_response_wrapper(
+            devboxes.list,
+        )
+        self.execute_sync = to_streamed_response_wrapper(
+            devboxes.execute_sync,
+        )
+        self.shutdown = to_streamed_response_wrapper(
+            devboxes.shutdown,
+        )
+
+    @cached_property
+    def logs(self) -> LogsResourceWithStreamingResponse:
+        return LogsResourceWithStreamingResponse(self._devboxes.logs)
+
+
+class AsyncDevboxesResourceWithStreamingResponse:
+    def __init__(self, devboxes: AsyncDevboxesResource) -> None:
+        self._devboxes = devboxes
+
+        self.create = async_to_streamed_response_wrapper(
+            devboxes.create,
+        )
+        self.retrieve = async_to_streamed_response_wrapper(
+            devboxes.retrieve,
+        )
+        self.list = async_to_streamed_response_wrapper(
+            devboxes.list,
+        )
+        self.execute_sync = async_to_streamed_response_wrapper(
+            devboxes.execute_sync,
+        )
+        self.shutdown = async_to_streamed_response_wrapper(
+            devboxes.shutdown,
+        )
+
+    @cached_property
+    def logs(self) -> AsyncLogsResourceWithStreamingResponse:
+        return AsyncLogsResourceWithStreamingResponse(self._devboxes.logs)

runloop_minus_api_minus_client/resources/devboxes/logs.py

@@ -0,0 +1,143 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ..._base_client import (
+    make_request_options,
+)
+from ...types.devboxes.devbox_logs_list_view import DevboxLogsListView
+
+__all__ = ["LogsResource", "AsyncLogsResource"]
+
+
+class LogsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> LogsResourceWithRawResponse:
+        return LogsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> LogsResourceWithStreamingResponse:
+        return LogsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxLogsListView:
+        """
+        Get all logs from a Devbox by id.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            f"/v1/devboxes/{id}/logs",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxLogsListView,
+        )
+
+
+class AsyncLogsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncLogsResourceWithRawResponse:
+        return AsyncLogsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncLogsResourceWithStreamingResponse:
+        return AsyncLogsResourceWithStreamingResponse(self)
+
+    async def list(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DevboxLogsListView:
+        """
+        Get all logs from a Devbox by id.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            f"/v1/devboxes/{id}/logs",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxLogsListView,
+        )
+
+
+class LogsResourceWithRawResponse:
+    def __init__(self, logs: LogsResource) -> None:
+        self._logs = logs
+
+        self.list = to_raw_response_wrapper(
+            logs.list,
+        )
+
+
+class AsyncLogsResourceWithRawResponse:
+    def __init__(self, logs: AsyncLogsResource) -> None:
+        self._logs = logs
+
+        self.list = async_to_raw_response_wrapper(
+            logs.list,
+        )
+
+
+class LogsResourceWithStreamingResponse:
+    def __init__(self, logs: LogsResource) -> None:
+        self._logs = logs
+
+        self.list = to_streamed_response_wrapper(
+            logs.list,
+        )
+
+
+class AsyncLogsResourceWithStreamingResponse:
+    def __init__(self, logs: AsyncLogsResource) -> None:
+        self._logs = logs
+
+        self.list = async_to_streamed_response_wrapper(
+            logs.list,
+        )