[Python] better wording for documentation

modules/swagger-codegen/src/main/java/io/swagger/codegen/languages/PythonClientCodegen.java

@@ -61,7 +61,7 @@ public PythonClientCodegen() {
                         "return", "def", "for", "lambda", "try"));
 
         cliOptions.clear();
-        cliOptions.add(new CliOption("packageName", "python package name (convension: under_score), default: swagger_client"));
+        cliOptions.add(new CliOption("packageName", "python package name (convention: snake_case), default: swagger_client"));
         cliOptions.add(new CliOption("packageVersion", "python package version, default: 1.0.0"));
     }
 

modules/swagger-codegen/src/main/resources/python/api.mustache

@@ -34,6 +34,7 @@ class {{classname}}(object):
     """
     NOTE: This class is auto generated by the swagger code generator program.
     Do not edit the class manually.
+    Ref: https://github.com/swagger-api/swagger-codegen
     """
 
     def __init__(self, api_client=None):
@@ -51,7 +52,7 @@ class {{classname}}(object):
         {{{summary}}}
         {{{notes}}}
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):

modules/swagger-codegen/src/main/resources/python/api_client.mustache

@@ -14,6 +14,8 @@ Copyright 2015 SmartBear Software
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
+
+   ref: https://github.com/swagger-api/swagger-codegen
 """
 
 from __future__ import absolute_import
@@ -56,7 +58,7 @@ class ApiClient(object):
     templates.
 
     NOTE: This class is auto generated by the swagger code generator program.
-    https://github.com/swagger-api/swagger-codegen
+    Ref: https://github.com/swagger-api/swagger-codegen
     Do not edit the class manually.
 
     :param host: The base path for the server to call.
@@ -75,7 +77,7 @@ class ApiClient(object):
         self.host = host
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'Python-Swagger'
+        self.user_agent = 'Python-Swagger/{{packageVersion}}'
 
     @property
     def user_agent(self):
@@ -280,7 +282,8 @@ class ApiClient(object):
                  body=None, post_params=None, files=None,
                  response_type=None, auth_settings=None, callback=None):
         """
-        Makes the HTTP request and return the deserialized data.
+        Makes the HTTP request (synchronous) and return the deserialized data.
+        To make an async request, define a function for callback.
 
         :param resource_path: Path to method endpoint.
         :param method: Method to call.
@@ -450,9 +453,8 @@ class ApiClient(object):
 
     def __deserialize_file(self, response):
         """
-        Saves response body into a file in (the defined) temporary folder,
-        using the filename from the `Content-Disposition` header if provided,
-        otherwise a random filename.
+        Saves response body into a file in a temporary folder,
+        using the filename from the `Content-Disposition` header if provided.
 
         :param response:  RESTResponse.
         :return: file path.

modules/swagger-codegen/src/main/resources/python/configuration.mustache

@@ -14,6 +14,8 @@ Copyright 2015 SmartBear Software
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
+
+   ref: https://github.com/swagger-api/swagger-codegen 
 """
 
 from __future__ import absolute_import
@@ -44,7 +46,7 @@ def singleton(cls, *args, **kw):
 class Configuration(object):
     """
     NOTE: This class is auto generated by the swagger code generator program.
-    https://github.com/swagger-api/swagger-codegen
+    Ref: https://github.com/swagger-api/swagger-codegen
     Do not edit the class manually.
     """
 
@@ -56,7 +58,7 @@ class Configuration(object):
         self.host = "{{basePath}}"
         # Default api client
         self.api_client = None
-        # Temp file folder for download
+        # Temp file folder for downloading files
         self.temp_folder_path = None
 
         # Authentication Settings
@@ -139,7 +141,7 @@ class Configuration(object):
 
     def get_basic_auth_token(self):
         """
-        Gets basic auth header string.
+        Gets HTTP basic authentication header (string).
 
         :return: The token for basic HTTP authentication.
         """

modules/swagger-codegen/src/main/resources/python/model.mustache

@@ -14,6 +14,8 @@ Copyright 2015 SmartBear Software
     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     See the License for the specific language governing permissions and
     limitations under the License.
+
+    Ref: https://github.com/swagger-api/swagger-codegen
 """
 
 {{#models}}
@@ -29,7 +31,7 @@ class {{classname}}(object):
     """
     def __init__(self):
         """
-        Swagger model
+        {{classname}} - a model defined in Swagger
 
         :param dict swaggerTypes: The key is attribute name
                                   and the value is attribute type.
@@ -82,7 +84,7 @@ class {{classname}}(object):
 {{/vars}}
     def to_dict(self):
         """
-        Return model properties dict
+        Returns the model properties as a dict
         """
         result = {}
 
@@ -102,7 +104,7 @@ class {{classname}}(object):
 
     def to_str(self):
         """
-        Return model properties str
+        Returns the string representation of the model
         """
         return pformat(self.to_dict())
 

modules/swagger-codegen/src/main/resources/python/setup.mustache

@@ -8,13 +8,11 @@ VERSION = "{{packageVersion}}"
 
 {{#apiInfo}}{{#apis}}{{^hasMore}}
 
-# To install the library, open a Terminal shell, then run this
-# file by typing:
+# To install the library, run the following
 #
 # python setup.py install
 #
-# You need to have the setuptools module installed.
-# Try reading the setuptools documentation:
+# prerequisite: setuptools
 # http://pypi.python.org/pypi/setuptools
 
 REQUIRES = ["urllib3 >= 1.10", "six >= 1.9", "certifi", "python-dateutil"]

samples/client/petstore/python/dev-requirements.txt.log

@@ -0,0 +1,15 @@
+Collecting nose (from -r dev-requirements.txt (line 1))
+  Using cached nose-1.3.7-py2-none-any.whl
+Collecting tox (from -r dev-requirements.txt (line 2))
+  Using cached tox-2.1.1-py2.py3-none-any.whl
+Collecting coverage (from -r dev-requirements.txt (line 3))
+Collecting randomize (from -r dev-requirements.txt (line 4))
+  Using cached randomize-0.13-py2.py3-none-any.whl
+Collecting virtualenv>=1.11.2 (from tox->-r dev-requirements.txt (line 2))
+  Using cached virtualenv-13.1.2-py2.py3-none-any.whl
+Collecting py>=1.4.17 (from tox->-r dev-requirements.txt (line 2))
+  Using cached py-1.4.30-py2.py3-none-any.whl
+Collecting pluggy<0.4.0,>=0.3.0 (from tox->-r dev-requirements.txt (line 2))
+  Using cached pluggy-0.3.0-py2.py3-none-any.whl
+Installing collected packages: nose, virtualenv, py, pluggy, tox, coverage, randomize
+Successfully installed coverage-3.7.1 nose-1.3.7 pluggy-0.3.0 py-1.4.30 randomize-0.13 tox-2.1.1 virtualenv-13.1.2

samples/client/petstore/python/setup.py

@@ -8,13 +8,11 @@
 
 
 
-# To install the library, open a Terminal shell, then run this
-# file by typing:
+# To install the library, run the following
 #
 # python setup.py install
 #
-# You need to have the setuptools module installed.
-# Try reading the setuptools documentation:
+# prerequisite: setuptools
 # http://pypi.python.org/pypi/setuptools
 
 REQUIRES = ["urllib3 >= 1.10", "six >= 1.9", "certifi", "python-dateutil"]

samples/client/petstore/python/swagger_client.egg-info/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 1.0
+Name: swagger-client
+Version: 1.0.0
+Summary: Swagger Petstore
+Home-page: UNKNOWN
+Author: UNKNOWN
+Author-email: apiteam@swagger.io
+License: UNKNOWN
+Description:     This is a sample server Petstore server.  You can find out more about Swagger at <a href=\"http://swagger.io\">http://swagger.io</a> or on irc.freenode.net, #swagger.  For this sample, you can use the api key \"special-key\" to test the authorization filters
+
+Keywords: Swagger,Swagger Petstore
+Platform: UNKNOWN

samples/client/petstore/python/swagger_client.egg-info/SOURCES.txt

@@ -0,0 +1,29 @@
+setup.cfg
+setup.py
+swagger_client/__init__.py
+swagger_client/api_client.py
+swagger_client/configuration.py
+swagger_client/rest.py
+swagger_client.egg-info/PKG-INFO
+swagger_client.egg-info/SOURCES.txt
+swagger_client.egg-info/dependency_links.txt
+swagger_client.egg-info/requires.txt
+swagger_client.egg-info/top_level.txt
+swagger_client/apis/__init__.py
+swagger_client/apis/pet_api.py
+swagger_client/apis/store_api.py
+swagger_client/apis/user_api.py
+swagger_client/models/__init__.py
+swagger_client/models/category.py
+swagger_client/models/order.py
+swagger_client/models/pet.py
+swagger_client/models/tag.py
+swagger_client/models/user.py
+tests/__init__.py
+tests/test_api_client.py
+tests/test_api_exception.py
+tests/test_deserialization.py
+tests/test_order_model.py
+tests/test_pet_api.py
+tests/test_pet_model.py
+tests/test_store_api.py

samples/client/petstore/python/swagger_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

samples/client/petstore/python/swagger_client.egg-info/requires.txt

@@ -0,0 +1,4 @@
+urllib3 >= 1.10
+six >= 1.9
+certifi
+python-dateutil

samples/client/petstore/python/swagger_client.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+swagger_client
+tests

samples/client/petstore/python/swagger_client/api_client.py

@@ -14,6 +14,8 @@
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
+
+   ref: https://github.com/swagger-api/swagger-codegen
 """
 
 from __future__ import absolute_import
@@ -56,7 +58,7 @@ class ApiClient(object):
     templates.
 
     NOTE: This class is auto generated by the swagger code generator program.
-    https://github.com/swagger-api/swagger-codegen
+    Ref: https://github.com/swagger-api/swagger-codegen
     Do not edit the class manually.
 
     :param host: The base path for the server to call.
@@ -75,7 +77,7 @@ def __init__(self, host=Configuration().host,
         self.host = host
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'Python-Swagger'
+        self.user_agent = 'Python-Swagger/1.0.0'
 
     @property
     def user_agent(self):
@@ -280,7 +282,8 @@ def call_api(self, resource_path, method,
                  body=None, post_params=None, files=None,
                  response_type=None, auth_settings=None, callback=None):
         """
-        Makes the HTTP request and return the deserialized data.
+        Makes the HTTP request (synchronous) and return the deserialized data.
+        To make an async request, define a function for callback.
 
         :param resource_path: Path to method endpoint.
         :param method: Method to call.
@@ -450,9 +453,8 @@ def update_params_for_auth(self, headers, querys, auth_settings):
 
     def __deserialize_file(self, response):
         """
-        Saves response body into a file in (the defined) temporary folder,
-        using the filename from the `Content-Disposition` header if provided,
-        otherwise a random filename.
+        Saves response body into a file in a temporary folder,
+        using the filename from the `Content-Disposition` header if provided.
 
         :param response:  RESTResponse.
         :return: file path.

samples/client/petstore/python/swagger_client/apis/pet_api.py

@@ -33,6 +33,7 @@ class PetApi(object):
     """
     NOTE: This class is auto generated by the swagger code generator program.
     Do not edit the class manually.
+    Ref: https://github.com/swagger-api/swagger-codegen
     """
 
     def __init__(self, api_client=None):
@@ -49,7 +50,7 @@ def update_pet(self, **kwargs):
         Update an existing pet
 
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):
@@ -124,7 +125,7 @@ def add_pet(self, **kwargs):
         Add a new pet to the store
 
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):
@@ -199,7 +200,7 @@ def find_pets_by_status(self, **kwargs):
         Finds Pets by status
         Multiple status values can be provided with comma seperated strings
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):
@@ -274,7 +275,7 @@ def find_pets_by_tags(self, **kwargs):
         Finds Pets by tags
         Muliple tags can be provided with comma seperated strings. Use tag1, tag2, tag3 for testing.
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):
@@ -349,7 +350,7 @@ def get_pet_by_id(self, pet_id, **kwargs):
         Find pet by ID
         Returns a pet when ID < 10.  ID > 10 or nonintegers will simulate API error conditions
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):
@@ -427,7 +428,7 @@ def update_pet_with_form(self, pet_id, **kwargs):
         Updates a pet in the store with form data
 
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):
@@ -511,7 +512,7 @@ def delete_pet(self, pet_id, **kwargs):
         Deletes a pet
 
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):
@@ -592,7 +593,7 @@ def upload_file(self, pet_id, **kwargs):
         uploads an image
 
 
-        This method makes a synchronous HTTP request by default.To make an
+        This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please define a `callback` function
         to be invoked when receiving the response.
         >>> def callback_function(response):