[python] : Make example code snippet compilable

[saigiridhar21]

PR checklist

• Read the contribution guidelines.
• Ran the shell script under ./bin/ to update Petstore sample so that CIs can verify the change. (For instance, only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the {LANG} (e.g. php, ruby, python, etc) code generator or {LANG} client's mustache templates). Windows batch files can be found in .\bin\windows\. If contributing template-only or documentation-only changes which will change sample output, be sure to build the project first.
• Filed the PR against the correct branch: master, 4.1.x, 5.0.x. Default: master.
• Copied the technical committee to review the pull request if your PR is targeting a particular programming language.

Description of the PR

Making example code snippets compilable.

@taxpon (2017/07) @frol (2017/07) @mbohlool (2017/07) @cbornet (2017/09) @kenjones-cisco (2017/11) @tomplus (2018/10) @Jyhess (2019/01)

[auto-labeler]

👍 Thanks for opening this issue!
🏷 I have applied any labels matching special text in your issue.

The team will review the labels and make any necessary changes.

[wing328]

@saigiridhar21 thanks for the PR. Please correct me if I'm wrong. I believe the default of configuration.host is already set to {{{basePath}}}. Why do we need to do it again before passing to ApiClient?:

[saigiridhar21]

@wing328 Yes. You are right. My reason might not be a strong one but it is more like a hint for users that they can update host.
In our use case, we have a horizontally scaled system and we generate SDKs using one of the hosts. So, we don't specify host in the swagger spec. As a result, SDKs get generated with localhost url. A public DNS is there which load balances requests to all the hosts. So, it is expected that clients specify the host in their code.

[wing328]

Very good reason. What about also adding a 1 liner comment explaining it's optional and default to {{{basePath}}} ？

[saigiridhar21]

Very good reason. What about also adding a 1 liner comment explaining it's optional and default to {{{basePath}}} ？ 在 2019年6月22日週六 上午10:21，Sai Giridhar P notifications@github.com 寫道：
…
@.**** commented on this pull request. ------------------------------ In modules/openapi-generator/src/main/resources/python/api_doc_example.mustache <#3148 (comment)> : > @@ -6,6 +6,7 @@ from {{{packageName}}}.rest import ApiException from pprint import pprint {{> python_doc_auth_partial}} {{#hasAuthMethods}} +configuration.host = "{{{basePath}}}" @wing328 https://github.com/wing328 Yes. You are right. My reason might not be a strong one but it is more like a hint for users that they can update host. In our use case, we have a horizontally scaled system and we generate SDKs using one of the hosts. We don't specify host in the swagger spec. So, SDKs get generated with localhost url. A public DNS is there which load balances requests to all the hosts. So, it is expected that clients specify the host in their code. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#3148?email_source=notifications&email_token=AAHEC5ES4OGHUZJCCGRYMXLP3WECRA5CNFSM4HXXM5LKYY3PNVWWK3TUL52HS4DFWFIHK3DMKJSXC5LFON2FEZLWNFSXPKTDN5WW2ZLOORPWSZGOB4K2W4Q#discussion_r296430977>, or mute the thread https://github.com/notifications/unsubscribe-auth/AAHEC5DPIAJG57FUAVUFNELP3WECRANCNFSM4HXXM5LA .

Sure I will add a comment

[saigiridhar21]

Very good reason. What about also adding a 1 liner comment explaining it's optional and default to {{{basePath}}} ？ 在 2019年6月22日週六 上午10:21，Sai Giridhar P notifications@github.com 寫道：
…
@.**** commented on this pull request. ------------------------------ In modules/openapi-generator/src/main/resources/python/api_doc_example.mustache <#3148 (comment)> : > @@ -6,6 +6,7 @@ from {{{packageName}}}.rest import ApiException from pprint import pprint {{> python_doc_auth_partial}} {{#hasAuthMethods}} +configuration.host = "{{{basePath}}}" @wing328 https://github.com/wing328 Yes. You are right. My reason might not be a strong one but it is more like a hint for users that they can update host. In our use case, we have a horizontally scaled system and we generate SDKs using one of the hosts. We don't specify host in the swagger spec. So, SDKs get generated with localhost url. A public DNS is there which load balances requests to all the hosts. So, it is expected that clients specify the host in their code. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#3148?email_source=notifications&email_token=AAHEC5ES4OGHUZJCCGRYMXLP3WECRA5CNFSM4HXXM5LKYY3PNVWWK3TUL52HS4DFWFIHK3DMKJSXC5LFON2FEZLWNFSXPKTDN5WW2ZLOORPWSZGOB4K2W4Q#discussion_r296430977>, or mute the thread https://github.com/notifications/unsubscribe-auth/AAHEC5DPIAJG57FUAVUFNELP3WECRANCNFSM4HXXM5LA .

Sure I will add a comment

@wing328 Added the comment as suggested. Please take a look.

[wing328]

Sorry that I wasn't clear in my reply. Can we add the comment 1 line above the code, which is more consistent with how the rest of the example code is documented?

[saigiridhar21]

Sorry that I wasn't clear in my reply. Can we add the comment 1 line above the code, which is more consistent with how the rest of the example code is documented?

@wing328 Made the change as suggested.

[saigiridhar21]

@wing328 Please take a look when you get a chance. I made the requested changes. Also, I made the first letter in each comment to capital letter to make it look consistent across all comments on example snippet.

[wing328]

LGTM

[wing328]

@saigiridhar21 the change looks good. Thanks for the prompt update.