Update parser to 2.0.29 (#11388)

* update parser to 2.0.29

* better handling of null in dereferencing

* update parser to 2.0.30

* update core to newer version

* add new files

* rollback to previous stable version

* remove files

* Fixes for python-experimental NullableShape component

Co-authored-by: Justin Black <justin.a.black@gmail.com>

modules/openapi-generator/src/main/java/org/openapitools/codegen/utils/ModelUtils.java

@@ -381,7 +381,11 @@ public class ModelUtils {
     }
 
     public static String getSimpleRef(String ref) {
-        if (ref.startsWith("#/components/")) {
+        if (ref == null) {
+            once(LOGGER).warn("Failed to get the schema name: null");
+            //throw new RuntimeException("Failed to get the schema: null");
+            return null;
+        } else if (ref.startsWith("#/components/")) {
             ref = ref.substring(ref.lastIndexOf("/") + 1);
         } else if (ref.startsWith("#/definitions/")) {
             ref = ref.substring(ref.lastIndexOf("/") + 1);
@@ -389,12 +393,12 @@ public class ModelUtils {
             once(LOGGER).warn("Failed to get the schema name: {}", ref);
             //throw new RuntimeException("Failed to get the schema: " + ref);
             return null;
-
         }
 
         try {
             ref = URLDecoder.decode(ref, "UTF-8");
         } catch (UnsupportedEncodingException ignored) {
+            once(LOGGER).warn("Found UnsupportedEncodingException: {}", ref);
         }
 
         // see https://tools.ietf.org/html/rfc6901#section-3

modules/openapi-generator/src/test/resources/3_0/python-experimental/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml

@@ -2488,16 +2488,13 @@ components:
         propertyName: shapeType
     NullableShape:
       description: The value may be a shape or the 'null' value.
-        The 'nullable' attribute was introduced in OAS schema >= 3.0
-        and has been deprecated in OAS schema >= 3.1.
-        For a nullable composed schema to work, one of its chosen oneOf schemas must be type null
+        For a composed schema to validate a null payload,
+        one of its chosen oneOf schemas must be type null
+        or nullable (introduced in OAS schema >= 3.0)
       oneOf:
         - $ref: '#/components/schemas/Triangle'
         - $ref: '#/components/schemas/Quadrilateral'
-        - type: null
-      discriminator:
-        propertyName: shapeType
-      nullable: true
+        - type: "null"
     TriangleInterface:
       properties:
         shapeType:

pom.xml

@@ -1485,7 +1485,7 @@
         <maven-surefire-plugin.version>3.0.0-M5</maven-surefire-plugin.version>
         <swagger-core.version>2.1.12</swagger-core.version>
         <swagger-parser-groupid.version>io.swagger.parser.v3</swagger-parser-groupid.version>
-        <swagger-parser.version>2.0.26</swagger-parser.version>
+        <swagger-parser.version>2.0.29</swagger-parser.version>
         <testng.version>7.3.0</testng.version>
         <violations-maven-plugin.version>1.34</violations-maven-plugin.version>
         <wagon-ssh-external.version>3.4.3</wagon-ssh-external.version>

samples/client/petstore/crystal/src/petstore/api/pet_api.cr

@@ -18,6 +18,7 @@ module Petstore
       @api_client = api_client
     end
     # Add a new pet to the store
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @return [Pet]
     def add_pet(pet : Pet)
@@ -26,6 +27,7 @@ module Petstore
     end
 
     # Add a new pet to the store
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @return [Array<(Pet, Integer, Hash)>] Pet data, response status code and response headers
     def add_pet_with_http_info(pet : Pet)
@@ -77,6 +79,7 @@ module Petstore
     end
 
     # Deletes a pet
+    # 
     # @param pet_id [Int64] Pet id to delete
     # @return [nil]
     def delete_pet(pet_id : Int64, api_key : String?)
@@ -85,6 +88,7 @@ module Petstore
     end
 
     # Deletes a pet
+    # 
     # @param pet_id [Int64] Pet id to delete
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_pet_with_http_info(pet_id : Int64, api_key : String?)
@@ -312,6 +316,7 @@ module Petstore
     end
 
     # Update an existing pet
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @return [Pet]
     def update_pet(pet : Pet)
@@ -320,6 +325,7 @@ module Petstore
     end
 
     # Update an existing pet
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @return [Array<(Pet, Integer, Hash)>] Pet data, response status code and response headers
     def update_pet_with_http_info(pet : Pet)
@@ -371,6 +377,7 @@ module Petstore
     end
 
     # Updates a pet in the store with form data
+    # 
     # @param pet_id [Int64] ID of pet that needs to be updated
     # @return [nil]
     def update_pet_with_form(pet_id : Int64, name : String?, status : String?)
@@ -379,6 +386,7 @@ module Petstore
     end
 
     # Updates a pet in the store with form data
+    # 
     # @param pet_id [Int64] ID of pet that needs to be updated
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def update_pet_with_form_with_http_info(pet_id : Int64, name : String?, status : String?)
@@ -430,6 +438,7 @@ module Petstore
     end
 
     # uploads an image
+    # 
     # @param pet_id [Int64] ID of pet to update
     # @return [ApiResponse]
     def upload_file(pet_id : Int64, additional_metadata : String?, file : ::File?)
@@ -438,6 +447,7 @@ module Petstore
     end
 
     # uploads an image
+    # 
     # @param pet_id [Int64] ID of pet to update
     # @return [Array<(ApiResponse, Integer, Hash)>] ApiResponse data, response status code and response headers
     def upload_file_with_http_info(pet_id : Int64, additional_metadata : String?, file : ::File?)

samples/client/petstore/crystal/src/petstore/api/store_api.cr

@@ -195,6 +195,7 @@ module Petstore
     end
 
     # Place an order for a pet
+    # 
     # @param order [Order] order placed for purchasing the pet
     # @return [Order]
     def place_order(order : Order)
@@ -203,6 +204,7 @@ module Petstore
     end
 
     # Place an order for a pet
+    # 
     # @param order [Order] order placed for purchasing the pet
     # @return [Array<(Order, Integer, Hash)>] Order data, response status code and response headers
     def place_order_with_http_info(order : Order)

samples/client/petstore/crystal/src/petstore/api/user_api.cr

@@ -77,6 +77,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array(User)] List of user object
     # @return [nil]
     def create_users_with_array_input(user : Array(User))
@@ -85,6 +86,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array(User)] List of user object
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def create_users_with_array_input_with_http_info(user : Array(User))
@@ -134,6 +136,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array(User)] List of user object
     # @return [nil]
     def create_users_with_list_input(user : Array(User))
@@ -142,6 +145,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array(User)] List of user object
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def create_users_with_list_input_with_http_info(user : Array(User))
@@ -248,6 +252,7 @@ module Petstore
     end
 
     # Get user by user name
+    # 
     # @param username [String] The name that needs to be fetched. Use user1 for testing.
     # @return [User]
     def get_user_by_name(username : String)
@@ -256,6 +261,7 @@ module Petstore
     end
 
     # Get user by user name
+    # 
     # @param username [String] The name that needs to be fetched. Use user1 for testing.
     # @return [Array<(User, Integer, Hash)>] User data, response status code and response headers
     def get_user_by_name_with_http_info(username : String)
@@ -305,6 +311,7 @@ module Petstore
     end
 
     # Logs user into the system
+    # 
     # @param username [String] The user name for login
     # @param password [String] The password for login in clear text
     # @return [String]
@@ -314,6 +321,7 @@ module Petstore
     end
 
     # Logs user into the system
+    # 
     # @param username [String] The user name for login
     # @param password [String] The password for login in clear text
     # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
@@ -375,6 +383,7 @@ module Petstore
     end
 
     # Logs out current logged in user session
+    # 
     # @return [nil]
     def logout_user()
       logout_user_with_http_info()
@@ -382,6 +391,7 @@ module Petstore
     end
 
     # Logs out current logged in user session
+    # 
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def logout_user_with_http_info()
       if @api_client.config.debugging

samples/client/petstore/elixir/lib/openapi_petstore/api/fake.ex

@@ -464,6 +464,7 @@ defmodule OpenapiPetstore.Api.Fake do
 
   @doc """
   test inline additionalProperties
+  
 
   ## Parameters
 
@@ -490,6 +491,7 @@ defmodule OpenapiPetstore.Api.Fake do
 
   @doc """
   test json serialization of form data
+  
 
   ## Parameters
 

samples/client/petstore/elixir/lib/openapi_petstore/api/pet.ex

@@ -13,6 +13,7 @@ defmodule OpenapiPetstore.Api.Pet do
 
   @doc """
   Add a new pet to the store
+  
 
   ## Parameters
 
@@ -40,6 +41,7 @@ defmodule OpenapiPetstore.Api.Pet do
 
   @doc """
   Deletes a pet
+  
 
   ## Parameters
 
@@ -155,6 +157,7 @@ defmodule OpenapiPetstore.Api.Pet do
 
   @doc """
   Update an existing pet
+  
 
   ## Parameters
 
@@ -184,6 +187,7 @@ defmodule OpenapiPetstore.Api.Pet do
 
   @doc """
   Updates a pet in the store with form data
+  
 
   ## Parameters
 
@@ -218,6 +222,7 @@ defmodule OpenapiPetstore.Api.Pet do
 
   @doc """
   uploads an image
+  
 
   ## Parameters
 
@@ -251,6 +256,7 @@ defmodule OpenapiPetstore.Api.Pet do
 
   @doc """
   uploads an image (required)
+  
 
   ## Parameters
 

samples/client/petstore/elixir/lib/openapi_petstore/api/store.ex

@@ -93,6 +93,7 @@ defmodule OpenapiPetstore.Api.Store do
 
   @doc """
   Place an order for a pet
+  
 
   ## Parameters
 

samples/client/petstore/elixir/lib/openapi_petstore/api/user.ex

@@ -40,6 +40,7 @@ defmodule OpenapiPetstore.Api.User do
 
   @doc """
   Creates list of users with given input array
+  
 
   ## Parameters
 
@@ -66,6 +67,7 @@ defmodule OpenapiPetstore.Api.User do
 
   @doc """
   Creates list of users with given input array
+  
 
   ## Parameters
 
@@ -119,6 +121,7 @@ defmodule OpenapiPetstore.Api.User do
 
   @doc """
   Get user by user name
+  
 
   ## Parameters
 
@@ -146,6 +149,7 @@ defmodule OpenapiPetstore.Api.User do
 
   @doc """
   Logs user into the system
+  
 
   ## Parameters
 
@@ -175,6 +179,7 @@ defmodule OpenapiPetstore.Api.User do
 
   @doc """
   Logs out current logged in user session
+  
 
   ## Parameters
 

samples/client/petstore/java/feign/api/openapi.yaml

@@ -53,6 +53,7 @@ paths:
       x-accepts: application/json
   /pet:
     post:
+      description: ""
       operationId: addPet
       requestBody:
         $ref: '#/components/requestBodies/Pet'
@@ -71,6 +72,7 @@ paths:
       x-contentType: application/json
       x-accepts: application/json
     put:
+      description: ""
       operationId: updatePet
       requestBody:
         $ref: '#/components/requestBodies/Pet'
@@ -186,6 +188,7 @@ paths:
       x-accepts: application/json
   /pet/{petId}:
     delete:
+      description: ""
       operationId: deletePet
       parameters:
       - explode: false
@@ -251,6 +254,7 @@ paths:
       - pet
       x-accepts: application/json
     post:
+      description: ""
       operationId: updatePetWithForm
       parameters:
       - description: ID of pet that needs to be updated
@@ -291,6 +295,7 @@ paths:
       x-accepts: application/json
   /pet/{petId}/uploadImage:
     post:
+      description: ""
       operationId: uploadFile
       parameters:
       - description: ID of pet to update
@@ -354,6 +359,7 @@ paths:
       x-accepts: application/json
   /store/order:
     post:
+      description: ""
       operationId: placeOrder
       requestBody:
         content:
@@ -457,6 +463,7 @@ paths:
       x-accepts: application/json
   /user/createWithArray:
     post:
+      description: ""
       operationId: createUsersWithArrayInput
       requestBody:
         $ref: '#/components/requestBodies/UserArray'
@@ -470,6 +477,7 @@ paths:
       x-accepts: application/json
   /user/createWithList:
     post:
+      description: ""
       operationId: createUsersWithListInput
       requestBody:
         $ref: '#/components/requestBodies/UserArray'
@@ -483,6 +491,7 @@ paths:
       x-accepts: application/json
   /user/login:
     get:
+      description: ""
       operationId: loginUser
       parameters:
       - description: The user name for login
@@ -534,6 +543,7 @@ paths:
       x-accepts: application/json
   /user/logout:
     get:
+      description: ""
       operationId: logoutUser
       responses:
         default:
@@ -565,6 +575,7 @@ paths:
       - user
       x-accepts: application/json
     get:
+      description: ""
       operationId: getUserByName
       parameters:
       - description: The name that needs to be fetched. Use user1 for testing.
@@ -1047,6 +1058,7 @@ paths:
       x-accepts: '*/*'
   /fake/jsonFormData:
     get:
+      description: ""
       operationId: testJsonFormData
       requestBody:
         $ref: '#/components/requestBodies/inline_object_4'
@@ -1074,6 +1086,7 @@ paths:
       x-accepts: application/json
   /fake/inline-additionalProperties:
     post:
+      description: ""
       operationId: testInlineAdditionalProperties
       requestBody:
         content:
@@ -1248,6 +1261,7 @@ paths:
       x-accepts: application/json
   /fake/{petId}/uploadImageWithRequiredFile:
     post:
+      description: ""
       operationId: uploadFileWithRequiredFile
       parameters:
       - description: ID of pet to update

samples/client/petstore/java/okhttp-gson-nextgen/docs/FakeApi.md

@@ -0,0 +1,892 @@
+# FakeApi
+
+All URIs are relative to *http://petstore.swagger.io:80/v2*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**fakeHealthGet**](FakeApi.md#fakeHealthGet) | **GET** /fake/health | Health check endpoint
+[**fakeOuterBooleanSerialize**](FakeApi.md#fakeOuterBooleanSerialize) | **POST** /fake/outer/boolean | 
+[**fakeOuterCompositeSerialize**](FakeApi.md#fakeOuterCompositeSerialize) | **POST** /fake/outer/composite | 
+[**fakeOuterNumberSerialize**](FakeApi.md#fakeOuterNumberSerialize) | **POST** /fake/outer/number | 
+[**fakeOuterStringSerialize**](FakeApi.md#fakeOuterStringSerialize) | **POST** /fake/outer/string | 
+[**getArrayOfEnums**](FakeApi.md#getArrayOfEnums) | **GET** /fake/array-of-enums | Array of Enums
+[**testBodyWithQueryParams**](FakeApi.md#testBodyWithQueryParams) | **PUT** /fake/body-with-query-params | 
+[**testClientModel**](FakeApi.md#testClientModel) | **PATCH** /fake | To test \"client\" model
+[**testEndpointParameters**](FakeApi.md#testEndpointParameters) | **POST** /fake | Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
+[**testEnumParameters**](FakeApi.md#testEnumParameters) | **GET** /fake | To test enum parameters
+[**testGroupParameters**](FakeApi.md#testGroupParameters) | **DELETE** /fake | Fake endpoint to test group parameters (optional)
+[**testInlineAdditionalProperties**](FakeApi.md#testInlineAdditionalProperties) | **POST** /fake/inline-additionalProperties | test inline additionalProperties
+[**testJsonFormData**](FakeApi.md#testJsonFormData) | **GET** /fake/jsonFormData | test json serialization of form data
+[**testQueryParameterCollectionFormat**](FakeApi.md#testQueryParameterCollectionFormat) | **PUT** /fake/test-query-parameters | 
+
+
+<a name="fakeHealthGet"></a>
+# **fakeHealthGet**
+> HealthCheckResult fakeHealthGet()
+
+Health check endpoint
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    try {
+      HealthCheckResult result = apiInstance.fakeHealthGet();
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+This endpoint does not need any parameter.
+
+### Return type
+
+[**HealthCheckResult**](HealthCheckResult.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | The instance started successfully |  -  |
+
+<a name="fakeOuterBooleanSerialize"></a>
+# **fakeOuterBooleanSerialize**
+> Boolean fakeOuterBooleanSerialize(body)
+
+
+
+Test serialization of outer boolean types
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    Boolean body = true; // Boolean | Input boolean as post body
+    try {
+      Boolean result = apiInstance.fakeOuterBooleanSerialize(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **body** | **Boolean**| Input boolean as post body | [optional]
+
+### Return type
+
+**Boolean**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: */*
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Output boolean |  -  |
+
+<a name="fakeOuterCompositeSerialize"></a>
+# **fakeOuterCompositeSerialize**
+> OuterComposite fakeOuterCompositeSerialize(outerComposite)
+
+
+
+Test serialization of object with outer number type
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    OuterComposite outerComposite = new OuterComposite(); // OuterComposite | Input composite as post body
+    try {
+      OuterComposite result = apiInstance.fakeOuterCompositeSerialize(outerComposite);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **outerComposite** | [**OuterComposite**](OuterComposite.md)| Input composite as post body | [optional]
+
+### Return type
+
+[**OuterComposite**](OuterComposite.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: */*
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Output composite |  -  |
+
+<a name="fakeOuterNumberSerialize"></a>
+# **fakeOuterNumberSerialize**
+> BigDecimal fakeOuterNumberSerialize(body)
+
+
+
+Test serialization of outer number types
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    BigDecimal body = new BigDecimal(78); // BigDecimal | Input number as post body
+    try {
+      BigDecimal result = apiInstance.fakeOuterNumberSerialize(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **body** | **BigDecimal**| Input number as post body | [optional]
+
+### Return type
+
+[**BigDecimal**](BigDecimal.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: */*
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Output number |  -  |
+
+<a name="fakeOuterStringSerialize"></a>
+# **fakeOuterStringSerialize**
+> String fakeOuterStringSerialize(body)
+
+
+
+Test serialization of outer string types
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    String body = "body_example"; // String | Input string as post body
+    try {
+      String result = apiInstance.fakeOuterStringSerialize(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **body** | **String**| Input string as post body | [optional]
+
+### Return type
+
+**String**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: */*
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Output string |  -  |
+
+<a name="getArrayOfEnums"></a>
+# **getArrayOfEnums**
+> List&lt;OuterEnum&gt; getArrayOfEnums()
+
+Array of Enums
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    try {
+      List<OuterEnum> result = apiInstance.getArrayOfEnums();
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+This endpoint does not need any parameter.
+
+### Return type
+
+[**List&lt;OuterEnum&gt;**](OuterEnum.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Got named array of enums |  -  |
+
+<a name="testBodyWithQueryParams"></a>
+# **testBodyWithQueryParams**
+> testBodyWithQueryParams(query, user)
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    String query = "query_example"; // String | 
+    User user = new User(); // User | 
+    try {
+      apiInstance.testBodyWithQueryParams(query, user);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **query** | **String**|  |
+ **user** | [**User**](User.md)|  |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Success |  -  |
+
+<a name="testClientModel"></a>
+# **testClientModel**
+> Client testClientModel(client)
+
+To test \&quot;client\&quot; model
+
+To test \&quot;client\&quot; model
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    Client client = new Client(); // Client | client model
+    try {
+      Client result = apiInstance.testClientModel(client);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **client** | [**Client**](Client.md)| client model |
+
+### Return type
+
+[**Client**](Client.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+
+<a name="testEndpointParameters"></a>
+# **testEndpointParameters**
+> testEndpointParameters(number, _double, patternWithoutDelimiter, _byte, integer, int32, int64, _float, string, binary, date, dateTime, password, paramCallback)
+
+Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
+
+Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure HTTP basic authorization: http_basic_test
+    HttpBasicAuth http_basic_test = (HttpBasicAuth) defaultClient.getAuthentication("http_basic_test");
+    http_basic_test.setUsername("YOUR USERNAME");
+    http_basic_test.setPassword("YOUR PASSWORD");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    BigDecimal number = new BigDecimal(78); // BigDecimal | None
+    Double _double = 3.4D; // Double | None
+    String patternWithoutDelimiter = "patternWithoutDelimiter_example"; // String | None
+    byte[] _byte = null; // byte[] | None
+    Integer integer = 56; // Integer | None
+    Integer int32 = 56; // Integer | None
+    Long int64 = 56L; // Long | None
+    Float _float = 3.4F; // Float | None
+    String string = "string_example"; // String | None
+    File binary = new File("/path/to/file"); // File | None
+    LocalDate date = LocalDate.now(); // LocalDate | None
+    OffsetDateTime dateTime = OffsetDateTime.parse("OffsetDateTime.parse("2010-02-01T09:20:10.111110Z[UTC]", java.time.format.DateTimeFormatter.ISO_ZONED_DATE_TIME.withZone(java.time.ZoneId.systemDefault()))"); // OffsetDateTime | None
+    String password = "password_example"; // String | None
+    String paramCallback = "paramCallback_example"; // String | None
+    try {
+      apiInstance.testEndpointParameters(number, _double, patternWithoutDelimiter, _byte, integer, int32, int64, _float, string, binary, date, dateTime, password, paramCallback);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **number** | **BigDecimal**| None |
+ **_double** | **Double**| None |
+ **patternWithoutDelimiter** | **String**| None |
+ **_byte** | **byte[]**| None |
+ **integer** | **Integer**| None | [optional]
+ **int32** | **Integer**| None | [optional]
+ **int64** | **Long**| None | [optional]
+ **_float** | **Float**| None | [optional]
+ **string** | **String**| None | [optional]
+ **binary** | **File**| None | [optional]
+ **date** | **LocalDate**| None | [optional]
+ **dateTime** | **OffsetDateTime**| None | [optional] [default to OffsetDateTime.parse(&quot;2010-02-01T09:20:10.111110Z[UTC]&quot;, java.time.format.DateTimeFormatter.ISO_ZONED_DATE_TIME.withZone(java.time.ZoneId.systemDefault()))]
+ **password** | **String**| None | [optional]
+ **paramCallback** | **String**| None | [optional]
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+[http_basic_test](../README.md#http_basic_test)
+
+### HTTP request headers
+
+ - **Content-Type**: application/x-www-form-urlencoded
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Invalid username supplied |  -  |
+**404** | User not found |  -  |
+
+<a name="testEnumParameters"></a>
+# **testEnumParameters**
+> testEnumParameters(enumHeaderStringArray, enumHeaderString, enumQueryStringArray, enumQueryString, enumQueryInteger, enumQueryDouble, enumFormStringArray, enumFormString)
+
+To test enum parameters
+
+To test enum parameters
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    List<String> enumHeaderStringArray = Arrays.asList("$"); // List<String> | Header parameter enum test (string array)
+    String enumHeaderString = "_abc"; // String | Header parameter enum test (string)
+    List<String> enumQueryStringArray = Arrays.asList("$"); // List<String> | Query parameter enum test (string array)
+    String enumQueryString = "_abc"; // String | Query parameter enum test (string)
+    Integer enumQueryInteger = 1; // Integer | Query parameter enum test (double)
+    Double enumQueryDouble = 1.1D; // Double | Query parameter enum test (double)
+    List<String> enumFormStringArray = Arrays.asList("$"); // List<String> | Form parameter enum test (string array)
+    String enumFormString = "_abc"; // String | Form parameter enum test (string)
+    try {
+      apiInstance.testEnumParameters(enumHeaderStringArray, enumHeaderString, enumQueryStringArray, enumQueryString, enumQueryInteger, enumQueryDouble, enumFormStringArray, enumFormString);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **enumHeaderStringArray** | [**List&lt;String&gt;**](String.md)| Header parameter enum test (string array) | [optional] [enum: >, $]
+ **enumHeaderString** | **String**| Header parameter enum test (string) | [optional] [default to -efg] [enum: _abc, -efg, (xyz)]
+ **enumQueryStringArray** | [**List&lt;String&gt;**](String.md)| Query parameter enum test (string array) | [optional] [enum: >, $]
+ **enumQueryString** | **String**| Query parameter enum test (string) | [optional] [default to -efg] [enum: _abc, -efg, (xyz)]
+ **enumQueryInteger** | **Integer**| Query parameter enum test (double) | [optional] [enum: 1, -2]
+ **enumQueryDouble** | **Double**| Query parameter enum test (double) | [optional] [enum: 1.1, -1.2]
+ **enumFormStringArray** | [**List&lt;String&gt;**](String.md)| Form parameter enum test (string array) | [optional] [enum: >, $]
+ **enumFormString** | **String**| Form parameter enum test (string) | [optional] [default to -efg] [enum: _abc, -efg, (xyz)]
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/x-www-form-urlencoded
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Invalid request |  -  |
+**404** | Not found |  -  |
+
+<a name="testGroupParameters"></a>
+# **testGroupParameters**
+> testGroupParameters(requiredStringGroup, requiredBooleanGroup, requiredInt64Group).stringGroup(stringGroup).booleanGroup(booleanGroup).int64Group(int64Group).execute();
+
+Fake endpoint to test group parameters (optional)
+
+Fake endpoint to test group parameters (optional)
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure HTTP bearer authorization: bearer_test
+    HttpBearerAuth bearer_test = (HttpBearerAuth) defaultClient.getAuthentication("bearer_test");
+    bearer_test.setBearerToken("BEARER TOKEN");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    Integer requiredStringGroup = 56; // Integer | Required String in group parameters
+    Boolean requiredBooleanGroup = true; // Boolean | Required Boolean in group parameters
+    Long requiredInt64Group = 56L; // Long | Required Integer in group parameters
+    Integer stringGroup = 56; // Integer | String in group parameters
+    Boolean booleanGroup = true; // Boolean | Boolean in group parameters
+    Long int64Group = 56L; // Long | Integer in group parameters
+    try {
+      apiInstance.testGroupParameters(requiredStringGroup, requiredBooleanGroup, requiredInt64Group)
+            .stringGroup(stringGroup)
+            .booleanGroup(booleanGroup)
+            .int64Group(int64Group)
+            .execute();
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **requiredStringGroup** | **Integer**| Required String in group parameters |
+ **requiredBooleanGroup** | **Boolean**| Required Boolean in group parameters |
+ **requiredInt64Group** | **Long**| Required Integer in group parameters |
+ **stringGroup** | **Integer**| String in group parameters | [optional]
+ **booleanGroup** | **Boolean**| Boolean in group parameters | [optional]
+ **int64Group** | **Long**| Integer in group parameters | [optional]
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+[bearer_test](../README.md#bearer_test)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Someting wrong |  -  |
+
+<a name="testInlineAdditionalProperties"></a>
+# **testInlineAdditionalProperties**
+> testInlineAdditionalProperties(requestBody)
+
+test inline additionalProperties
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    Map<String, String> requestBody = new HashMap(); // Map<String, String> | request body
+    try {
+      apiInstance.testInlineAdditionalProperties(requestBody);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **requestBody** | [**Map&lt;String, String&gt;**](String.md)| request body |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+
+<a name="testJsonFormData"></a>
+# **testJsonFormData**
+> testJsonFormData(param, param2)
+
+test json serialization of form data
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    String param = "param_example"; // String | field1
+    String param2 = "param2_example"; // String | field2
+    try {
+      apiInstance.testJsonFormData(param, param2);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **param** | **String**| field1 |
+ **param2** | **String**| field2 |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/x-www-form-urlencoded
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+
+<a name="testQueryParameterCollectionFormat"></a>
+# **testQueryParameterCollectionFormat**
+> testQueryParameterCollectionFormat(pipe, ioutil, http, url, context)
+
+
+
+To test the collection format in query parameters
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.FakeApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    FakeApi apiInstance = new FakeApi(defaultClient);
+    List<String> pipe = Arrays.asList(); // List<String> | 
+    List<String> ioutil = Arrays.asList(); // List<String> | 
+    List<String> http = Arrays.asList(); // List<String> | 
+    List<String> url = Arrays.asList(); // List<String> | 
+    List<String> context = Arrays.asList(); // List<String> | 
+    try {
+      apiInstance.testQueryParameterCollectionFormat(pipe, ioutil, http, url, context);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **pipe** | [**List&lt;String&gt;**](String.md)|  |
+ **ioutil** | [**List&lt;String&gt;**](String.md)|  |
+ **http** | [**List&lt;String&gt;**](String.md)|  |
+ **url** | [**List&lt;String&gt;**](String.md)|  |
+ **context** | [**List&lt;String&gt;**](String.md)|  |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | Success |  -  |
+

samples/client/petstore/java/okhttp-gson-nextgen/docs/PetApi.md

@@ -0,0 +1,606 @@
+# PetApi
+
+All URIs are relative to *http://petstore.swagger.io:80/v2*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**addPet**](PetApi.md#addPet) | **POST** /pet | Add a new pet to the store
+[**deletePet**](PetApi.md#deletePet) | **DELETE** /pet/{petId} | Deletes a pet
+[**findPetsByStatus**](PetApi.md#findPetsByStatus) | **GET** /pet/findByStatus | Finds Pets by status
+[**findPetsByTags**](PetApi.md#findPetsByTags) | **GET** /pet/findByTags | Finds Pets by tags
+[**getPetById**](PetApi.md#getPetById) | **GET** /pet/{petId} | Find pet by ID
+[**updatePet**](PetApi.md#updatePet) | **PUT** /pet | Update an existing pet
+[**updatePetWithForm**](PetApi.md#updatePetWithForm) | **POST** /pet/{petId} | Updates a pet in the store with form data
+[**uploadFile**](PetApi.md#uploadFile) | **POST** /pet/{petId}/uploadImage | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)
+
+
+<a name="addPet"></a>
+# **addPet**
+> addPet(pet)
+
+Add a new pet to the store
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Pet pet = new Pet(); // Pet | Pet object that needs to be added to the store
+    try {
+      apiInstance.addPet(pet);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **pet** | [**Pet**](Pet.md)| Pet object that needs to be added to the store |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+[http_signature_test](../README.md#http_signature_test), [petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json, application/xml
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**405** | Invalid input |  -  |
+
+<a name="deletePet"></a>
+# **deletePet**
+> deletePet(petId, apiKey)
+
+Deletes a pet
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Long petId = 56L; // Long | Pet id to delete
+    String apiKey = "apiKey_example"; // String | 
+    try {
+      apiInstance.deletePet(petId, apiKey);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **petId** | **Long**| Pet id to delete |
+ **apiKey** | **String**|  | [optional]
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+[petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Invalid pet value |  -  |
+
+<a name="findPetsByStatus"></a>
+# **findPetsByStatus**
+> List&lt;Pet&gt; findPetsByStatus(status)
+
+Finds Pets by status
+
+Multiple status values can be provided with comma separated strings
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    List<String> status = Arrays.asList("available"); // List<String> | Status values that need to be considered for filter
+    try {
+      List<Pet> result = apiInstance.findPetsByStatus(status);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **status** | [**List&lt;String&gt;**](String.md)| Status values that need to be considered for filter | [enum: available, pending, sold]
+
+### Return type
+
+[**List&lt;Pet&gt;**](Pet.md)
+
+### Authorization
+
+[http_signature_test](../README.md#http_signature_test), [petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/xml, application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+**400** | Invalid status value |  -  |
+
+<a name="findPetsByTags"></a>
+# **findPetsByTags**
+> List&lt;Pet&gt; findPetsByTags(tags)
+
+Finds Pets by tags
+
+Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    List<String> tags = Arrays.asList(); // List<String> | Tags to filter by
+    try {
+      List<Pet> result = apiInstance.findPetsByTags(tags);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **tags** | [**List&lt;String&gt;**](String.md)| Tags to filter by |
+
+### Return type
+
+[**List&lt;Pet&gt;**](Pet.md)
+
+### Authorization
+
+[http_signature_test](../README.md#http_signature_test), [petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/xml, application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+**400** | Invalid tag value |  -  |
+
+<a name="getPetById"></a>
+# **getPetById**
+> Pet getPetById(petId)
+
+Find pet by ID
+
+Returns a single pet
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure API key authorization: api_key
+    ApiKeyAuth api_key = (ApiKeyAuth) defaultClient.getAuthentication("api_key");
+    api_key.setApiKey("YOUR API KEY");
+    // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
+    //api_key.setApiKeyPrefix("Token");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Long petId = 56L; // Long | ID of pet to return
+    try {
+      Pet result = apiInstance.getPetById(petId);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **petId** | **Long**| ID of pet to return |
+
+### Return type
+
+[**Pet**](Pet.md)
+
+### Authorization
+
+[api_key](../README.md#api_key)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/xml, application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+**400** | Invalid ID supplied |  -  |
+**404** | Pet not found |  -  |
+
+<a name="updatePet"></a>
+# **updatePet**
+> updatePet(pet)
+
+Update an existing pet
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Pet pet = new Pet(); // Pet | Pet object that needs to be added to the store
+    try {
+      apiInstance.updatePet(pet);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **pet** | [**Pet**](Pet.md)| Pet object that needs to be added to the store |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+[http_signature_test](../README.md#http_signature_test), [petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json, application/xml
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Invalid ID supplied |  -  |
+**404** | Pet not found |  -  |
+**405** | Validation exception |  -  |
+
+<a name="updatePetWithForm"></a>
+# **updatePetWithForm**
+> updatePetWithForm(petId, name, status)
+
+Updates a pet in the store with form data
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Long petId = 56L; // Long | ID of pet that needs to be updated
+    String name = "name_example"; // String | Updated name of the pet
+    String status = "status_example"; // String | Updated status of the pet
+    try {
+      apiInstance.updatePetWithForm(petId, name, status);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **petId** | **Long**| ID of pet that needs to be updated |
+ **name** | **String**| Updated name of the pet | [optional]
+ **status** | **String**| Updated status of the pet | [optional]
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+[petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/x-www-form-urlencoded
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**405** | Invalid input |  -  |
+
+<a name="uploadFile"></a>
+# **uploadFile**
+> ModelApiResponse uploadFile(petId, additionalMetadata, _file)
+
+uploads an image
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Long petId = 56L; // Long | ID of pet to update
+    String additionalMetadata = "additionalMetadata_example"; // String | Additional data to pass to server
+    File _file = new File("/path/to/file"); // File | file to upload
+    try {
+      ModelApiResponse result = apiInstance.uploadFile(petId, additionalMetadata, _file);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **petId** | **Long**| ID of pet to update |
+ **additionalMetadata** | **String**| Additional data to pass to server | [optional]
+ **_file** | **File**| file to upload | [optional]
+
+### Return type
+
+[**ModelApiResponse**](ModelApiResponse.md)
+
+### Authorization
+
+[petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: multipart/form-data
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+
+<a name="uploadFileWithRequiredFile"></a>
+# **uploadFileWithRequiredFile**
+> ModelApiResponse uploadFileWithRequiredFile(petId, requiredFile, additionalMetadata)
+
+uploads an image (required)
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.PetApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure OAuth2 access token for authorization: petstore_auth
+    OAuth petstore_auth = (OAuth) defaultClient.getAuthentication("petstore_auth");
+    petstore_auth.setAccessToken("YOUR ACCESS TOKEN");
+
+    PetApi apiInstance = new PetApi(defaultClient);
+    Long petId = 56L; // Long | ID of pet to update
+    File requiredFile = new File("/path/to/file"); // File | file to upload
+    String additionalMetadata = "additionalMetadata_example"; // String | Additional data to pass to server
+    try {
+      ModelApiResponse result = apiInstance.uploadFileWithRequiredFile(petId, requiredFile, additionalMetadata);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **petId** | **Long**| ID of pet to update |
+ **requiredFile** | **File**| file to upload |
+ **additionalMetadata** | **String**| Additional data to pass to server | [optional]
+
+### Return type
+
+[**ModelApiResponse**](ModelApiResponse.md)
+
+### Authorization
+
+[petstore_auth](../README.md#petstore_auth)
+
+### HTTP request headers
+
+ - **Content-Type**: multipart/form-data
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+

samples/client/petstore/java/okhttp-gson-nextgen/docs/StoreApi.md

@@ -0,0 +1,250 @@
+# StoreApi
+
+All URIs are relative to *http://petstore.swagger.io:80/v2*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**deleteOrder**](StoreApi.md#deleteOrder) | **DELETE** /store/order/{order_id} | Delete purchase order by ID
+[**getInventory**](StoreApi.md#getInventory) | **GET** /store/inventory | Returns pet inventories by status
+[**getOrderById**](StoreApi.md#getOrderById) | **GET** /store/order/{order_id} | Find purchase order by ID
+[**placeOrder**](StoreApi.md#placeOrder) | **POST** /store/order | Place an order for a pet
+
+
+<a name="deleteOrder"></a>
+# **deleteOrder**
+> deleteOrder(orderId)
+
+Delete purchase order by ID
+
+For valid response try integer IDs with value &lt; 1000. Anything above 1000 or nonintegers will generate API errors
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.StoreApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    StoreApi apiInstance = new StoreApi(defaultClient);
+    String orderId = "orderId_example"; // String | ID of the order that needs to be deleted
+    try {
+      apiInstance.deleteOrder(orderId);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **orderId** | **String**| ID of the order that needs to be deleted |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Invalid ID supplied |  -  |
+**404** | Order not found |  -  |
+
+<a name="getInventory"></a>
+# **getInventory**
+> Map&lt;String, Integer&gt; getInventory()
+
+Returns pet inventories by status
+
+Returns a map of status codes to quantities
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.auth.*;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.StoreApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+    
+    // Configure API key authorization: api_key
+    ApiKeyAuth api_key = (ApiKeyAuth) defaultClient.getAuthentication("api_key");
+    api_key.setApiKey("YOUR API KEY");
+    // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
+    //api_key.setApiKeyPrefix("Token");
+
+    StoreApi apiInstance = new StoreApi(defaultClient);
+    try {
+      Map<String, Integer> result = apiInstance.getInventory();
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+This endpoint does not need any parameter.
+
+### Return type
+
+**Map&lt;String, Integer&gt;**
+
+### Authorization
+
+[api_key](../README.md#api_key)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+
+<a name="getOrderById"></a>
+# **getOrderById**
+> Order getOrderById(orderId)
+
+Find purchase order by ID
+
+For valid response try integer IDs with value &lt;&#x3D; 5 or &gt; 10. Other values will generated exceptions
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.StoreApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    StoreApi apiInstance = new StoreApi(defaultClient);
+    Long orderId = 56L; // Long | ID of pet that needs to be fetched
+    try {
+      Order result = apiInstance.getOrderById(orderId);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **orderId** | **Long**| ID of pet that needs to be fetched |
+
+### Return type
+
+[**Order**](Order.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/xml, application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+**400** | Invalid ID supplied |  -  |
+**404** | Order not found |  -  |
+
+<a name="placeOrder"></a>
+# **placeOrder**
+> Order placeOrder(order)
+
+Place an order for a pet
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.StoreApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    StoreApi apiInstance = new StoreApi(defaultClient);
+    Order order = new Order(); // Order | order placed for purchasing the pet
+    try {
+      Order result = apiInstance.placeOrder(order);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **order** | [**Order**](Order.md)| order placed for purchasing the pet |
+
+### Return type
+
+[**Order**](Order.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/xml, application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+**400** | Invalid Order |  -  |
+

samples/client/petstore/java/okhttp-gson-nextgen/docs/UserApi.md

@@ -0,0 +1,479 @@
+# UserApi
+
+All URIs are relative to *http://petstore.swagger.io:80/v2*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**createUser**](UserApi.md#createUser) | **POST** /user | Create user
+[**createUsersWithArrayInput**](UserApi.md#createUsersWithArrayInput) | **POST** /user/createWithArray | Creates list of users with given input array
+[**createUsersWithListInput**](UserApi.md#createUsersWithListInput) | **POST** /user/createWithList | Creates list of users with given input array
+[**deleteUser**](UserApi.md#deleteUser) | **DELETE** /user/{username} | Delete user
+[**getUserByName**](UserApi.md#getUserByName) | **GET** /user/{username} | Get user by user name
+[**loginUser**](UserApi.md#loginUser) | **GET** /user/login | Logs user into the system
+[**logoutUser**](UserApi.md#logoutUser) | **GET** /user/logout | Logs out current logged in user session
+[**updateUser**](UserApi.md#updateUser) | **PUT** /user/{username} | Updated user
+
+
+<a name="createUser"></a>
+# **createUser**
+> createUser(user)
+
+Create user
+
+This can only be done by the logged in user.
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    User user = new User(); // User | Created user object
+    try {
+      apiInstance.createUser(user);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **user** | [**User**](User.md)| Created user object |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**0** | successful operation |  -  |
+
+<a name="createUsersWithArrayInput"></a>
+# **createUsersWithArrayInput**
+> createUsersWithArrayInput(user)
+
+Creates list of users with given input array
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    List<User> user = Arrays.asList(); // List<User> | List of user object
+    try {
+      apiInstance.createUsersWithArrayInput(user);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **user** | [**List&lt;User&gt;**](User.md)| List of user object |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**0** | successful operation |  -  |
+
+<a name="createUsersWithListInput"></a>
+# **createUsersWithListInput**
+> createUsersWithListInput(user)
+
+Creates list of users with given input array
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    List<User> user = Arrays.asList(); // List<User> | List of user object
+    try {
+      apiInstance.createUsersWithListInput(user);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **user** | [**List&lt;User&gt;**](User.md)| List of user object |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**0** | successful operation |  -  |
+
+<a name="deleteUser"></a>
+# **deleteUser**
+> deleteUser(username)
+
+Delete user
+
+This can only be done by the logged in user.
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    String username = "username_example"; // String | The name that needs to be deleted
+    try {
+      apiInstance.deleteUser(username);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **username** | **String**| The name that needs to be deleted |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Invalid username supplied |  -  |
+**404** | User not found |  -  |
+
+<a name="getUserByName"></a>
+# **getUserByName**
+> User getUserByName(username)
+
+Get user by user name
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    String username = "username_example"; // String | The name that needs to be fetched. Use user1 for testing.
+    try {
+      User result = apiInstance.getUserByName(username);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **username** | **String**| The name that needs to be fetched. Use user1 for testing. |
+
+### Return type
+
+[**User**](User.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/xml, application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  -  |
+**400** | Invalid username supplied |  -  |
+**404** | User not found |  -  |
+
+<a name="loginUser"></a>
+# **loginUser**
+> String loginUser(username, password)
+
+Logs user into the system
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    String username = "username_example"; // String | The user name for login
+    String password = "password_example"; // String | The password for login in clear text
+    try {
+      String result = apiInstance.loginUser(username, password);
+      System.out.println(result);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **username** | **String**| The user name for login |
+ **password** | **String**| The password for login in clear text |
+
+### Return type
+
+**String**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/xml, application/json
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | successful operation |  * X-Rate-Limit - calls per hour allowed by the user <br>  * X-Expires-After - date in UTC when token expires <br>  |
+**400** | Invalid username/password supplied |  -  |
+
+<a name="logoutUser"></a>
+# **logoutUser**
+> logoutUser()
+
+Logs out current logged in user session
+
+
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    try {
+      apiInstance.logoutUser();
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+This endpoint does not need any parameter.
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**0** | successful operation |  -  |
+
+<a name="updateUser"></a>
+# **updateUser**
+> updateUser(username, user)
+
+Updated user
+
+This can only be done by the logged in user.
+
+### Example
+```java
+// Import classes:
+import org.openapitools.client.ApiClient;
+import org.openapitools.client.ApiException;
+import org.openapitools.client.Configuration;
+import org.openapitools.client.models.*;
+import org.openapitools.client.api.UserApi;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = Configuration.getDefaultApiClient();
+    defaultClient.setBasePath("http://petstore.swagger.io:80/v2");
+
+    UserApi apiInstance = new UserApi(defaultClient);
+    String username = "username_example"; // String | name that need to be deleted
+    User user = new User(); // User | Updated user object
+    try {
+      apiInstance.updateUser(username, user);
+    } catch (ApiException e) {
+
+    }
+  }
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **username** | **String**| name that need to be deleted |
+ **user** | [**User**](User.md)| Updated user object |
+
+### Return type
+
+null (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**400** | Invalid user supplied |  -  |
+**404** | User not found |  -  |
+

samples/client/petstore/java/okhttp-gson/api/openapi.yaml

@@ -53,6 +53,7 @@ paths:
       x-accepts: application/json
   /pet:
     post:
+      description: ""
       operationId: addPet
       requestBody:
         $ref: '#/components/requestBodies/Pet'
@@ -70,6 +71,7 @@ paths:
       x-contentType: application/json
       x-accepts: application/json
     put:
+      description: ""
       operationId: updatePet
       requestBody:
         $ref: '#/components/requestBodies/Pet'
@@ -183,6 +185,7 @@ paths:
       x-accepts: application/json
   /pet/{petId}:
     delete:
+      description: ""
       operationId: deletePet
       parameters:
       - explode: false
@@ -246,6 +249,7 @@ paths:
       - pet
       x-accepts: application/json
     post:
+      description: ""
       operationId: updatePetWithForm
       parameters:
       - description: ID of pet that needs to be updated
@@ -284,6 +288,7 @@ paths:
       x-accepts: application/json
   /pet/{petId}/uploadImage:
     post:
+      description: ""
       operationId: uploadFile
       parameters:
       - description: ID of pet to update
@@ -347,6 +352,7 @@ paths:
       x-accepts: application/json
   /store/order:
     post:
+      description: ""
       operationId: placeOrder
       requestBody:
         content:
@@ -450,6 +456,7 @@ paths:
       x-accepts: application/json
   /user/createWithArray:
     post:
+      description: ""
       operationId: createUsersWithArrayInput
       requestBody:
         $ref: '#/components/requestBodies/UserArray'
@@ -463,6 +470,7 @@ paths:
       x-accepts: application/json
   /user/createWithList:
     post:
+      description: ""
       operationId: createUsersWithListInput
       requestBody:
         $ref: '#/components/requestBodies/UserArray'
@@ -476,6 +484,7 @@ paths:
       x-accepts: application/json
   /user/login:
     get:
+      description: ""
       operationId: loginUser
       parameters:
       - description: The user name for login
@@ -527,6 +536,7 @@ paths:
       x-accepts: application/json
   /user/logout:
     get:
+      description: ""
       operationId: logoutUser
       responses:
         default:
@@ -558,6 +568,7 @@ paths:
       - user
       x-accepts: application/json
     get:
+      description: ""
       operationId: getUserByName
       parameters:
       - description: The name that needs to be fetched. Use user1 for testing.
@@ -1020,6 +1031,7 @@ paths:
       x-accepts: '*/*'
   /fake/jsonFormData:
     get:
+      description: ""
       operationId: testJsonFormData
       requestBody:
         $ref: '#/components/requestBodies/inline_object_4'
@@ -1047,6 +1059,7 @@ paths:
       x-accepts: application/json
   /fake/inline-additionalProperties:
     post:
+      description: ""
       operationId: testInlineAdditionalProperties
       requestBody:
         content:
@@ -1183,6 +1196,7 @@ paths:
       x-accepts: application/json
   /fake/{petId}/uploadImageWithRequiredFile:
     post:
+      description: ""
       operationId: uploadFileWithRequiredFile
       parameters:
       - description: ID of pet to update

samples/client/petstore/java/okhttp-gson/docs/FakeApi.md

@@ -821,6 +821,8 @@ null (empty response body)
 
 test inline additionalProperties
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -880,6 +882,8 @@ No authorization required
 
 test json serialization of form data
 
+
+
 ### Example
 ```java
 // Import classes:

samples/client/petstore/java/okhttp-gson/docs/PetApi.md

@@ -21,6 +21,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -86,6 +88,8 @@ null (empty response body)
 
 Deletes a pet
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -361,6 +365,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -428,6 +434,8 @@ null (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -496,6 +504,8 @@ null (empty response body)
 
 uploads an image
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -565,6 +575,8 @@ Name | Type | Description  | Notes
 
 uploads an image (required)
 
+
+
 ### Example
 ```java
 // Import classes:

samples/client/petstore/java/okhttp-gson/docs/StoreApi.md

@@ -207,6 +207,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 ```java
 // Import classes:

samples/client/petstore/java/okhttp-gson/docs/UserApi.md

@@ -81,6 +81,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -140,6 +142,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -261,6 +265,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -323,6 +329,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 ```java
 // Import classes:
@@ -386,6 +394,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 ```java
 // Import classes:

samples/client/petstore/java/webclient-nulable-arrays/api/openapi.yaml

@@ -8,6 +8,8 @@ servers:
 paths:
   /nullable-array-test:
     get:
+      description: ""
+      operationId: ""
       parameters: []
       responses:
         "200":
@@ -17,6 +19,8 @@ paths:
                 items:
                   $ref: '#/components/schemas/ByteArrayObject'
                 type: array
+          description: ""
+      summary: ""
       x-accepts: application/json
 components:
   schemas:

samples/client/petstore/java/webclient-nulable-arrays/docs/DefaultApi.md

@@ -14,6 +14,8 @@ Method | HTTP request | Description
 
 
 
+
+
 ### Example
 
 ```java

samples/client/petstore/java/webclient-nulable-arrays/src/main/java/org/openapitools/client/api/DefaultApi.java

@@ -49,7 +49,7 @@ public class DefaultApi {
     /**
      * 
      * 
-     * <p><b>200</b>
+     * <p><b>200</b> - 
      * @return List&lt;ByteArrayObject&gt;
      * @throws WebClientResponseException if an error occurs while attempting to invoke the API
      */
@@ -79,7 +79,7 @@ public class DefaultApi {
     /**
      * 
      * 
-     * <p><b>200</b>
+     * <p><b>200</b> - 
      * @return List&lt;ByteArrayObject&gt;
      * @throws WebClientResponseException if an error occurs while attempting to invoke the API
      */

samples/client/petstore/java/webclient/api/openapi.yaml

@@ -53,6 +53,7 @@ paths:
       x-accepts: application/json
   /pet:
     post:
+      description: ""
       operationId: addPet
       requestBody:
         $ref: '#/components/requestBodies/Pet'
@@ -71,6 +72,7 @@ paths:
       x-contentType: application/json
       x-accepts: application/json
     put:
+      description: ""
       operationId: updatePet
       requestBody:
         $ref: '#/components/requestBodies/Pet'
@@ -186,6 +188,7 @@ paths:
       x-accepts: application/json
   /pet/{petId}:
     delete:
+      description: ""
       operationId: deletePet
       parameters:
       - explode: false
@@ -251,6 +254,7 @@ paths:
       - pet
       x-accepts: application/json
     post:
+      description: ""
       operationId: updatePetWithForm
       parameters:
       - description: ID of pet that needs to be updated
@@ -291,6 +295,7 @@ paths:
       x-accepts: application/json
   /pet/{petId}/uploadImage:
     post:
+      description: ""
       operationId: uploadFile
       parameters:
       - description: ID of pet to update
@@ -354,6 +359,7 @@ paths:
       x-accepts: application/json
   /store/order:
     post:
+      description: ""
       operationId: placeOrder
       requestBody:
         content:
@@ -457,6 +463,7 @@ paths:
       x-accepts: application/json
   /user/createWithArray:
     post:
+      description: ""
       operationId: createUsersWithArrayInput
       requestBody:
         $ref: '#/components/requestBodies/UserArray'
@@ -470,6 +477,7 @@ paths:
       x-accepts: application/json
   /user/createWithList:
     post:
+      description: ""
       operationId: createUsersWithListInput
       requestBody:
         $ref: '#/components/requestBodies/UserArray'
@@ -483,6 +491,7 @@ paths:
       x-accepts: application/json
   /user/login:
     get:
+      description: ""
       operationId: loginUser
       parameters:
       - description: The user name for login
@@ -534,6 +543,7 @@ paths:
       x-accepts: application/json
   /user/logout:
     get:
+      description: ""
       operationId: logoutUser
       responses:
         default:
@@ -565,6 +575,7 @@ paths:
       - user
       x-accepts: application/json
     get:
+      description: ""
       operationId: getUserByName
       parameters:
       - description: The name that needs to be fetched. Use user1 for testing.
@@ -1047,6 +1058,7 @@ paths:
       x-accepts: '*/*'
   /fake/jsonFormData:
     get:
+      description: ""
       operationId: testJsonFormData
       requestBody:
         $ref: '#/components/requestBodies/inline_object_4'
@@ -1074,6 +1086,7 @@ paths:
       x-accepts: application/json
   /fake/inline-additionalProperties:
     post:
+      description: ""
       operationId: testInlineAdditionalProperties
       requestBody:
         content:
@@ -1248,6 +1261,7 @@ paths:
       x-accepts: application/json
   /fake/{petId}/uploadImageWithRequiredFile:
     post:
+      description: ""
       operationId: uploadFileWithRequiredFile
       parameters:
       - description: ID of pet to update

samples/client/petstore/java/webclient/docs/FakeApi.md

@@ -1008,6 +1008,8 @@ null (empty response body)
 
 test inline additionalProperties
 
+
+
 ### Example
 
 ```java
@@ -1071,6 +1073,8 @@ No authorization required
 
 test json serialization of form data
 
+
+
 ### Example
 
 ```java

samples/client/petstore/java/webclient/docs/PetApi.md

@@ -22,6 +22,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 
 ```java
@@ -91,6 +93,8 @@ null (empty response body)
 
 Deletes a pet
 
+
+
 ### Example
 
 ```java
@@ -381,6 +385,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 
 ```java
@@ -452,6 +458,8 @@ null (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 
 ```java
@@ -525,6 +533,8 @@ null (empty response body)
 
 uploads an image
 
+
+
 ### Example
 
 ```java
@@ -598,6 +608,8 @@ Name | Type | Description  | Notes
 
 uploads an image (required)
 
+
+
 ### Example
 
 ```java

samples/client/petstore/java/webclient/docs/StoreApi.md

@@ -220,6 +220,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 
 ```java

samples/client/petstore/java/webclient/docs/UserApi.md

@@ -86,6 +86,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```java
@@ -149,6 +151,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```java
@@ -278,6 +282,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Example
 
 ```java
@@ -344,6 +350,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 
 ```java
@@ -411,6 +419,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 
 ```java

samples/client/petstore/javascript-es6/docs/FakeApi.md

@@ -732,6 +732,8 @@ null (empty response body)
 
 test inline additionalProperties
 
+
+
 ### Example
 
 ```javascript
@@ -775,6 +777,8 @@ No authorization required
 
 test json serialization of form data
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-es6/docs/PetApi.md

@@ -22,6 +22,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 
 ```javascript
@@ -69,6 +71,8 @@ null (empty response body)
 
 Deletes a pet
 
+
+
 ### Example
 
 ```javascript
@@ -269,6 +273,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 
 ```javascript
@@ -316,6 +322,8 @@ null (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 
 ```javascript
@@ -369,6 +377,8 @@ null (empty response body)
 
 uploads an image
 
+
+
 ### Example
 
 ```javascript
@@ -422,6 +432,8 @@ Name | Type | Description  | Notes
 
 uploads an image (required)
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-es6/docs/StoreApi.md

@@ -154,6 +154,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-es6/docs/UserApi.md

@@ -66,6 +66,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```javascript
@@ -109,6 +111,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```javascript
@@ -197,6 +201,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Example
 
 ```javascript
@@ -240,6 +246,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 
 ```javascript
@@ -285,6 +293,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-es6/src/api/FakeApi.js

@@ -694,6 +694,7 @@ export default class FakeApi {
 
     /**
      * test inline additionalProperties
+     * 
      * @param {Object.<String, {String: String}>} requestBody request body
      * @param {module:api/FakeApi~testInlineAdditionalPropertiesCallback} callback The callback function, accepting three arguments: error, data, response
      */
@@ -734,6 +735,7 @@ export default class FakeApi {
 
     /**
      * test json serialization of form data
+     * 
      * @param {String} param field1
      * @param {String} param2 field2
      * @param {module:api/FakeApi~testJsonFormDataCallback} callback The callback function, accepting three arguments: error, data, response

samples/client/petstore/javascript-es6/src/api/PetApi.js

@@ -45,6 +45,7 @@ export default class PetApi {
 
     /**
      * Add a new pet to the store
+     * 
      * @param {module:model/Pet} pet Pet object that needs to be added to the store
      * @param {module:api/PetApi~addPetCallback} callback The callback function, accepting three arguments: error, data, response
      */
@@ -95,6 +96,7 @@ export default class PetApi {
 
     /**
      * Deletes a pet
+     * 
      * @param {Number} petId Pet id to delete
      * @param {Object} opts Optional parameters
      * @param {String} opts.apiKey 
@@ -269,6 +271,7 @@ export default class PetApi {
 
     /**
      * Update an existing pet
+     * 
      * @param {module:model/Pet} pet Pet object that needs to be added to the store
      * @param {module:api/PetApi~updatePetCallback} callback The callback function, accepting three arguments: error, data, response
      */
@@ -319,6 +322,7 @@ export default class PetApi {
 
     /**
      * Updates a pet in the store with form data
+     * 
      * @param {Number} petId ID of pet that needs to be updated
      * @param {Object} opts Optional parameters
      * @param {String} opts.name Updated name of the pet
@@ -366,6 +370,7 @@ export default class PetApi {
 
     /**
      * uploads an image
+     * 
      * @param {Number} petId ID of pet to update
      * @param {Object} opts Optional parameters
      * @param {String} opts.additionalMetadata Additional data to pass to server
@@ -414,6 +419,7 @@ export default class PetApi {
 
     /**
      * uploads an image (required)
+     * 
      * @param {Number} petId ID of pet to update
      * @param {File} requiredFile file to upload
      * @param {Object} opts Optional parameters

samples/client/petstore/javascript-es6/src/api/StoreApi.js

@@ -166,6 +166,7 @@ export default class StoreApi {
 
     /**
      * Place an order for a pet
+     * 
      * @param {module:model/Order} order order placed for purchasing the pet
      * @param {module:api/StoreApi~placeOrderCallback} callback The callback function, accepting three arguments: error, data, response
      * data is of type: {@link module:model/Order}

samples/client/petstore/javascript-es6/src/api/UserApi.js

@@ -85,6 +85,7 @@ export default class UserApi {
 
     /**
      * Creates list of users with given input array
+     * 
      * @param {Array.<module:model/User>} user List of user object
      * @param {module:api/UserApi~createUsersWithArrayInputCallback} callback The callback function, accepting three arguments: error, data, response
      */
@@ -125,6 +126,7 @@ export default class UserApi {
 
     /**
      * Creates list of users with given input array
+     * 
      * @param {Array.<module:model/User>} user List of user object
      * @param {module:api/UserApi~createUsersWithListInputCallback} callback The callback function, accepting three arguments: error, data, response
      */
@@ -207,6 +209,7 @@ export default class UserApi {
 
     /**
      * Get user by user name
+     * 
      * @param {String} username The name that needs to be fetched. Use user1 for testing.
      * @param {module:api/UserApi~getUserByNameCallback} callback The callback function, accepting three arguments: error, data, response
      * data is of type: {@link module:model/User}
@@ -249,6 +252,7 @@ export default class UserApi {
 
     /**
      * Logs user into the system
+     * 
      * @param {String} username The user name for login
      * @param {String} password The password for login in clear text
      * @param {module:api/UserApi~loginUserCallback} callback The callback function, accepting three arguments: error, data, response
@@ -297,6 +301,7 @@ export default class UserApi {
 
     /**
      * Logs out current logged in user session
+     * 
      * @param {module:api/UserApi~logoutUserCallback} callback The callback function, accepting three arguments: error, data, response
      */
     logoutUser(callback) {

samples/client/petstore/javascript-promise-es6/docs/FakeApi.md

@@ -718,6 +718,8 @@ null (empty response body)
 
 test inline additionalProperties
 
+
+
 ### Example
 
 ```javascript
@@ -760,6 +762,8 @@ No authorization required
 
 test json serialization of form data
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-promise-es6/docs/PetApi.md

@@ -22,6 +22,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 
 ```javascript
@@ -68,6 +70,8 @@ null (empty response body)
 
 Deletes a pet
 
+
+
 ### Example
 
 ```javascript
@@ -264,6 +268,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 
 ```javascript
@@ -310,6 +316,8 @@ null (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 
 ```javascript
@@ -362,6 +370,8 @@ null (empty response body)
 
 uploads an image
 
+
+
 ### Example
 
 ```javascript
@@ -414,6 +424,8 @@ Name | Type | Description  | Notes
 
 uploads an image (required)
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-promise-es6/docs/StoreApi.md

@@ -151,6 +151,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-promise-es6/docs/UserApi.md

@@ -65,6 +65,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```javascript
@@ -107,6 +109,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```javascript
@@ -193,6 +197,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Example
 
 ```javascript
@@ -235,6 +241,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 
 ```javascript
@@ -279,6 +287,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 
 ```javascript

samples/client/petstore/javascript-promise-es6/src/api/FakeApi.js

@@ -788,6 +788,7 @@ export default class FakeApi {
 
     /**
      * test inline additionalProperties
+     * 
      * @param {Object.<String, {String: String}>} requestBody request body
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
      */
@@ -820,6 +821,7 @@ export default class FakeApi {
 
     /**
      * test inline additionalProperties
+     * 
      * @param {Object.<String, {String: String}>} requestBody request body
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}
      */
@@ -833,6 +835,7 @@ export default class FakeApi {
 
     /**
      * test json serialization of form data
+     * 
      * @param {String} param field1
      * @param {String} param2 field2
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
@@ -872,6 +875,7 @@ export default class FakeApi {
 
     /**
      * test json serialization of form data
+     * 
      * @param {String} param field1
      * @param {String} param2 field2
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}

samples/client/petstore/javascript-promise-es6/src/api/PetApi.js

@@ -38,6 +38,7 @@ export default class PetApi {
 
     /**
      * Add a new pet to the store
+     * 
      * @param {module:model/Pet} pet Pet object that needs to be added to the store
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
      */
@@ -80,6 +81,7 @@ export default class PetApi {
 
     /**
      * Add a new pet to the store
+     * 
      * @param {module:model/Pet} pet Pet object that needs to be added to the store
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}
      */
@@ -93,6 +95,7 @@ export default class PetApi {
 
     /**
      * Deletes a pet
+     * 
      * @param {Number} petId Pet id to delete
      * @param {Object} opts Optional parameters
      * @param {String} opts.apiKey 
@@ -130,6 +133,7 @@ export default class PetApi {
 
     /**
      * Deletes a pet
+     * 
      * @param {Number} petId Pet id to delete
      * @param {Object} opts Optional parameters
      * @param {String} opts.apiKey 
@@ -289,6 +293,7 @@ export default class PetApi {
 
     /**
      * Update an existing pet
+     * 
      * @param {module:model/Pet} pet Pet object that needs to be added to the store
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
      */
@@ -331,6 +336,7 @@ export default class PetApi {
 
     /**
      * Update an existing pet
+     * 
      * @param {module:model/Pet} pet Pet object that needs to be added to the store
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}
      */
@@ -344,6 +350,7 @@ export default class PetApi {
 
     /**
      * Updates a pet in the store with form data
+     * 
      * @param {Number} petId ID of pet that needs to be updated
      * @param {Object} opts Optional parameters
      * @param {String} opts.name Updated name of the pet
@@ -383,6 +390,7 @@ export default class PetApi {
 
     /**
      * Updates a pet in the store with form data
+     * 
      * @param {Number} petId ID of pet that needs to be updated
      * @param {Object} opts Optional parameters
      * @param {String} opts.name Updated name of the pet
@@ -399,6 +407,7 @@ export default class PetApi {
 
     /**
      * uploads an image
+     * 
      * @param {Number} petId ID of pet to update
      * @param {Object} opts Optional parameters
      * @param {String} opts.additionalMetadata Additional data to pass to server
@@ -438,6 +447,7 @@ export default class PetApi {
 
     /**
      * uploads an image
+     * 
      * @param {Number} petId ID of pet to update
      * @param {Object} opts Optional parameters
      * @param {String} opts.additionalMetadata Additional data to pass to server
@@ -454,6 +464,7 @@ export default class PetApi {
 
     /**
      * uploads an image (required)
+     * 
      * @param {Number} petId ID of pet to update
      * @param {File} requiredFile file to upload
      * @param {Object} opts Optional parameters
@@ -497,6 +508,7 @@ export default class PetApi {
 
     /**
      * uploads an image (required)
+     * 
      * @param {Number} petId ID of pet to update
      * @param {File} requiredFile file to upload
      * @param {Object} opts Optional parameters

samples/client/petstore/javascript-promise-es6/src/api/StoreApi.js

@@ -174,6 +174,7 @@ export default class StoreApi {
 
     /**
      * Place an order for a pet
+     * 
      * @param {module:model/Order} order order placed for purchasing the pet
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/Order} and HTTP response
      */
@@ -206,6 +207,7 @@ export default class StoreApi {
 
     /**
      * Place an order for a pet
+     * 
      * @param {module:model/Order} order order placed for purchasing the pet
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/Order}
      */

samples/client/petstore/javascript-promise-es6/src/api/UserApi.js

@@ -84,6 +84,7 @@ export default class UserApi {
 
     /**
      * Creates list of users with given input array
+     * 
      * @param {Array.<module:model/User>} user List of user object
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
      */
@@ -116,6 +117,7 @@ export default class UserApi {
 
     /**
      * Creates list of users with given input array
+     * 
      * @param {Array.<module:model/User>} user List of user object
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}
      */
@@ -129,6 +131,7 @@ export default class UserApi {
 
     /**
      * Creates list of users with given input array
+     * 
      * @param {Array.<module:model/User>} user List of user object
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
      */
@@ -161,6 +164,7 @@ export default class UserApi {
 
     /**
      * Creates list of users with given input array
+     * 
      * @param {Array.<module:model/User>} user List of user object
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}
      */
@@ -222,6 +226,7 @@ export default class UserApi {
 
     /**
      * Get user by user name
+     * 
      * @param {String} username The name that needs to be fetched. Use user1 for testing.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link module:model/User} and HTTP response
      */
@@ -255,6 +260,7 @@ export default class UserApi {
 
     /**
      * Get user by user name
+     * 
      * @param {String} username The name that needs to be fetched. Use user1 for testing.
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link module:model/User}
      */
@@ -268,6 +274,7 @@ export default class UserApi {
 
     /**
      * Logs user into the system
+     * 
      * @param {String} username The user name for login
      * @param {String} password The password for login in clear text
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing data of type {@link String} and HTTP response
@@ -307,6 +314,7 @@ export default class UserApi {
 
     /**
      * Logs user into the system
+     * 
      * @param {String} username The user name for login
      * @param {String} password The password for login in clear text
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with data of type {@link String}
@@ -321,6 +329,7 @@ export default class UserApi {
 
     /**
      * Logs out current logged in user session
+     * 
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}, with an object containing HTTP response
      */
     logoutUserWithHttpInfo() {
@@ -348,6 +357,7 @@ export default class UserApi {
 
     /**
      * Logs out current logged in user session
+     * 
      * @return {Promise} a {@link https://www.promisejs.org/|Promise}
      */
     logoutUser() {

samples/client/petstore/kotlin-uppercase-enum/docs/EnumApi.md

@@ -13,6 +13,8 @@ Method | HTTP request | Description
 
 Get enums
 
+
+
 ### Example
 ```kotlin
 // Import classes:

samples/client/petstore/objc/core-data/docs/SWGPetApi.md

@@ -22,6 +22,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -73,6 +75,8 @@ void (empty response body)
 
 Deletes a pet
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -296,6 +300,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -348,6 +354,8 @@ void (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -406,6 +414,8 @@ void (empty response body)
 
 uploads an image
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];

samples/client/petstore/objc/core-data/docs/SWGStoreApi.md

@@ -168,6 +168,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 ```objc
 

samples/client/petstore/objc/core-data/docs/SWGUserApi.md

@@ -69,6 +69,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```objc
 
@@ -114,6 +116,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```objc
 
@@ -206,6 +210,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Example
 ```objc
 
@@ -255,6 +261,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 ```objc
 
@@ -306,6 +314,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 ```objc
 

samples/client/petstore/objc/default/docs/SWGPetApi.md

@@ -22,6 +22,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -73,6 +75,8 @@ void (empty response body)
 
 Deletes a pet
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -296,6 +300,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -348,6 +354,8 @@ void (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];
@@ -406,6 +414,8 @@ void (empty response body)
 
 uploads an image
 
+
+
 ### Example
 ```objc
 SWGDefaultConfiguration *apiConfig = [SWGDefaultConfiguration sharedConfig];

samples/client/petstore/objc/default/docs/SWGStoreApi.md

@@ -168,6 +168,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 ```objc
 

samples/client/petstore/objc/default/docs/SWGUserApi.md

@@ -69,6 +69,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```objc
 
@@ -114,6 +116,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```objc
 
@@ -206,6 +210,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Example
 ```objc
 
@@ -255,6 +261,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 ```objc
 
@@ -306,6 +314,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 ```objc
 

samples/client/petstore/perl/docs/FakeApi.md

@@ -729,6 +729,8 @@ void (empty response body)
 
 test inline additionalProperties
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -772,6 +774,8 @@ No authorization required
 
 test json serialization of form data
 
+
+
 ### Example
 ```perl
 use Data::Dumper;

samples/client/petstore/perl/docs/PetApi.md

@@ -25,6 +25,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -71,6 +73,8 @@ void (empty response body)
 
 Deletes a pet
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -268,6 +272,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -314,6 +320,8 @@ void (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -364,6 +372,8 @@ void (empty response body)
 
 uploads an image
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -415,6 +425,8 @@ Name | Type | Description  | Notes
 
 uploads an image (required)
 
+
+
 ### Example
 ```perl
 use Data::Dumper;

samples/client/petstore/perl/docs/StoreApi.md

@@ -158,6 +158,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 ```perl
 use Data::Dumper;

samples/client/petstore/perl/docs/UserApi.md

@@ -69,6 +69,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -112,6 +114,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -200,6 +204,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -244,6 +250,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 ```perl
 use Data::Dumper;
@@ -290,6 +298,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 ```perl
 use Data::Dumper;

samples/client/petstore/php/OpenAPIClient-php/docs/Api/FakeApi.md

@@ -869,6 +869,8 @@ testInlineAdditionalProperties($request_body)
 
 test inline additionalProperties
 
+
+
 ### Example
 
 ```php
@@ -922,6 +924,8 @@ testJsonFormData($param, $param2)
 
 test json serialization of form data
 
+
+
 ### Example
 
 ```php

samples/client/petstore/php/OpenAPIClient-php/docs/Api/PetApi.md

@@ -23,6 +23,8 @@ addPet($pet)
 
 Add a new pet to the store
 
+
+
 ### Example
 
 ```php
@@ -80,6 +82,8 @@ deletePet($pet_id, $api_key)
 
 Deletes a pet
 
+
+
 ### Example
 
 ```php
@@ -321,6 +325,8 @@ updatePet($pet)
 
 Update an existing pet
 
+
+
 ### Example
 
 ```php
@@ -378,6 +384,8 @@ updatePetWithForm($pet_id, $name, $status)
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 
 ```php
@@ -439,6 +447,8 @@ uploadFile($pet_id, $additional_metadata, $file): \OpenAPI\Client\Model\ApiRespo
 
 uploads an image
 
+
+
 ### Example
 
 ```php
@@ -501,6 +511,8 @@ uploadFileWithRequiredFile($pet_id, $required_file, $additional_metadata): \Open
 
 uploads an image (required)
 
+
+
 ### Example
 
 ```php

samples/client/petstore/php/OpenAPIClient-php/docs/Api/StoreApi.md

@@ -188,6 +188,8 @@ placeOrder($order): \OpenAPI\Client\Model\Order
 
 Place an order for a pet
 
+
+
 ### Example
 
 ```php

samples/client/petstore/php/OpenAPIClient-php/docs/Api/UserApi.md

@@ -77,6 +77,8 @@ createUsersWithArrayInput($user)
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```php
@@ -130,6 +132,8 @@ createUsersWithListInput($user)
 
 Creates list of users with given input array
 
+
+
 ### Example
 
 ```php
@@ -238,6 +242,8 @@ getUserByName($username): \OpenAPI\Client\Model\User
 
 Get user by user name
 
+
+
 ### Example
 
 ```php
@@ -292,6 +298,8 @@ loginUser($username, $password): string
 
 Logs user into the system
 
+
+
 ### Example
 
 ```php
@@ -348,6 +356,8 @@ logoutUser()
 
 Logs out current logged in user session
 
+
+
 ### Example
 
 ```php

samples/client/petstore/powershell/docs/PSPetApi.md

@@ -21,6 +21,8 @@ Method | HTTP request | Description
 
 Add a new pet to the store
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc
@@ -70,6 +72,8 @@ Name | Type | Description  | Notes
 
 Deletes a pet
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc
@@ -264,6 +268,8 @@ Name | Type | Description  | Notes
 
 Update an existing pet
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc
@@ -314,6 +320,8 @@ Name | Type | Description  | Notes
 
 Updates a pet in the store with form data
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc
@@ -366,6 +374,8 @@ void (empty response body)
 
 uploads an image
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc

samples/client/petstore/powershell/docs/PSStoreApi.md

@@ -148,6 +148,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Example
 ```powershell
 $Order = Initialize-Order -Id 0 -PetId 0 -Quantity 0 -ShipDate (Get-Date) -Status "placed" -Complete $false # Order | order placed for purchasing the pet

samples/client/petstore/powershell/docs/PSUserApi.md

@@ -71,6 +71,8 @@ void (empty response body)
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc
@@ -119,6 +121,8 @@ void (empty response body)
 
 Creates list of users with given input array
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc
@@ -217,6 +221,8 @@ void (empty response body)
 
 Get user by user name
 
+
+
 ### Example
 ```powershell
 $Username = "MyUsername" # String | The name that needs to be fetched. Use user1 for testing.
@@ -259,6 +265,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Example
 ```powershell
 $Username = "MyUsername" # String | The user name for login
@@ -301,6 +309,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Example
 ```powershell
 # general setting of the PowerShell module, e.g. base URL, authentication, etc

samples/client/petstore/ruby-faraday/docs/FakeApi.md

@@ -995,6 +995,8 @@ nil (empty response body)
 
 test inline additionalProperties
 
+
+
 ### Examples
 
 ```ruby
@@ -1056,6 +1058,8 @@ No authorization required
 
 test json serialization of form data
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby-faraday/docs/PetApi.md

@@ -21,6 +21,8 @@ All URIs are relative to *http://petstore.swagger.io:80/v2*
 
 Add a new pet to the store
 
+
+
 ### Examples
 
 ```ruby
@@ -87,6 +89,8 @@ nil (empty response body)
 
 Deletes a pet
 
+
+
 ### Examples
 
 ```ruby
@@ -366,6 +370,8 @@ end
 
 Update an existing pet
 
+
+
 ### Examples
 
 ```ruby
@@ -432,6 +438,8 @@ nil (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Examples
 
 ```ruby
@@ -504,6 +512,8 @@ nil (empty response body)
 
 uploads an image
 
+
+
 ### Examples
 
 ```ruby
@@ -577,6 +587,8 @@ end
 
 uploads an image (required)
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby-faraday/docs/StoreApi.md

@@ -211,6 +211,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby-faraday/docs/UserApi.md

@@ -83,6 +83,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Examples
 
 ```ruby
@@ -144,6 +146,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Examples
 
 ```ruby
@@ -268,6 +272,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Examples
 
 ```ruby
@@ -330,6 +336,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Examples
 
 ```ruby
@@ -394,6 +402,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby-faraday/lib/petstore/api/fake_api.rb

@@ -1093,6 +1093,7 @@ module Petstore
     end
 
     # test inline additionalProperties
+    # 
     # @param request_body [Hash<String, String>] request body
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -1102,6 +1103,7 @@ module Petstore
     end
 
     # test inline additionalProperties
+    # 
     # @param request_body [Hash<String, String>] request body
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -1157,6 +1159,7 @@ module Petstore
     end
 
     # test json serialization of form data
+    # 
     # @param param [String] field1
     # @param param2 [String] field2
     # @param [Hash] opts the optional parameters
@@ -1167,6 +1170,7 @@ module Petstore
     end
 
     # test json serialization of form data
+    # 
     # @param param [String] field1
     # @param param2 [String] field2
     # @param [Hash] opts the optional parameters

samples/client/petstore/ruby-faraday/lib/petstore/api/pet_api.rb

@@ -20,6 +20,7 @@ module Petstore
       @api_client = api_client
     end
     # Add a new pet to the store
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -29,6 +30,7 @@ module Petstore
     end
 
     # Add a new pet to the store
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -84,6 +86,7 @@ module Petstore
     end
 
     # Deletes a pet
+    # 
     # @param pet_id [Integer] Pet id to delete
     # @param [Hash] opts the optional parameters
     # @option opts [String] :api_key 
@@ -94,6 +97,7 @@ module Petstore
     end
 
     # Deletes a pet
+    # 
     # @param pet_id [Integer] Pet id to delete
     # @param [Hash] opts the optional parameters
     # @option opts [String] :api_key 
@@ -337,6 +341,7 @@ module Petstore
     end
 
     # Update an existing pet
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -346,6 +351,7 @@ module Petstore
     end
 
     # Update an existing pet
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -401,6 +407,7 @@ module Petstore
     end
 
     # Updates a pet in the store with form data
+    # 
     # @param pet_id [Integer] ID of pet that needs to be updated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :name Updated name of the pet
@@ -412,6 +419,7 @@ module Petstore
     end
 
     # Updates a pet in the store with form data
+    # 
     # @param pet_id [Integer] ID of pet that needs to be updated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :name Updated name of the pet
@@ -471,6 +479,7 @@ module Petstore
     end
 
     # uploads an image
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param [Hash] opts the optional parameters
     # @option opts [String] :additional_metadata Additional data to pass to server
@@ -482,6 +491,7 @@ module Petstore
     end
 
     # uploads an image
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param [Hash] opts the optional parameters
     # @option opts [String] :additional_metadata Additional data to pass to server
@@ -543,6 +553,7 @@ module Petstore
     end
 
     # uploads an image (required)
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param required_file [File] file to upload
     # @param [Hash] opts the optional parameters
@@ -554,6 +565,7 @@ module Petstore
     end
 
     # uploads an image (required)
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param required_file [File] file to upload
     # @param [Hash] opts the optional parameters

samples/client/petstore/ruby-faraday/lib/petstore/api/store_api.rb

@@ -209,6 +209,7 @@ module Petstore
     end
 
     # Place an order for a pet
+    # 
     # @param order [Order] order placed for purchasing the pet
     # @param [Hash] opts the optional parameters
     # @return [Order]
@@ -218,6 +219,7 @@ module Petstore
     end
 
     # Place an order for a pet
+    # 
     # @param order [Order] order placed for purchasing the pet
     # @param [Hash] opts the optional parameters
     # @return [Array<(Order, Integer, Hash)>] Order data, response status code and response headers

samples/client/petstore/ruby-faraday/lib/petstore/api/user_api.rb

@@ -86,6 +86,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -95,6 +96,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -150,6 +152,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -159,6 +162,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -275,6 +279,7 @@ module Petstore
     end
 
     # Get user by user name
+    # 
     # @param username [String] The name that needs to be fetched. Use user1 for testing.
     # @param [Hash] opts the optional parameters
     # @return [User]
@@ -284,6 +289,7 @@ module Petstore
     end
 
     # Get user by user name
+    # 
     # @param username [String] The name that needs to be fetched. Use user1 for testing.
     # @param [Hash] opts the optional parameters
     # @return [Array<(User, Integer, Hash)>] User data, response status code and response headers
@@ -336,6 +342,7 @@ module Petstore
     end
 
     # Logs user into the system
+    # 
     # @param username [String] The user name for login
     # @param password [String] The password for login in clear text
     # @param [Hash] opts the optional parameters
@@ -346,6 +353,7 @@ module Petstore
     end
 
     # Logs user into the system
+    # 
     # @param username [String] The user name for login
     # @param password [String] The password for login in clear text
     # @param [Hash] opts the optional parameters
@@ -405,6 +413,7 @@ module Petstore
     end
 
     # Logs out current logged in user session
+    # 
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def logout_user(opts = {})
@@ -413,6 +422,7 @@ module Petstore
     end
 
     # Logs out current logged in user session
+    # 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def logout_user_with_http_info(opts = {})

samples/client/petstore/ruby/docs/FakeApi.md

@@ -995,6 +995,8 @@ nil (empty response body)
 
 test inline additionalProperties
 
+
+
 ### Examples
 
 ```ruby
@@ -1056,6 +1058,8 @@ No authorization required
 
 test json serialization of form data
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby/docs/PetApi.md

@@ -21,6 +21,8 @@ All URIs are relative to *http://petstore.swagger.io:80/v2*
 
 Add a new pet to the store
 
+
+
 ### Examples
 
 ```ruby
@@ -87,6 +89,8 @@ nil (empty response body)
 
 Deletes a pet
 
+
+
 ### Examples
 
 ```ruby
@@ -366,6 +370,8 @@ end
 
 Update an existing pet
 
+
+
 ### Examples
 
 ```ruby
@@ -432,6 +438,8 @@ nil (empty response body)
 
 Updates a pet in the store with form data
 
+
+
 ### Examples
 
 ```ruby
@@ -504,6 +512,8 @@ nil (empty response body)
 
 uploads an image
 
+
+
 ### Examples
 
 ```ruby
@@ -577,6 +587,8 @@ end
 
 uploads an image (required)
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby/docs/StoreApi.md

@@ -211,6 +211,8 @@ No authorization required
 
 Place an order for a pet
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby/docs/UserApi.md

@@ -83,6 +83,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Examples
 
 ```ruby
@@ -144,6 +146,8 @@ No authorization required
 
 Creates list of users with given input array
 
+
+
 ### Examples
 
 ```ruby
@@ -268,6 +272,8 @@ No authorization required
 
 Get user by user name
 
+
+
 ### Examples
 
 ```ruby
@@ -330,6 +336,8 @@ No authorization required
 
 Logs user into the system
 
+
+
 ### Examples
 
 ```ruby
@@ -394,6 +402,8 @@ No authorization required
 
 Logs out current logged in user session
 
+
+
 ### Examples
 
 ```ruby

samples/client/petstore/ruby/lib/petstore/api/fake_api.rb

@@ -1093,6 +1093,7 @@ module Petstore
     end
 
     # test inline additionalProperties
+    # 
     # @param request_body [Hash<String, String>] request body
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -1102,6 +1103,7 @@ module Petstore
     end
 
     # test inline additionalProperties
+    # 
     # @param request_body [Hash<String, String>] request body
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -1157,6 +1159,7 @@ module Petstore
     end
 
     # test json serialization of form data
+    # 
     # @param param [String] field1
     # @param param2 [String] field2
     # @param [Hash] opts the optional parameters
@@ -1167,6 +1170,7 @@ module Petstore
     end
 
     # test json serialization of form data
+    # 
     # @param param [String] field1
     # @param param2 [String] field2
     # @param [Hash] opts the optional parameters

samples/client/petstore/ruby/lib/petstore/api/pet_api.rb

@@ -20,6 +20,7 @@ module Petstore
       @api_client = api_client
     end
     # Add a new pet to the store
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -29,6 +30,7 @@ module Petstore
     end
 
     # Add a new pet to the store
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -84,6 +86,7 @@ module Petstore
     end
 
     # Deletes a pet
+    # 
     # @param pet_id [Integer] Pet id to delete
     # @param [Hash] opts the optional parameters
     # @option opts [String] :api_key 
@@ -94,6 +97,7 @@ module Petstore
     end
 
     # Deletes a pet
+    # 
     # @param pet_id [Integer] Pet id to delete
     # @param [Hash] opts the optional parameters
     # @option opts [String] :api_key 
@@ -337,6 +341,7 @@ module Petstore
     end
 
     # Update an existing pet
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -346,6 +351,7 @@ module Petstore
     end
 
     # Update an existing pet
+    # 
     # @param pet [Pet] Pet object that needs to be added to the store
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -401,6 +407,7 @@ module Petstore
     end
 
     # Updates a pet in the store with form data
+    # 
     # @param pet_id [Integer] ID of pet that needs to be updated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :name Updated name of the pet
@@ -412,6 +419,7 @@ module Petstore
     end
 
     # Updates a pet in the store with form data
+    # 
     # @param pet_id [Integer] ID of pet that needs to be updated
     # @param [Hash] opts the optional parameters
     # @option opts [String] :name Updated name of the pet
@@ -471,6 +479,7 @@ module Petstore
     end
 
     # uploads an image
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param [Hash] opts the optional parameters
     # @option opts [String] :additional_metadata Additional data to pass to server
@@ -482,6 +491,7 @@ module Petstore
     end
 
     # uploads an image
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param [Hash] opts the optional parameters
     # @option opts [String] :additional_metadata Additional data to pass to server
@@ -543,6 +553,7 @@ module Petstore
     end
 
     # uploads an image (required)
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param required_file [File] file to upload
     # @param [Hash] opts the optional parameters
@@ -554,6 +565,7 @@ module Petstore
     end
 
     # uploads an image (required)
+    # 
     # @param pet_id [Integer] ID of pet to update
     # @param required_file [File] file to upload
     # @param [Hash] opts the optional parameters

samples/client/petstore/ruby/lib/petstore/api/store_api.rb

@@ -209,6 +209,7 @@ module Petstore
     end
 
     # Place an order for a pet
+    # 
     # @param order [Order] order placed for purchasing the pet
     # @param [Hash] opts the optional parameters
     # @return [Order]
@@ -218,6 +219,7 @@ module Petstore
     end
 
     # Place an order for a pet
+    # 
     # @param order [Order] order placed for purchasing the pet
     # @param [Hash] opts the optional parameters
     # @return [Array<(Order, Integer, Hash)>] Order data, response status code and response headers

samples/client/petstore/ruby/lib/petstore/api/user_api.rb

@@ -86,6 +86,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -95,6 +96,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -150,6 +152,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -159,6 +162,7 @@ module Petstore
     end
 
     # Creates list of users with given input array
+    # 
     # @param user [Array<User>] List of user object
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -275,6 +279,7 @@ module Petstore
     end
 
     # Get user by user name
+    # 
     # @param username [String] The name that needs to be fetched. Use user1 for testing.
     # @param [Hash] opts the optional parameters
     # @return [User]
@@ -284,6 +289,7 @@ module Petstore
     end
 
     # Get user by user name
+    # 
     # @param username [String] The name that needs to be fetched. Use user1 for testing.
     # @param [Hash] opts the optional parameters
     # @return [Array<(User, Integer, Hash)>] User data, response status code and response headers
@@ -336,6 +342,7 @@ module Petstore
     end
 
     # Logs user into the system
+    # 
     # @param username [String] The user name for login
     # @param password [String] The password for login in clear text
     # @param [Hash] opts the optional parameters
@@ -346,6 +353,7 @@ module Petstore
     end
 
     # Logs user into the system
+    # 
     # @param username [String] The user name for login
     # @param password [String] The password for login in clear text
     # @param [Hash] opts the optional parameters
@@ -405,6 +413,7 @@ module Petstore
     end
 
     # Logs out current logged in user session
+    # 
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def logout_user(opts = {})
@@ -413,6 +422,7 @@ module Petstore
     end
 
     # Logs out current logged in user session
+    # 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def logout_user_with_http_info(opts = {})

samples/client/petstore/rust/hyper/petstore/docs/PetApi.md

@@ -20,6 +20,8 @@ Method | HTTP request | Description
 > crate::models::Pet add_pet(pet)
 Add a new pet to the store
 
+
+
 ### Parameters
 
 
@@ -48,6 +50,8 @@ Name | Type | Description  | Required | Notes
 > delete_pet(pet_id, api_key)
 Deletes a pet
 
+
+
 ### Parameters
 
 
@@ -167,6 +171,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::Pet update_pet(pet)
 Update an existing pet
 
+
+
 ### Parameters
 
 
@@ -195,6 +201,8 @@ Name | Type | Description  | Required | Notes
 > update_pet_with_form(pet_id, name, status)
 Updates a pet in the store with form data
 
+
+
 ### Parameters
 
 
@@ -225,6 +233,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::ApiResponse upload_file(pet_id, additional_metadata, file)
 uploads an image
 
+
+
 ### Parameters
 
 

samples/client/petstore/rust/hyper/petstore/docs/StoreApi.md

@@ -103,6 +103,8 @@ No authorization required
 > crate::models::Order place_order(order)
 Place an order for a pet
 
+
+
 ### Parameters
 
 

samples/client/petstore/rust/hyper/petstore/docs/UserApi.md

@@ -50,6 +50,8 @@ Name | Type | Description  | Required | Notes
 > create_users_with_array_input(user)
 Creates list of users with given input array
 
+
+
 ### Parameters
 
 
@@ -78,6 +80,8 @@ Name | Type | Description  | Required | Notes
 > create_users_with_list_input(user)
 Creates list of users with given input array
 
+
+
 ### Parameters
 
 
@@ -136,6 +140,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::User get_user_by_name(username)
 Get user by user name
 
+
+
 ### Parameters
 
 
@@ -164,6 +170,8 @@ No authorization required
 > String login_user(username, password)
 Logs user into the system
 
+
+
 ### Parameters
 
 
@@ -193,6 +201,8 @@ No authorization required
 > logout_user()
 Logs out current logged in user session
 
+
+
 ### Parameters
 
 This endpoint does not need any parameter.

samples/client/petstore/rust/reqwest/petstore-async/docs/PetApi.md

@@ -20,6 +20,8 @@ Method | HTTP request | Description
 > crate::models::Pet add_pet(pet)
 Add a new pet to the store
 
+
+
 ### Parameters
 
 
@@ -48,6 +50,8 @@ Name | Type | Description  | Required | Notes
 > delete_pet(pet_id, api_key)
 Deletes a pet
 
+
+
 ### Parameters
 
 
@@ -167,6 +171,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::Pet update_pet(pet)
 Update an existing pet
 
+
+
 ### Parameters
 
 
@@ -195,6 +201,8 @@ Name | Type | Description  | Required | Notes
 > update_pet_with_form(pet_id, name, status)
 Updates a pet in the store with form data
 
+
+
 ### Parameters
 
 
@@ -225,6 +233,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::ApiResponse upload_file(pet_id, additional_metadata, file)
 uploads an image
 
+
+
 ### Parameters
 
 

samples/client/petstore/rust/reqwest/petstore-async/docs/StoreApi.md

@@ -103,6 +103,8 @@ No authorization required
 > crate::models::Order place_order(order)
 Place an order for a pet
 
+
+
 ### Parameters
 
 

samples/client/petstore/rust/reqwest/petstore-async/docs/UserApi.md

@@ -50,6 +50,8 @@ Name | Type | Description  | Required | Notes
 > create_users_with_array_input(user)
 Creates list of users with given input array
 
+
+
 ### Parameters
 
 
@@ -78,6 +80,8 @@ Name | Type | Description  | Required | Notes
 > create_users_with_list_input(user)
 Creates list of users with given input array
 
+
+
 ### Parameters
 
 
@@ -136,6 +140,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::User get_user_by_name(username)
 Get user by user name
 
+
+
 ### Parameters
 
 
@@ -164,6 +170,8 @@ No authorization required
 > String login_user(username, password)
 Logs user into the system
 
+
+
 ### Parameters
 
 
@@ -193,6 +201,8 @@ No authorization required
 > logout_user()
 Logs out current logged in user session
 
+
+
 ### Parameters
 
 This endpoint does not need any parameter.

samples/client/petstore/rust/reqwest/petstore-async/src/apis/pet_api.rs

@@ -209,6 +209,7 @@ pub enum UploadFileError {
 }
 
 
+/// 
 pub async fn add_pet(configuration: &configuration::Configuration, params: AddPetParams) -> Result<ResponseContent<AddPetSuccess>, Error<AddPetError>> {
     let local_var_configuration = configuration;
 
@@ -246,6 +247,7 @@ pub async fn add_pet(configuration: &configuration::Configuration, params: AddPe
     }
 }
 
+/// 
 pub async fn delete_pet(configuration: &configuration::Configuration, params: DeletePetParams) -> Result<ResponseContent<DeletePetSuccess>, Error<DeletePetError>> {
     let local_var_configuration = configuration;
 
@@ -410,6 +412,7 @@ pub async fn get_pet_by_id(configuration: &configuration::Configuration, params:
     }
 }
 
+/// 
 pub async fn update_pet(configuration: &configuration::Configuration, params: UpdatePetParams) -> Result<ResponseContent<UpdatePetSuccess>, Error<UpdatePetError>> {
     let local_var_configuration = configuration;
 
@@ -447,6 +450,7 @@ pub async fn update_pet(configuration: &configuration::Configuration, params: Up
     }
 }
 
+/// 
 pub async fn update_pet_with_form(configuration: &configuration::Configuration, params: UpdatePetWithFormParams) -> Result<ResponseContent<UpdatePetWithFormSuccess>, Error<UpdatePetWithFormError>> {
     let local_var_configuration = configuration;
 
@@ -493,6 +497,7 @@ pub async fn update_pet_with_form(configuration: &configuration::Configuration,
     }
 }
 
+/// 
 pub async fn upload_file(configuration: &configuration::Configuration, params: UploadFileParams) -> Result<ResponseContent<UploadFileSuccess>, Error<UploadFileError>> {
     let local_var_configuration = configuration;
 

samples/client/petstore/rust/reqwest/petstore-async/src/apis/store_api.rs

@@ -210,6 +210,7 @@ pub async fn get_order_by_id(configuration: &configuration::Configuration, param
     }
 }
 
+/// 
 pub async fn place_order(configuration: &configuration::Configuration, params: PlaceOrderParams) -> Result<ResponseContent<PlaceOrderSuccess>, Error<PlaceOrderError>> {
     let local_var_configuration = configuration;
 

samples/client/petstore/rust/reqwest/petstore-async/src/apis/user_api.rs

@@ -237,6 +237,7 @@ pub async fn create_user(configuration: &configuration::Configuration, params: C
     }
 }
 
+/// 
 pub async fn create_users_with_array_input(configuration: &configuration::Configuration, params: CreateUsersWithArrayInputParams) -> Result<ResponseContent<CreateUsersWithArrayInputSuccess>, Error<CreateUsersWithArrayInputError>> {
     let local_var_configuration = configuration;
 
@@ -279,6 +280,7 @@ pub async fn create_users_with_array_input(configuration: &configuration::Config
     }
 }
 
+/// 
 pub async fn create_users_with_list_input(configuration: &configuration::Configuration, params: CreateUsersWithListInputParams) -> Result<ResponseContent<CreateUsersWithListInputSuccess>, Error<CreateUsersWithListInputError>> {
     let local_var_configuration = configuration;
 
@@ -363,6 +365,7 @@ pub async fn delete_user(configuration: &configuration::Configuration, params: D
     }
 }
 
+/// 
 pub async fn get_user_by_name(configuration: &configuration::Configuration, params: GetUserByNameParams) -> Result<ResponseContent<GetUserByNameSuccess>, Error<GetUserByNameError>> {
     let local_var_configuration = configuration;
 
@@ -396,6 +399,7 @@ pub async fn get_user_by_name(configuration: &configuration::Configuration, para
     }
 }
 
+/// 
 pub async fn login_user(configuration: &configuration::Configuration, params: LoginUserParams) -> Result<ResponseContent<LoginUserSuccess>, Error<LoginUserError>> {
     let local_var_configuration = configuration;
 
@@ -432,6 +436,7 @@ pub async fn login_user(configuration: &configuration::Configuration, params: Lo
     }
 }
 
+/// 
 pub async fn logout_user(configuration: &configuration::Configuration) -> Result<ResponseContent<LogoutUserSuccess>, Error<LogoutUserError>> {
     let local_var_configuration = configuration;
 

samples/client/petstore/rust/reqwest/petstore/docs/PetApi.md

@@ -20,6 +20,8 @@ Method | HTTP request | Description
 > crate::models::Pet add_pet(pet)
 Add a new pet to the store
 
+
+
 ### Parameters
 
 
@@ -48,6 +50,8 @@ Name | Type | Description  | Required | Notes
 > delete_pet(pet_id, api_key)
 Deletes a pet
 
+
+
 ### Parameters
 
 
@@ -167,6 +171,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::Pet update_pet(pet)
 Update an existing pet
 
+
+
 ### Parameters
 
 
@@ -195,6 +201,8 @@ Name | Type | Description  | Required | Notes
 > update_pet_with_form(pet_id, name, status)
 Updates a pet in the store with form data
 
+
+
 ### Parameters
 
 
@@ -225,6 +233,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::ApiResponse upload_file(pet_id, additional_metadata, file)
 uploads an image
 
+
+
 ### Parameters
 
 

samples/client/petstore/rust/reqwest/petstore/docs/StoreApi.md

@@ -103,6 +103,8 @@ No authorization required
 > crate::models::Order place_order(order)
 Place an order for a pet
 
+
+
 ### Parameters
 
 

samples/client/petstore/rust/reqwest/petstore/docs/UserApi.md

@@ -50,6 +50,8 @@ Name | Type | Description  | Required | Notes
 > create_users_with_array_input(user)
 Creates list of users with given input array
 
+
+
 ### Parameters
 
 
@@ -78,6 +80,8 @@ Name | Type | Description  | Required | Notes
 > create_users_with_list_input(user)
 Creates list of users with given input array
 
+
+
 ### Parameters
 
 
@@ -136,6 +140,8 @@ Name | Type | Description  | Required | Notes
 > crate::models::User get_user_by_name(username)
 Get user by user name
 
+
+
 ### Parameters
 
 
@@ -164,6 +170,8 @@ No authorization required
 > String login_user(username, password)
 Logs user into the system
 
+
+
 ### Parameters
 
 
@@ -193,6 +201,8 @@ No authorization required
 > logout_user()
 Logs out current logged in user session
 
+
+
 ### Parameters
 
 This endpoint does not need any parameter.

samples/client/petstore/rust/reqwest/petstore/src/apis/pet_api.rs

@@ -82,6 +82,7 @@ pub enum UploadFileError {
 }
 
 
+/// 
 pub fn add_pet(configuration: &configuration::Configuration, pet: crate::models::Pet) -> Result<crate::models::Pet, Error<AddPetError>> {
     let local_var_configuration = configuration;
 
@@ -113,6 +114,7 @@ pub fn add_pet(configuration: &configuration::Configuration, pet: crate::models:
     }
 }
 
+/// 
 pub fn delete_pet(configuration: &configuration::Configuration, pet_id: i64, api_key: Option<&str>) -> Result<(), Error<DeletePetError>> {
     let local_var_configuration = configuration;
 
@@ -252,6 +254,7 @@ pub fn get_pet_by_id(configuration: &configuration::Configuration, pet_id: i64)
     }
 }
 
+/// 
 pub fn update_pet(configuration: &configuration::Configuration, pet: crate::models::Pet) -> Result<crate::models::Pet, Error<UpdatePetError>> {
     let local_var_configuration = configuration;
 
@@ -283,6 +286,7 @@ pub fn update_pet(configuration: &configuration::Configuration, pet: crate::mode
     }
 }
 
+/// 
 pub fn update_pet_with_form(configuration: &configuration::Configuration, pet_id: i64, name: Option<&str>, status: Option<&str>) -> Result<(), Error<UpdatePetWithFormError>> {
     let local_var_configuration = configuration;
 
@@ -321,6 +325,7 @@ pub fn update_pet_with_form(configuration: &configuration::Configuration, pet_id
     }
 }
 
+/// 
 pub fn upload_file(configuration: &configuration::Configuration, pet_id: i64, additional_metadata: Option<&str>, file: Option<std::path::PathBuf>) -> Result<crate::models::ApiResponse, Error<UploadFileError>> {
     let local_var_configuration = configuration;
 

samples/client/petstore/rust/reqwest/petstore/src/apis/store_api.rs

@@ -141,6 +141,7 @@ pub fn get_order_by_id(configuration: &configuration::Configuration, order_id: i
     }
 }
 
+/// 
 pub fn place_order(configuration: &configuration::Configuration, order: crate::models::Order) -> Result<crate::models::Order, Error<PlaceOrderError>> {
     let local_var_configuration = configuration;
 

samples/client/petstore/rust/reqwest/petstore/src/apis/user_api.rs

@@ -120,6 +120,7 @@ pub fn create_user(configuration: &configuration::Configuration, user: crate::mo
     }
 }
 
+/// 
 pub fn create_users_with_array_input(configuration: &configuration::Configuration, user: Vec<crate::models::User>) -> Result<(), Error<CreateUsersWithArrayInputError>> {
     let local_var_configuration = configuration;
 
@@ -156,6 +157,7 @@ pub fn create_users_with_array_input(configuration: &configuration::Configuratio
     }
 }
 
+/// 
 pub fn create_users_with_list_input(configuration: &configuration::Configuration, user: Vec<crate::models::User>) -> Result<(), Error<CreateUsersWithListInputError>> {
     let local_var_configuration = configuration;
 
@@ -228,6 +230,7 @@ pub fn delete_user(configuration: &configuration::Configuration, username: &str)
     }
 }
 
+/// 
 pub fn get_user_by_name(configuration: &configuration::Configuration, username: &str) -> Result<crate::models::User, Error<GetUserByNameError>> {
     let local_var_configuration = configuration;
 
@@ -255,6 +258,7 @@ pub fn get_user_by_name(configuration: &configuration::Configuration, username:
     }
 }
 
+/// 
 pub fn login_user(configuration: &configuration::Configuration, username: &str, password: &str) -> Result<String, Error<LoginUserError>> {
     let local_var_configuration = configuration;
 
@@ -284,6 +288,7 @@ pub fn login_user(configuration: &configuration::Configuration, username: &str,
     }
 }
 
+/// 
 pub fn logout_user(configuration: &configuration::Configuration, ) -> Result<(), Error<LogoutUserError>> {
     let local_var_configuration = configuration;
 

samples/client/petstore/scala-akka/src/main/scala/org/openapitools/client/api/PetApi.scala

@@ -26,6 +26,8 @@ object PetApi {
 class PetApi(baseUrl: String) {
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : Pet (successful operation)
    *   code 405 :  (Invalid input)
@@ -40,6 +42,8 @@ class PetApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 400 :  (Invalid pet value)
    * 
@@ -108,6 +112,8 @@ class PetApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : Pet (successful operation)
    *   code 400 :  (Invalid ID supplied)
@@ -126,6 +132,8 @@ class PetApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 :  (successful operation)
    *   code 405 :  (Invalid input)
@@ -144,6 +152,8 @@ class PetApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : ApiResponse (successful operation)
    * 

samples/client/petstore/scala-akka/src/main/scala/org/openapitools/client/api/StoreApi.scala

@@ -73,6 +73,8 @@ class StoreApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : Order (successful operation)
    *   code 400 :  (Invalid Order)

samples/client/petstore/scala-akka/src/main/scala/org/openapitools/client/api/UserApi.scala

@@ -43,6 +43,8 @@ class UserApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 0 :  (successful operation)
    * 
@@ -59,6 +61,8 @@ class UserApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 0 :  (successful operation)
    * 
@@ -95,6 +99,8 @@ class UserApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : User (successful operation)
    *   code 400 :  (Invalid username supplied)
@@ -111,6 +117,8 @@ class UserApi(baseUrl: String) {
       
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : String (successful operation)
    *              Headers :
@@ -136,6 +144,8 @@ class UserApi(baseUrl: String) {
   }
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 0 :  (successful operation)
    * 

samples/client/petstore/scala-sttp/src/main/scala/org/openapitools/client/api/PetApi.scala

@@ -26,6 +26,8 @@ def apply(baseUrl: String = "http://petstore.swagger.io/v2") = new PetApi(baseUr
 class PetApi(baseUrl: String) {
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : Pet (successful operation)
    *   code 405 :  (Invalid input)
@@ -41,6 +43,8 @@ class PetApi(baseUrl: String) {
       .response(asJson[Pet])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 400 :  (Invalid pet value)
    * 
@@ -109,6 +113,8 @@ class PetApi(baseUrl: String) {
       .response(asJson[Pet])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : Pet (successful operation)
    *   code 400 :  (Invalid ID supplied)
@@ -126,6 +132,8 @@ class PetApi(baseUrl: String) {
       .response(asJson[Pet])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 405 :  (Invalid input)
    * 
@@ -145,6 +153,8 @@ class PetApi(baseUrl: String) {
       .response(asJson[Unit])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : ApiResponse (successful operation)
    * 

samples/client/petstore/scala-sttp/src/main/scala/org/openapitools/client/api/StoreApi.scala

@@ -74,6 +74,8 @@ class StoreApi(baseUrl: String) {
       .response(asJson[Order])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : Order (successful operation)
    *   code 400 :  (Invalid Order)

samples/client/petstore/scala-sttp/src/main/scala/org/openapitools/client/api/UserApi.scala

@@ -45,6 +45,8 @@ class UserApi(baseUrl: String) {
       .response(asJson[Unit])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 0 :  (successful operation)
    * 
@@ -63,6 +65,8 @@ class UserApi(baseUrl: String) {
       .response(asJson[Unit])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 0 :  (successful operation)
    * 
@@ -101,6 +105,8 @@ class UserApi(baseUrl: String) {
       .response(asJson[Unit])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : User (successful operation)
    *   code 400 :  (Invalid username supplied)
@@ -116,6 +122,8 @@ class UserApi(baseUrl: String) {
       .response(asJson[User])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 200 : String (successful operation)
    *              Headers :
@@ -135,6 +143,8 @@ class UserApi(baseUrl: String) {
       .response(asJson[String])
 
   /**
+   * 
+   * 
    * Expected answers:
    *   code 0 :  (successful operation)
    *