athena-intelligence 0.1.100__tar.gz → 0.1.101__tar.gz

{athena_intelligence-0.1.100 → athena_intelligence-0.1.101}/PKG-INFO

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

{athena_intelligence-0.1.100 → athena_intelligence-0.1.101}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "athena-intelligence"
-version = "0.1.100"
+version = "0.1.101"
 description = "Athena Intelligence Python Library"
 readme = "README.md"
 authors = []

{athena_intelligence-0.1.100 → athena_intelligence-0.1.101}/src/athena/__init__.py

@@ -18,6 +18,7 @@ from .errors import (
 )
 from . import query, tools
 from .environment import AthenaEnvironment
+from .query import QueryExecuteRequestDatabaseAssetIds
 from .tools import ToolsDataFrameRequestColumnsItem
 from .version import __version__
 
@@ -31,6 +32,7 @@ __all__ = [
     "FileFetchError",
     "InternalServerError",
     "NotFoundError",
+    "QueryExecuteRequestDatabaseAssetIds",
     "SqlUnauthorizedError",
     "ToolsDataFrameRequestColumnsItem",
     "UnauthorizedError",

{athena_intelligence-0.1.100 → athena_intelligence-0.1.101}/src/athena/core/client_wrapper.py

@@ -17,7 +17,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "athena-intelligence",
-            "X-Fern-SDK-Version": "0.1.100",
+            "X-Fern-SDK-Version": "0.1.101",
         }
         headers["X-API-KEY"] = self.api_key
         return headers

athena_intelligence-0.1.101/src/athena/query/__init__.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import QueryExecuteRequestDatabaseAssetIds
+
+__all__ = ["QueryExecuteRequestDatabaseAssetIds"]

{athena_intelligence-0.1.100 → athena_intelligence-0.1.101}/src/athena/query/client.py

@@ -5,6 +5,7 @@ from json.decoder import JSONDecodeError
 
 from ..core.api_error import ApiError
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.jsonable_encoder import jsonable_encoder
 from ..core.pydantic_utilities import pydantic_v1
 from ..core.request_options import RequestOptions
 from ..errors.internal_server_error import InternalServerError
@@ -12,6 +13,7 @@ from ..errors.unauthorized_error import UnauthorizedError
 from ..errors.unprocessable_entity_error import UnprocessableEntityError
 from ..types.data_frame_request_out import DataFrameRequestOut
 from ..types.sql_unauthorized_error import SqlUnauthorizedError
+from .types.query_execute_request_database_asset_ids import QueryExecuteRequestDatabaseAssetIds
 
 
 class QueryClient:
@@ -19,6 +21,64 @@ class QueryClient:
         self._client_wrapper = client_wrapper
 
     def execute(
+        self,
+        *,
+        sql_command: str,
+        database_asset_ids: QueryExecuteRequestDatabaseAssetIds,
+        request_options: typing.Optional[RequestOptions] = None
+    ) -> DataFrameRequestOut:
+        """
+        Get the result of an SQL query over given assets.
+
+        Parameters
+        ----------
+        sql_command : str
+            SQL query string
+
+        database_asset_ids : QueryExecuteRequestDatabaseAssetIds
+            Single ID or list of asset IDs
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DataFrameRequestOut
+            Successful Response
+
+        Examples
+        --------
+        from athena.client import Athena
+
+        client = Athena(
+            api_key="YOUR_API_KEY",
+        )
+        client.query.execute(
+            sql_command="sql_command",
+            database_asset_ids="database_asset_ids",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v0/query/sql/code/execute",
+            method="GET",
+            params={"sql_command": sql_command, "database_asset_ids": jsonable_encoder(database_asset_ids)},
+            request_options=request_options,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic_v1.parse_obj_as(DataFrameRequestOut, _response.json())  # type: ignore
+        if _response.status_code == 401:
+            raise UnauthorizedError(pydantic_v1.parse_obj_as(SqlUnauthorizedError, _response.json()))  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic_v1.parse_obj_as(typing.Any, _response.json()))  # type: ignore
+        if _response.status_code == 500:
+            raise InternalServerError(pydantic_v1.parse_obj_as(typing.Any, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    def execute_snippet(
         self, *, snippet_asset_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> DataFrameRequestOut:
         """
@@ -43,7 +103,7 @@ class QueryClient:
         client = Athena(
             api_key="YOUR_API_KEY",
         )
-        client.query.execute(
+        client.query.execute_snippet(
             snippet_asset_id="snippet_asset_id",
         )
         """
@@ -73,6 +133,64 @@ class AsyncQueryClient:
         self._client_wrapper = client_wrapper
 
     async def execute(
+        self,
+        *,
+        sql_command: str,
+        database_asset_ids: QueryExecuteRequestDatabaseAssetIds,
+        request_options: typing.Optional[RequestOptions] = None
+    ) -> DataFrameRequestOut:
+        """
+        Get the result of an SQL query over given assets.
+
+        Parameters
+        ----------
+        sql_command : str
+            SQL query string
+
+        database_asset_ids : QueryExecuteRequestDatabaseAssetIds
+            Single ID or list of asset IDs
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DataFrameRequestOut
+            Successful Response
+
+        Examples
+        --------
+        from athena.client import AsyncAthena
+
+        client = AsyncAthena(
+            api_key="YOUR_API_KEY",
+        )
+        await client.query.execute(
+            sql_command="sql_command",
+            database_asset_ids="database_asset_ids",
+        )
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v0/query/sql/code/execute",
+            method="GET",
+            params={"sql_command": sql_command, "database_asset_ids": jsonable_encoder(database_asset_ids)},
+            request_options=request_options,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic_v1.parse_obj_as(DataFrameRequestOut, _response.json())  # type: ignore
+        if _response.status_code == 401:
+            raise UnauthorizedError(pydantic_v1.parse_obj_as(SqlUnauthorizedError, _response.json()))  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic_v1.parse_obj_as(typing.Any, _response.json()))  # type: ignore
+        if _response.status_code == 500:
+            raise InternalServerError(pydantic_v1.parse_obj_as(typing.Any, _response.json()))  # type: ignore
+        try:
+            _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)
+
+    async def execute_snippet(
         self, *, snippet_asset_id: str, request_options: typing.Optional[RequestOptions] = None
     ) -> DataFrameRequestOut:
         """
@@ -97,7 +215,7 @@ class AsyncQueryClient:
         client = AsyncAthena(
             api_key="YOUR_API_KEY",
         )
-        await client.query.execute(
+        await client.query.execute_snippet(
             snippet_asset_id="snippet_asset_id",
         )
         """

athena_intelligence-0.1.101/src/athena/query/types/__init__.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .query_execute_request_database_asset_ids import QueryExecuteRequestDatabaseAssetIds
+
+__all__ = ["QueryExecuteRequestDatabaseAssetIds"]

athena_intelligence-0.1.101/src/athena/query/types/query_execute_request_database_asset_ids.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+QueryExecuteRequestDatabaseAssetIds = typing.Union[str, typing.List[str]]

athena_intelligence-0.1.100/src/athena/query/__init__.py

@@ -1,2 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-