Add support for controlling output of OpenAPI Generator version in ge…

…nerated files (#17952)

* add initial openapi config and java generated files

* add java implementation for adding generator version

* regenerate sample client files

* remove tabs

* only show generated version if build info exists

* set build info for batch generation

* update generator doc for new global flag

* use existing property for generator version

* update templates to include generator version

* update templates for better generator version syntax

* revert undesired changes

* regenerate samples for openapi client

* update templates to correct formatting/newlines

* correct description text and add to usage doc

* add generator cli option for all codegen types

* use more concise version info; update existing codegens to support new prop

* correct wrong prop reference

* add initial test coverage for new prop

* update last (scala) templates with new prop

* update samples after upstream merge

* use consistent version output

* use better sample project id/name

* revert using option for generator version in templates

bin/configs/java-apache-generator-version.yaml

@@ -0,0 +1,8 @@
+generatorName: java
+outputDir: samples/client/petstore/java/apache-httpclient-generator-version
+library: apache-httpclient
+inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml
+templateDir: modules/openapi-generator/src/main/resources/Java
+additionalProperties:
+  artifactId: apache-httpclient-generator-version
+  hideGenerationTimestamp: true

modules/openapi-generator-maven-plugin/examples/templates/README.mustache

@@ -10,6 +10,8 @@
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
 
+- Generator version: {{generatorVersion}}
+
 {{#appDescriptionWithNewLines}}{{{appDescriptionWithNewLines}}}{{/appDescriptionWithNewLines}}
 
 {{#infoUrl}}

modules/openapi-generator-maven-plugin/src/it/custom-template/templates/README.mustache

@@ -10,6 +10,8 @@
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
 
+- Generator version: {{generatorVersion}}
+
 {{#appDescriptionWithNewLines}}{{{appDescriptionWithNewLines}}}{{/appDescriptionWithNewLines}}
 
 {{#infoUrl}}

modules/openapi-generator-maven-plugin/src/it/jaxrs-jersey2/templates/README.mustache

@@ -10,6 +10,8 @@
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
 
+- Generator version: {{generatorVersion}}
+
 {{#appDescriptionWithNewLines}}{{{appDescriptionWithNewLines}}}{{/appDescriptionWithNewLines}}
 
 {{#infoUrl}}

modules/openapi-generator-maven-plugin/src/it/jaxrs-jersey3/templates/README.mustache

@@ -10,6 +10,8 @@
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
 
+- Generator version: {{generatorVersion}}
+
 {{#appDescriptionWithNewLines}}{{{appDescriptionWithNewLines}}}{{/appDescriptionWithNewLines}}
 
 {{#infoUrl}}

modules/openapi-generator/src/main/resources/C-libcurl/README.md.mustache

@@ -8,6 +8,7 @@ This API client was generated by the [OpenAPI Generator](https://openapi-generat
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/Eiffel/README.mustache

@@ -12,6 +12,7 @@ This API client was generated by the [OpenAPI Generator](https://openapi-generat
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/Groovy/README.mustache

@@ -13,6 +13,7 @@ This Groovy package, using the [http-builder-ng library](https://http-builder-ng
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/Java/README.mustache

@@ -8,6 +8,8 @@
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
 
+- Generator version: {{generatorVersion}}
+
 {{{appDescriptionWithNewLines}}}
 
 {{#infoUrl}}

modules/openapi-generator/src/main/resources/Java/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/Java/libraries/apache-httpclient/README.mustache

@@ -8,6 +8,8 @@
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
 
+- Generator version: {{generatorVersion}}
+
 {{#appDescriptionWithNewLines}}{{{appDescriptionWithNewLines}}}{{/appDescriptionWithNewLines}}
 
 {{#infoUrl}}

modules/openapi-generator/src/main/resources/Java/libraries/jersey3/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/Java/libraries/microprofile/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{rootJavaEEPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{rootJavaEEPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/Java/libraries/native/README.mustache

@@ -8,6 +8,8 @@
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
 
+- Generator version: {{generatorVersion}}
+
 {{{appDescriptionWithNewLines}}}
 
 {{#infoUrl}}

modules/openapi-generator/src/main/resources/Java/libraries/native/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/Java/libraries/okhttp-gson/README.mustache

@@ -5,6 +5,7 @@
 {{^hideGenerationTimestamp}}
   - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+  - Generator version: {{generatorVersion}}
 
 {{{appDescriptionWithNewLines}}}
 

modules/openapi-generator/src/main/resources/JavaInflector/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaJaxRS/cxf-cdi/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaJaxRS/cxf-ext/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaJaxRS/cxf/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaJaxRS/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaJaxRS/resteasy/eap/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaJaxRS/resteasy/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaJaxRS/spec/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaPlayFramework/generatedAnnotation.mustache

@@ -1 +1 @@
-@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@{{javaxPackage}}.annotation.Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaSpring/generatedAnnotation.mustache

@@ -1 +1 @@
-@Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}})
+@Generated(value = "{{generatorClass}}"{{^hideGenerationTimestamp}}, date = "{{generatedDate}}"{{/hideGenerationTimestamp}}, comments = "Generator version: {{generatorVersion}}")

modules/openapi-generator/src/main/resources/JavaVertXServer/README.mustache

@@ -1,3 +1,4 @@
 {{^hideGenerationTimestamp}}
 Project generated on : {{generatedDate}}
 {{/hideGenerationTimestamp}}
+Generator version: {{generatorVersion}}

modules/openapi-generator/src/main/resources/JavaVertXWebServer/README.mustache

@@ -1,6 +1,7 @@
 {{^hideGenerationTimestamp}}
 Project generated on : {{generatedDate}}
 {{/hideGenerationTimestamp}}
+Generator version: {{generatorVersion}}
 
 ## Getting Started
 

modules/openapi-generator/src/main/resources/Javascript-Apollo/README.mustache

@@ -11,6 +11,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/Javascript-Closure-Angular/api.mustache

@@ -9,6 +9,7 @@
 {{^hideGenerationTimestamp}}
  * Generated at: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+* Generator version: {{generatorVersion}}
  * Generated by: {{generatorClass}}
  */{{#licenseInfo}}
 /**

modules/openapi-generator/src/main/resources/Javascript-Closure-Angular/es6/api.mustache

@@ -9,6 +9,7 @@
 {{^hideGenerationTimestamp}}
  * Generated at: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+ * Generator version: {{generatorVersion}}
  * Generated by: {{generatorClass}}
  */{{#licenseInfo}}
 /**

modules/openapi-generator/src/main/resources/Javascript/README.mustache

@@ -11,6 +11,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/bash/bash-completion.mustache

@@ -8,8 +8,11 @@
 # ! openapi-generator (https://openapi-generator.tech)
 # ! FROM OPENAPI SPECIFICATION IN JSON.
 # !
-{{^hideGenerationTimestamp}}# ! Generated on: {{generatedDate}}
-{{/hideGenerationTimestamp}}# !
+{{^hideGenerationTimestamp}}
+# ! Generated on: {{generatedDate}}
+{{/hideGenerationTimestamp}}
+# ! Generator version: {{generatorVersion}}
+# !
 # !
 # ! System wide installation:
 # !

modules/openapi-generator/src/main/resources/bash/client.mustache

@@ -8,8 +8,11 @@
 # ! openapi-generator (https://openapi-generator.tech)
 # ! FROM OPENAPI SPECIFICATION IN JSON.
 # !
-{{^hideGenerationTimestamp}}# ! Generated on: {{generatedDate}}
-{{/hideGenerationTimestamp}}# !
+{{^hideGenerationTimestamp}}
+# ! Generated on: {{generatedDate}}
+{{/hideGenerationTimestamp}}
+# ! Generator version: {{generatorVersion}}
+# !
 # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 
 #

modules/openapi-generator/src/main/resources/bash/zsh-completion.mustache

@@ -10,8 +10,11 @@
 # !
 # ! Based on: https://github.com/Valodim/zsh-curl-completion/blob/master/_curl
 # !
-{{^hideGenerationTimestamp}}# ! Generated on: {{generatedDate}}
-{{/hideGenerationTimestamp}}# !
+{{^hideGenerationTimestamp}}
+# ! Generated on: {{generatedDate}}
+{{/hideGenerationTimestamp}}
+# ! Generator version: {{generatorVersion}}
+# !
 # !
 # ! Installation:
 # !

modules/openapi-generator/src/main/resources/cpp-qt-client/README.mustache

@@ -6,9 +6,9 @@
 
 - API version: {{appVersion}}
 {{^hideGenerationTimestamp}}
-
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 
 {{{appDescriptionWithNewLines}}}
 

modules/openapi-generator/src/main/resources/cpp-qt-qhttpengine-server/README.md.mustache

@@ -9,8 +9,11 @@ To see how to make this your own, look here:
 
 [README]((https://openapi-generator.tech))
 
-- API version: {{appVersion}}{{^hideGenerationTimestamp}}
-- Build date: {{generatedDate}}{{/hideGenerationTimestamp}}
+- API version: {{appVersion}}
+{{^hideGenerationTimestamp}}
+- Build date: {{generatedDate}}
+{{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
 {{/infoUrl}}

modules/openapi-generator/src/main/resources/cpp-rest-sdk-client/README.mustache

@@ -12,6 +12,7 @@ This API client was generated by the [OpenAPI Generator](https://openapi-generat
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/crystal/README.mustache

@@ -13,6 +13,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/crystal/api_info.mustache

@@ -9,4 +9,4 @@
 {{#version}}The version of the OpenAPI document: {{.}}{{/version}}
 {{#infoEmail}}Contact: {{{.}}}{{/infoEmail}}
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: {{{generatorVersion}}}
+Generator version: {{{generatorVersion}}}

modules/openapi-generator/src/main/resources/csharp/README.mustache

@@ -11,6 +11,7 @@ This C# SDK is automatically generated by the [OpenAPI Generator](https://openap
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
     For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/csharp/libraries/generichost/README.client.mustache

@@ -179,8 +179,11 @@ Class | Method | HTTP request | Description
 {{/authMethods}}
 
 ## Build
-- SDK version: {{packageVersion}}{{^hideGenerationTimestamp}}
-- Build date: {{generatedDate}}{{/hideGenerationTimestamp}}
+- SDK version: {{packageVersion}}
+{{^hideGenerationTimestamp}}
+- Build date: {{generatedDate}}
+{{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 
 ## Api Information

modules/openapi-generator/src/main/resources/csharp/libraries/unityWebRequest/README.mustache

@@ -11,6 +11,7 @@ This C# SDK is automatically generated by the [OpenAPI Generator](https://openap
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
     For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/dart/libraries/dio/README.mustache

@@ -12,6 +12,7 @@ This Dart package is automatically generated by the [OpenAPI Generator](https://
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/dart2/README.mustache

@@ -12,6 +12,7 @@ This Dart package is automatically generated by the [OpenAPI Generator](https://
 {{^hideGenerationTimestamp}}
 - Build date: {{{generatedDate}}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{{generatorClass}}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/elm/README.mustache

@@ -12,6 +12,7 @@ This API client was generated by the [OpenAPI Generator](https://openapi-generat
 {{^hideGenerationTimestamp}}
 - Build date: {{generatedDate}}
 {{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 - Build package: {{generatorClass}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})

modules/openapi-generator/src/main/resources/go-echo-server/README.mustache

@@ -14,8 +14,11 @@ To see how to make this your own, look here:
 
 [README](https://openapi-generator.tech)
 
-- API version: {{appVersion}}{{^hideGenerationTimestamp}}
-- Build date: {{generatedDate}}{{/hideGenerationTimestamp}}
+- API version: {{appVersion}}
+{{^hideGenerationTimestamp}}
+- Build date: {{generatedDate}}
+{{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
 {{/infoUrl}}

modules/openapi-generator/src/main/resources/go-gin-server/README.mustache

@@ -14,8 +14,11 @@ To see how to make this your own, look here:
 
 [README](https://openapi-generator.tech)
 
-- API version: {{appVersion}}{{^hideGenerationTimestamp}}
-- Build date: {{generatedDate}}{{/hideGenerationTimestamp}}
+- API version: {{appVersion}}
+{{^hideGenerationTimestamp}}
+- Build date: {{generatedDate}}
+{{/hideGenerationTimestamp}}
+- Generator version: {{generatorVersion}}
 {{#infoUrl}}
 For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
 {{/infoUrl}}