formance-sdk-python 3.0.1__tar.gz → 4.0.0__tar.gz

{formance-sdk-python-3.0.1/src/formance_sdk_python.egg-info → formance-sdk-python-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: formance-sdk-python
-Version: 3.0.1
+Version: 4.0.0
 Summary: Python Client SDK Generated by Speakeasy
 Home-page: https://github.com/formancehq/formance-sdk-python.git
 Author: Formance
@@ -23,9 +23,39 @@ Description: # formance-sdk-python
         - [ ] 🎁 Publish your SDK to package managers by [configuring automatic publishing](https://www.speakeasyapi.dev/docs/productionize-sdks/publish-sdks)
         - [ ] ✨ When ready to productionize, delete this section from the README
         
+        <!-- Start Summary [summary] -->
+        ## Summary
+        
+        Formance Stack API: Open, modular foundation for unique payments flows
+        
+        # Introduction
+        This API is documented in **OpenAPI format**.
+        
+        # Authentication
+        Formance Stack offers one forms of authentication:
+          - OAuth2
+        OAuth2 - an open protocol to allow secure authorization in a simple
+        and standard method from web, mobile and desktop applications.
+        <SecurityDefinitions />
+        <!-- End Summary [summary] -->
+        
+        <!-- Start Table of Contents [toc] -->
+        ## Table of Contents
+        
+        * [SDK Installation](https://github.com/formancehq/formance-sdk-python/blob/master/#sdk-installation)
+        * [SDK Example Usage](https://github.com/formancehq/formance-sdk-python/blob/master/#sdk-example-usage)
+        * [Available Resources and Operations](https://github.com/formancehq/formance-sdk-python/blob/master/#available-resources-and-operations)
+        * [Error Handling](https://github.com/formancehq/formance-sdk-python/blob/master/#error-handling)
+        * [Server Selection](https://github.com/formancehq/formance-sdk-python/blob/master/#server-selection)
+        * [Custom HTTP Client](https://github.com/formancehq/formance-sdk-python/blob/master/#custom-http-client)
+        * [Authentication](https://github.com/formancehq/formance-sdk-python/blob/master/#authentication)
+        <!-- End Table of Contents [toc] -->
+        
         <!-- Start SDK Installation [installation] -->
         ## SDK Installation
         
+        The SDK can be installed using the *pip* package manager, with dependencies and metadata stored in the `setup.py` file.
+        
         ```bash
         pip install formance-sdk-python
         ```
@@ -60,10 +90,8 @@ Description: # formance-sdk-python
         <!-- Start Available Resources and Operations [operations] -->
         ## Available Resources and Operations
         
-        ### [SDK](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md)
-        
-        * [get_oidc_well_knowns](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_oidc_well_knowns) - Retrieve OpenID connect well-knowns.
-        * [get_versions](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_versions) - Show stack version information
+        <details open>
+        <summary>Available methods</summary>
         
         ### [auth](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/auth/README.md)
         
@@ -219,6 +247,11 @@ Description: # formance-sdk-python
         * [reconcile](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/reconciliation/README.md#reconcile) - Reconcile using a policy
         * [reconciliationget_server_info](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/reconciliation/README.md#reconciliationget_server_info) - Get server info
         
+        ### [SDK](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md)
+        
+        * [get_oidc_well_knowns](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_oidc_well_knowns) - Retrieve OpenID connect well-knowns.
+        * [get_versions](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_versions) - Show stack version information
+        
         ### [search](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/search/README.md)
         
         * [search](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/search/README.md#search) - Search
@@ -252,6 +285,8 @@ Description: # formance-sdk-python
         * [get_many_configs](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/webhooks/README.md#get_many_configs) - Get many configs
         * [insert_config](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/webhooks/README.md#insert_config) - Insert a new config
         * [test_config](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/webhooks/README.md#test_config) - Test one config
+        
+        </details>
         <!-- End Available Resources and Operations [operations] -->
         
         <!-- Start Error Handling [errors] -->
@@ -290,6 +325,18 @@ Description: # formance-sdk-python
                                 destination='users:002',
                                 source='users:001',
                             ),
+                            shared.Posting(
+                                amount=100,
+                                asset='COIN',
+                                destination='users:002',
+                                source='users:001',
+                            ),
+                            shared.Posting(
+                                amount=100,
+                                asset='COIN',
+                                destination='users:002',
+                                source='users:001',
+                            ),
                         ],
                         reference='ref:001',
                     ),

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/README.md

@@ -16,9 +16,39 @@ It has been generated successfully based on your OpenAPI spec. However, it is no
 - [ ] 🎁 Publish your SDK to package managers by [configuring automatic publishing](https://www.speakeasyapi.dev/docs/productionize-sdks/publish-sdks)
 - [ ] ✨ When ready to productionize, delete this section from the README
 
+<!-- Start Summary [summary] -->
+## Summary
+
+Formance Stack API: Open, modular foundation for unique payments flows
+
+# Introduction
+This API is documented in **OpenAPI format**.
+
+# Authentication
+Formance Stack offers one forms of authentication:
+  - OAuth2
+OAuth2 - an open protocol to allow secure authorization in a simple
+and standard method from web, mobile and desktop applications.
+<SecurityDefinitions />
+<!-- End Summary [summary] -->
+
+<!-- Start Table of Contents [toc] -->
+## Table of Contents
+
+* [SDK Installation](#sdk-installation)
+* [SDK Example Usage](#sdk-example-usage)
+* [Available Resources and Operations](#available-resources-and-operations)
+* [Error Handling](#error-handling)
+* [Server Selection](#server-selection)
+* [Custom HTTP Client](#custom-http-client)
+* [Authentication](#authentication)
+<!-- End Table of Contents [toc] -->
+
 <!-- Start SDK Installation [installation] -->
 ## SDK Installation
 
+The SDK can be installed using the *pip* package manager, with dependencies and metadata stored in the `setup.py` file.
+
 ```bash
 pip install formance-sdk-python
 ```
@@ -53,10 +83,8 @@ if res is not None:
 <!-- Start Available Resources and Operations [operations] -->
 ## Available Resources and Operations
 
-### [SDK](docs/sdks/sdk/README.md)
-
-* [get_oidc_well_knowns](docs/sdks/sdk/README.md#get_oidc_well_knowns) - Retrieve OpenID connect well-knowns.
-* [get_versions](docs/sdks/sdk/README.md#get_versions) - Show stack version information
+<details open>
+<summary>Available methods</summary>
 
 ### [auth](docs/sdks/auth/README.md)
 
@@ -212,6 +240,11 @@ if res is not None:
 * [reconcile](docs/sdks/reconciliation/README.md#reconcile) - Reconcile using a policy
 * [reconciliationget_server_info](docs/sdks/reconciliation/README.md#reconciliationget_server_info) - Get server info
 
+### [SDK](docs/sdks/sdk/README.md)
+
+* [get_oidc_well_knowns](docs/sdks/sdk/README.md#get_oidc_well_knowns) - Retrieve OpenID connect well-knowns.
+* [get_versions](docs/sdks/sdk/README.md#get_versions) - Show stack version information
+
 ### [search](docs/sdks/search/README.md)
 
 * [search](docs/sdks/search/README.md#search) - Search
@@ -245,6 +278,8 @@ if res is not None:
 * [get_many_configs](docs/sdks/webhooks/README.md#get_many_configs) - Get many configs
 * [insert_config](docs/sdks/webhooks/README.md#insert_config) - Insert a new config
 * [test_config](docs/sdks/webhooks/README.md#test_config) - Test one config
+
+</details>
 <!-- End Available Resources and Operations [operations] -->
 
 <!-- Start Error Handling [errors] -->
@@ -283,6 +318,18 @@ try:
                         destination='users:002',
                         source='users:001',
                     ),
+                    shared.Posting(
+                        amount=100,
+                        asset='COIN',
+                        destination='users:002',
+                        source='users:001',
+                    ),
+                    shared.Posting(
+                        amount=100,
+                        asset='COIN',
+                        destination='users:002',
+                        source='users:001',
+                    ),
                 ],
                 reference='ref:001',
             ),

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/setup.py

@@ -19,7 +19,7 @@ except FileNotFoundError:
 
 setuptools.setup(
     name='formance-sdk-python',
-    version='3.0.1',
+    version='4.0.0',
     author='Formance',
     description='Python Client SDK Generated by Speakeasy',
     url='https://github.com/formancehq/formance-sdk-python.git',

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0/src/formance_sdk_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: formance-sdk-python
-Version: 3.0.1
+Version: 4.0.0
 Summary: Python Client SDK Generated by Speakeasy
 Home-page: https://github.com/formancehq/formance-sdk-python.git
 Author: Formance
@@ -23,9 +23,39 @@ Description: # formance-sdk-python
         - [ ] 🎁 Publish your SDK to package managers by [configuring automatic publishing](https://www.speakeasyapi.dev/docs/productionize-sdks/publish-sdks)
         - [ ] ✨ When ready to productionize, delete this section from the README
         
+        <!-- Start Summary [summary] -->
+        ## Summary
+        
+        Formance Stack API: Open, modular foundation for unique payments flows
+        
+        # Introduction
+        This API is documented in **OpenAPI format**.
+        
+        # Authentication
+        Formance Stack offers one forms of authentication:
+          - OAuth2
+        OAuth2 - an open protocol to allow secure authorization in a simple
+        and standard method from web, mobile and desktop applications.
+        <SecurityDefinitions />
+        <!-- End Summary [summary] -->
+        
+        <!-- Start Table of Contents [toc] -->
+        ## Table of Contents
+        
+        * [SDK Installation](https://github.com/formancehq/formance-sdk-python/blob/master/#sdk-installation)
+        * [SDK Example Usage](https://github.com/formancehq/formance-sdk-python/blob/master/#sdk-example-usage)
+        * [Available Resources and Operations](https://github.com/formancehq/formance-sdk-python/blob/master/#available-resources-and-operations)
+        * [Error Handling](https://github.com/formancehq/formance-sdk-python/blob/master/#error-handling)
+        * [Server Selection](https://github.com/formancehq/formance-sdk-python/blob/master/#server-selection)
+        * [Custom HTTP Client](https://github.com/formancehq/formance-sdk-python/blob/master/#custom-http-client)
+        * [Authentication](https://github.com/formancehq/formance-sdk-python/blob/master/#authentication)
+        <!-- End Table of Contents [toc] -->
+        
         <!-- Start SDK Installation [installation] -->
         ## SDK Installation
         
+        The SDK can be installed using the *pip* package manager, with dependencies and metadata stored in the `setup.py` file.
+        
         ```bash
         pip install formance-sdk-python
         ```
@@ -60,10 +90,8 @@ Description: # formance-sdk-python
         <!-- Start Available Resources and Operations [operations] -->
         ## Available Resources and Operations
         
-        ### [SDK](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md)
-        
-        * [get_oidc_well_knowns](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_oidc_well_knowns) - Retrieve OpenID connect well-knowns.
-        * [get_versions](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_versions) - Show stack version information
+        <details open>
+        <summary>Available methods</summary>
         
         ### [auth](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/auth/README.md)
         
@@ -219,6 +247,11 @@ Description: # formance-sdk-python
         * [reconcile](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/reconciliation/README.md#reconcile) - Reconcile using a policy
         * [reconciliationget_server_info](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/reconciliation/README.md#reconciliationget_server_info) - Get server info
         
+        ### [SDK](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md)
+        
+        * [get_oidc_well_knowns](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_oidc_well_knowns) - Retrieve OpenID connect well-knowns.
+        * [get_versions](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/sdk/README.md#get_versions) - Show stack version information
+        
         ### [search](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/search/README.md)
         
         * [search](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/search/README.md#search) - Search
@@ -252,6 +285,8 @@ Description: # formance-sdk-python
         * [get_many_configs](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/webhooks/README.md#get_many_configs) - Get many configs
         * [insert_config](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/webhooks/README.md#insert_config) - Insert a new config
         * [test_config](https://github.com/formancehq/formance-sdk-python/blob/master/docs/sdks/webhooks/README.md#test_config) - Test one config
+        
+        </details>
         <!-- End Available Resources and Operations [operations] -->
         
         <!-- Start Error Handling [errors] -->
@@ -290,6 +325,18 @@ Description: # formance-sdk-python
                                 destination='users:002',
                                 source='users:001',
                             ),
+                            shared.Posting(
+                                amount=100,
+                                asset='COIN',
+                                destination='users:002',
+                                source='users:001',
+                            ),
+                            shared.Posting(
+                                amount=100,
+                                asset='COIN',
+                                destination='users:002',
+                                source='users:001',
+                            ),
                         ],
                         reference='ref:001',
                     ),

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/src/sdk/_hooks/clientcredentials.py

@@ -99,7 +99,7 @@ class ClientCredentialsHook(SDKInitHook, BeforeRequestHook, AfterErrorHook):
         return Credentials(
             client_id=security.client_id,
             client_secret=security.client_secret,
-            token_url=security.TOKEN_URL
+            token_url=security.token_url
         )
 
     def do_token_request(self, credentials: Credentials, scopes: Optional[List[str]]) -> Session:

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/src/sdk/models/shared/balance.py

@@ -14,7 +14,7 @@ from typing import Optional
 class Balance:
     UNSET='__SPEAKEASY_UNSET__'
     name: str = dataclasses.field(metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('name') }})
-    expires_at: Optional[datetime] = dataclasses.field(default=UNSET, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('expiresAt'), 'encoder': utils.datetimeisoformat(True), 'decoder': dateutil.parser.isoparse, 'exclude': lambda f: f is Balance.UNSET }})
+    expires_at: Optional[datetime] = dataclasses.field(default=UNSET, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('expiresAt'), 'encoder': utils.datetimeisoformat(True), 'decoder': utils.decodeunset(dateutil.parser.isoparse), 'exclude': lambda f: f is Balance.UNSET }})
     priority: Optional[int] = dataclasses.field(default=None, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('priority'), 'exclude': lambda f: f is None }})
     
 

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/src/sdk/models/shared/balancewithassets.py

@@ -15,7 +15,7 @@ class BalanceWithAssets:
     UNSET='__SPEAKEASY_UNSET__'
     assets: Dict[str, int] = dataclasses.field(metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('assets') }})
     name: str = dataclasses.field(metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('name') }})
-    expires_at: Optional[datetime] = dataclasses.field(default=UNSET, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('expiresAt'), 'encoder': utils.datetimeisoformat(True), 'decoder': dateutil.parser.isoparse, 'exclude': lambda f: f is BalanceWithAssets.UNSET }})
+    expires_at: Optional[datetime] = dataclasses.field(default=UNSET, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('expiresAt'), 'encoder': utils.datetimeisoformat(True), 'decoder': utils.decodeunset(dateutil.parser.isoparse), 'exclude': lambda f: f is BalanceWithAssets.UNSET }})
     priority: Optional[int] = dataclasses.field(default=None, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('priority'), 'exclude': lambda f: f is None }})
     
 

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/src/sdk/models/shared/createbalancerequest.py

@@ -14,7 +14,7 @@ from typing import Optional
 class CreateBalanceRequest:
     UNSET='__SPEAKEASY_UNSET__'
     name: str = dataclasses.field(metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('name') }})
-    expires_at: Optional[datetime] = dataclasses.field(default=UNSET, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('expiresAt'), 'encoder': utils.datetimeisoformat(True), 'decoder': dateutil.parser.isoparse, 'exclude': lambda f: f is CreateBalanceRequest.UNSET }})
+    expires_at: Optional[datetime] = dataclasses.field(default=UNSET, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('expiresAt'), 'encoder': utils.datetimeisoformat(True), 'decoder': utils.decodeunset(dateutil.parser.isoparse), 'exclude': lambda f: f is CreateBalanceRequest.UNSET }})
     priority: Optional[int] = dataclasses.field(default=None, metadata={'dataclasses_json': { 'letter_case': utils.get_field_name('priority'), 'exclude': lambda f: f is None }})
     
 

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/src/sdk/models/shared/security.py

@@ -2,13 +2,12 @@
 
 from __future__ import annotations
 import dataclasses
-from typing import Final
 
 
 @dataclasses.dataclass
 class Security:
     client_id: str = dataclasses.field(metadata={'security': { 'scheme': True, 'type': 'oauth2', 'sub_type': 'client_credentials', 'field_name': 'clientID' }})
     client_secret: str = dataclasses.field(metadata={'security': { 'scheme': True, 'type': 'oauth2', 'sub_type': 'client_credentials', 'field_name': 'clientSecret' }})
-    TOKEN_URL: Final[str] = dataclasses.field(default='/api/auth/oauth/token')
+    token_url: str = dataclasses.field(default='/api/auth/oauth/token')
     
 

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/src/sdk/sdkconfiguration.py

@@ -23,10 +23,10 @@ class SDKConfiguration:
     server_url: Optional[str] = ''
     server_idx: Optional[int] = 0
     language: str = 'python'
-    openapi_doc_version: str = 'v2.0.8'
-    sdk_version: str = '3.0.1'
-    gen_version: str = '2.385.2'
-    user_agent: str = 'speakeasy-sdk/python 3.0.1 2.385.2 v2.0.8 formance-sdk-python'
+    openapi_doc_version: str = 'v2.0.17'
+    sdk_version: str = '4.0.0'
+    gen_version: str = '2.421.3'
+    user_agent: str = 'speakeasy-sdk/python 4.0.0 2.421.3 v2.0.17 formance-sdk-python'
     retry_config: Optional[RetryConfig] = None
 
     def __post_init__(self):

{formance-sdk-python-3.0.1 → formance-sdk-python-4.0.0}/src/sdk/utils/utils.py

@@ -218,7 +218,7 @@ def _populate_path_params(
                 if isinstance(param, List):
                     pp_vals: List[str] = []
                     for pp_val in param:
-                        if pp_val is None:
+                        if pp_val is None or pp_val == "__SPEAKEASY_UNSET__":
                             continue
                         pp_vals.append(_val_to_string(pp_val))
                     path_param_values[param_metadata.get("field_name", field.name)] = (
@@ -227,7 +227,10 @@ def _populate_path_params(
                 elif isinstance(param, Dict):
                     pp_vals: List[str] = []
                     for pp_key in param:
-                        if param[pp_key] is None:
+                        if (
+                            param[pp_key] is None
+                            or param[pp_key] == "__SPEAKEASY_UNSET__"
+                        ):
                             continue
                         if param_metadata.get("explode"):
                             pp_vals.append(f"{pp_key}={_val_to_string(param[pp_key])}")
@@ -247,7 +250,10 @@ def _populate_path_params(
                         param_name = param_value_metadata.get("field_name", field.name)
 
                         param_field_val = getattr(param, param_field.name)
-                        if param_field_val is None:
+                        if (
+                            param_field_val is None
+                            or param_field_val == "__SPEAKEASY_UNSET__"
+                        ):
                             continue
                         if param_metadata.get("explode"):
                             pp_vals.append(
@@ -406,19 +412,23 @@ def _get_serialized_params(
 def _populate_deep_object_query_params(
     metadata: Dict, field_name: str, obj: Any, params: Dict[str, List[str]]
 ):
-    if obj is None:
+    if obj is None or obj == "__SPEAKEASY_UNSET__":
         return
 
     if is_dataclass(obj):
-        _populate_deep_object_query_params_dataclass(metadata.get("field_name", field_name), obj, params)
+        _populate_deep_object_query_params_dataclass(
+            metadata.get("field_name", field_name), obj, params
+        )
     elif isinstance(obj, Dict):
-        _populate_deep_object_query_params_dict(metadata.get("field_name", field_name), obj, params)
+        _populate_deep_object_query_params_dict(
+            metadata.get("field_name", field_name), obj, params
+        )
 
 
 def _populate_deep_object_query_params_dataclass(
     prior_params_key: str, obj: Any, params: Dict[str, List[str]]
 ):
-    if obj is None:
+    if obj is None or obj == "__SPEAKEASY_UNSET__":
         return
 
     if not is_dataclass(obj):
@@ -431,7 +441,7 @@ def _populate_deep_object_query_params_dataclass(
             continue
 
         obj_val = getattr(obj, obj_field.name)
-        if obj_val is None:
+        if obj_val is None or obj_val == "__SPEAKEASY_UNSET__":
             continue
 
         params_key = f'{prior_params_key}[{obj_param_metadata.get("field_name", obj_field.name)}]'
@@ -449,14 +459,14 @@ def _populate_deep_object_query_params_dataclass(
 def _populate_deep_object_query_params_dict(
     prior_params_key: str, value: Dict, params: Dict[str, List[str]]
 ):
-    if value is None:
+    if value is None or value == "__SPEAKEASY_UNSET__":
         return
 
     for key, val in value.items():
-        if val is None:
+        if val is None or val == "__SPEAKEASY_UNSET__":
             continue
 
-        params_key = f'{prior_params_key}[{key}]'
+        params_key = f"{prior_params_key}[{key}]"
 
         if is_dataclass(val):
             _populate_deep_object_query_params_dataclass(params_key, val, params)
@@ -471,11 +481,11 @@ def _populate_deep_object_query_params_dict(
 def _populate_deep_object_query_params_list(
     params_key: str, value: List, params: Dict[str, List[str]]
 ):
-    if value is None:
+    if value is None or value == "__SPEAKEASY_UNSET__":
         return
 
     for val in value:
-        if val is None:
+        if val is None or val == "__SPEAKEASY_UNSET__":
             continue
 
         if params.get(params_key) is None:
@@ -593,7 +603,7 @@ def serialize_multipart_form(
 
     for field in request_fields:
         val = getattr(request, field.name)
-        if val is None:
+        if val is None or val == "__SPEAKEASY_UNSET__":
             continue
 
         field_metadata = field.metadata.get("multipart_form")
@@ -631,10 +641,12 @@ def serialize_multipart_form(
             field_name = field_metadata.get("field_name", field.name)
             if isinstance(val, List):
                 for value in val:
-                    if value is None:
+                    if value is None or value == "__SPEAKEASY_UNSET__":
                         continue
                     form.append([field_name + "[]", [None, _val_to_string(value)]])
             else:
+                if val == "__SPEAKEASY_UNSET__":
+                    continue
                 form.append([field_name, [None, _val_to_string(val)]])
     return media_type, None, form
 
@@ -667,7 +679,7 @@ def serialize_form_data(field_name: str, data: Any) -> Dict[str, Any]:
     if is_dataclass(data):
         for field in fields(data):
             val = getattr(data, field.name)
-            if val is None:
+            if val is None or val == "__SPEAKEASY_UNSET__":
                 continue
 
             metadata = field.metadata.get("form")
@@ -692,6 +704,8 @@ def serialize_form_data(field_name: str, data: Any) -> Dict[str, Any]:
                     raise Exception(f"Invalid form style for field {field.name}")
     elif isinstance(data, Dict):
         for key, value in data.items():
+            if value == "__SPEAKEASY_UNSET__":
+                continue
             form[key] = [_val_to_string(value)]
     else:
         raise Exception(f"Invalid request body type for field {field_name}")
@@ -716,7 +730,7 @@ def _populate_form(
     delimiter: str,
     form: Dict[str, List[str]],
 ):
-    if obj is None:
+    if obj is None or obj == "__SPEAKEASY_UNSET__":
         return form
 
     if is_dataclass(obj):
@@ -729,7 +743,7 @@ def _populate_form(
                 continue
 
             val = getattr(obj, obj_field.name)
-            if val is None:
+            if val is None or val == "__SPEAKEASY_UNSET__":
                 continue
 
             if explode:
@@ -742,7 +756,7 @@ def _populate_form(
     elif isinstance(obj, Dict):
         items = []
         for key, value in obj.items():
-            if value is None:
+            if value is None or value == "__SPEAKEASY_UNSET__":
                 continue
 
             if explode:
@@ -756,7 +770,7 @@ def _populate_form(
         items = []
 
         for value in obj:
-            if value is None:
+            if value is None or value == "__SPEAKEASY_UNSET__":
                 continue
 
             if explode:
@@ -769,13 +783,14 @@ def _populate_form(
         if len(items) > 0:
             form[field_name] = [delimiter.join([str(item) for item in items])]
     else:
-        form[field_name] = [_val_to_string(obj)]
+        if obj != "__SPEAKEASY_UNSET__":
+            form[field_name] = [_val_to_string(obj)]
 
     return form
 
 
 def _serialize_header(explode: bool, obj: Any) -> str:
-    if obj is None:
+    if obj is None or obj == "__SPEAKEASY_UNSET__":
         return ""
 
     if is_dataclass(obj):
@@ -792,7 +807,7 @@ def _serialize_header(explode: bool, obj: Any) -> str:
                 continue
 
             val = getattr(obj, obj_field.name)
-            if val is None:
+            if val is None or val == "__SPEAKEASY_UNSET__":
                 continue
 
             if explode:
@@ -807,7 +822,7 @@ def _serialize_header(explode: bool, obj: Any) -> str:
         items = []
 
         for key, value in obj.items():
-            if value is None:
+            if value is None or value == "__SPEAKEASY_UNSET__":
                 continue
 
             if explode:
@@ -822,7 +837,7 @@ def _serialize_header(explode: bool, obj: Any) -> str:
         items = []
 
         for value in obj:
-            if value is None:
+            if value is None or value == "__SPEAKEASY_UNSET__":
                 continue
 
             items.append(_val_to_string(value))
@@ -830,6 +845,8 @@ def _serialize_header(explode: bool, obj: Any) -> str:
         if len(items) > 0:
             return ",".join(items)
     else:
+        if obj == "__SPEAKEASY_UNSET__":
+            return ""
         return f"{_val_to_string(obj)}"
 
     return ""
@@ -928,6 +945,7 @@ def bigintdecoder(val):
         raise ValueError(f"{val} is a float")
     return int(val)
 
+
 def integerstrencoder(optional: bool):
     def integerstrencode(val: int):
         if optional and val is None:
@@ -1114,3 +1132,15 @@ def remove_suffix(input_string, suffix):
     if suffix and input_string.endswith(suffix):
         return input_string[: -len(suffix)]
     return input_string
+
+
+def decodeunset(decoder: Optional[Callable] = None):
+    def decode(val):
+        if val == "__SPEAKEASY_UNSET__":
+            return val
+        if decoder is None:
+            return None
+
+        return decoder(val)
+
+    return decode