groundx 2.0.15__py3-none-any.whl → 2.7.7__py3-none-any.whl

groundx/buckets/client.py

@@ -1,19 +1,14 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
-from ..core.client_wrapper import SyncClientWrapper
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
 from ..types.bucket_list_response import BucketListResponse
-from ..core.pydantic_utilities import parse_obj_as
-from json.decoder import JSONDecodeError
-from ..core.api_error import ApiError
 from ..types.bucket_response import BucketResponse
-from ..errors.bad_request_error import BadRequestError
-from ..core.jsonable_encoder import jsonable_encoder
-from ..errors.unauthorized_error import UnauthorizedError
 from ..types.bucket_update_response import BucketUpdateResponse
 from ..types.message_response import MessageResponse
-from ..core.client_wrapper import AsyncClientWrapper
+from .raw_client import AsyncRawBucketsClient, RawBucketsClient
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -21,7 +16,18 @@ OMIT = typing.cast(typing.Any, ...)
 
 class BucketsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = RawBucketsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawBucketsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawBucketsClient
+        """
+        return self._raw_client
 
     def list(
         self,
@@ -33,8 +39,6 @@ class BucketsClient:
         """
         List all buckets within your GroundX account
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         n : typing.Optional[int]
@@ -58,37 +62,18 @@ class BucketsClient:
         client = GroundX(
             api_key="YOUR_API_KEY",
         )
-        client.buckets.list()
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/bucket",
-            method="GET",
-            params={
-                "n": n,
-                "nextToken": next_token,
-            },
-            request_options=request_options,
+        client.buckets.list(
+            n=1,
+            next_token="nextToken",
         )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketListResponse,
-                    parse_obj_as(
-                        type_=BucketListResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        """
+        _response = self._raw_client.list(n=n, next_token=next_token, request_options=request_options)
+        return _response.data
 
     def create(self, *, name: str, request_options: typing.Optional[RequestOptions] = None) -> BucketResponse:
         """
         Create a new bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         name : str
@@ -112,48 +97,13 @@ class BucketsClient:
             name="your_bucket_name",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/bucket",
-            method="POST",
-            json={
-                "name": name,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketResponse,
-                    parse_obj_as(
-                        type_=BucketResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.create(name=name, request_options=request_options)
+        return _response.data
 
     def get(self, bucket_id: int, *, request_options: typing.Optional[RequestOptions] = None) -> BucketResponse:
         """
         Look up a specific bucket by its bucketId.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         bucket_id : int
@@ -178,44 +128,8 @@ class BucketsClient:
             bucket_id=1,
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/bucket/{jsonable_encoder(bucket_id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketResponse,
-                    parse_obj_as(
-                        type_=BucketResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.get(bucket_id, request_options=request_options)
+        return _response.data
 
     def update(
         self, bucket_id: int, *, new_name: str, request_options: typing.Optional[RequestOptions] = None
@@ -223,8 +137,6 @@ class BucketsClient:
         """
         Rename a bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         bucket_id : int
@@ -253,58 +165,13 @@ class BucketsClient:
             new_name="your_bucket_name",
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/bucket/{jsonable_encoder(bucket_id)}",
-            method="PUT",
-            json={
-                "newName": new_name,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketUpdateResponse,
-                    parse_obj_as(
-                        type_=BucketUpdateResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.update(bucket_id, new_name=new_name, request_options=request_options)
+        return _response.data
 
     def delete(self, bucket_id: int, *, request_options: typing.Optional[RequestOptions] = None) -> MessageResponse:
         """
         Delete a bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         bucket_id : int
@@ -329,49 +196,24 @@ class BucketsClient:
             bucket_id=1,
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/bucket/{jsonable_encoder(bucket_id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    MessageResponse,
-                    parse_obj_as(
-                        type_=MessageResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = self._raw_client.delete(bucket_id, request_options=request_options)
+        return _response.data
 
 
 class AsyncBucketsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = AsyncRawBucketsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawBucketsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawBucketsClient
+        """
+        return self._raw_client
 
     async def list(
         self,
@@ -383,8 +225,6 @@ class AsyncBucketsClient:
         """
         List all buckets within your GroundX account
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         n : typing.Optional[int]
@@ -413,40 +253,21 @@ class AsyncBucketsClient:
 
 
         async def main() -> None:
-            await client.buckets.list()
+            await client.buckets.list(
+                n=1,
+                next_token="nextToken",
+            )
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/bucket",
-            method="GET",
-            params={
-                "n": n,
-                "nextToken": next_token,
-            },
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketListResponse,
-                    parse_obj_as(
-                        type_=BucketListResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.list(n=n, next_token=next_token, request_options=request_options)
+        return _response.data
 
     async def create(self, *, name: str, request_options: typing.Optional[RequestOptions] = None) -> BucketResponse:
         """
         Create a new bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         name : str
@@ -478,48 +299,13 @@ class AsyncBucketsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/bucket",
-            method="POST",
-            json={
-                "name": name,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketResponse,
-                    parse_obj_as(
-                        type_=BucketResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.create(name=name, request_options=request_options)
+        return _response.data
 
     async def get(self, bucket_id: int, *, request_options: typing.Optional[RequestOptions] = None) -> BucketResponse:
         """
         Look up a specific bucket by its bucketId.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         bucket_id : int
@@ -552,44 +338,8 @@ class AsyncBucketsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/bucket/{jsonable_encoder(bucket_id)}",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketResponse,
-                    parse_obj_as(
-                        type_=BucketResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.get(bucket_id, request_options=request_options)
+        return _response.data
 
     async def update(
         self, bucket_id: int, *, new_name: str, request_options: typing.Optional[RequestOptions] = None
@@ -597,8 +347,6 @@ class AsyncBucketsClient:
         """
         Rename a bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         bucket_id : int
@@ -635,51 +383,8 @@ class AsyncBucketsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/bucket/{jsonable_encoder(bucket_id)}",
-            method="PUT",
-            json={
-                "newName": new_name,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    BucketUpdateResponse,
-                    parse_obj_as(
-                        type_=BucketUpdateResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.update(bucket_id, new_name=new_name, request_options=request_options)
+        return _response.data
 
     async def delete(
         self, bucket_id: int, *, request_options: typing.Optional[RequestOptions] = None
@@ -687,8 +392,6 @@ class AsyncBucketsClient:
         """
         Delete a bucket.
 
-        Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.
-
         Parameters
         ----------
         bucket_id : int
@@ -721,41 +424,5 @@ class AsyncBucketsClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/bucket/{jsonable_encoder(bucket_id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    MessageResponse,
-                    parse_obj_as(
-                        type_=MessageResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 400:
-                raise BadRequestError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            if _response.status_code == 401:
-                raise UnauthorizedError(
-                    typing.cast(
-                        typing.Optional[typing.Any],
-                        parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
+        _response = await self._raw_client.delete(bucket_id, request_options=request_options)
+        return _response.data