Minor improvement to Go client generator, move test case (#430)

* move test cases to under fake endpoint * remove trailing spaces in the template * update samples * add new file * minor fix to OAS3 spec
2025-12-11 04:42:47 +00:00 · 2018-07-02 10:23:12 +08:00
parent 412923ab5f
commit 862fe79f32
140 changed files with 1199 additions and 916 deletions
--- a/samples/client/petstore/java/feign/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/feign/src/main/java/org/openapitools/client/api/PetApi.java
@@ -184,14 +184,14 @@ public interface PetApi extends ApiClient.Api {
  ModelApiResponse uploadFile(@Param("petId") Long petId, @Param("additionalMetadata") String additionalMetadata, @Param("file") File file);

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
    * @param petId ID of pet to update (required)
    * @param file file to upload (required)
    * @param additionalMetadata Additional data to pass to server (optional, default to null)
   * @return ModelApiResponse
   */
-  @RequestLine("POST /pet/{petId}/uploadImageWithRequiredFile")
+  @RequestLine("POST /fake/{petId}/uploadImageWithRequiredFile")
  @Headers({
    "Content-Type: multipart/form-data",
    "Accept: application/json",
--- a/samples/client/petstore/java/google-api-client/docs/PetApi.md
+++ b/samples/client/petstore/java/google-api-client/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/google-api-client/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/google-api-client/src/main/java/org/openapitools/client/api/PetApi.java
@@ -716,7 +716,7 @@ public class PetApi {


  /**
-    * uploads an image
+    * uploads an image (required)
    * <p><b>200</b> - successful operation
    * @param petId ID of pet to update
    * @param file file to upload
@@ -731,7 +731,7 @@ public class PetApi {
    }

  /**
-    * uploads an image
+    * uploads an image (required)
    * <p><b>200</b> - successful operation
    * @param petId ID of pet to update
    * @param file file to upload
@@ -756,7 +756,7 @@ public class PetApi {
        // create a map of path variables
        final Map<String, Object> uriVariables = new HashMap<String, Object>();
        uriVariables.put("petId", petId);
-        UriBuilder uriBuilder = UriBuilder.fromUri(apiClient.getBasePath() + "/pet/{petId}/uploadImageWithRequiredFile");
+        UriBuilder uriBuilder = UriBuilder.fromUri(apiClient.getBasePath() + "/fake/{petId}/uploadImageWithRequiredFile");

        String url = uriBuilder.buildFromMap(uriVariables).toString();
        GenericUrl genericUrl = new GenericUrl(url);
@@ -776,7 +776,7 @@ public class PetApi {
        // create a map of path variables
        final Map<String, Object> uriVariables = new HashMap<String, Object>();
        uriVariables.put("petId", petId);
-        UriBuilder uriBuilder = UriBuilder.fromUri(apiClient.getBasePath() + "/pet/{petId}/uploadImageWithRequiredFile");
+        UriBuilder uriBuilder = UriBuilder.fromUri(apiClient.getBasePath() + "/fake/{petId}/uploadImageWithRequiredFile");

        // Copy the params argument if present, to allow passing in immutable maps
        Map<String, Object> allParams = params == null ? new HashMap<String, Object>() : new HashMap<String, Object>(params);
--- a/samples/client/petstore/java/jersey1/docs/PetApi.md
+++ b/samples/client/petstore/java/jersey1/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/jersey1/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/jersey1/src/main/java/org/openapitools/client/api/PetApi.java
@@ -406,7 +406,7 @@ if (file != null)
    return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
      }
  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -428,7 +428,7 @@ if (file != null)
    }
    
    // create path and map variables
-    String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile"
+    String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile"
      .replaceAll("\\{" + "petId" + "\\}", apiClient.escapeString(petId.toString()));

    // query params
--- a/samples/client/petstore/java/jersey2-java6/docs/PetApi.md
+++ b/samples/client/petstore/java/jersey2-java6/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/jersey2-java6/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/jersey2-java6/src/main/java/org/openapitools/client/api/PetApi.java
@@ -480,7 +480,7 @@ if (file != null)
    return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
      }
  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -493,7 +493,7 @@ if (file != null)
      }

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -515,7 +515,7 @@ if (file != null)
    }
    
    // create path and map variables
-    String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile"
+    String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile"
      .replaceAll("\\{" + "petId" + "\\}", apiClient.escapeString(petId.toString()));

    // query params
--- a/samples/client/petstore/java/jersey2-java8/docs/PetApi.md
+++ b/samples/client/petstore/java/jersey2-java8/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/jersey2-java8/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/jersey2-java8/src/main/java/org/openapitools/client/api/PetApi.java
@@ -480,7 +480,7 @@ if (file != null)
    return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
      }
  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -493,7 +493,7 @@ if (file != null)
      }

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -515,7 +515,7 @@ if (file != null)
    }
    
    // create path and map variables
-    String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile"
+    String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile"
      .replaceAll("\\{" + "petId" + "\\}", apiClient.escapeString(petId.toString()));

    // query params
--- a/samples/client/petstore/java/jersey2/docs/PetApi.md
+++ b/samples/client/petstore/java/jersey2/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/jersey2/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/jersey2/src/main/java/org/openapitools/client/api/PetApi.java
@@ -480,7 +480,7 @@ if (file != null)
    return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
      }
  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -493,7 +493,7 @@ if (file != null)
      }

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -515,7 +515,7 @@ if (file != null)
    }
    
    // create path and map variables
-    String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile"
+    String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile"
      .replaceAll("\\{" + "petId" + "\\}", apiClient.escapeString(petId.toString()));

    // query params
--- a/samples/client/petstore/java/okhttp-gson-parcelableModel/docs/PetApi.md
+++ b/samples/client/petstore/java/okhttp-gson-parcelableModel/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/okhttp-gson-parcelableModel/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/okhttp-gson-parcelableModel/src/main/java/org/openapitools/client/api/PetApi.java
@@ -1077,7 +1077,7 @@ public class PetApi {
        Object localVarPostBody = new Object();

        // create path and map variables
-        String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile"
+        String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile"
            .replaceAll("\\{" + "petId" + "\\}", apiClient.escapeString(petId.toString()));

        List<Pair> localVarQueryParams = new ArrayList<Pair>();
@@ -1139,7 +1139,7 @@ public class PetApi {
    }

    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
@@ -1153,7 +1153,7 @@ public class PetApi {
    }

    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
@@ -1168,7 +1168,7 @@ public class PetApi {
    }

    /**
-     * uploads an image (asynchronously)
+     * uploads an image (required) (asynchronously)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
--- a/samples/client/petstore/java/okhttp-gson/docs/PetApi.md
+++ b/samples/client/petstore/java/okhttp-gson/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/okhttp-gson/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/okhttp-gson/src/main/java/org/openapitools/client/api/PetApi.java
@@ -1077,7 +1077,7 @@ public class PetApi {
        Object localVarPostBody = new Object();

        // create path and map variables
-        String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile"
+        String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile"
            .replaceAll("\\{" + "petId" + "\\}", apiClient.escapeString(petId.toString()));

        List<Pair> localVarQueryParams = new ArrayList<Pair>();
@@ -1139,7 +1139,7 @@ public class PetApi {
    }

    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
@@ -1153,7 +1153,7 @@ public class PetApi {
    }

    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
@@ -1168,7 +1168,7 @@ public class PetApi {
    }

    /**
-     * uploads an image (asynchronously)
+     * uploads an image (required) (asynchronously)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
--- a/samples/client/petstore/java/rest-assured/docs/PetApi.md
+++ b/samples/client/petstore/java/rest-assured/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -350,7 +350,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/rest-assured/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/rest-assured/src/main/java/org/openapitools/client/api/PetApi.java
@@ -743,7 +743,7 @@ public class PetApi {
        }
    }
    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     *
     * @see #petIdPath ID of pet to update (required)
@@ -753,7 +753,7 @@ public class PetApi {
     */
    public class UploadFileWithRequiredFileOper {

-        public static final String REQ_URI = "/pet/{petId}/uploadImageWithRequiredFile";
+        public static final String REQ_URI = "/fake/{petId}/uploadImageWithRequiredFile";

        private RequestSpecBuilder reqSpec;

@@ -774,7 +774,7 @@ public class PetApi {
        }

        /**
-         * POST /pet/{petId}/uploadImageWithRequiredFile
+         * POST /fake/{petId}/uploadImageWithRequiredFile
         * @param handler handler
         * @param <T> type
         * @return type
@@ -784,7 +784,7 @@ public class PetApi {
        }

        /**
-         * POST /pet/{petId}/uploadImageWithRequiredFile
+         * POST /fake/{petId}/uploadImageWithRequiredFile
         * @param handler handler
         * @return ModelApiResponse
         */
--- a/samples/client/petstore/java/resteasy/docs/PetApi.md
+++ b/samples/client/petstore/java/resteasy/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/resteasy/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/resteasy/src/main/java/org/openapitools/client/api/PetApi.java
@@ -384,7 +384,7 @@ if (file != null)
    return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
      }
  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -406,7 +406,7 @@ if (file != null)
    }
    
    // create path and map variables
-    String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile".replaceAll("\\{format\\}","json")
+    String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile".replaceAll("\\{format\\}","json")
      .replaceAll("\\{" + "petId" + "\\}", apiClient.escapeString(petId.toString()));

    // query params
--- a/samples/client/petstore/java/resttemplate-withXml/docs/PetApi.md
+++ b/samples/client/petstore/java/resttemplate-withXml/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/resttemplate-withXml/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/resttemplate-withXml/src/main/java/org/openapitools/client/api/PetApi.java
@@ -356,7 +356,7 @@ public class PetApi {
        return apiClient.invokeAPI(path, HttpMethod.POST, queryParams, postBody, headerParams, formParams, accept, contentType, authNames, returnType);
    }
    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * <p><b>200</b> - successful operation
     * @param petId ID of pet to update
@@ -381,7 +381,7 @@ public class PetApi {
        // create path and map variables
        final Map<String, Object> uriVariables = new HashMap<String, Object>();
        uriVariables.put("petId", petId);
-        String path = UriComponentsBuilder.fromPath("/pet/{petId}/uploadImageWithRequiredFile").buildAndExpand(uriVariables).toUriString();
+        String path = UriComponentsBuilder.fromPath("/fake/{petId}/uploadImageWithRequiredFile").buildAndExpand(uriVariables).toUriString();
        
        final MultiValueMap<String, String> queryParams = new LinkedMultiValueMap<String, String>();
        final HttpHeaders headerParams = new HttpHeaders();
--- a/samples/client/petstore/java/resttemplate/docs/PetApi.md
+++ b/samples/client/petstore/java/resttemplate/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/resttemplate/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/resttemplate/src/main/java/org/openapitools/client/api/PetApi.java
@@ -356,7 +356,7 @@ public class PetApi {
        return apiClient.invokeAPI(path, HttpMethod.POST, queryParams, postBody, headerParams, formParams, accept, contentType, authNames, returnType);
    }
    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * <p><b>200</b> - successful operation
     * @param petId ID of pet to update
@@ -381,7 +381,7 @@ public class PetApi {
        // create path and map variables
        final Map<String, Object> uriVariables = new HashMap<String, Object>();
        uriVariables.put("petId", petId);
-        String path = UriComponentsBuilder.fromPath("/pet/{petId}/uploadImageWithRequiredFile").buildAndExpand(uriVariables).toUriString();
+        String path = UriComponentsBuilder.fromPath("/fake/{petId}/uploadImageWithRequiredFile").buildAndExpand(uriVariables).toUriString();
        
        final MultiValueMap<String, String> queryParams = new LinkedMultiValueMap<String, String>();
        final HttpHeaders headerParams = new HttpHeaders();
--- a/samples/client/petstore/java/retrofit/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/retrofit/src/main/java/org/openapitools/client/api/PetApi.java
@@ -223,7 +223,7 @@ public interface PetApi {
    @retrofit.http.Path("petId") Long petId, @retrofit.http.Part("additionalMetadata") String additionalMetadata, @retrofit.http.Part("file") TypedFile file, Callback<ModelApiResponse> cb
  );
  /**
-   * uploads an image
+   * uploads an image (required)
   * Sync method
   * 
   * @param petId ID of pet to update (required)
@@ -233,13 +233,13 @@ public interface PetApi {
   */
  
  @retrofit.http.Multipart
-  @POST("/pet/{petId}/uploadImageWithRequiredFile")
+  @POST("/fake/{petId}/uploadImageWithRequiredFile")
  ModelApiResponse uploadFileWithRequiredFile(
    @retrofit.http.Path("petId") Long petId, @retrofit.http.Part("file") TypedFile file, @retrofit.http.Part("additionalMetadata") String additionalMetadata
  );

  /**
-   * uploads an image
+   * uploads an image (required)
   * Async method
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -248,7 +248,7 @@ public interface PetApi {
   */
  
  @retrofit.http.Multipart
-  @POST("/pet/{petId}/uploadImageWithRequiredFile")
+  @POST("/fake/{petId}/uploadImageWithRequiredFile")
  void uploadFileWithRequiredFile(
    @retrofit.http.Path("petId") Long petId, @retrofit.http.Part("file") TypedFile file, @retrofit.http.Part("additionalMetadata") String additionalMetadata, Callback<ModelApiResponse> cb
  );
--- a/samples/client/petstore/java/retrofit2-play24/docs/PetApi.md
+++ b/samples/client/petstore/java/retrofit2-play24/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/retrofit2-play24/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/retrofit2-play24/src/main/java/org/openapitools/client/api/PetApi.java
@@ -126,7 +126,7 @@ public interface PetApi {
  );

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -134,7 +134,7 @@ public interface PetApi {
   * @return Call&lt;ModelApiResponse&gt;
   */
  @retrofit2.http.Multipart
-  @POST("pet/{petId}/uploadImageWithRequiredFile")
+  @POST("fake/{petId}/uploadImageWithRequiredFile")
  F.Promise<Response<ModelApiResponse>> uploadFileWithRequiredFile(
    @retrofit2.http.Path("petId") Long petId, @retrofit2.http.Part("file") MultipartBody.Part file, @retrofit2.http.Part("additionalMetadata") String additionalMetadata
  );
--- a/samples/client/petstore/java/retrofit2-play25/docs/PetApi.md
+++ b/samples/client/petstore/java/retrofit2-play25/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/retrofit2-play25/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/retrofit2-play25/src/main/java/org/openapitools/client/api/PetApi.java
@@ -126,7 +126,7 @@ public interface PetApi {
  );

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -134,7 +134,7 @@ public interface PetApi {
   * @return Call&lt;ModelApiResponse&gt;
   */
  @retrofit2.http.Multipart
-  @POST("pet/{petId}/uploadImageWithRequiredFile")
+  @POST("fake/{petId}/uploadImageWithRequiredFile")
  CompletionStage<Response<ModelApiResponse>> uploadFileWithRequiredFile(
    @retrofit2.http.Path("petId") Long petId, @retrofit2.http.Part("file") MultipartBody.Part file, @retrofit2.http.Part("additionalMetadata") String additionalMetadata
  );
--- a/samples/client/petstore/java/retrofit2/docs/PetApi.md
+++ b/samples/client/petstore/java/retrofit2/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/retrofit2/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/retrofit2/src/main/java/org/openapitools/client/api/PetApi.java
@@ -123,7 +123,7 @@ public interface PetApi {
  );

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -131,7 +131,7 @@ public interface PetApi {
   * @return Call&lt;ModelApiResponse&gt;
   */
  @retrofit2.http.Multipart
-  @POST("pet/{petId}/uploadImageWithRequiredFile")
+  @POST("fake/{petId}/uploadImageWithRequiredFile")
  Call<ModelApiResponse> uploadFileWithRequiredFile(
    @retrofit2.http.Path("petId") Long petId, @retrofit2.http.Part("file") MultipartBody.Part file, @retrofit2.http.Part("additionalMetadata") String additionalMetadata
  );
--- a/samples/client/petstore/java/retrofit2rx/docs/PetApi.md
+++ b/samples/client/petstore/java/retrofit2rx/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/retrofit2rx/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/retrofit2rx/src/main/java/org/openapitools/client/api/PetApi.java
@@ -123,7 +123,7 @@ public interface PetApi {
  );

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -131,7 +131,7 @@ public interface PetApi {
   * @return Observable&lt;ModelApiResponse&gt;
   */
  @retrofit2.http.Multipart
-  @POST("pet/{petId}/uploadImageWithRequiredFile")
+  @POST("fake/{petId}/uploadImageWithRequiredFile")
  Observable<ModelApiResponse> uploadFileWithRequiredFile(
    @retrofit2.http.Path("petId") Long petId, @retrofit2.http.Part("file") MultipartBody.Part file, @retrofit2.http.Part("additionalMetadata") String additionalMetadata
  );
--- a/samples/client/petstore/java/retrofit2rx2/docs/PetApi.md
+++ b/samples/client/petstore/java/retrofit2rx2/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/retrofit2rx2/src/main/java/org/openapitools/client/api/PetApi.java
+++ b/samples/client/petstore/java/retrofit2rx2/src/main/java/org/openapitools/client/api/PetApi.java
@@ -124,7 +124,7 @@ public interface PetApi {
  );

  /**
-   * uploads an image
+   * uploads an image (required)
   * 
   * @param petId ID of pet to update (required)
   * @param file file to upload (required)
@@ -132,7 +132,7 @@ public interface PetApi {
   * @return Observable&lt;ModelApiResponse&gt;
   */
  @retrofit2.http.Multipart
-  @POST("pet/{petId}/uploadImageWithRequiredFile")
+  @POST("fake/{petId}/uploadImageWithRequiredFile")
  Observable<ModelApiResponse> uploadFileWithRequiredFile(
    @retrofit2.http.Path("petId") Long petId, @retrofit2.http.Part("file") MultipartBody.Part file, @retrofit2.http.Part("additionalMetadata") String additionalMetadata
  );
--- a/samples/client/petstore/java/vertx/docs/PetApi.md
+++ b/samples/client/petstore/java/vertx/docs/PetApi.md
@@ -12,7 +12,7 @@ Method | HTTP request | Description
 [**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** /pet/{petId}/uploadImageWithRequiredFile | uploads an image
+[**uploadFileWithRequiredFile**](PetApi.md#uploadFileWithRequiredFile) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required)


 <a name="addPet"></a>
@@ -441,7 +441,7 @@ Name | Type | Description  | Notes
 # **uploadFileWithRequiredFile**
 > ModelApiResponse uploadFileWithRequiredFile(petId, file, additionalMetadata)

-uploads an image
+uploads an image (required)

 ### Example
 ```java
--- a/samples/client/petstore/java/vertx/src/main/java/org/openapitools/client/api/PetApiImpl.java
+++ b/samples/client/petstore/java/vertx/src/main/java/org/openapitools/client/api/PetApiImpl.java
@@ -325,7 +325,7 @@ if (file != null) localVarFormParams.put("file", file);
        apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarBody, localVarHeaderParams, localVarFormParams, localVarAccepts, localVarContentTypes, localVarAuthNames, localVarReturnType, resultHandler);
    }
    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
@@ -348,7 +348,7 @@ if (file != null) localVarFormParams.put("file", file);
        }
        
        // create path and map variables
-        String localVarPath = "/pet/{petId}/uploadImageWithRequiredFile".replaceAll("\\{" + "petId" + "\\}", petId.toString());
+        String localVarPath = "/fake/{petId}/uploadImageWithRequiredFile".replaceAll("\\{" + "petId" + "\\}", petId.toString());

        // query params
        List<Pair> localVarQueryParams = new ArrayList<>();
--- a/samples/client/petstore/java/vertx/src/main/java/org/openapitools/client/api/rxjava/PetApi.java
+++ b/samples/client/petstore/java/vertx/src/main/java/org/openapitools/client/api/rxjava/PetApi.java
@@ -202,7 +202,7 @@ public class PetApi {
        }));
    }
    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)
@@ -214,7 +214,7 @@ public class PetApi {
    }

    /**
-     * uploads an image
+     * uploads an image (required)
     * 
     * @param petId ID of pet to update (required)
     * @param file file to upload (required)