diff --git a/modules/openapi-generator/src/main/resources/python/model_doc.mustache b/modules/openapi-generator/src/main/resources/python/model_doc.mustache index 71c106fdc5..c1ead8680c 100644 --- a/modules/openapi-generator/src/main/resources/python/model_doc.mustache +++ b/modules/openapi-generator/src/main/resources/python/model_doc.mustache @@ -1,5 +1,7 @@ {{#models}}{{#model}}# {{classname}} +{{#description}}{{description}} +{{/description}} ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/modules/openapi-generator/src/main/resources/python/python-experimental/model_doc.mustache b/modules/openapi-generator/src/main/resources/python/python-experimental/model_doc.mustache index 70b2339985..a8bfb933b6 100644 --- a/modules/openapi-generator/src/main/resources/python/python-experimental/model_doc.mustache +++ b/modules/openapi-generator/src/main/resources/python/python-experimental/model_doc.mustache @@ -1,5 +1,7 @@ {{#models}}{{#model}}# {{classname}} +{{#description}}{{description}} +{{/description}} ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-asyncio/docs/ClassModel.md b/samples/client/petstore/python-asyncio/docs/ClassModel.md index 7f6f6d1721..733c19fae9 100644 --- a/samples/client/petstore/python-asyncio/docs/ClassModel.md +++ b/samples/client/petstore/python-asyncio/docs/ClassModel.md @@ -1,5 +1,6 @@ # ClassModel +Model for testing model with \"_class\" property ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-asyncio/docs/File.md b/samples/client/petstore/python-asyncio/docs/File.md index 6a925f0a7a..5dce05eabb 100644 --- a/samples/client/petstore/python-asyncio/docs/File.md +++ b/samples/client/petstore/python-asyncio/docs/File.md @@ -1,5 +1,6 @@ # File +Must be named `File` for test. ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-asyncio/docs/Model200Response.md b/samples/client/petstore/python-asyncio/docs/Model200Response.md index 30f47cae52..40d0d7828e 100644 --- a/samples/client/petstore/python-asyncio/docs/Model200Response.md +++ b/samples/client/petstore/python-asyncio/docs/Model200Response.md @@ -1,5 +1,6 @@ # Model200Response +Model for testing model name starting with number ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-asyncio/docs/ModelReturn.md b/samples/client/petstore/python-asyncio/docs/ModelReturn.md index 2b03798e30..65ec73ddae 100644 --- a/samples/client/petstore/python-asyncio/docs/ModelReturn.md +++ b/samples/client/petstore/python-asyncio/docs/ModelReturn.md @@ -1,5 +1,6 @@ # ModelReturn +Model for testing reserved words ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-asyncio/docs/Name.md b/samples/client/petstore/python-asyncio/docs/Name.md index 17dc7a38fe..807b76afc6 100644 --- a/samples/client/petstore/python-asyncio/docs/Name.md +++ b/samples/client/petstore/python-asyncio/docs/Name.md @@ -1,5 +1,6 @@ # Name +Model for testing model name same as property name ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-experimental/docs/ClassModel.md b/samples/client/petstore/python-experimental/docs/ClassModel.md index 7f6f6d1721..733c19fae9 100644 --- a/samples/client/petstore/python-experimental/docs/ClassModel.md +++ b/samples/client/petstore/python-experimental/docs/ClassModel.md @@ -1,5 +1,6 @@ # ClassModel +Model for testing model with \"_class\" property ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-experimental/docs/File.md b/samples/client/petstore/python-experimental/docs/File.md index 6a925f0a7a..5dce05eabb 100644 --- a/samples/client/petstore/python-experimental/docs/File.md +++ b/samples/client/petstore/python-experimental/docs/File.md @@ -1,5 +1,6 @@ # File +Must be named `File` for test. ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-experimental/docs/Model200Response.md b/samples/client/petstore/python-experimental/docs/Model200Response.md index 30f47cae52..40d0d7828e 100644 --- a/samples/client/petstore/python-experimental/docs/Model200Response.md +++ b/samples/client/petstore/python-experimental/docs/Model200Response.md @@ -1,5 +1,6 @@ # Model200Response +Model for testing model name starting with number ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-experimental/docs/ModelReturn.md b/samples/client/petstore/python-experimental/docs/ModelReturn.md index 2b03798e30..65ec73ddae 100644 --- a/samples/client/petstore/python-experimental/docs/ModelReturn.md +++ b/samples/client/petstore/python-experimental/docs/ModelReturn.md @@ -1,5 +1,6 @@ # ModelReturn +Model for testing reserved words ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-experimental/docs/Name.md b/samples/client/petstore/python-experimental/docs/Name.md index 17dc7a38fe..807b76afc6 100644 --- a/samples/client/petstore/python-experimental/docs/Name.md +++ b/samples/client/petstore/python-experimental/docs/Name.md @@ -1,5 +1,6 @@ # Name +Model for testing model name same as property name ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-experimental/docs/TypeHolderDefault.md b/samples/client/petstore/python-experimental/docs/TypeHolderDefault.md index aa409ec652..21d125a8e5 100644 --- a/samples/client/petstore/python-experimental/docs/TypeHolderDefault.md +++ b/samples/client/petstore/python-experimental/docs/TypeHolderDefault.md @@ -1,5 +1,6 @@ # TypeHolderDefault +a model to test optional properties with server defaults ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-experimental/docs/TypeHolderExample.md b/samples/client/petstore/python-experimental/docs/TypeHolderExample.md index 3f38a46c58..b74c520d44 100644 --- a/samples/client/petstore/python-experimental/docs/TypeHolderExample.md +++ b/samples/client/petstore/python-experimental/docs/TypeHolderExample.md @@ -1,5 +1,6 @@ # TypeHolderExample +a model to test required properties with an example and length one enum ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-tornado/docs/ClassModel.md b/samples/client/petstore/python-tornado/docs/ClassModel.md index 7f6f6d1721..733c19fae9 100644 --- a/samples/client/petstore/python-tornado/docs/ClassModel.md +++ b/samples/client/petstore/python-tornado/docs/ClassModel.md @@ -1,5 +1,6 @@ # ClassModel +Model for testing model with \"_class\" property ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-tornado/docs/File.md b/samples/client/petstore/python-tornado/docs/File.md index 6a925f0a7a..5dce05eabb 100644 --- a/samples/client/petstore/python-tornado/docs/File.md +++ b/samples/client/petstore/python-tornado/docs/File.md @@ -1,5 +1,6 @@ # File +Must be named `File` for test. ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-tornado/docs/Model200Response.md b/samples/client/petstore/python-tornado/docs/Model200Response.md index 30f47cae52..40d0d7828e 100644 --- a/samples/client/petstore/python-tornado/docs/Model200Response.md +++ b/samples/client/petstore/python-tornado/docs/Model200Response.md @@ -1,5 +1,6 @@ # Model200Response +Model for testing model name starting with number ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-tornado/docs/ModelReturn.md b/samples/client/petstore/python-tornado/docs/ModelReturn.md index 2b03798e30..65ec73ddae 100644 --- a/samples/client/petstore/python-tornado/docs/ModelReturn.md +++ b/samples/client/petstore/python-tornado/docs/ModelReturn.md @@ -1,5 +1,6 @@ # ModelReturn +Model for testing reserved words ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python-tornado/docs/Name.md b/samples/client/petstore/python-tornado/docs/Name.md index 17dc7a38fe..807b76afc6 100644 --- a/samples/client/petstore/python-tornado/docs/Name.md +++ b/samples/client/petstore/python-tornado/docs/Name.md @@ -1,5 +1,6 @@ # Name +Model for testing model name same as property name ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python/docs/ClassModel.md b/samples/client/petstore/python/docs/ClassModel.md index 7f6f6d1721..733c19fae9 100644 --- a/samples/client/petstore/python/docs/ClassModel.md +++ b/samples/client/petstore/python/docs/ClassModel.md @@ -1,5 +1,6 @@ # ClassModel +Model for testing model with \"_class\" property ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python/docs/File.md b/samples/client/petstore/python/docs/File.md index 6a925f0a7a..5dce05eabb 100644 --- a/samples/client/petstore/python/docs/File.md +++ b/samples/client/petstore/python/docs/File.md @@ -1,5 +1,6 @@ # File +Must be named `File` for test. ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python/docs/Model200Response.md b/samples/client/petstore/python/docs/Model200Response.md index 30f47cae52..40d0d7828e 100644 --- a/samples/client/petstore/python/docs/Model200Response.md +++ b/samples/client/petstore/python/docs/Model200Response.md @@ -1,5 +1,6 @@ # Model200Response +Model for testing model name starting with number ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python/docs/ModelReturn.md b/samples/client/petstore/python/docs/ModelReturn.md index 2b03798e30..65ec73ddae 100644 --- a/samples/client/petstore/python/docs/ModelReturn.md +++ b/samples/client/petstore/python/docs/ModelReturn.md @@ -1,5 +1,6 @@ # ModelReturn +Model for testing reserved words ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/client/petstore/python/docs/Name.md b/samples/client/petstore/python/docs/Name.md index 17dc7a38fe..807b76afc6 100644 --- a/samples/client/petstore/python/docs/Name.md +++ b/samples/client/petstore/python/docs/Name.md @@ -1,5 +1,6 @@ # Name +Model for testing model name same as property name ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/openapi3/client/petstore/python/docs/ClassModel.md b/samples/openapi3/client/petstore/python/docs/ClassModel.md index 7f6f6d1721..733c19fae9 100644 --- a/samples/openapi3/client/petstore/python/docs/ClassModel.md +++ b/samples/openapi3/client/petstore/python/docs/ClassModel.md @@ -1,5 +1,6 @@ # ClassModel +Model for testing model with \"_class\" property ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/openapi3/client/petstore/python/docs/File.md b/samples/openapi3/client/petstore/python/docs/File.md index 6a925f0a7a..5dce05eabb 100644 --- a/samples/openapi3/client/petstore/python/docs/File.md +++ b/samples/openapi3/client/petstore/python/docs/File.md @@ -1,5 +1,6 @@ # File +Must be named `File` for test. ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/openapi3/client/petstore/python/docs/HealthCheckResult.md b/samples/openapi3/client/petstore/python/docs/HealthCheckResult.md index 346889210a..7cde5c0932 100644 --- a/samples/openapi3/client/petstore/python/docs/HealthCheckResult.md +++ b/samples/openapi3/client/petstore/python/docs/HealthCheckResult.md @@ -1,5 +1,6 @@ # HealthCheckResult +Just a string to inform instance is up and running. Make it nullable in hope to get it as pointer in generated model. ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/openapi3/client/petstore/python/docs/Model200Response.md b/samples/openapi3/client/petstore/python/docs/Model200Response.md index 30f47cae52..40d0d7828e 100644 --- a/samples/openapi3/client/petstore/python/docs/Model200Response.md +++ b/samples/openapi3/client/petstore/python/docs/Model200Response.md @@ -1,5 +1,6 @@ # Model200Response +Model for testing model name starting with number ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/openapi3/client/petstore/python/docs/ModelReturn.md b/samples/openapi3/client/petstore/python/docs/ModelReturn.md index 2b03798e30..65ec73ddae 100644 --- a/samples/openapi3/client/petstore/python/docs/ModelReturn.md +++ b/samples/openapi3/client/petstore/python/docs/ModelReturn.md @@ -1,5 +1,6 @@ # ModelReturn +Model for testing reserved words ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | ------------- diff --git a/samples/openapi3/client/petstore/python/docs/Name.md b/samples/openapi3/client/petstore/python/docs/Name.md index 17dc7a38fe..807b76afc6 100644 --- a/samples/openapi3/client/petstore/python/docs/Name.md +++ b/samples/openapi3/client/petstore/python/docs/Name.md @@ -1,5 +1,6 @@ # Name +Model for testing model name same as property name ## Properties Name | Type | Description | Notes ------------ | ------------- | ------------- | -------------