opencode-python-sdk 0.1.0__py3-none-any.whl

opencode/resources/rpc.py

@@ -0,0 +1,111 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``rpc`` resource."""
+
+from __future__ import annotations
+
+from typing import Any, cast
+
+from .._base_client import RequestOptions
+from .._qs import encode_path_segment
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, Query, Timeout
+from ..types import (
+    Location,
+    RpcOutput,
+)
+
+__all__ = ["RpcResource", "AsyncRpcResource"]
+
+
+class RpcResource(SyncAPIResource):
+    """Operations under ``client.rpc`` (OpenCode ``rpc``)."""
+
+    def call(
+        self,
+        rpc_id: str,
+        method: str,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        input: Any | NotGiven = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> RpcOutput:
+        """Call a plugin RPC.
+
+        Dispatch a method to the currently registered RPC at the requested location.
+
+        Raises:
+          RpcError
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          RpcInternalError
+
+        ``POST /api/rpc/:rpcID/:method``
+        """
+        return cast(
+            "RpcOutput",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/rpc/{encode_path_segment(rpc_id)}/{encode_path_segment(method)}",
+                    query={"location": self._location(location)},
+                    body={"input": input},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=RpcOutput,
+            ),
+        )
+
+
+class AsyncRpcResource(AsyncAPIResource):
+    """Operations under ``client.rpc`` (OpenCode ``rpc``)."""
+
+    async def call(
+        self,
+        rpc_id: str,
+        method: str,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        input: Any | NotGiven = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> RpcOutput:
+        """Call a plugin RPC.
+
+        Dispatch a method to the currently registered RPC at the requested location.
+
+        Raises:
+          RpcError
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          RpcInternalError
+
+        ``POST /api/rpc/:rpcID/:method``
+        """
+        return cast(
+            "RpcOutput",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/rpc/{encode_path_segment(rpc_id)}/{encode_path_segment(method)}",
+                    query={"location": self._location(location)},
+                    body={"input": input},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=RpcOutput,
+            ),
+        )

opencode/resources/server.py

@@ -0,0 +1,228 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``server`` resource."""
+
+from __future__ import annotations
+
+from typing import cast
+
+from .._base_client import RequestOptions
+from .._qs import encode_path_segment
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, Query, Timeout
+from ..types import (
+    PairingCode,
+    PairingSession,
+    ServerInfo,
+)
+
+__all__ = ["ServerResource", "AsyncServerResource"]
+
+
+class ServerResource(SyncAPIResource):
+    """Operations under ``client.server`` (OpenCode ``server``)."""
+
+    def info(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> ServerInfo:
+        """Get server info.
+
+        Return the server identity, connection URLs, paths, and readiness status.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/info``
+        """
+        return cast(
+            "ServerInfo",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/info",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=ServerInfo,
+            ),
+        )
+
+    def pair(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> PairingCode:
+        """Create pairing code.
+
+        Create a short-lived, single-use code for a /auth/connect/:code pairing link.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``POST /api/pair``
+        """
+        return cast(
+            "PairingCode",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/pair",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=PairingCode,
+            ),
+        )
+
+    def connect(
+        self,
+        code: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> PairingSession:
+        """Redeem pairing code.
+
+        Redeem a pairing code. Browsers receive a session cookie and a redirect to the web app; requests that accept JSON receive a session token to use as the password.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /auth/connect/:code``
+        """
+        return cast(
+            "PairingSession",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/auth/connect/{encode_path_segment(code)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=PairingSession,
+            ),
+        )
+
+
+class AsyncServerResource(AsyncAPIResource):
+    """Operations under ``client.server`` (OpenCode ``server``)."""
+
+    async def info(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> ServerInfo:
+        """Get server info.
+
+        Return the server identity, connection URLs, paths, and readiness status.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/info``
+        """
+        return cast(
+            "ServerInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/info",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=ServerInfo,
+            ),
+        )
+
+    async def pair(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> PairingCode:
+        """Create pairing code.
+
+        Create a short-lived, single-use code for a /auth/connect/:code pairing link.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``POST /api/pair``
+        """
+        return cast(
+            "PairingCode",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/pair",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=PairingCode,
+            ),
+        )
+
+    async def connect(
+        self,
+        code: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> PairingSession:
+        """Redeem pairing code.
+
+        Redeem a pairing code. Browsers receive a session cookie and a redirect to the web app; requests that accept JSON receive a session token to use as the password.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /auth/connect/:code``
+        """
+        return cast(
+            "PairingSession",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/auth/connect/{encode_path_segment(code)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=PairingSession,
+            ),
+        )