v2 improve endpoint params code sample (#146)

* Adds type hints for path/query/cookie/header params in endpoint code samples

* Samples regen

* Simplifies makefiles

Author: spacether

modules/openapi-json-schema-generator/src/main/resources/python/paths/path/verb/_helper_operation_doc_example.hbs

@@ -10,6 +10,9 @@ from {{packageName}}.{{apiPackage}}.tags import {{moduleName}}
         {{/if}}
     {{/each}}
 {{/if}}
+{{#or pathParams queryParams headerParams cookieParams}}
+from {{packageName}}.paths.{{path.snakeCase}}.{{jsonPathPiece.original}} import operation
+{{/or}}
 {{#each imports}}
 {{{.}}}
 {{/each}}
@@ -31,7 +34,7 @@ with {{{packageName}}}.ApiClient(used_configuration) as api_client:
 
     # example passing only required values which don't have defaults set
     {{#if pathParams}}
-    path_params = {
+    path_params: operation.RequestPathParameters.Params = {
         {{#each pathParams}}
             {{#if refInfo}}
                 {{#if getDeepestRef.required}}
@@ -46,7 +49,7 @@ with {{{packageName}}}.ApiClient(used_configuration) as api_client:
     }
     {{/if}}
     {{#if queryParams}}
-    query_params = {
+    query_params: operation.RequestQueryParameters.Params = {
         {{#each queryParams}}
             {{#if refInfo}}
                 {{#if getDeepestRef.required}}
@@ -61,7 +64,7 @@ with {{{packageName}}}.ApiClient(used_configuration) as api_client:
     }
     {{/if}}
     {{#if cookieParams}}
-    cookie_params = {
+    cookie_params: operation.RequestCookieParameters.Params = {
         {{#each cookieParams}}
             {{#if refInfo}}
                 {{#if getDeepestRef.required}}
@@ -76,7 +79,7 @@ with {{{packageName}}}.ApiClient(used_configuration) as api_client:
     }
     {{/if}}
     {{#if headerParams}}
-    header_params = {
+    header_params: operation.RequestHeaderParameters.Params = {
         {{#each headerParams}}
             {{#if refInfo}}
                 {{#if getDeepestRef.required}}
@@ -169,7 +172,7 @@ with {{{packageName}}}.ApiClient(used_configuration) as api_client:
     }
     {{/if}}
     {{#if queryParams}}
-    query_params = {
+    query_params: operation.RequestQueryParameters.Params = {
         {{#each queryParams}}
             {{#if refInfo}}
         '{{getDeepestRef.name}}': {{{getDeepestRef.example}}},
@@ -180,7 +183,7 @@ with {{{packageName}}}.ApiClient(used_configuration) as api_client:
     }
     {{/if}}
     {{#if cookieParams}}
-    cookie_params = {
+    cookie_params: operation.RequestCookieParameters.Params = {
         {{#each cookieParams}}
             {{#if refInfo}}
         '{{getDeepestRef.name}}': {{{getDeepestRef.example}}},
@@ -191,7 +194,7 @@ with {{{packageName}}}.ApiClient(used_configuration) as api_client:
     }
     {{/if}}
     {{#if headerParams}}
-    header_params = {
+    header_params: operation.RequestHeaderParameters.Params = {
         {{#each headerParams}}
             {{#if refInfo}}
         '{{getDeepestRef.name}}': {{{getDeepestRef.example}}},

samples/openapi3/client/3_0_3_unit_test/python/Makefile

@@ -1,10 +1,7 @@
-REQUIREMENTS_FILE=dev-requirements.txt
-REQUIREMENTS_OUT=dev-requirements.txt.log
 SETUP_OUT=*.egg-info
 VENV=venv
 
 clean:
-	rm -rf $(REQUIREMENTS_OUT)
 	rm -rf $(SETUP_OUT)
 	rm -rf $(VENV)
 	rm -rf .tox

samples/openapi3/client/features/nonCompliantUseDiscriminatorIfCompositionFails/python/Makefile

@@ -1,10 +1,7 @@
-REQUIREMENTS_FILE=dev-requirements.txt
-REQUIREMENTS_OUT=dev-requirements.txt.log
 SETUP_OUT=*.egg-info
 VENV=venv
 
 clean:
-	rm -rf $(REQUIREMENTS_OUT)
 	rm -rf $(SETUP_OUT)
 	rm -rf $(VENV)
 	rm -rf .tox

samples/openapi3/client/features/nonCompliantUseDiscriminatorIfCompositionFails/python/docs/apis/tags/DefaultApi.md

@@ -1,10 +1,7 @@
-REQUIREMENTS_FILE=dev-requirements.txt
-REQUIREMENTS_OUT=dev-requirements.txt.log
 SETUP_OUT=*.egg-info
 VENV=venv
 
 clean:
-	rm -rf $(REQUIREMENTS_OUT)
 	rm -rf $(SETUP_OUT)
 	rm -rf $(VENV)
 	rm -rf .tox

samples/openapi3/client/features/security/python/Makefile

@@ -1,10 +1,7 @@
-REQUIREMENTS_FILE=dev-requirements.txt
-REQUIREMENTS_OUT=dev-requirements.txt.log
 SETUP_OUT=*.egg-info
 VENV=venv
 
 clean:
-	rm -rf $(REQUIREMENTS_OUT)
 	rm -rf $(SETUP_OUT)
 	rm -rf $(VENV)
 	rm -rf .tox

samples/openapi3/client/petstore/python/Makefile

@@ -169,6 +169,7 @@ server_index | Class | Description
 import petstore_api
 from petstore_api.configurations import api_configuration
 from petstore_api.apis.tags import fake_api
+from petstore_api.paths.fake.delete import operation
 from pprint import pprint
 # security_index 0
 from petstore_api.components.security_schemes import security_scheme_bearer_test
@@ -189,11 +190,11 @@ with petstore_api.ApiClient(used_configuration) as api_client:
     api_instance = fake_api.FakeApi(api_client)
 
     # example passing only required values which don't have defaults set
-    query_params = {
+    query_params: operation.RequestQueryParameters.Params = {
         'required_string_group': "required_string_group_example",
         'required_int64_group': 1,
     }
-    header_params = {
+    header_params: operation.RequestHeaderParameters.Params = {
         'required_boolean_group': "true",
     }
     try:
@@ -207,13 +208,13 @@ with petstore_api.ApiClient(used_configuration) as api_client:
         print("Exception when calling FakeApi->group_parameters: %s\n" % e)
 
     # example passing only optional values
-    query_params = {
+    query_params: operation.RequestQueryParameters.Params = {
         'required_string_group': "required_string_group_example",
         'required_int64_group': 1,
         'string_group': "string_group_example",
         'int64_group': 1,
     }
-    header_params = {
+    header_params: operation.RequestHeaderParameters.Params = {
         'required_boolean_group': "true",
         'boolean_group': "true",
     }

samples/openapi3/client/petstore/python/docs/paths/fake/delete.md

@@ -229,6 +229,7 @@ server_index | Class | Description
 import petstore_api
 from petstore_api.configurations import api_configuration
 from petstore_api.apis.tags import fake_api
+from petstore_api.paths.fake.get import operation
 from pprint import pprint
 used_configuration = api_configuration.ApiConfiguration(
 )
@@ -238,15 +239,15 @@ with petstore_api.ApiClient(used_configuration) as api_client:
     api_instance = fake_api.FakeApi(api_client)
 
     # example passing only optional values
-    query_params = {
+    query_params: operation.RequestQueryParameters.Params = {
         'enum_query_string_array': [
         "$"
     ],
         'enum_query_string': "-efg",
         'enum_query_integer': 1,
         'enum_query_double': 1.1,
     }
-    header_params = {
+    header_params: operation.RequestHeaderParameters.Params = {
         'enum_header_string_array': [
         "$"
     ],

samples/openapi3/client/petstore/python/docs/paths/fake/get.md

@@ -91,6 +91,7 @@ server_index | Class | Description
 import petstore_api
 from petstore_api.configurations import api_configuration
 from petstore_api.apis.tags import fake_api
+from petstore_api.paths.fake_body_with_query_params.put import operation
 from pprint import pprint
 used_configuration = api_configuration.ApiConfiguration(
 )
@@ -100,7 +101,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
     api_instance = fake_api.FakeApi(api_client)
 
     # example passing only required values which don't have defaults set
-    query_params = {
+    query_params: operation.RequestQueryParameters.Params = {
         'query': "query_example",
     }
     body = user.User(

samples/openapi3/client/petstore/python/docs/paths/fake_body_with_query_params/put.md

@@ -96,6 +96,7 @@ server_index | Class | Description
 import petstore_api
 from petstore_api.configurations import api_configuration
 from petstore_api.apis.tags import fake_api
+from petstore_api.paths.fake_case_sensitive_params.put import operation
 from pprint import pprint
 used_configuration = api_configuration.ApiConfiguration(
 )
@@ -105,7 +106,7 @@ with petstore_api.ApiClient(used_configuration) as api_client:
     api_instance = fake_api.FakeApi(api_client)
 
     # example passing only required values which don't have defaults set
-    query_params = {
+    query_params: operation.RequestQueryParameters.Params = {
         'someVar': "someVar_example",
         'SomeVar': "SomeVar_example",
         'some_var': "some_var_example",