openapi-json-schema-tools · spacether · Dec 4, 2023 · Dec 4, 2023 · Dec 4, 2023 · Dec 4, 2023
diff --git a/samples/client/3_0_3_unit_test/java/README.md b/samples/client/3_0_3_unit_test/java/README.md
@@ -152,7 +152,6 @@ org.openapijsonschematools.client.components.schemas to validate input payloads
 output classes. Json schemas allow multiple types for one schema, so a schema's validate method can have
 allowed input and output types.
 
-
 ## Component Schemas
 
 | Class | Description |
@@ -244,4 +243,3 @@ allowed input and output types.
 | [UriFormat.UriFormat1](docs/components/schemas/UriFormat.md#uriformat1) | |
 | [UriReferenceFormat.UriReferenceFormat1](docs/components/schemas/UriReferenceFormat.md#urireferenceformat1) | |
 | [UriTemplateFormat.UriTemplateFormat1](docs/components/schemas/UriTemplateFormat.md#uritemplateformat1) | |
-
diff --git a/...penapi_features/nonCompliantUseDiscriminatorIfCompositionFails/python/README.md b/...penapi_features/nonCompliantUseDiscriminatorIfCompositionFails/python/README.md
@@ -152,6 +152,7 @@ with this_package.ApiClient(used_configuration) as api_client:
         "operator_id": "ADD",
     )
     try:
+        # 
         api_response = api_instance.post_operators(
             body=body,
         )
@@ -180,9 +181,9 @@ HTTP request | Method | Description
 
 Class | Description
 ----- | ------------
-[AdditionOperator](docs/components/schema/addition_operator.md) |
-[Operator](docs/components/schema/operator.md) |
-[SubtractionOperator](docs/components/schema/subtraction_operator.md) |
+[AdditionOperator](docs/components/schema/addition_operator.md) | 
+[Operator](docs/components/schema/operator.md) | 
+[SubtractionOperator](docs/components/schema/subtraction_operator.md) | 
 
 ## Notes for Large OpenAPI documents
 If the OpenAPI document is large, imports in this_package.apis.tags.tag_to_api and this_package.components.schemas may fail with a

diff --git a/...criminatorIfCompositionFails/python/docs/components/schema/addition_operator.md b/...criminatorIfCompositionFails/python/docs/components/schema/addition_operator.md
@@ -4,6 +4,9 @@ this_package.components.schema.addition_operator
 type: schemas.Schema
 ```
 
+## Description
+
+
 ## validate method
 Input Type | Return Type | Notes
 ------------ | ------------- | -------------

diff --git a/...antUseDiscriminatorIfCompositionFails/python/docs/components/schema/operator.md b/...antUseDiscriminatorIfCompositionFails/python/docs/components/schema/operator.md
@@ -4,6 +4,9 @@ this_package.components.schema.operator
 type: schemas.Schema
 ```
 
+## Description
+
+
 ## validate method
 Input Type | Return Type | Notes
 ------------ | ------------- | -------------

diff --git a/...minatorIfCompositionFails/python/docs/components/schema/subtraction_operator.md b/...minatorIfCompositionFails/python/docs/components/schema/subtraction_operator.md
@@ -4,6 +4,9 @@ this_package.components.schema.subtraction_operator
 type: schemas.Schema
 ```
 
+## Description
+
+
 ## validate method
 Input Type | Return Type | Notes
 ------------ | ------------- | -------------

diff --git a/...CompliantUseDiscriminatorIfCompositionFails/python/docs/paths/operators/post.md b/...CompliantUseDiscriminatorIfCompositionFails/python/docs/paths/operators/post.md
@@ -17,6 +17,7 @@ this_package.paths.operators.operation
 ## General Info
 | Field | Value |
 | ----- | ----- |
+| Summary |  |
 | Path | "/operators" |
 | HTTP Method | post |
 
@@ -101,6 +102,7 @@ with this_package.ApiClient(used_configuration) as api_client:
         "operator_id": "ADD",
     )
     try:
+        # 
         api_response = api_instance.post_operators(
             body=body,
         )

diff --git a/...iminatorIfCompositionFails/python/src/this_package/components/schema/addition_operator.py b/...iminatorIfCompositionFails/python/src/this_package/components/schema/addition_operator.py
@@ -122,6 +122,8 @@ class AdditionOperator(
     Ref: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator
 
     Do not edit the class manually.
+
+
     """
     types: typing.FrozenSet[typing.Type] = frozenset({schemas.immutabledict})
     required: typing.FrozenSet[str] = frozenset({

diff --git a/...tUseDiscriminatorIfCompositionFails/python/src/this_package/components/schema/operator.py b/...tUseDiscriminatorIfCompositionFails/python/src/this_package/components/schema/operator.py
@@ -27,6 +27,8 @@ class Operator(
     Ref: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator
 
     Do not edit the class manually.
+
+
     """
     # any type
     discriminator: typing.Mapping[str, typing.Mapping[str, typing.Type[schemas.Schema]]] = dataclasses.field(

diff --git a/...natorIfCompositionFails/python/src/this_package/components/schema/subtraction_operator.py b/...natorIfCompositionFails/python/src/this_package/components/schema/subtraction_operator.py
@@ -122,6 +122,8 @@ class SubtractionOperator(
     Ref: https://github.com/openapi-json-schema-tools/openapi-json-schema-generator
 
     Do not edit the class manually.
+
+
     """
     types: typing.FrozenSet[typing.Type] = frozenset({schemas.immutabledict})
     required: typing.FrozenSet[str] = frozenset({

diff --git a/...DiscriminatorIfCompositionFails/python/src/this_package/paths/operators/post/operation.py b/...DiscriminatorIfCompositionFails/python/src/this_package/paths/operators/post/operation.py
@@ -75,6 +75,7 @@ def _post_operators(
         timeout: typing.Optional[typing.Union[int, float, typing.Tuple]] = None,
     ):
         """
+
         :param skip_deserialization: If true then api_response.response will be set but
             api_response.body and api_response.headers will not be deserialized into schema
             class instances

diff --git a/samples/client/openapi_features/security/python/README.md b/samples/client/openapi_features/security/python/README.md
@@ -147,8 +147,7 @@ with this_package.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' path with no explicit security
-        '''
+        # path with no explicit security
         api_response = api_instance.path_with_no_explicit_security()
         pprint(api_response)
     except this_package.ApiException as e:

diff --git a/...enapi_features/security/python/docs/paths/path_with_no_explicit_security/get.md b/...enapi_features/security/python/docs/paths/path_with_no_explicit_security/get.md
@@ -77,8 +77,7 @@ with this_package.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' path with no explicit security
-        '''
+        # path with no explicit security
         api_response = api_instance.path_with_no_explicit_security()
         pprint(api_response)
     except this_package.ApiException as e:

diff --git a/...napi_features/security/python/docs/paths/path_with_one_explicit_security/get.md b/...napi_features/security/python/docs/paths/path_with_one_explicit_security/get.md
@@ -104,8 +104,7 @@ with this_package.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' path with one explicit security
-        '''
+        # path with one explicit security
         api_response = api_instance.path_with_one_explicit_security()
         pprint(api_response)
     except this_package.ApiException as e:

diff --git a/...openapi_features/security/python/docs/paths/path_with_security_from_root/get.md b/...openapi_features/security/python/docs/paths/path_with_security_from_root/get.md
@@ -145,8 +145,7 @@ with this_package.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' path with security from root
-        '''
+        # path with security from root
         api_response = api_instance.path_with_security_from_root()
         pprint(api_response)
     except this_package.ApiException as e:

diff --git a/...napi_features/security/python/docs/paths/path_with_two_explicit_security/get.md b/...napi_features/security/python/docs/paths/path_with_two_explicit_security/get.md
@@ -121,8 +121,7 @@ with this_package.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' path with two explicit security
-        '''
+        # path with two explicit security
         api_response = api_instance.path_with_two_explicit_security()
         pprint(api_response)
     except this_package.ApiException as e:

diff --git a/samples/client/petstore/java/README.md b/samples/client/petstore/java/README.md
@@ -152,7 +152,6 @@ org.openapijsonschematools.client.components.schemas to validate input payloads
 output classes. Json schemas allow multiple types for one schema, so a schema's validate method can have
 allowed input and output types.
 
-
 ## Component Schemas
 
 | Class | Description |
@@ -295,4 +294,3 @@ allowed input and output types.
 | [Mammal.Mammal1](docs/components/schemas/Mammal.md#mammal1) | |
 | [Whale.Whale1](docs/components/schemas/Whale.md#whale1) | |
 | [Zebra.Zebra1](docs/components/schemas/Zebra.md#zebra1) | |
-
diff --git a/samples/client/petstore/python/README.md b/samples/client/petstore/python/README.md
@@ -147,8 +147,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' slash route
-        '''
+        # slash route
         api_response = api_instance.slash_route()
         pprint(api_response)
     except petstore_api.ApiException as e:
@@ -398,7 +397,8 @@ Class | Description
 
 Class | Description
 ----- | ------------
-[HeadersWithNoBody](docs/components/responses/response_headers_with_no_body.md) | A response that contains headers but no body 
+[HeadersWithNoBody](docs/components/responses/response_headers_with_no_body.md) | A response that contains headers but no body
+
 [RefSuccessDescriptionOnly](docs/components/responses/response_ref_success_description_only.md) |
 [RefSuccessfulXmlAndJsonArrayOfPet](docs/components/responses/response_ref_successful_xml_and_json_array_of_pet.md) |
 [SuccessDescriptionOnly](docs/components/responses/response_success_description_only.md) | Success

diff --git a/...ient/petstore/python/docs/components/responses/response_headers_with_no_body.md b/...ient/petstore/python/docs/components/responses/response_headers_with_no_body.md
@@ -2,7 +2,8 @@ petstore_api.components.responses.response_headers_with_no_body
 # Response HeadersWithNoBody
 
 ## Description
-A response that contains headers but no body 
+A response that contains headers but no body
+
 
 ## ApiResponse
 Name | Type | Description  | Notes

diff --git a/samples/client/petstore/python/docs/paths/another_fake_dummy/patch.md b/samples/client/petstore/python/docs/paths/another_fake_dummy/patch.md
@@ -103,8 +103,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "client": "client_example",
     })
     try:
-        ''' To test special tags
-        '''
+        # To test special tags
         api_response = api_instance.call_123_test__special_tags(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake/delete.md b/samples/client/petstore/python/docs/paths/fake/delete.md
@@ -193,8 +193,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         'required_boolean_group': "true",
     }
     try:
-        ''' Fake endpoint to test group parameters (optional)
-        '''
+        # Fake endpoint to test group parameters (optional)
         api_response = api_instance.group_parameters(
             query_params=query_params,
             header_params=header_params,
@@ -215,8 +214,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         'boolean_group': "true",
     }
     try:
-        ''' Fake endpoint to test group parameters (optional)
-        '''
+        # Fake endpoint to test group parameters (optional)
         api_response = api_instance.group_parameters(
             query_params=query_params,
             header_params=header_params,

diff --git a/samples/client/petstore/python/docs/paths/fake/get.md b/samples/client/petstore/python/docs/paths/fake/get.md
@@ -317,8 +317,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "enum_form_string": "-efg",
     }
     try:
-        ''' To test enum parameters
-        '''
+        # To test enum parameters
         api_response = api_instance.enum_parameters(
             query_params=query_params,
             header_params=header_params,

diff --git a/samples/client/petstore/python/docs/paths/fake/patch.md b/samples/client/petstore/python/docs/paths/fake/patch.md
@@ -103,8 +103,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "client": "client_example",
     })
     try:
-        ''' To test &quot;client&quot; model
-        '''
+        # To test \\\"client\\\" model
         api_response = api_instance.client_model(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake/post.md b/samples/client/petstore/python/docs/paths/fake/post.md
@@ -222,12 +222,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "callback": "callback_example",
     }
     try:
-        ''' Fake endpoint for testing various parameters
-假端點
-偽のエンドポイント
-가짜 엔드 포인트
-
-        '''
+        # Fake endpoint for testing various parameters 假端點 偽のエンドポイント 가짜 엔드 포인트 
         api_response = api_instance.endpoint_parameters(
             body=body,
         )

diff --git a/...etstore/python/docs/paths/fake_additional_properties_with_array_of_enums/get.md b/...etstore/python/docs/paths/fake_additional_properties_with_array_of_enums/get.md
@@ -125,8 +125,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         ],
     })
     try:
-        ''' Additional Properties with Array of Enums
-        '''
+        # Additional Properties with Array of Enums
         api_response = api_instance.additional_properties_with_array_of_enums(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake_classname_test/patch.md b/samples/client/petstore/python/docs/paths/fake_classname_test/patch.md
@@ -130,8 +130,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "client": "client_example",
     })
     try:
-        ''' To test class name in snake case
-        '''
+        # To test class name in snake case
         api_response = api_instance.classname(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake_delete_coffee_id/delete.md b/samples/client/petstore/python/docs/paths/fake_delete_coffee_id/delete.md
@@ -124,8 +124,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         'id': "id_example",
     }
     try:
-        ''' Delete coffee
-        '''
+        # Delete coffee
         api_response = api_instance.delete_coffee(
             path_params=path_params,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake_health/get.md b/samples/client/petstore/python/docs/paths/fake_health/get.md
@@ -97,8 +97,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' Health check endpoint
-        '''
+        # Health check endpoint
         api_response = api_instance.fake_health_get()
         pprint(api_response)
     except petstore_api.ApiException as e:

diff --git a/...les/client/petstore/python/docs/paths/fake_inline_additional_properties/post.md b/...les/client/petstore/python/docs/paths/fake_inline_additional_properties/post.md
@@ -18,6 +18,7 @@ petstore_api.paths.fake_inline_additional_properties.operation
 | Field | Value |
 | ----- | ----- |
 | Summary | test inline additionalProperties |
+| Description |  |
 | Path | "/fake/inline-additionalProperties" |
 | HTTP Method | post |
 
@@ -120,8 +121,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "key": "key_example",
     }
     try:
-        ''' test inline additionalProperties
-        '''
+        # test inline additionalProperties
         api_response = api_instance.inline_additional_properties(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake_inline_composition/post.md b/samples/client/petstore/python/docs/paths/fake_inline_composition/post.md
@@ -339,8 +339,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
     }
     body = None
     try:
-        ''' testing composed schemas at inline locations
-        '''
+        # testing composed schemas at inline locations
         api_response = api_instance.inline_composition(
             query_params=query_params,
             body=body,

diff --git a/samples/client/petstore/python/docs/paths/fake_json_form_data/get.md b/samples/client/petstore/python/docs/paths/fake_json_form_data/get.md
@@ -18,6 +18,7 @@ petstore_api.paths.fake_json_form_data.operation
 | Field | Value |
 | ----- | ----- |
 | Summary | test json serialization of form data |
+| Description |  |
 | Path | "/fake/jsonFormData" |
 | HTTP Method | get |
 
@@ -125,8 +126,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "param2": "param2_example",
     }
     try:
-        ''' test json serialization of form data
-        '''
+        # test json serialization of form data
         api_response = api_instance.json_form_data(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake_json_patch/patch.md b/samples/client/petstore/python/docs/paths/fake_json_patch/patch.md
@@ -91,8 +91,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         None
     ])
     try:
-        ''' json patch
-        '''
+        # json patch
         api_response = api_instance.json_patch(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake_json_with_charset/post.md b/samples/client/petstore/python/docs/paths/fake_json_with_charset/post.md
@@ -118,8 +118,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
     # example passing only optional values
     body = None
     try:
-        ''' json with charset tx and rx
-        '''
+        # json with charset tx and rx
         api_response = api_instance.json_with_charset(
             body=body,
         )

diff --git a/...ent/petstore/python/docs/paths/fake_multiple_request_body_content_types/post.md b/...ent/petstore/python/docs/paths/fake_multiple_request_body_content_types/post.md
@@ -197,8 +197,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         "a": "a_example",
     }
     try:
-        ''' testing composed schemas at inline locations
-        '''
+        # testing composed schemas at inline locations
         api_response = api_instance.multiple_request_body_content_types(
             body=body,
         )

diff --git a/samples/client/petstore/python/docs/paths/fake_multiple_response_bodies/get.md b/samples/client/petstore/python/docs/paths/fake_multiple_response_bodies/get.md
@@ -127,8 +127,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
 
     # example, this endpoint has no required or optional parameters
     try:
-        ''' multiple responses have response bodies
-        '''
+        # multiple responses have response bodies
         api_response = api_instance.multiple_response_bodies()
         pprint(api_response)
     except petstore_api.ApiException as e: