deeporigin-data-sdk 0.1.0a67__py3-none-any.whl → 0.1.0a69__py3-none-any.whl

deeporigin_data/__init__.py

@@ -36,7 +36,7 @@ from ._exceptions import (
     UnprocessableEntityError,
     APIResponseValidationError,
 )
-from ._base_client import DefaultHttpxClient, DefaultAsyncHttpxClient
+from ._base_client import DefaultHttpxClient, DefaultAioHttpClient, DefaultAsyncHttpxClient
 from ._utils._logs import setup_logging as _setup_logging
 
 __all__ = [
@@ -78,6 +78,7 @@ __all__ = [
     "DEFAULT_CONNECTION_LIMITS",
     "DefaultHttpxClient",
     "DefaultAsyncHttpxClient",
+    "DefaultAioHttpClient",
 ]
 
 if not _t.TYPE_CHECKING:

deeporigin_data/_base_client.py

@@ -1289,6 +1289,24 @@ class _DefaultAsyncHttpxClient(httpx.AsyncClient):
         super().__init__(**kwargs)
 
 
+try:
+    import httpx_aiohttp
+except ImportError:
+
+    class _DefaultAioHttpClient(httpx.AsyncClient):
+        def __init__(self, **_kwargs: Any) -> None:
+            raise RuntimeError("To use the aiohttp client you must have installed the package with the `aiohttp` extra")
+else:
+
+    class _DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient):  # type: ignore
+        def __init__(self, **kwargs: Any) -> None:
+            kwargs.setdefault("timeout", DEFAULT_TIMEOUT)
+            kwargs.setdefault("limits", DEFAULT_CONNECTION_LIMITS)
+            kwargs.setdefault("follow_redirects", True)
+
+            super().__init__(**kwargs)
+
+
 if TYPE_CHECKING:
     DefaultAsyncHttpxClient = httpx.AsyncClient
     """An alias to `httpx.AsyncClient` that provides the same defaults that this SDK
@@ -1297,8 +1315,12 @@ if TYPE_CHECKING:
     This is useful because overriding the `http_client` with your own instance of
     `httpx.AsyncClient` will result in httpx's defaults being used, not ours.
     """
+
+    DefaultAioHttpClient = httpx.AsyncClient
+    """An alias to `httpx.AsyncClient` that changes the default HTTP transport to `aiohttp`."""
 else:
     DefaultAsyncHttpxClient = _DefaultAsyncHttpxClient
+    DefaultAioHttpClient = _DefaultAioHttpClient
 
 
 class AsyncHttpxClientWrapper(DefaultAsyncHttpxClient):

deeporigin_data/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "deeporigin_data"
-__version__ = "0.1.0-alpha.67"  # x-release-please-version
+__version__ = "0.1.0-alpha.69"  # x-release-please-version

{deeporigin_data_sdk-0.1.0a67.dist-info → deeporigin_data_sdk-0.1.0a69.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deeporigin_data_sdk
-Version: 0.1.0a67
+Version: 0.1.0a69
 Summary: The official Python library for the deeporigin_data API
 Project-URL: Homepage, https://github.com/deeporiginbio/deeporigin-data-sdk
 Project-URL: Repository, https://github.com/deeporiginbio/deeporigin-data-sdk
@@ -27,6 +27,9 @@ Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
 Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
+Provides-Extra: aiohttp
+Requires-Dist: aiohttp; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.6; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
 # Deeporigin Data Python API library
@@ -101,6 +104,41 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install --pre deeporigin_data_sdk[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import os
+import asyncio
+from deeporigin_data import DefaultAioHttpClient
+from deeporigin_data import AsyncDeeporiginData
+
+
+async def main() -> None:
+    async with AsyncDeeporiginData(
+        org_id="My Org ID",
+        token=os.environ.get("ORG_BEARER_TOKEN"),  # This is the default and can be omitted
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        describe_row_response = await client.describe_row(
+            row_id="rowId",
+        )
+        print(describe_row_response.data)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -200,7 +238,7 @@ client.with_options(max_retries=5).describe_row(
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from deeporigin_data import DeeporiginData

{deeporigin_data_sdk-0.1.0a67.dist-info → deeporigin_data_sdk-0.1.0a69.dist-info}/RECORD

@@ -1,5 +1,5 @@
-deeporigin_data/__init__.py,sha256=_1jHk-ZDjq8xlaketuGzIObYaQy2_sQC44AmxyzI_sM,2644
-deeporigin_data/_base_client.py,sha256=tQ1V6dw8jphj0fgcVbPKQWApTT697LuoBrGkAg3k9ME,65893
+deeporigin_data/__init__.py,sha256=GcSYGhjO8h3JlVcNC7CouZJUsoefUYjFRQFRpylXg5c,2694
+deeporigin_data/_base_client.py,sha256=xAVMwRYOW6B9fGncMM-yE2yDlBMVsb9QSHB1Q5ayDRk,66724
 deeporigin_data/_client.py,sha256=ulANUIkBX3gHIvrpeU1IRCakrx5gIcgD56I0FmwiaXo,171969
 deeporigin_data/_compat.py,sha256=VWemUKbj6DDkQ-O4baSpHVLJafotzeXmCQGJugfVTIw,6580
 deeporigin_data/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
@@ -11,7 +11,7 @@ deeporigin_data/_resource.py,sha256=tkm4gF9YRotE93j48jTDBSGs8wyVa0E5NS9fj19e38c,
 deeporigin_data/_response.py,sha256=i98w-_OFUAnDfRaLynqu2Qrgh39xKGq9WQ1DK2CueMs,28870
 deeporigin_data/_streaming.py,sha256=yG857cOSJD3gbc7mEc2wqfvcPVLMGmYX4hBOqqIT5RE,10132
 deeporigin_data/_types.py,sha256=z_gHfGnZNr7ReZxda_iICWQnmy5anm8-i8lRB3jpRL0,6206
-deeporigin_data/_version.py,sha256=lGAaRHDNWk_1Ic-GO2L9MeeVs36xSc2ayW4__tmIr1M,176
+deeporigin_data/_version.py,sha256=tQUm67qkVi72aVCsa7-GVGXt2uVDWaU4-ewfpr14uLE,176
 deeporigin_data/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 deeporigin_data/_utils/__init__.py,sha256=PNZ_QJuzZEgyYXqkO1HVhGkj5IU9bglVUcw7H-Knjzw,2062
 deeporigin_data/_utils/_logs.py,sha256=R7dnUaDs2cdYbq1Ee16dHy863wdcTZRRzubw9KE0qNc,801
@@ -121,7 +121,7 @@ deeporigin_data/types/shared_params/add_column_base.py,sha256=s8cbOjluJmf4Pzmg_v
 deeporigin_data/types/shared_params/add_column_union.py,sha256=uEJwB-xtbKY19Hq7a2vIrGdDfPcHIBwp9_R63Qf9KO0,1036
 deeporigin_data/types/shared_params/condition.py,sha256=38ItZ9QZrA3rnXNgds7KZcXCZ-h1zVttiD1R6uf5IGQ,3153
 deeporigin_data/types/shared_params/row_filter_join.py,sha256=QIo2yhjJJZLcGF-hBF7YcLcYHLhf5uq5EkQG-0WJjtU,595
-deeporigin_data_sdk-0.1.0a67.dist-info/METADATA,sha256=ptdQnd37bHypGX0d6m8hJ46JWMA0U1eZtjU5y_-DFiU,13795
-deeporigin_data_sdk-0.1.0a67.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-deeporigin_data_sdk-0.1.0a67.dist-info/licenses/LICENSE,sha256=jT1To9IZ3XdRqtpv8wDrIwpatTUvf5yP0sFYhEtJVZY,11345
-deeporigin_data_sdk-0.1.0a67.dist-info/RECORD,,
+deeporigin_data_sdk-0.1.0a69.dist-info/METADATA,sha256=U6nzt_eHzmyrKubMQpYnSEhYjNpPIeYg0JGeNwnGhJM,14863
+deeporigin_data_sdk-0.1.0a69.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+deeporigin_data_sdk-0.1.0a69.dist-info/licenses/LICENSE,sha256=jT1To9IZ3XdRqtpv8wDrIwpatTUvf5yP0sFYhEtJVZY,11345
+deeporigin_data_sdk-0.1.0a69.dist-info/RECORD,,