[python] Renames python generators (#7965)

* python->python-legacy, python-experimental->python * test with openjdk8 * test with openjdk11 * comment out rm * move kotlin tests to circleci * move kotlin tests * move tests to circleci * fix circleci * rearrange test * move tests * use wrapper Co-authored-by: Justin Black <justin.a.black@gmail.com>
2020-11-18 14:34:00 +08:00
parent c08f14500e
commit 3bf8ca7484
1213 changed files with 40106 additions and 38656 deletions
--- a/samples/client/petstore/python/docs/PetApi.md
+++ b/samples/client/petstore/python/docs/PetApi.md
@@ -24,10 +24,10 @@ Add a new pet to the store

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
+from petstore_api.model.pet import Pet
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -49,13 +49,32 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    body = petstore_api.Pet() # Pet | Pet object that needs to be added to the store
+    api_instance = pet_api.PetApi(api_client)
+    body = Pet(
+        id=1,
+        category=Category(
+            id=1,
+            name="default-name",
+        ),
+        name="doggie",
+        photo_urls=[
+            "photo_urls_example",
+        ],
+        tags=[
+            Tag(
+                id=1,
+                name="name_example",
+                full_name="full_name_example",
+            ),
+        ],
+        status="available",
+    ) # Pet | Pet object that needs to be added to the store

+    # example passing only required values which don't have defaults set
    try:
        # Add a new pet to the store
        api_instance.add_pet(body)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->add_pet: %s\n" % e)
 ```

@@ -63,7 +82,7 @@ with petstore_api.ApiClient(configuration) as api_client:

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **body** | [**Pet**](Pet.md)| Pet object that needs to be added to the store | 
+ **body** | [**Pet**](Pet.md)| Pet object that needs to be added to the store |

 ### Return type

@@ -87,7 +106,7 @@ void (empty response body)
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

 # **delete_pet**
-> delete_pet(pet_id, api_key=api_key)
+> delete_pet(pet_id)

 Deletes a pet

@@ -95,10 +114,9 @@ Deletes a pet

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -120,14 +138,23 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    pet_id = 56 # int | Pet id to delete
-api_key = 'api_key_example' # str |  (optional)
+    api_instance = pet_api.PetApi(api_client)
+    pet_id = 1 # int | Pet id to delete
+    api_key = "api_key_example" # str |  (optional)

+    # example passing only required values which don't have defaults set
+    try:
+        # Deletes a pet
+        api_instance.delete_pet(pet_id)
+    except petstore_api.ApiException as e:
+        print("Exception when calling PetApi->delete_pet: %s\n" % e)
+
+    # example passing only required values which don't have defaults set
+    # and optional values
    try:
        # Deletes a pet
        api_instance.delete_pet(pet_id, api_key=api_key)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->delete_pet: %s\n" % e)
 ```

@@ -135,8 +162,8 @@ api_key = 'api_key_example' # str |  (optional)

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **pet_id** | **int**| Pet id to delete | 
- **api_key** | **str**|  | [optional] 
+ **pet_id** | **int**| Pet id to delete |
+ **api_key** | **str**|  | [optional]

 ### Return type

@@ -160,7 +187,7 @@ void (empty response body)
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

 # **find_pets_by_status**
-> list[Pet] find_pets_by_status(status)
+> [Pet] find_pets_by_status(status)

 Finds Pets by status

@@ -170,10 +197,10 @@ Multiple status values can be provided with comma separated strings

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
+from petstore_api.model.pet import Pet
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -195,14 +222,17 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    status = ['status_example'] # list[str] | Status values that need to be considered for filter
+    api_instance = pet_api.PetApi(api_client)
+    status = [
+        "available",
+    ] # [str] | Status values that need to be considered for filter

+    # example passing only required values which don't have defaults set
    try:
        # Finds Pets by status
        api_response = api_instance.find_pets_by_status(status)
        pprint(api_response)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->find_pets_by_status: %s\n" % e)
 ```

@@ -210,11 +240,11 @@ with petstore_api.ApiClient(configuration) as api_client:

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **status** | [**list[str]**](str.md)| Status values that need to be considered for filter | 
+ **status** | **[str]**| Status values that need to be considered for filter |

 ### Return type

-[**list[Pet]**](Pet.md)
+[**[Pet]**](Pet.md)

 ### Authorization

@@ -234,7 +264,7 @@ Name | Type | Description  | Notes
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

 # **find_pets_by_tags**
-> list[Pet] find_pets_by_tags(tags)
+> [Pet] find_pets_by_tags(tags)

 Finds Pets by tags

@@ -244,10 +274,10 @@ Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
+from petstore_api.model.pet import Pet
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -269,14 +299,17 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    tags = ['tags_example'] # list[str] | Tags to filter by
+    api_instance = pet_api.PetApi(api_client)
+    tags = [
+        "tags_example",
+    ] # [str] | Tags to filter by

+    # example passing only required values which don't have defaults set
    try:
        # Finds Pets by tags
        api_response = api_instance.find_pets_by_tags(tags)
        pprint(api_response)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->find_pets_by_tags: %s\n" % e)
 ```

@@ -284,11 +317,11 @@ with petstore_api.ApiClient(configuration) as api_client:

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **tags** | [**list[str]**](str.md)| Tags to filter by | 
+ **tags** | **[str]**| Tags to filter by |

 ### Return type

-[**list[Pet]**](Pet.md)
+[**[Pet]**](Pet.md)

 ### Authorization

@@ -318,10 +351,10 @@ Returns a single pet

 * Api Key Authentication (api_key):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
+from petstore_api.model.pet import Pet
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -343,14 +376,15 @@ configuration.api_key['api_key'] = 'YOUR_API_KEY'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    pet_id = 56 # int | ID of pet to return
+    api_instance = pet_api.PetApi(api_client)
+    pet_id = 1 # int | ID of pet to return

+    # example passing only required values which don't have defaults set
    try:
        # Find pet by ID
        api_response = api_instance.get_pet_by_id(pet_id)
        pprint(api_response)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->get_pet_by_id: %s\n" % e)
 ```

@@ -358,7 +392,7 @@ with petstore_api.ApiClient(configuration) as api_client:

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **pet_id** | **int**| ID of pet to return | 
+ **pet_id** | **int**| ID of pet to return |

 ### Return type

@@ -391,10 +425,10 @@ Update an existing pet

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
+from petstore_api.model.pet import Pet
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -416,13 +450,32 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    body = petstore_api.Pet() # Pet | Pet object that needs to be added to the store
+    api_instance = pet_api.PetApi(api_client)
+    body = Pet(
+        id=1,
+        category=Category(
+            id=1,
+            name="default-name",
+        ),
+        name="doggie",
+        photo_urls=[
+            "photo_urls_example",
+        ],
+        tags=[
+            Tag(
+                id=1,
+                name="name_example",
+                full_name="full_name_example",
+            ),
+        ],
+        status="available",
+    ) # Pet | Pet object that needs to be added to the store

+    # example passing only required values which don't have defaults set
    try:
        # Update an existing pet
        api_instance.update_pet(body)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->update_pet: %s\n" % e)
 ```

@@ -430,7 +483,7 @@ with petstore_api.ApiClient(configuration) as api_client:

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **body** | [**Pet**](Pet.md)| Pet object that needs to be added to the store | 
+ **body** | [**Pet**](Pet.md)| Pet object that needs to be added to the store |

 ### Return type

@@ -456,7 +509,7 @@ void (empty response body)
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

 # **update_pet_with_form**
-> update_pet_with_form(pet_id, name=name, status=status)
+> update_pet_with_form(pet_id)

 Updates a pet in the store with form data

@@ -464,10 +517,9 @@ Updates a pet in the store with form data

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -489,15 +541,24 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    pet_id = 56 # int | ID of pet that needs to be updated
-name = 'name_example' # str | Updated name of the pet (optional)
-status = 'status_example' # str | Updated status of the pet (optional)
+    api_instance = pet_api.PetApi(api_client)
+    pet_id = 1 # int | ID of pet that needs to be updated
+    name = "name_example" # str | Updated name of the pet (optional)
+    status = "status_example" # str | Updated status of the pet (optional)

+    # example passing only required values which don't have defaults set
+    try:
+        # Updates a pet in the store with form data
+        api_instance.update_pet_with_form(pet_id)
+    except petstore_api.ApiException as e:
+        print("Exception when calling PetApi->update_pet_with_form: %s\n" % e)
+
+    # example passing only required values which don't have defaults set
+    # and optional values
    try:
        # Updates a pet in the store with form data
        api_instance.update_pet_with_form(pet_id, name=name, status=status)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->update_pet_with_form: %s\n" % e)
 ```

@@ -505,9 +566,9 @@ status = 'status_example' # str | Updated status of the pet (optional)

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **pet_id** | **int**| ID of pet that needs to be updated | 
- **name** | **str**| Updated name of the pet | [optional] 
- **status** | **str**| Updated status of the pet | [optional] 
+ **pet_id** | **int**| ID of pet that needs to be updated |
+ **name** | **str**| Updated name of the pet | [optional]
+ **status** | **str**| Updated status of the pet | [optional]

 ### Return type

@@ -530,7 +591,7 @@ void (empty response body)
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

 # **upload_file**
-> ApiResponse upload_file(pet_id, additional_metadata=additional_metadata, file=file)
+> ApiResponse upload_file(pet_id)

 uploads an image

@@ -538,10 +599,10 @@ uploads an image

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
+from petstore_api.model.api_response import ApiResponse
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -563,16 +624,27 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    pet_id = 56 # int | ID of pet to update
-additional_metadata = 'additional_metadata_example' # str | Additional data to pass to server (optional)
-file = '/path/to/file' # file | file to upload (optional)
+    api_instance = pet_api.PetApi(api_client)
+    pet_id = 1 # int | ID of pet to update
+    additional_metadata = "additional_metadata_example" # str | Additional data to pass to server (optional)
+    file = open('/path/to/file', 'rb') # file_type | file to upload (optional)
+    files =  # [file_type] | files to upload (optional)

+    # example passing only required values which don't have defaults set
    try:
        # uploads an image
-        api_response = api_instance.upload_file(pet_id, additional_metadata=additional_metadata, file=file)
+        api_response = api_instance.upload_file(pet_id)
        pprint(api_response)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
+        print("Exception when calling PetApi->upload_file: %s\n" % e)
+
+    # example passing only required values which don't have defaults set
+    # and optional values
+    try:
+        # uploads an image
+        api_response = api_instance.upload_file(pet_id, additional_metadata=additional_metadata, file=file, files=files)
+        pprint(api_response)
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->upload_file: %s\n" % e)
 ```

@@ -580,9 +652,10 @@ file = '/path/to/file' # file | file to upload (optional)

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **pet_id** | **int**| ID of pet to update | 
- **additional_metadata** | **str**| Additional data to pass to server | [optional] 
- **file** | **file**| file to upload | [optional] 
+ **pet_id** | **int**| ID of pet to update |
+ **additional_metadata** | **str**| Additional data to pass to server | [optional]
+ **file** | **file_type**| file to upload | [optional]
+ **files** | **[file_type]**| files to upload | [optional]

 ### Return type

@@ -605,7 +678,7 @@ Name | Type | Description  | Notes
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

 # **upload_file_with_required_file**
-> ApiResponse upload_file_with_required_file(pet_id, required_file, additional_metadata=additional_metadata)
+> ApiResponse upload_file_with_required_file(pet_id, required_file)

 uploads an image (required)

@@ -613,10 +686,10 @@ uploads an image (required)

 * OAuth Authentication (petstore_auth):
 ```python
-from __future__ import print_function
 import time
 import petstore_api
-from petstore_api.rest import ApiException
+from petstore_api.api import pet_api
+from petstore_api.model.api_response import ApiResponse
 from pprint import pprint
 # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2
 # See configuration.py for a list of all supported configuration parameters.
@@ -638,16 +711,26 @@ configuration.access_token = 'YOUR_ACCESS_TOKEN'
 # Enter a context with an instance of the API client
 with petstore_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
-    api_instance = petstore_api.PetApi(api_client)
-    pet_id = 56 # int | ID of pet to update
-required_file = '/path/to/file' # file | file to upload
-additional_metadata = 'additional_metadata_example' # str | Additional data to pass to server (optional)
+    api_instance = pet_api.PetApi(api_client)
+    pet_id = 1 # int | ID of pet to update
+    required_file = open('/path/to/file', 'rb') # file_type | file to upload
+    additional_metadata = "additional_metadata_example" # str | Additional data to pass to server (optional)

+    # example passing only required values which don't have defaults set
+    try:
+        # uploads an image (required)
+        api_response = api_instance.upload_file_with_required_file(pet_id, required_file)
+        pprint(api_response)
+    except petstore_api.ApiException as e:
+        print("Exception when calling PetApi->upload_file_with_required_file: %s\n" % e)
+
+    # example passing only required values which don't have defaults set
+    # and optional values
    try:
        # uploads an image (required)
        api_response = api_instance.upload_file_with_required_file(pet_id, required_file, additional_metadata=additional_metadata)
        pprint(api_response)
-    except ApiException as e:
+    except petstore_api.ApiException as e:
        print("Exception when calling PetApi->upload_file_with_required_file: %s\n" % e)
 ```

@@ -655,9 +738,9 @@ additional_metadata = 'additional_metadata_example' # str | Additional data to p

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **pet_id** | **int**| ID of pet to update | 
- **required_file** | **file**| file to upload | 
- **additional_metadata** | **str**| Additional data to pass to server | [optional] 
+ **pet_id** | **int**| ID of pet to update |
+ **required_file** | **file_type**| file to upload |
+ **additional_metadata** | **str**| Additional data to pass to server | [optional]

 ### Return type