Unified-python-sdk 0.38.1__tar.gz → 0.40.0__tar.gz

unified_python_sdk-0.38.1/README-PYPI.md → unified_python_sdk-0.40.0/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.3
+Name: Unified-python-sdk
+Version: 0.40.0
+Summary: Python Client SDK for Unified.to
+Author: Unified API Inc.
+Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: eval-type-backport (>=0.2.0)
+Requires-Dist: httpx (>=0.28.1)
+Requires-Dist: pydantic (>=2.10.3)
+Requires-Dist: python-dateutil (>=2.8.2)
+Requires-Dist: typing-inspection (>=0.4.0)
+Project-URL: Repository, https://github.com/unified-to/unified-python-sdk.git
+Description-Content-Type: text/markdown
+
 <div align="left">
     <a href="https://speakeasyapi.dev/"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
     <a href="https://github.com/unified-to/unified-python-sdk/actions"><img src="https://img.shields.io/github/actions/workflow/status/unified-to/unified-python-sdk/speakeasy_sdk_generation.yml?style=for-the-badge" /></a>
@@ -31,6 +51,11 @@ Unified.to API: One API to Rule Them All
 <!-- Start SDK Installation [installation] -->
 ## SDK Installation
 
+> [!NOTE]
+> **Python version upgrade policy**
+>
+> Once a Python version reaches its [official end of life date](https://devguide.python.org/versions/), a 3-month grace period is provided for users to upgrade. Following this grace period, the minimum python version supported in the SDK will be updated.
+
 The SDK can be installed with either *pip* or *poetry* package managers.
 
 ### PIP
@@ -48,6 +73,37 @@ pip install Unified-python-sdk
 ```bash
 poetry add Unified-python-sdk
 ```
+
+### Shell and script usage with `uv`
+
+You can use this SDK in a Python shell with [uv](https://docs.astral.sh/uv/) and the `uvx` command that comes with it like so:
+
+```shell
+uvx --from Unified-python-sdk python
+```
+
+It's also possible to write a standalone Python script without needing to set up a whole project like so:
+
+```python
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.9"
+# dependencies = [
+#     "Unified-python-sdk",
+# ]
+# ///
+
+from unified_python_sdk import UnifiedTo
+
+sdk = UnifiedTo(
+  # SDK arguments
+)
+
+# Rest of script here...
+```
+
+Once that is saved to a file, you can run it with `uv run script.py` where
+`script.py` can be replaced with the actual file name.
 <!-- End SDK Installation [installation] -->
 
 <!-- Start IDE Support [idesupport] -->
@@ -70,6 +126,7 @@ Generally, the SDK will work well with most IDEs out of the box. However, when u
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -97,6 +154,7 @@ from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
 async def main():
+
     async with UnifiedTo(
         security=shared.Security(
             jwt="<YOUR_API_KEY_HERE>",
@@ -1207,6 +1265,7 @@ Certain SDK methods accept file objects as part of a request body or multi-part
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1237,6 +1296,7 @@ from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 from unified_python_sdk.utils import BackoffStrategy, RetryConfig
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1262,6 +1322,7 @@ from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 from unified_python_sdk.utils import BackoffStrategy, RetryConfig
 
+
 with UnifiedTo(
     retry_config=RetryConfig("backoff", BackoffStrategy(1, 50, 1.1, 100), False),
     security=shared.Security(
@@ -1308,6 +1369,7 @@ When custom error responses are specified for an operation, the SDK may also rai
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import errors, shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1341,10 +1403,10 @@ with UnifiedTo(
 
 You can override the default server globally by passing a server index to the `server_idx: int` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the indexes associated with the available servers:
 
-| #   | Server                      |
-| --- | --------------------------- |
-| 0   | `https://api.unified.to`    |
-| 1   | `https://api-eu.unified.to` |
+| #   | Server                      | Description                |
+| --- | --------------------------- | -------------------------- |
+| 0   | `https://api.unified.to`    | North American data region |
+| 1   | `https://api-eu.unified.to` | European data region       |
 
 #### Example
 
@@ -1352,6 +1414,7 @@ You can override the default server globally by passing a server index to the `s
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     server_idx=1,
     security=shared.Security(
@@ -1378,6 +1441,7 @@ The default server can also be overridden globally by passing a URL to the `serv
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     server_url="https://api.unified.to",
     security=shared.Security(
@@ -1499,6 +1563,7 @@ You can set the security parameters through the `security` optional parameter wh
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1574,3 +1639,4 @@ While we value open-source contributions to this SDK, this library is generated
 Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release!
 
 ### SDK Created by [Speakeasy](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)
+

unified_python_sdk-0.38.1/PKG-INFO → unified_python_sdk-0.40.0/README-PYPI.md

@@ -1,24 +1,3 @@
-Metadata-Version: 2.3
-Name: Unified-python-sdk
-Version: 0.38.1
-Summary: Python Client SDK for Unified.to
-Author: Unified API Inc.
-Requires-Python: >=3.9
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: eval-type-backport (>=0.2.0,<0.3.0)
-Requires-Dist: httpx (>=0.28.1,<0.29.0)
-Requires-Dist: jsonpath-python (>=1.0.6,<2.0.0)
-Requires-Dist: pydantic (>=2.10.3,<2.11.0)
-Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
-Requires-Dist: typing-inspect (>=0.9.0,<0.10.0)
-Project-URL: Repository, https://github.com/unified-to/unified-python-sdk.git
-Description-Content-Type: text/markdown
-
 <div align="left">
     <a href="https://speakeasyapi.dev/"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
     <a href="https://github.com/unified-to/unified-python-sdk/actions"><img src="https://img.shields.io/github/actions/workflow/status/unified-to/unified-python-sdk/speakeasy_sdk_generation.yml?style=for-the-badge" /></a>
@@ -52,6 +31,11 @@ Unified.to API: One API to Rule Them All
 <!-- Start SDK Installation [installation] -->
 ## SDK Installation
 
+> [!NOTE]
+> **Python version upgrade policy**
+>
+> Once a Python version reaches its [official end of life date](https://devguide.python.org/versions/), a 3-month grace period is provided for users to upgrade. Following this grace period, the minimum python version supported in the SDK will be updated.
+
 The SDK can be installed with either *pip* or *poetry* package managers.
 
 ### PIP
@@ -69,6 +53,37 @@ pip install Unified-python-sdk
 ```bash
 poetry add Unified-python-sdk
 ```
+
+### Shell and script usage with `uv`
+
+You can use this SDK in a Python shell with [uv](https://docs.astral.sh/uv/) and the `uvx` command that comes with it like so:
+
+```shell
+uvx --from Unified-python-sdk python
+```
+
+It's also possible to write a standalone Python script without needing to set up a whole project like so:
+
+```python
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.9"
+# dependencies = [
+#     "Unified-python-sdk",
+# ]
+# ///
+
+from unified_python_sdk import UnifiedTo
+
+sdk = UnifiedTo(
+  # SDK arguments
+)
+
+# Rest of script here...
+```
+
+Once that is saved to a file, you can run it with `uv run script.py` where
+`script.py` can be replaced with the actual file name.
 <!-- End SDK Installation [installation] -->
 
 <!-- Start IDE Support [idesupport] -->
@@ -91,6 +106,7 @@ Generally, the SDK will work well with most IDEs out of the box. However, when u
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -118,6 +134,7 @@ from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
 async def main():
+
     async with UnifiedTo(
         security=shared.Security(
             jwt="<YOUR_API_KEY_HERE>",
@@ -1228,6 +1245,7 @@ Certain SDK methods accept file objects as part of a request body or multi-part
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1258,6 +1276,7 @@ from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 from unified_python_sdk.utils import BackoffStrategy, RetryConfig
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1283,6 +1302,7 @@ from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 from unified_python_sdk.utils import BackoffStrategy, RetryConfig
 
+
 with UnifiedTo(
     retry_config=RetryConfig("backoff", BackoffStrategy(1, 50, 1.1, 100), False),
     security=shared.Security(
@@ -1329,6 +1349,7 @@ When custom error responses are specified for an operation, the SDK may also rai
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import errors, shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1362,10 +1383,10 @@ with UnifiedTo(
 
 You can override the default server globally by passing a server index to the `server_idx: int` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the indexes associated with the available servers:
 
-| #   | Server                      |
-| --- | --------------------------- |
-| 0   | `https://api.unified.to`    |
-| 1   | `https://api-eu.unified.to` |
+| #   | Server                      | Description                |
+| --- | --------------------------- | -------------------------- |
+| 0   | `https://api.unified.to`    | North American data region |
+| 1   | `https://api-eu.unified.to` | European data region       |
 
 #### Example
 
@@ -1373,6 +1394,7 @@ You can override the default server globally by passing a server index to the `s
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     server_idx=1,
     security=shared.Security(
@@ -1399,6 +1421,7 @@ The default server can also be overridden globally by passing a URL to the `serv
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     server_url="https://api.unified.to",
     security=shared.Security(
@@ -1520,6 +1543,7 @@ You can set the security parameters through the `security` optional parameter wh
 from unified_python_sdk import UnifiedTo
 from unified_python_sdk.models import shared
 
+
 with UnifiedTo(
     security=shared.Security(
         jwt="<YOUR_API_KEY_HERE>",
@@ -1595,4 +1619,3 @@ While we value open-source contributions to this SDK, this library is generated
 Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release!
 
 ### SDK Created by [Speakeasy](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)
-

{unified_python_sdk-0.38.1 → unified_python_sdk-0.40.0}/pyproject.toml

@@ -1,17 +1,16 @@
 [project]
 name = "Unified-python-sdk"
-version = "0.38.1"
+version = "0.40.0"
 description = "Python Client SDK for Unified.to"
 authors = [{ name = "Unified API Inc." },]
 readme = "README-PYPI.md"
 requires-python = ">=3.9"
 dependencies = [
-    "eval-type-backport (>=0.2.0,<0.3.0)",
-    "httpx (>=0.28.1,<0.29.0)",
-    "jsonpath-python (>=1.0.6,<2.0.0)",
-    "pydantic (>=2.10.3,<2.11.0)",
-    "python-dateutil (>=2.8.2,<3.0.0)",
-    "typing-inspect (>=0.9.0,<0.10.0)",
+    "eval-type-backport >=0.2.0",
+    "httpx >=0.28.1",
+    "pydantic >=2.10.3",
+    "python-dateutil >=2.8.2",
+    "typing-inspection >=0.4.0",
 ]
 
 [tool.poetry]
@@ -37,6 +36,7 @@ requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"
 
 [tool.pytest.ini_options]
+asyncio_default_fixture_loop_scope = "function"
 pythonpath = ["src"]
 
 [tool.mypy]

{unified_python_sdk-0.38.1 → unified_python_sdk-0.40.0}/src/unified_python_sdk/_hooks/types.py

@@ -7,16 +7,19 @@ from unified_python_sdk.httpclient import HttpClient
 
 
 class HookContext:
+    base_url: str
     operation_id: str
     oauth2_scopes: Optional[List[str]] = None
     security_source: Optional[Union[Any, Callable[[], Any]]] = None
 
     def __init__(
         self,
+        base_url: str,
         operation_id: str,
         oauth2_scopes: Optional[List[str]],
         security_source: Optional[Union[Any, Callable[[], Any]]],
     ):
+        self.base_url = base_url
         self.operation_id = operation_id
         self.oauth2_scopes = oauth2_scopes
         self.security_source = security_source
@@ -25,21 +28,30 @@ class HookContext:
 class BeforeRequestContext(HookContext):
     def __init__(self, hook_ctx: HookContext):
         super().__init__(
-            hook_ctx.operation_id, hook_ctx.oauth2_scopes, hook_ctx.security_source
+            hook_ctx.base_url,
+            hook_ctx.operation_id,
+            hook_ctx.oauth2_scopes,
+            hook_ctx.security_source,
         )
 
 
 class AfterSuccessContext(HookContext):
     def __init__(self, hook_ctx: HookContext):
         super().__init__(
-            hook_ctx.operation_id, hook_ctx.oauth2_scopes, hook_ctx.security_source
+            hook_ctx.base_url,
+            hook_ctx.operation_id,
+            hook_ctx.oauth2_scopes,
+            hook_ctx.security_source,
         )
 
 
 class AfterErrorContext(HookContext):
     def __init__(self, hook_ctx: HookContext):
         super().__init__(
-            hook_ctx.operation_id, hook_ctx.oauth2_scopes, hook_ctx.security_source
+            hook_ctx.base_url,
+            hook_ctx.operation_id,
+            hook_ctx.oauth2_scopes,
+            hook_ctx.security_source,
         )
 
 

{unified_python_sdk-0.38.1 → unified_python_sdk-0.40.0}/src/unified_python_sdk/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "Unified-python-sdk"
-__version__: str = "0.38.1"
+__version__: str = "0.40.0"
 __openapi_doc_version__: str = "1.0"
-__gen_version__: str = "2.493.13"
-__user_agent__: str = "speakeasy-sdk/python 0.38.1 2.493.13 1.0 Unified-python-sdk"
+__gen_version__: str = "2.552.1"
+__user_agent__: str = "speakeasy-sdk/python 0.40.0 2.552.1 1.0 Unified-python-sdk"
 
 try:
     if __package__ is not None: