athena-intelligence 0.1.201__tar.gz → 0.1.203__tar.gz

{athena_intelligence-0.1.201 → athena_intelligence-0.1.203}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: athena-intelligence
-Version: 0.1.201
+Version: 0.1.203
 Summary: Athena Intelligence Python Library
 Requires-Python: >=3.9,<4.0
 Classifier: Intended Audience :: Developers

{athena_intelligence-0.1.201 → athena_intelligence-0.1.203}/pyproject.toml

@@ -3,7 +3,7 @@ name = "athena-intelligence"
 
 [tool.poetry]
 name = "athena-intelligence"
-version = "0.1.201"
+version = "0.1.203"
 description = "Athena Intelligence Python Library"
 readme = "README.md"
 authors = []

{athena_intelligence-0.1.201 → athena_intelligence-0.1.203}/src/athena/__init__.py

@@ -32,6 +32,7 @@ from .types import (
     GeneralAgentResponse,
     GeneralAgentResponseMessage,
     GeneralAgentResponseMessageKwargs,
+    GetTableResponse,
     Id,
     ImageUrlContent,
     InputMessage,
@@ -101,6 +102,7 @@ __all__ = [
     "GeneralAgentResponse",
     "GeneralAgentResponseMessage",
     "GeneralAgentResponseMessageKwargs",
+    "GetTableResponse",
     "Id",
     "ImageUrlContent",
     "InputMessage",

{athena_intelligence-0.1.201 → athena_intelligence-0.1.203}/src/athena/core/client_wrapper.py

@@ -22,10 +22,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "athena-intelligence/0.1.201",
+            "User-Agent": "athena-intelligence/0.1.203",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "athena-intelligence",
-            "X-Fern-SDK-Version": "0.1.201",
+            "X-Fern-SDK-Version": "0.1.203",
             **(self.get_custom_headers() or {}),
         }
         headers["X-API-KEY"] = self.api_key

{athena_intelligence-0.1.201 → athena_intelligence-0.1.203}/src/athena/tools/sheets/client.py

@@ -5,6 +5,7 @@ import typing
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.create_new_sheet_tab_response import CreateNewSheetTabResponse
+from ...types.get_table_response import GetTableResponse
 from ...types.sheet_operation_response import SheetOperationResponse
 from .raw_client import AsyncRawSheetsClient, RawSheetsClient
 
@@ -527,6 +528,61 @@ class SheetsClient:
         )
         return _response.data
 
+    def insert_row(
+        self,
+        *,
+        asset_id: str,
+        reference_row_index: int,
+        num_rows: typing.Optional[int] = OMIT,
+        sheet_id: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SheetOperationResponse:
+        """
+        Insert a row in an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        reference_row_index : int
+            1-based reference row index where to insert
+
+        num_rows : typing.Optional[int]
+            Number of rows to insert
+
+        sheet_id : typing.Optional[int]
+            Sheet ID (defaults to 1)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SheetOperationResponse
+            Successful Response
+
+        Examples
+        --------
+        from athena import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.tools.sheets.insert_row(
+            asset_id="asset_id",
+            reference_row_index=1,
+        )
+        """
+        _response = self._raw_client.insert_row(
+            asset_id=asset_id,
+            reference_row_index=reference_row_index,
+            num_rows=num_rows,
+            sheet_id=sheet_id,
+            request_options=request_options,
+        )
+        return _response.data
+
     def duplicate_sheet(
         self,
         *,
@@ -828,6 +884,52 @@ class SheetsClient:
         )
         return _response.data
 
+    def get_table(
+        self,
+        *,
+        asset_id: str,
+        table_id: typing.Optional[str] = OMIT,
+        table_name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> GetTableResponse:
+        """
+        Retrieve table data from an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        table_id : typing.Optional[str]
+            Table ID to retrieve
+
+        table_name : typing.Optional[str]
+            Table name to retrieve
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetTableResponse
+            Successful Response
+
+        Examples
+        --------
+        from athena import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.tools.sheets.get_table(
+            asset_id="asset_id",
+        )
+        """
+        _response = self._raw_client.get_table(
+            asset_id=asset_id, table_id=table_id, table_name=table_name, request_options=request_options
+        )
+        return _response.data
+
     def update_table(
         self,
         *,
@@ -1488,6 +1590,69 @@ class AsyncSheetsClient:
         )
         return _response.data
 
+    async def insert_row(
+        self,
+        *,
+        asset_id: str,
+        reference_row_index: int,
+        num_rows: typing.Optional[int] = OMIT,
+        sheet_id: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SheetOperationResponse:
+        """
+        Insert a row in an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        reference_row_index : int
+            1-based reference row index where to insert
+
+        num_rows : typing.Optional[int]
+            Number of rows to insert
+
+        sheet_id : typing.Optional[int]
+            Sheet ID (defaults to 1)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SheetOperationResponse
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from athena import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.tools.sheets.insert_row(
+                asset_id="asset_id",
+                reference_row_index=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.insert_row(
+            asset_id=asset_id,
+            reference_row_index=reference_row_index,
+            num_rows=num_rows,
+            sheet_id=sheet_id,
+            request_options=request_options,
+        )
+        return _response.data
+
     async def duplicate_sheet(
         self,
         *,
@@ -1829,6 +1994,60 @@ class AsyncSheetsClient:
         )
         return _response.data
 
+    async def get_table(
+        self,
+        *,
+        asset_id: str,
+        table_id: typing.Optional[str] = OMIT,
+        table_name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> GetTableResponse:
+        """
+        Retrieve table data from an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        table_id : typing.Optional[str]
+            Table ID to retrieve
+
+        table_name : typing.Optional[str]
+            Table name to retrieve
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetTableResponse
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from athena import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.tools.sheets.get_table(
+                asset_id="asset_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_table(
+            asset_id=asset_id, table_id=table_id, table_name=table_name, request_options=request_options
+        )
+        return _response.data
+
     async def update_table(
         self,
         *,

{athena_intelligence-0.1.201 → athena_intelligence-0.1.203}/src/athena/tools/sheets/raw_client.py

@@ -10,6 +10,7 @@ from ...core.pydantic_utilities import parse_obj_as
 from ...core.request_options import RequestOptions
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.create_new_sheet_tab_response import CreateNewSheetTabResponse
+from ...types.get_table_response import GetTableResponse
 from ...types.sheet_operation_response import SheetOperationResponse
 
 # this is used as the default value for optional parameters
@@ -670,6 +671,81 @@ class RawSheetsClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def insert_row(
+        self,
+        *,
+        asset_id: str,
+        reference_row_index: int,
+        num_rows: typing.Optional[int] = OMIT,
+        sheet_id: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[SheetOperationResponse]:
+        """
+        Insert a row in an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        reference_row_index : int
+            1-based reference row index where to insert
+
+        num_rows : typing.Optional[int]
+            Number of rows to insert
+
+        sheet_id : typing.Optional[int]
+            Sheet ID (defaults to 1)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[SheetOperationResponse]
+            Successful Response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v0/tools/sheets/row/insert",
+            method="POST",
+            json={
+                "asset_id": asset_id,
+                "num_rows": num_rows,
+                "reference_row_index": reference_row_index,
+                "sheet_id": sheet_id,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    SheetOperationResponse,
+                    parse_obj_as(
+                        type_=SheetOperationResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=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, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     def duplicate_sheet(
         self,
         *,
@@ -1065,6 +1141,76 @@ class RawSheetsClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def get_table(
+        self,
+        *,
+        asset_id: str,
+        table_id: typing.Optional[str] = OMIT,
+        table_name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[GetTableResponse]:
+        """
+        Retrieve table data from an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        table_id : typing.Optional[str]
+            Table ID to retrieve
+
+        table_name : typing.Optional[str]
+            Table name to retrieve
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[GetTableResponse]
+            Successful Response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v0/tools/sheets/table/get",
+            method="POST",
+            json={
+                "asset_id": asset_id,
+                "table_id": table_id,
+                "table_name": table_name,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetTableResponse,
+                    parse_obj_as(
+                        type_=GetTableResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=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, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     def update_table(
         self,
         *,
@@ -1815,6 +1961,81 @@ class AsyncRawSheetsClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    async def insert_row(
+        self,
+        *,
+        asset_id: str,
+        reference_row_index: int,
+        num_rows: typing.Optional[int] = OMIT,
+        sheet_id: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[SheetOperationResponse]:
+        """
+        Insert a row in an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        reference_row_index : int
+            1-based reference row index where to insert
+
+        num_rows : typing.Optional[int]
+            Number of rows to insert
+
+        sheet_id : typing.Optional[int]
+            Sheet ID (defaults to 1)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[SheetOperationResponse]
+            Successful Response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v0/tools/sheets/row/insert",
+            method="POST",
+            json={
+                "asset_id": asset_id,
+                "num_rows": num_rows,
+                "reference_row_index": reference_row_index,
+                "sheet_id": sheet_id,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    SheetOperationResponse,
+                    parse_obj_as(
+                        type_=SheetOperationResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=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, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     async def duplicate_sheet(
         self,
         *,
@@ -2210,6 +2431,76 @@ class AsyncRawSheetsClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    async def get_table(
+        self,
+        *,
+        asset_id: str,
+        table_id: typing.Optional[str] = OMIT,
+        table_name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[GetTableResponse]:
+        """
+        Retrieve table data from an Athena spreadsheet.
+
+        Parameters
+        ----------
+        asset_id : str
+            The ID of the spreadsheet asset
+
+        table_id : typing.Optional[str]
+            Table ID to retrieve
+
+        table_name : typing.Optional[str]
+            Table name to retrieve
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[GetTableResponse]
+            Successful Response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v0/tools/sheets/table/get",
+            method="POST",
+            json={
+                "asset_id": asset_id,
+                "table_id": table_id,
+                "table_name": table_name,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetTableResponse,
+                    parse_obj_as(
+                        type_=GetTableResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=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, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     async def update_table(
         self,
         *,

{athena_intelligence-0.1.201 → athena_intelligence-0.1.203}/src/athena/types/__init__.py

@@ -29,6 +29,7 @@ from .general_agent_request import GeneralAgentRequest
 from .general_agent_response import GeneralAgentResponse
 from .general_agent_response_message import GeneralAgentResponseMessage
 from .general_agent_response_message_kwargs import GeneralAgentResponseMessageKwargs
+from .get_table_response import GetTableResponse
 from .id import Id
 from .image_url_content import ImageUrlContent
 from .input_message import InputMessage
@@ -79,6 +80,7 @@ __all__ = [
     "GeneralAgentResponse",
     "GeneralAgentResponseMessage",
     "GeneralAgentResponseMessageKwargs",
+    "GetTableResponse",
     "Id",
     "ImageUrlContent",
     "InputMessage",

athena_intelligence-0.1.203/src/athena/types/get_table_response.py

@@ -0,0 +1,37 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class GetTableResponse(UniversalBaseModel):
+    asset_id: str = pydantic.Field()
+    """
+    The ID of the spreadsheet asset
+    """
+
+    data: typing.List[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field()
+    """
+    Array of row objects with column names as keys
+    """
+
+    message: str = pydantic.Field()
+    """
+    Success message or error description
+    """
+
+    success: bool = pydantic.Field()
+    """
+    Whether the operation was successful
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow