syllable-sdk 0.35.27__tar.gz → 0.35.31__tar.gz

{syllable_sdk-0.35.27 → syllable_sdk-0.35.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: syllable-sdk
-Version: 0.35.27
+Version: 0.35.31
 Summary: Python Client SDK Generated by Speakeasy.
 Author: Syllable
 Requires-Python: >=3.9.2
@@ -562,18 +562,26 @@ with SyllableSDK(
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-[`SyllableSDKError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/syllablesdkerror.py) is the base class for all HTTP error responses. It has the following properties:
+Handling errors in this SDK should largely match your expectations. All operations return a response object or raise an exception.
 
-| Property           | Type             | Description                                                                             |
-| ------------------ | ---------------- | --------------------------------------------------------------------------------------- |
-| `err.message`      | `str`            | Error message                                                                           |
-| `err.status_code`  | `int`            | HTTP response status code eg `404`                                                      |
-| `err.headers`      | `httpx.Headers`  | HTTP response headers                                                                   |
-| `err.body`         | `str`            | HTTP body. Can be empty string if no body is returned.                                  |
-| `err.raw_response` | `httpx.Response` | Raw HTTP response                                                                       |
-| `err.data`         |                  | Optional. Some errors may contain structured data. [See Error Classes](https://github.com/asksyllable/syllable-sdk-python/blob/master/#error-classes). |
+By default, an API error will raise a models.APIError exception, which has the following properties:
+
+| Property        | Type             | Description           |
+|-----------------|------------------|-----------------------|
+| `.status_code`  | *int*            | The HTTP status code  |
+| `.message`      | *str*            | The error message     |
+| `.raw_response` | *httpx.Response* | The raw HTTP response |
+| `.body`         | *str*            | The response content  |
+
+When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `list_async` method may raise the following exceptions:
+
+| Error Type                 | Status Code | Content Type     |
+| -------------------------- | ----------- | ---------------- |
+| models.HTTPValidationError | 422         | application/json |
+| models.APIError            | 4XX, 5XX    | \*/\*            |
 
 ### Example
+
 ```python
 import os
 import syllable_sdk
@@ -595,41 +603,13 @@ with SyllableSDK(
         # Handle response
         print(res)
 
-
-    except models.SyllableSDKError as e:
-        # The base class for HTTP error responses
-        print(e.message)
-        print(e.status_code)
-        print(e.body)
-        print(e.headers)
-        print(e.raw_response)
-
-        # Depending on the method different errors may be thrown
-        if isinstance(e, models.HTTPValidationError):
-            print(e.data.detail)  # Optional[List[syllable_sdk.ValidationError]]
+    except models.HTTPValidationError as e:
+        # handle e.data: models.HTTPValidationErrorData
+        raise(e)
+    except models.APIError as e:
+        # handle exception
+        raise(e)
 ```
-
-### Error Classes
-**Primary errors:**
-* [`SyllableSDKError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/syllablesdkerror.py): The base class for HTTP error responses.
-  * [`HTTPValidationError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/httpvalidationerror.py): Validation Error. Status code `422`. *
-
-<details><summary>Less common errors (5)</summary>
-
-<br />
-
-**Network errors:**
-* [`httpx.RequestError`](https://www.python-httpx.org/exceptions/#httpx.RequestError): Base class for request errors.
-    * [`httpx.ConnectError`](https://www.python-httpx.org/exceptions/#httpx.ConnectError): HTTP client was unable to make a request to a server.
-    * [`httpx.TimeoutException`](https://www.python-httpx.org/exceptions/#httpx.TimeoutException): HTTP request timed out.
-
-
-**Inherit from [`SyllableSDKError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/syllablesdkerror.py)**:
-* [`ResponseValidationError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
-
-</details>
-
-\* Check [the method documentation](https://github.com/asksyllable/syllable-sdk-python/blob/master/#available-resources-and-operations) to see if the error is applicable.
 <!-- End Error Handling [errors] -->
 
 <!-- Start Server Selection [server] -->

{syllable_sdk-0.35.27 → syllable_sdk-0.35.31}/README-PYPI.md

@@ -545,18 +545,26 @@ with SyllableSDK(
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-[`SyllableSDKError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/syllablesdkerror.py) is the base class for all HTTP error responses. It has the following properties:
+Handling errors in this SDK should largely match your expectations. All operations return a response object or raise an exception.
 
-| Property           | Type             | Description                                                                             |
-| ------------------ | ---------------- | --------------------------------------------------------------------------------------- |
-| `err.message`      | `str`            | Error message                                                                           |
-| `err.status_code`  | `int`            | HTTP response status code eg `404`                                                      |
-| `err.headers`      | `httpx.Headers`  | HTTP response headers                                                                   |
-| `err.body`         | `str`            | HTTP body. Can be empty string if no body is returned.                                  |
-| `err.raw_response` | `httpx.Response` | Raw HTTP response                                                                       |
-| `err.data`         |                  | Optional. Some errors may contain structured data. [See Error Classes](https://github.com/asksyllable/syllable-sdk-python/blob/master/#error-classes). |
+By default, an API error will raise a models.APIError exception, which has the following properties:
+
+| Property        | Type             | Description           |
+|-----------------|------------------|-----------------------|
+| `.status_code`  | *int*            | The HTTP status code  |
+| `.message`      | *str*            | The error message     |
+| `.raw_response` | *httpx.Response* | The raw HTTP response |
+| `.body`         | *str*            | The response content  |
+
+When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `list_async` method may raise the following exceptions:
+
+| Error Type                 | Status Code | Content Type     |
+| -------------------------- | ----------- | ---------------- |
+| models.HTTPValidationError | 422         | application/json |
+| models.APIError            | 4XX, 5XX    | \*/\*            |
 
 ### Example
+
 ```python
 import os
 import syllable_sdk
@@ -578,41 +586,13 @@ with SyllableSDK(
         # Handle response
         print(res)
 
-
-    except models.SyllableSDKError as e:
-        # The base class for HTTP error responses
-        print(e.message)
-        print(e.status_code)
-        print(e.body)
-        print(e.headers)
-        print(e.raw_response)
-
-        # Depending on the method different errors may be thrown
-        if isinstance(e, models.HTTPValidationError):
-            print(e.data.detail)  # Optional[List[syllable_sdk.ValidationError]]
+    except models.HTTPValidationError as e:
+        # handle e.data: models.HTTPValidationErrorData
+        raise(e)
+    except models.APIError as e:
+        # handle exception
+        raise(e)
 ```
-
-### Error Classes
-**Primary errors:**
-* [`SyllableSDKError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/syllablesdkerror.py): The base class for HTTP error responses.
-  * [`HTTPValidationError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/httpvalidationerror.py): Validation Error. Status code `422`. *
-
-<details><summary>Less common errors (5)</summary>
-
-<br />
-
-**Network errors:**
-* [`httpx.RequestError`](https://www.python-httpx.org/exceptions/#httpx.RequestError): Base class for request errors.
-    * [`httpx.ConnectError`](https://www.python-httpx.org/exceptions/#httpx.ConnectError): HTTP client was unable to make a request to a server.
-    * [`httpx.TimeoutException`](https://www.python-httpx.org/exceptions/#httpx.TimeoutException): HTTP request timed out.
-
-
-**Inherit from [`SyllableSDKError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/syllablesdkerror.py)**:
-* [`ResponseValidationError`](https://github.com/asksyllable/syllable-sdk-python/blob/master/./src/syllable_sdk/models/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
-
-</details>
-
-\* Check [the method documentation](https://github.com/asksyllable/syllable-sdk-python/blob/master/#available-resources-and-operations) to see if the error is applicable.
 <!-- End Error Handling [errors] -->
 
 <!-- Start Server Selection [server] -->

{syllable_sdk-0.35.27 → syllable_sdk-0.35.31}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "syllable-sdk"
-version = "0.35.27"
+version = "0.35.31"
 description = "Python Client SDK Generated by Speakeasy."
 authors = [{ name = "Syllable" },]
 readme = "README-PYPI.md"

{syllable_sdk-0.35.27 → syllable_sdk-0.35.31}/src/syllable_sdk/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "syllable-sdk"
-__version__: str = "0.35.27"
+__version__: str = "0.35.31"
 __openapi_doc_version__: str = "0.0.2"
-__gen_version__: str = "2.648.1"
-__user_agent__: str = "speakeasy-sdk/python 0.35.27 2.648.1 0.0.2 syllable-sdk"
+__gen_version__: str = "2.644.1"
+__user_agent__: str = "speakeasy-sdk/python 0.35.31 2.644.1 0.0.2 syllable-sdk"
 
 try:
     if __package__ is not None: