athena-intelligence 0.1.100__py3-none-any.whl → 0.1.101__py3-none-any.whl

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/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/query/__init__.py

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

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/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/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.dist-info → athena_intelligence-0.1.101.dist-info}/METADATA

@@ -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.dist-info → athena_intelligence-0.1.101.dist-info}/RECORD

@@ -1,9 +1,9 @@
-athena/__init__.py,sha256=_1vtiajlFbHjHlAngtGg_C_XyqinPbX9lbn2D-zjgWc,1094
+athena/__init__.py,sha256=lGo6ASUYoueZCu_oWrD7ruCsa0nLRNo9qZ_-2RV4WxY,1192
 athena/base_client.py,sha256=TlP599mOBvj7Tk8IpFe5dgrDM98GJu3lEQh_zwl4vtA,5439
 athena/client.py,sha256=2jxJ8mZWLa9LOH9XCxbxwLV6qVPXw53gi7GiYUTcpZg,9346
 athena/core/__init__.py,sha256=UFXpYzcGxWQUucU1TkjOQ9mGWN3A5JohluOIWVYKU4I,973
 athena/core/api_error.py,sha256=RE8LELok2QCjABadECTvtDp7qejA1VmINCh6TbqPwSE,426
-athena/core/client_wrapper.py,sha256=De-MIVXRtOZtBkHGrEavMifAIjhtpKVddLmCkL5sCzM,1806
+athena/core/client_wrapper.py,sha256=OWm1dmWnrVS5aatw4sJNN9fa54tiO28qSndRzyy8ksw,1806
 athena/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 athena/core/file.py,sha256=sy1RUGZ3aJYuw998bZytxxo6QdgKmlnlgBaMvwEKCGg,1480
 athena/core/http_client.py,sha256=Z4NuAsJD-51yqmoME17O5sxwx5orSp1wsnd6bPyKcgA,17768
@@ -20,8 +20,10 @@ athena/errors/unauthorized_error.py,sha256=6qGByG08vA3iFHmK5ReHUK2AiGeCsK3Vf50C5
 athena/errors/unprocessable_entity_error.py,sha256=OztAzRntOJVxbZtXwoR4epahhG6chKOB5chVLUC8D9Q,257
 athena/errors/unsupported_media_type_error.py,sha256=fQ7TYQ3QYcT_YzFzO4f8_bLger7UQfZmuF22I9jYxFA,340
 athena/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-athena/query/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
-athena/query/client.py,sha256=q2ucGRJX5TY0sEJvYVzKKZcuDjYzhgUS-SoPQ4MIRfQ,4634
+athena/query/__init__.py,sha256=EIeVs3aDVNAqLyWetSrQldzc2yUdJkf_cJXyrLdMDj0,171
+athena/query/client.py,sha256=3i_yiGD7JM204TsTwY7R1CvGRs0odCh6QkYeNggHbc8,9147
+athena/query/types/__init__.py,sha256=WX-Or2h5NY2sv93ojrZsHcmiFHGYdqd0yxNo-5iGHR4,206
+athena/query/types/query_execute_request_database_asset_ids.py,sha256=aoVl5Xb34Q27hYGuVTnByGIxtHkL67wAwzXh7eJctew,154
 athena/tools/__init__.py,sha256=3n7oOoMebo06MAQqYRE2CX9Q0fTNnKBYE0cTlh1MPkM,165
 athena/tools/client.py,sha256=sMV_--PzUReXXILfKJeS8g9GQzYxxPDZI59wlos_rSo,10565
 athena/tools/types/__init__.py,sha256=cA-ZQm6veQAP3_vKu9KkZpISsQqgTBN_Z--FGY1c2iA,197
@@ -35,6 +37,6 @@ athena/types/data_frame_unknown_format_error.py,sha256=lbgAUArEgIYZt3P5Ji4Clp-xy
 athena/types/file_fetch_error.py,sha256=iR7IXjj2C4lJFcWV3aS2gfhmT3CE-_hhBDSWFaCktHU,1162
 athena/types/sql_unauthorized_error.py,sha256=c3LR7lDgg66km9J0BYDCRu0hdDYaPqpnfcE3YXXKkVM,1105
 athena/version.py,sha256=8aYAOJtVLaJLpRp6mTiEIhnl8gXA7yE0aDtZ-3mKQ4k,87
-athena_intelligence-0.1.100.dist-info/METADATA,sha256=JInGWwIplFb6naHD9zUXn3e5KXrpXlsGvdFya138JCg,5274
-athena_intelligence-0.1.100.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-athena_intelligence-0.1.100.dist-info/RECORD,,
+athena_intelligence-0.1.101.dist-info/METADATA,sha256=vYeSC3K17uL8bbSXmpJ1Vz0mn80WW3LiR5zhJouF0Vw,5274
+athena_intelligence-0.1.101.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+athena_intelligence-0.1.101.dist-info/RECORD,,