[Python] Add echo_api test object serialization for multipart requests (#18176)

* [python] echo add test object serialization for multipart requests

* [echo api] update samples

* [echo api] update samples

samples/client/echo_api/python-pydantic-v1/.openapi-generator/FILES

@@ -18,6 +18,7 @@ docs/Query.md
 docs/QueryApi.md
 docs/StringEnumRef.md
 docs/Tag.md
+docs/TestFormObjectMultipartRequestMarker.md
 docs/TestQueryStyleDeepObjectExplodeTrueObjectAllOfQueryObjectParameter.md
 docs/TestQueryStyleFormExplodeTrueArrayStringQueryObjectParameter.md
 git_push.sh
@@ -43,6 +44,7 @@ openapi_client/models/pet.py
 openapi_client/models/query.py
 openapi_client/models/string_enum_ref.py
 openapi_client/models/tag.py
+openapi_client/models/test_form_object_multipart_request_marker.py
 openapi_client/models/test_query_style_deep_object_explode_true_object_all_of_query_object_parameter.py
 openapi_client/models/test_query_style_form_explode_true_array_string_query_object_parameter.py
 openapi_client/py.typed

samples/client/echo_api/python-pydantic-v1/README.md

@@ -108,6 +108,7 @@ Class | Method | HTTP request | Description
 *BodyApi* | [**test_echo_body_string_enum**](docs/BodyApi.md#test_echo_body_string_enum) | **POST** /echo/body/string_enum | Test string enum response body
 *BodyApi* | [**test_echo_body_tag_response_string**](docs/BodyApi.md#test_echo_body_tag_response_string) | **POST** /echo/body/Tag/response_string | Test empty json (request body)
 *FormApi* | [**test_form_integer_boolean_string**](docs/FormApi.md#test_form_integer_boolean_string) | **POST** /form/integer/boolean/string | Test form parameter(s)
+*FormApi* | [**test_form_object_multipart**](docs/FormApi.md#test_form_object_multipart) | **POST** /form/object/multipart | Test form parameter(s) for multipart schema
 *FormApi* | [**test_form_oneof**](docs/FormApi.md#test_form_oneof) | **POST** /form/oneof | Test form parameter(s) for oneOf schema
 *HeaderApi* | [**test_header_integer_boolean_string_enums**](docs/HeaderApi.md#test_header_integer_boolean_string_enums) | **GET** /header/integer/boolean/string/enums | Test header parameter(s)
 *PathApi* | [**tests_path_string_path_string_integer_path_integer_enum_nonref_string_path_enum_ref_string_path**](docs/PathApi.md#tests_path_string_path_string_integer_path_integer_enum_nonref_string_path_enum_ref_string_path) | **GET** /path/string/{path_string}/integer/{path_integer}/{enum_nonref_string_path}/{enum_ref_string_path} | Test path parameter(s)
@@ -134,6 +135,7 @@ Class | Method | HTTP request | Description
  - [Query](docs/Query.md)
  - [StringEnumRef](docs/StringEnumRef.md)
  - [Tag](docs/Tag.md)
+ - [TestFormObjectMultipartRequestMarker](docs/TestFormObjectMultipartRequestMarker.md)
  - [TestQueryStyleDeepObjectExplodeTrueObjectAllOfQueryObjectParameter](docs/TestQueryStyleDeepObjectExplodeTrueObjectAllOfQueryObjectParameter.md)
  - [TestQueryStyleFormExplodeTrueArrayStringQueryObjectParameter](docs/TestQueryStyleFormExplodeTrueArrayStringQueryObjectParameter.md)
 

samples/client/echo_api/python-pydantic-v1/docs/FormApi.md

@@ -5,6 +5,7 @@ All URIs are relative to *http://localhost:3000*
 Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**test_form_integer_boolean_string**](FormApi.md#test_form_integer_boolean_string) | **POST** /form/integer/boolean/string | Test form parameter(s)
+[**test_form_object_multipart**](FormApi.md#test_form_object_multipart) | **POST** /form/object/multipart | Test form parameter(s) for multipart schema
 [**test_form_oneof**](FormApi.md#test_form_oneof) | **POST** /form/oneof | Test form parameter(s) for oneOf schema
 
 
@@ -78,6 +79,73 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **test_form_object_multipart**
+> str test_form_object_multipart(marker)
+
+Test form parameter(s) for multipart schema
+
+Test form parameter(s) for multipart schema
+
+### Example
+
+```python
+import time
+import os
+import openapi_client
+from openapi_client.models.test_form_object_multipart_request_marker import TestFormObjectMultipartRequestMarker
+from openapi_client.rest import ApiException
+from pprint import pprint
+
+# Defining the host is optional and defaults to http://localhost:3000
+# See configuration.py for a list of all supported configuration parameters.
+configuration = openapi_client.Configuration(
+    host = "http://localhost:3000"
+)
+
+
+# Enter a context with an instance of the API client
+with openapi_client.ApiClient(configuration) as api_client:
+    # Create an instance of the API class
+    api_instance = openapi_client.FormApi(api_client)
+    marker = openapi_client.TestFormObjectMultipartRequestMarker() # TestFormObjectMultipartRequestMarker | 
+
+    try:
+        # Test form parameter(s) for multipart schema
+        api_response = api_instance.test_form_object_multipart(marker)
+        print("The response of FormApi->test_form_object_multipart:\n")
+        pprint(api_response)
+    except Exception as e:
+        print("Exception when calling FormApi->test_form_object_multipart: %s\n" % e)
+```
+
+
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **marker** | [**TestFormObjectMultipartRequestMarker**](TestFormObjectMultipartRequestMarker.md)|  | 
+
+### Return type
+
+**str**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: multipart/form-data
+ - **Accept**: text/plain
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Successful operation |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **test_form_oneof**
 > str test_form_oneof(form1=form1, form2=form2, form3=form3, form4=form4, id=id, name=name)
 

samples/client/echo_api/python-pydantic-v1/docs/TestFormObjectMultipartRequestMarker.md

@@ -0,0 +1,28 @@
+# TestFormObjectMultipartRequestMarker
+
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**name** | **str** |  | [optional] 
+
+## Example
+
+```python
+from openapi_client.models.test_form_object_multipart_request_marker import TestFormObjectMultipartRequestMarker
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of TestFormObjectMultipartRequestMarker from a JSON string
+test_form_object_multipart_request_marker_instance = TestFormObjectMultipartRequestMarker.from_json(json)
+# print the JSON string representation of the object
+print TestFormObjectMultipartRequestMarker.to_json()
+
+# convert the object into a dict
+test_form_object_multipart_request_marker_dict = test_form_object_multipart_request_marker_instance.to_dict()
+# create an instance of TestFormObjectMultipartRequestMarker from a dict
+test_form_object_multipart_request_marker_form_dict = test_form_object_multipart_request_marker.from_dict(test_form_object_multipart_request_marker_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

samples/client/echo_api/python-pydantic-v1/openapi_client/__init__.py

@@ -46,5 +46,6 @@ from openapi_client.models.pet import Pet
 from openapi_client.models.query import Query
 from openapi_client.models.string_enum_ref import StringEnumRef
 from openapi_client.models.tag import Tag
+from openapi_client.models.test_form_object_multipart_request_marker import TestFormObjectMultipartRequestMarker
 from openapi_client.models.test_query_style_deep_object_explode_true_object_all_of_query_object_parameter import TestQueryStyleDeepObjectExplodeTrueObjectAllOfQueryObjectParameter
 from openapi_client.models.test_query_style_form_explode_true_array_string_query_object_parameter import TestQueryStyleFormExplodeTrueArrayStringQueryObjectParameter

samples/client/echo_api/python-pydantic-v1/openapi_client/api/form_api.py

@@ -23,6 +23,7 @@ from pydantic import StrictBool, StrictInt, StrictStr
 
 from typing import Optional
 
+from openapi_client.models.test_form_object_multipart_request_marker import TestFormObjectMultipartRequestMarker
 
 from openapi_client.api_client import ApiClient
 from openapi_client.api_response import ApiResponse
@@ -207,6 +208,153 @@ class FormApi:
             collection_formats=_collection_formats,
             _request_auth=_params.get('_request_auth'))
 
+    @validate_arguments
+    def test_form_object_multipart(self, marker : TestFormObjectMultipartRequestMarker, **kwargs) -> str:  # noqa: E501
+        """Test form parameter(s) for multipart schema  # noqa: E501
+
+        Test form parameter(s) for multipart schema  # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+
+        >>> thread = api.test_form_object_multipart(marker, async_req=True)
+        >>> result = thread.get()
+
+        :param marker: (required)
+        :type marker: TestFormObjectMultipartRequestMarker
+        :param async_req: Whether to execute the request asynchronously.
+        :type async_req: bool, optional
+        :param _request_timeout: timeout setting for this request.
+               If one number provided, it will be total request
+               timeout. It can also be a pair (tuple) of
+               (connection, read) timeouts.
+        :return: Returns the result object.
+                 If the method is called asynchronously,
+                 returns the request thread.
+        :rtype: str
+        """
+        kwargs['_return_http_data_only'] = True
+        if '_preload_content' in kwargs:
+            message = "Error! Please call the test_form_object_multipart_with_http_info method with `_preload_content` instead and obtain raw data from ApiResponse.raw_data"  # noqa: E501
+            raise ValueError(message)
+        return self.test_form_object_multipart_with_http_info(marker, **kwargs)  # noqa: E501
+
+    @validate_arguments
+    def test_form_object_multipart_with_http_info(self, marker : TestFormObjectMultipartRequestMarker, **kwargs) -> ApiResponse:  # noqa: E501
+        """Test form parameter(s) for multipart schema  # noqa: E501
+
+        Test form parameter(s) for multipart schema  # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+
+        >>> thread = api.test_form_object_multipart_with_http_info(marker, async_req=True)
+        >>> result = thread.get()
+
+        :param marker: (required)
+        :type marker: TestFormObjectMultipartRequestMarker
+        :param async_req: Whether to execute the request asynchronously.
+        :type async_req: bool, optional
+        :param _preload_content: if False, the ApiResponse.data will
+                                 be set to none and raw_data will store the
+                                 HTTP response body without reading/decoding.
+                                 Default is True.
+        :type _preload_content: bool, optional
+        :param _return_http_data_only: response data instead of ApiResponse
+                                       object with status code, headers, etc
+        :type _return_http_data_only: bool, optional
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the authentication
+                              in the spec for a single request.
+        :type _request_auth: dict, optional
+        :type _content_type: string, optional: force content-type for the request
+        :return: Returns the result object.
+                 If the method is called asynchronously,
+                 returns the request thread.
+        :rtype: tuple(str, status_code(int), headers(HTTPHeaderDict))
+        """
+
+        _params = locals()
+
+        _all_params = [
+            'marker'
+        ]
+        _all_params.extend(
+            [
+                'async_req',
+                '_return_http_data_only',
+                '_preload_content',
+                '_request_timeout',
+                '_request_auth',
+                '_content_type',
+                '_headers'
+            ]
+        )
+
+        # validate the arguments
+        for _key, _val in _params['kwargs'].items():
+            if _key not in _all_params:
+                raise ApiTypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method test_form_object_multipart" % _key
+                )
+            _params[_key] = _val
+        del _params['kwargs']
+
+        _collection_formats = {}
+
+        # process the path parameters
+        _path_params = {}
+
+        # process the query parameters
+        _query_params = []
+        # process the header parameters
+        _header_params = dict(_params.get('_headers', {}))
+        # process the form parameters
+        _form_params = []
+        _files = {}
+        if _params['marker'] is not None:
+            _form_params.append(('marker', _params['marker']))
+
+        # process the body parameter
+        _body_params = None
+        # set the HTTP header `Accept`
+        _header_params['Accept'] = self.api_client.select_header_accept(
+            ['text/plain'])  # noqa: E501
+
+        # set the HTTP header `Content-Type`
+        _content_types_list = _params.get('_content_type',
+            self.api_client.select_header_content_type(
+                ['multipart/form-data']))
+        if _content_types_list:
+                _header_params['Content-Type'] = _content_types_list
+
+        # authentication setting
+        _auth_settings = []  # noqa: E501
+
+        _response_types_map = {
+            '200': "str",
+        }
+
+        return self.api_client.call_api(
+            '/form/object/multipart', 'POST',
+            _path_params,
+            _query_params,
+            _header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            response_types_map=_response_types_map,
+            auth_settings=_auth_settings,
+            async_req=_params.get('async_req'),
+            _return_http_data_only=_params.get('_return_http_data_only'),  # noqa: E501
+            _preload_content=_params.get('_preload_content', True),
+            _request_timeout=_params.get('_request_timeout'),
+            collection_formats=_collection_formats,
+            _request_auth=_params.get('_request_auth'))
+
     @validate_arguments
     def test_form_oneof(self, form1 : Optional[StrictStr] = None, form2 : Optional[StrictInt] = None, form3 : Optional[StrictStr] = None, form4 : Optional[StrictBool] = None, id : Optional[StrictInt] = None, name : Optional[StrictStr] = None, **kwargs) -> str:  # noqa: E501
         """Test form parameter(s) for oneOf schema  # noqa: E501

samples/client/echo_api/python-pydantic-v1/openapi_client/models/__init__.py

@@ -24,5 +24,6 @@ from openapi_client.models.pet import Pet
 from openapi_client.models.query import Query
 from openapi_client.models.string_enum_ref import StringEnumRef
 from openapi_client.models.tag import Tag
+from openapi_client.models.test_form_object_multipart_request_marker import TestFormObjectMultipartRequestMarker
 from openapi_client.models.test_query_style_deep_object_explode_true_object_all_of_query_object_parameter import TestQueryStyleDeepObjectExplodeTrueObjectAllOfQueryObjectParameter
 from openapi_client.models.test_query_style_form_explode_true_array_string_query_object_parameter import TestQueryStyleFormExplodeTrueArrayStringQueryObjectParameter

samples/client/echo_api/python-pydantic-v1/openapi_client/models/test_form_object_multipart_request_marker.py

@@ -0,0 +1,72 @@
+# coding: utf-8
+
+"""
+    Echo Server API
+
+    Echo Server API
+
+    The version of the OpenAPI document: 0.1.0
+    Contact: team@openapitools.org
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+
+from typing import Optional
+from pydantic import BaseModel, StrictStr
+
+class TestFormObjectMultipartRequestMarker(BaseModel):
+    """
+    TestFormObjectMultipartRequestMarker
+    """
+    name: Optional[StrictStr] = None
+    __properties = ["name"]
+
+    class Config:
+        """Pydantic configuration"""
+        allow_population_by_field_name = True
+        validate_assignment = True
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.dict(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> TestFormObjectMultipartRequestMarker:
+        """Create an instance of TestFormObjectMultipartRequestMarker from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self):
+        """Returns the dictionary representation of the model using alias"""
+        _dict = self.dict(by_alias=True,
+                          exclude={
+                          },
+                          exclude_none=True)
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: dict) -> TestFormObjectMultipartRequestMarker:
+        """Create an instance of TestFormObjectMultipartRequestMarker from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return TestFormObjectMultipartRequestMarker.parse_obj(obj)
+
+        _obj = TestFormObjectMultipartRequestMarker.parse_obj({
+            "name": obj.get("name")
+        })
+        return _obj
+
+

samples/client/echo_api/python-pydantic-v1/test/test_test_form_object_multipart_request_marker.py

@@ -0,0 +1,53 @@
+# coding: utf-8
+
+"""
+    Echo Server API
+
+    Echo Server API
+
+    The version of the OpenAPI document: 0.1.0
+    Contact: team@openapitools.org
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+import unittest
+import datetime
+
+from openapi_client.models.test_form_object_multipart_request_marker import TestFormObjectMultipartRequestMarker  # noqa: E501
+
+class TestTestFormObjectMultipartRequestMarker(unittest.TestCase):
+    """TestFormObjectMultipartRequestMarker unit test stubs"""
+
+    def setUp(self):
+        pass
+
+    def tearDown(self):
+        pass
+
+    def make_instance(self, include_optional) -> TestFormObjectMultipartRequestMarker:
+        """Test TestFormObjectMultipartRequestMarker
+            include_option is a boolean, when False only required
+            params are included, when True both required and
+            optional params are included """
+        # uncomment below to create an instance of `TestFormObjectMultipartRequestMarker`
+        """
+        model = TestFormObjectMultipartRequestMarker()  # noqa: E501
+        if include_optional:
+            return TestFormObjectMultipartRequestMarker(
+                name = ''
+            )
+        else:
+            return TestFormObjectMultipartRequestMarker(
+        )
+        """
+
+    def testTestFormObjectMultipartRequestMarker(self):
+        """Test TestFormObjectMultipartRequestMarker"""
+        # inst_req_only = self.make_instance(include_optional=False)
+        # inst_req_and_optional = self.make_instance(include_optional=True)
+
+if __name__ == '__main__':
+    unittest.main()