diff --git a/0358ea4a.319c66aa.js b/0358ea4a.319c66aa.js
deleted file mode 100644
index c81fea476a8..00000000000
--- a/0358ea4a.319c66aa.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[7],{133:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Documentation for the java Generator"},c={id:"generators/java",title:"Documentation for the java Generator",description:"## METADATA",source:"@site/../docs/generators/java.md",permalink:"/docs/generators/java",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java.md",lastUpdatedBy:"Justin Black",lastUpdatedAt:1650213369},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"SUPPORTED VENDOR EXTENSIONS",id:"supported-vendor-extensions",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("h2",{id:"metadata"},"METADATA"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Value"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Notes"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator stability"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"STABLE"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CLIENT"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator language"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"mustache"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generates a Java client library (HTTP lib: Jersey (1.x, 2.x), Retrofit (2.x), OpenFeign (10.x) and more."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))))),Object(l.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalEnumTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for enum type(class level annotations)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalModelTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated api classes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.client.api")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactDescription"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact description in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI Java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi-java-client")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact version in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"asyncNative"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If true, async handlers will be used, instead of the sync version"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"bigDecimalAsString"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Treat BigDecimal values as Strings to avoid precision loss."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"get")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"caseInsensitiveResponseHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Make API response's headers case-insensitive. Available on okhttp-gson, jersey2 libraries"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"configKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Config key in @RegisterRestClient. Default to none. Only ",Object(l.b)("inlineCode",{parentName:"td"},"microprofile")," supports this option."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Option. Date library to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"joda")),Object(l.b)("dd",null,"Joda (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"legacy")),Object(l.b)("dd",null,"Legacy java.util.Date"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8-localdatetime")),Object(l.b)("dd",null,"Java 8 using LocalDateTime (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8")),Object(l.b)("dd",null,"Java 8 native JSR310 (preferred for jdk 1.8+)"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java8")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerEmail"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer email in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"team@openapitools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer name in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI-Generator Contributors")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganization"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPITools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganizationUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://openapitools.org"}),"http://openapitools.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disableHtmlEscaping"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"discriminatorCaseSensitive"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dynamicOperations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate operations dynamically at runtime from an OAS"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumUnknownDefaultCase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"No changes to the enum's are made, this is the default option."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"errorObjectType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Error Object type. (This option is for okhttp-gson-next-gen only)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"fullJavaUtil"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to use fully qualified name for classes under java.util. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"gradleProperties"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Append additional Gradle properties to the gradle.properties file"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ignoreAnyOfInEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ignore anyOf keyword in enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters in the generated API methods using @ApiImplicitParams annotation."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeadersRegex"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"invokerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"root package for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.client")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"library template (sub-template) to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jersey1")),Object(l.b)("dd",null,"HTTP client: Jersey client 1.19.x. JSON processing: Jackson 2.9.x. Enable gzip request encoding using '-DuseGzipFeature=true'. IMPORTANT NOTE: jersey 1.x is no longer actively maintained so please upgrade to 'jersey3' or other HTTP libraries instead."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jersey2")),Object(l.b)("dd",null,"HTTP client: Jersey client 2.25.1. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jersey3")),Object(l.b)("dd",null,"HTTP client: Jersey client 3.x. JSON processing: Jackson 2.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"feign")),Object(l.b)("dd",null,"HTTP client: OpenFeign 10.x. JSON processing: Jackson 2.9.x."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"okhttp-gson")),Object(l.b)("dd",null,"[DEFAULT]"," HTTP client: OkHttp 3.x. JSON processing: Gson 2.8.x. Enable Parcelable models on Android using '-DparcelableModel=true'. Enable gzip request encoding using '-DuseGzipFeature=true'."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"retrofit2")),Object(l.b)("dd",null,"HTTP client: OkHttp 3.x. JSON processing: Gson 2.x (Retrofit 2.3.0). Enable the RxJava adapter using '-DuseRxJava","[2/3]","=true'. (RxJava 1.x or 2.x or 3.x)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"resttemplate")),Object(l.b)("dd",null,"HTTP client: Spring RestTemplate 4.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"webclient")),Object(l.b)("dd",null,"HTTP client: Spring WebClient 5.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"resteasy")),Object(l.b)("dd",null,"HTTP client: Resteasy client 3.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"vertx")),Object(l.b)("dd",null,"HTTP client: VertX client 3.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"google-api-client")),Object(l.b)("dd",null,"HTTP client: Google API client 1.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"rest-assured")),Object(l.b)("dd",null,"HTTP client: rest-assured : 4.x. JSON processing: Gson 2.x or Jackson 2.10.x. Only for Java 8"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"native")),Object(l.b)("dd",null,"HTTP client: Java native HttpClient. JSON processing: Jackson 2.9.x. Only for Java11+"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"microprofile")),Object(l.b)("dd",null,"HTTP client: Microprofile client 1.x. JSON processing: JSON-B"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"apache-httpclient")),Object(l.b)("dd",null,"HTTP client: Apache httpclient 4.x"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"okhttp-gson")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Unlicense")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://unlicense.org"}),"http://unlicense.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"microprofileFramework"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Framework for microprofile. Possible values ",'"',"kumuluzee",'"'),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.client.model")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openApiNullable"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enable OpenAPI Jackson Nullable library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parcelableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to generate models for Android that implement Parcelable with the okhttp-gson library."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentArtifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentGroupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"performBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Perform BeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmDeveloperConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM developer connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean - toggle ",'"',"implements Serializable",'"'," for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializationLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Serialization library, default depends on value of the option library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jsonb")),Object(l.b)("dd",null,"Use JSON-B as serialization library"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jackson")),Object(l.b)("dd",null,"Use Jackson as serialization library"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"gson")),Object(l.b)("dd",null,"Use Gson as serialization library"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"snapshotVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uses a SNAPSHOT version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Use a SnapShot Version"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"Use a Release Version"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"src/main/java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"supportStreaming"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Support streaming endpoint (beta)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"testOutput"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set output folder for models and APIs tests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"${project.build.directory}/generated-test-sources/openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useAbstractionForFiles"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use alternative types instead of java.io.File to allow passing bytes without a file on disk. Available on resttemplate, webclient, libraries"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use BeanValidation API annotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useGzipFeature"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Send gzip-encoded requests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useOneOfDiscriminatorLookup"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use the discriminator's mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf's schemas) will be skipped. Only jersey2, jersey3, native, okhttp-gson support this option."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"usePlayWS"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use Play! Async HTTP client (Play WS API)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useReflectionEqualsHashCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use org.apache.commons.lang3.builder for equals and hashCode in the models. WARNING: This will fail under a security manager, unless the appropriate permissions are set up correctly and also there's potential performance impact."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useRuntimeException"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use RuntimeException instead of Exception"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useRxJava2"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to use the RxJava2 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useRxJava3"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to use the RxJava3 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"supported-vendor-extensions"},"SUPPORTED VENDOR EXTENSIONS"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Extension name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Applicable for"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default value"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-discriminator-value"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Used with model inheritance to specify value for discriminator that identifies current model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ability to specify interfaces that model must implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"empty array")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-setter-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom annotation that can be specified over java setter for specific field"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"When field is array & uniqueItems, then this extension is used to add ",Object(l.b)("inlineCode",{parentName:"td"},"@JsonDeserialize(as = LinkedHashSet.class)")," over setter, otherwise no value")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-tags"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify multiple swagger tags for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-accepts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Accept' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-content-type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Content-Type' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-class-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-field-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to property"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-webclient-blocking"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specifies if method for specific operation should be blocking or non-blocking(ex: return ",Object(l.b)("inlineCode",{parentName:"td"},"Mono<T>/Flux<T>")," or ",Object(l.b)("inlineCode",{parentName:"td"},"return T/List<T>/Set<T>")," & execute ",Object(l.b)("inlineCode",{parentName:"td"},".block()")," inside generated method)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BigDecimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.math.BigDecimal")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Date")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.io.File")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.LinkedHashSet")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDate"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Map")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Timestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.sql.Timestamp")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"URI"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.net.URI")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UUID"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.UUID")))),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet")))),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Boolean"),Object(l.b)("li",null,"Double"),Object(l.b)("li",null,"Float"),Object(l.b)("li",null,"Integer"),Object(l.b)("li",null,"Long"),Object(l.b)("li",null,"Object"),Object(l.b)("li",null,"String"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"byte[]")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"abstract"),Object(l.b)("li",null,"apiclient"),Object(l.b)("li",null,"apiexception"),Object(l.b)("li",null,"apiresponse"),Object(l.b)("li",null,"assert"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"configuration"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"extends"),Object(l.b)("li",null,"file"),Object(l.b)("li",null,"final"),Object(l.b)("li",null,"finally"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"implements"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"instanceof"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"list"),Object(l.b)("li",null,"localreturntype"),Object(l.b)("li",null,"localvaraccept"),Object(l.b)("li",null,"localvaraccepts"),Object(l.b)("li",null,"localvarauthnames"),Object(l.b)("li",null,"localvarcollectionqueryparams"),Object(l.b)("li",null,"localvarcontenttype"),Object(l.b)("li",null,"localvarcontenttypes"),Object(l.b)("li",null,"localvarcookieparams"),Object(l.b)("li",null,"localvarformparams"),Object(l.b)("li",null,"localvarheaderparams"),Object(l.b)("li",null,"localvarpath"),Object(l.b)("li",null,"localvarpostbody"),Object(l.b)("li",null,"localvarqueryparams"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"native"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"null"),Object(l.b)("li",null,"object"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"strictfp"),Object(l.b)("li",null,"stringutil"),Object(l.b)("li",null,"super"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"synchronized"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"throws"),Object(l.b)("li",null,"transient"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"while")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uuid"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Null"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"AnyType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Object"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"anyOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"oneOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"not"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return m}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},o=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),o=n,m=p["".concat(r,".").concat(o)]||p[o]||d[o]||l;return a?b.a.createElement(m,c({ref:e},j,{components:a})):b.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=o;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}o.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/0358ea4a.eb6d82ad.js b/0358ea4a.eb6d82ad.js
new file mode 100644
index 00000000000..661998f0589
--- /dev/null
+++ b/0358ea4a.eb6d82ad.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[7],{133:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Documentation for the java Generator"},c={id:"generators/java",title:"Documentation for the java Generator",description:"## METADATA",source:"@site/../docs/generators/java.md",permalink:"/docs/generators/java",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java.md",lastUpdatedBy:"Andrii Serkes",lastUpdatedAt:1650436183},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"SUPPORTED VENDOR EXTENSIONS",id:"supported-vendor-extensions",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("h2",{id:"metadata"},"METADATA"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Value"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Notes"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator stability"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"STABLE"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CLIENT"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator language"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"mustache"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generates a Java client library (HTTP lib: Jersey (1.x, 2.x), Retrofit (2.x), OpenFeign (10.x) and more."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))))),Object(l.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalEnumTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for enum type(class level annotations)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalModelTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated api classes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.client.api")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactDescription"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact description in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI Java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi-java-client")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact version in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"asyncNative"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If true, async handlers will be used, instead of the sync version"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"bigDecimalAsString"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Treat BigDecimal values as Strings to avoid precision loss."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"get")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"caseInsensitiveResponseHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Make API response's headers case-insensitive. Available on okhttp-gson, jersey2 libraries"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"configKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Config key in @RegisterRestClient. Default to none. Only ",Object(l.b)("inlineCode",{parentName:"td"},"microprofile")," supports this option."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Option. Date library to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"joda")),Object(l.b)("dd",null,"Joda (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"legacy")),Object(l.b)("dd",null,"Legacy java.util.Date"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8-localdatetime")),Object(l.b)("dd",null,"Java 8 using LocalDateTime (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8")),Object(l.b)("dd",null,"Java 8 native JSR310 (preferred for jdk 1.8+)"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java8")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerEmail"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer email in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"team@openapitools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer name in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI-Generator Contributors")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganization"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPITools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganizationUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://openapitools.org"}),"http://openapitools.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disableHtmlEscaping"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"discriminatorCaseSensitive"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dynamicOperations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate operations dynamically at runtime from an OAS"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumUnknownDefaultCase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"No changes to the enum's are made, this is the default option."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"errorObjectType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Error Object type. (This option is for okhttp-gson-next-gen only)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"fullJavaUtil"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to use fully qualified name for classes under java.util. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"gradleProperties"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Append additional Gradle properties to the gradle.properties file"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ignoreAnyOfInEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ignore anyOf keyword in enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters in the generated API methods using @ApiImplicitParams annotation."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeadersRegex"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"invokerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"root package for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.client")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"library template (sub-template) to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jersey1")),Object(l.b)("dd",null,"HTTP client: Jersey client 1.19.x. JSON processing: Jackson 2.9.x. Enable gzip request encoding using '-DuseGzipFeature=true'. IMPORTANT NOTE: jersey 1.x is no longer actively maintained so please upgrade to 'jersey3' or other HTTP libraries instead."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jersey2")),Object(l.b)("dd",null,"HTTP client: Jersey client 2.25.1. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jersey3")),Object(l.b)("dd",null,"HTTP client: Jersey client 3.x. JSON processing: Jackson 2.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"feign")),Object(l.b)("dd",null,"HTTP client: OpenFeign 10.x. JSON processing: Jackson 2.9.x."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"okhttp-gson")),Object(l.b)("dd",null,"[DEFAULT]"," HTTP client: OkHttp 3.x. JSON processing: Gson 2.8.x. Enable Parcelable models on Android using '-DparcelableModel=true'. Enable gzip request encoding using '-DuseGzipFeature=true'."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"retrofit2")),Object(l.b)("dd",null,"HTTP client: OkHttp 3.x. JSON processing: Gson 2.x (Retrofit 2.3.0). Enable the RxJava adapter using '-DuseRxJava","[2/3]","=true'. (RxJava 1.x or 2.x or 3.x)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"resttemplate")),Object(l.b)("dd",null,"HTTP client: Spring RestTemplate 4.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"webclient")),Object(l.b)("dd",null,"HTTP client: Spring WebClient 5.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"resteasy")),Object(l.b)("dd",null,"HTTP client: Resteasy client 3.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"vertx")),Object(l.b)("dd",null,"HTTP client: VertX client 3.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"google-api-client")),Object(l.b)("dd",null,"HTTP client: Google API client 1.x. JSON processing: Jackson 2.9.x"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"rest-assured")),Object(l.b)("dd",null,"HTTP client: rest-assured : 4.x. JSON processing: Gson 2.x or Jackson 2.10.x. Only for Java 8"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"native")),Object(l.b)("dd",null,"HTTP client: Java native HttpClient. JSON processing: Jackson 2.9.x. Only for Java11+"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"microprofile")),Object(l.b)("dd",null,"HTTP client: Microprofile client 1.x. JSON processing: JSON-B"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"apache-httpclient")),Object(l.b)("dd",null,"HTTP client: Apache httpclient 4.x"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"okhttp-gson")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Unlicense")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://unlicense.org"}),"http://unlicense.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"microprofileFramework"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Framework for microprofile. Possible values ",'"',"kumuluzee",'"'),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"microprofileRestClientVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Version of MicroProfile Rest Client API."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.client.model")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openApiNullable"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enable OpenAPI Jackson Nullable library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parcelableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to generate models for Android that implement Parcelable with the okhttp-gson library."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentArtifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentGroupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"performBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Perform BeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmDeveloperConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM developer connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean - toggle ",'"',"implements Serializable",'"'," for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializationLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Serialization library, default depends on value of the option library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jsonb")),Object(l.b)("dd",null,"Use JSON-B as serialization library"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"jackson")),Object(l.b)("dd",null,"Use Jackson as serialization library"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"gson")),Object(l.b)("dd",null,"Use Gson as serialization library"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"snapshotVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uses a SNAPSHOT version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Use a SnapShot Version"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"Use a Release Version"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"src/main/java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"supportStreaming"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Support streaming endpoint (beta)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"testOutput"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set output folder for models and APIs tests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"${project.build.directory}/generated-test-sources/openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useAbstractionForFiles"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use alternative types instead of java.io.File to allow passing bytes without a file on disk. Available on resttemplate, webclient, libraries"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use BeanValidation API annotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useGzipFeature"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Send gzip-encoded requests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useOneOfDiscriminatorLookup"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use the discriminator's mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf's schemas) will be skipped. Only jersey2, jersey3, native, okhttp-gson support this option."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"usePlayWS"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use Play! Async HTTP client (Play WS API)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useReflectionEqualsHashCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use org.apache.commons.lang3.builder for equals and hashCode in the models. WARNING: This will fail under a security manager, unless the appropriate permissions are set up correctly and also there's potential performance impact."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useRuntimeException"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use RuntimeException instead of Exception"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useRxJava2"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to use the RxJava2 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useRxJava3"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to use the RxJava3 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"supported-vendor-extensions"},"SUPPORTED VENDOR EXTENSIONS"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Extension name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Applicable for"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default value"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-discriminator-value"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Used with model inheritance to specify value for discriminator that identifies current model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ability to specify interfaces that model must implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"empty array")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-setter-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom annotation that can be specified over java setter for specific field"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"When field is array & uniqueItems, then this extension is used to add ",Object(l.b)("inlineCode",{parentName:"td"},"@JsonDeserialize(as = LinkedHashSet.class)")," over setter, otherwise no value")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-tags"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify multiple swagger tags for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-accepts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Accept' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-content-type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Content-Type' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-class-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-field-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to property"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-webclient-blocking"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specifies if method for specific operation should be blocking or non-blocking(ex: return ",Object(l.b)("inlineCode",{parentName:"td"},"Mono<T>/Flux<T>")," or ",Object(l.b)("inlineCode",{parentName:"td"},"return T/List<T>/Set<T>")," & execute ",Object(l.b)("inlineCode",{parentName:"td"},".block()")," inside generated method)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BigDecimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.math.BigDecimal")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Date")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.io.File")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.LinkedHashSet")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDate"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Map")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Timestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.sql.Timestamp")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"URI"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.net.URI")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UUID"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.UUID")))),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet")))),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Boolean"),Object(l.b)("li",null,"Double"),Object(l.b)("li",null,"Float"),Object(l.b)("li",null,"Integer"),Object(l.b)("li",null,"Long"),Object(l.b)("li",null,"Object"),Object(l.b)("li",null,"String"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"byte[]")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"abstract"),Object(l.b)("li",null,"apiclient"),Object(l.b)("li",null,"apiexception"),Object(l.b)("li",null,"apiresponse"),Object(l.b)("li",null,"assert"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"configuration"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"extends"),Object(l.b)("li",null,"file"),Object(l.b)("li",null,"final"),Object(l.b)("li",null,"finally"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"implements"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"instanceof"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"list"),Object(l.b)("li",null,"localreturntype"),Object(l.b)("li",null,"localvaraccept"),Object(l.b)("li",null,"localvaraccepts"),Object(l.b)("li",null,"localvarauthnames"),Object(l.b)("li",null,"localvarcollectionqueryparams"),Object(l.b)("li",null,"localvarcontenttype"),Object(l.b)("li",null,"localvarcontenttypes"),Object(l.b)("li",null,"localvarcookieparams"),Object(l.b)("li",null,"localvarformparams"),Object(l.b)("li",null,"localvarheaderparams"),Object(l.b)("li",null,"localvarpath"),Object(l.b)("li",null,"localvarpostbody"),Object(l.b)("li",null,"localvarqueryparams"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"native"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"null"),Object(l.b)("li",null,"object"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"strictfp"),Object(l.b)("li",null,"stringutil"),Object(l.b)("li",null,"super"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"synchronized"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"throws"),Object(l.b)("li",null,"transient"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"while")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uuid"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Null"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"AnyType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Object"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"anyOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"oneOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"not"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return m}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},o=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),o=n,m=p["".concat(r,".").concat(o)]||p[o]||d[o]||l;return a?b.a.createElement(m,c({ref:e},j,{components:a})):b.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=o;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}o.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/03abeb31.8a0f7431.js b/03abeb31.8a0f7431.js
deleted file mode 100644
index 4af7942e2d7..00000000000
--- a/03abeb31.8a0f7431.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[8],{134:function(e,n,t){"use strict";t.r(n),t.d(n,"frontMatter",(function(){return l})),t.d(n,"metadata",(function(){return r})),t.d(n,"rightToc",(function(){return s})),t.d(n,"default",(function(){return c}));var o=t(1),i=t(9),a=(t(0),t(312)),l={id:"debugging",title:"Debugging"},r={id:"debugging",title:"Debugging",description:"## Generation",source:"@site/../docs/debugging.md",permalink:"/docs/debugging",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/debugging.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Customization",permalink:"/docs/customization"},next:{title:"Workflow Integrations",permalink:"/docs/integrations"}},s=[{value:"Generation",id:"generation",children:[]},{value:"Templates",id:"templates",children:[]},{value:"Runtime",id:"runtime",children:[]},{value:"Logs",id:"logs",children:[]}],p={rightToc:s};function c(e){var n=e.components,t=Object(i.a)(e,["components"]);return Object(a.b)("wrapper",Object(o.a)({},p,t,{components:n,mdxType:"MDXLayout"}),Object(a.b)("h2",{id:"generation"},"Generation"),Object(a.b)("p",null,"As a user there may be times when generated outputs don't match your expectations it's unclear why. The CLI supports a ",Object(a.b)("inlineCode",{parentName:"p"},"--dry-run")," option which may be used to inspect the anticipated file operations without making changes to the file system."),Object(a.b)("p",null,"Suppose you generate using the ",Object(a.b)("inlineCode",{parentName:"p"},"--minimal-update")," option, and you notice on subsequent generations of a client that no files have changed. This is by design."),Object(a.b)("p",null,"For example, if you generate the aspnetcore generator passing ",Object(a.b)("inlineCode",{parentName:"p"},"--minimal-update --dry-run")," to the sample generation script in the code repository:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),'export JAVA_OPTS="-Dlog.level=off"\n./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run\n')),Object(a.b)("p",null,"You'll see the output similar to the following:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),"$ ./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run\n# START SCRIPT: ./bin/generate-samples.sh\nThis script generates all configs under bin/configs by default.\nYou may generate a targeted script or set of scripts using glob patterns.\n\nFor example:\n    ./bin/generate-samples.sh bin/configs/java-*\n\nYou may generate a single config with additional options if you use -- to\nseparate the single config file from the generator arguments.\n\nFor example:\n    ./bin/generate-samples.sh bin/configs/java-vertx.yaml -- --global-property debugModels=true\n\n\n[main] INFO  o.o.codegen.DefaultGenerator - Generating with dryRun=true\n[main] INFO  o.o.codegen.DefaultGenerator - OpenAPI Generator: lua (client)\n[main] INFO  o.o.codegen.DefaultGenerator - Generator 'lua' is considered beta.\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] INFO  o.o.codegen.DefaultGenerator - Model inline_object (marked as unused due to form parameters) is generated due to the system property skipFormModel=false (default)\n[main] INFO  o.o.codegen.DefaultGenerator - Model inline_object_1 (marked as unused due to form parameters) is generated due to the system property skipFormModel=false (default)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/json)\n[main] WARN  o.o.codegen.DefaultCodegen - Multiple MediaTypes found, using only the first one\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/json)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] ERROR o.o.codegen.DefaultGenerator - \n\nDry Run Results:\n\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore\nn /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua\n\n\nStates:\n\n  - w Write\n  - n Write if New/Updated\n  - i Ignored\n  - s Skipped Overwrite\n  - k Skipped by user option(s)\n  - e Error evaluating file write state\n\n\n[main] ERROR o.o.codegen.DefaultGenerator - \n\nDry Run Results:\n\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore\nn /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua\n\n\nStates:\n\n  - w Write\n  - n Write if New/Updated\n  - i Ignored\n  - s Skipped Overwrite\n  - k Skipped by user option(s)\n  - e Error evaluating file write state\n\n")),Object(a.b)("p",null,"The output lists the files which would be written in a normal run of the tool. Notice that we skip ",Object(a.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," because the file exists and we don't want to blow away the user's generation rules. Most of these files will overwrite output files only if the contents slated for write are different from those on the filesystem; this is denoted by an ",Object(a.b)("inlineCode",{parentName:"p"},"n")," preceding the filename. Some of the above lines begin with a ",Object(a.b)("inlineCode",{parentName:"p"},"w"),", meaning these files will ",Object(a.b)("em",{parentName:"p"},"always")," result in a write operation."),Object(a.b)("p",null,"If you find an operation that you feel should result in a different state, please ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/issues/new/choose"}),"open an issue")," or ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/compare"}),"submit a pull request")," to change the behavior (we welcome all contributions)."),Object(a.b)("h2",{id:"templates"},"Templates"),Object(a.b)("p",null,"Sometimes, you may have issues with variables in your templates. As discussed in the ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"/docs/templating"}),"templating")," docs, we offer a variety of system properties for inspecting the models bound to templates."),Object(a.b)("dl",null,Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugOpenAPI")),Object(a.b)("dd",null,"Prints out the JSON model of the OpenAPI Document, as seen by OpenAPI Generator"),Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugModels")),Object(a.b)("dd",null,"Prints out the JSON model passed to model templates"),Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugOperations")),Object(a.b)("dd",null,"Prints out the JSON model passed to operation (api) templates"),Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugSupportingFiles")),Object(a.b)("dd",null,"Prints out the JSON model passed to supporting files")),Object(a.b)("p",null,"One or more of these properties can be passed alongside other command line options:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugModels,debugOperations\n")),Object(a.b)("p",null,"Or you can add these to your ",Object(a.b)("inlineCode",{parentName:"p"},"JAVA_OPTS")," environment variable (this applies to every invocation of the tool):"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),'export JAVA_OPTS="${JAVA_OPTS} --global-property debugModels,debugOperations"\n')),Object(a.b)("blockquote",null,Object(a.b)("p",{parentName:"blockquote"},"NOTE: Globally available system options like these will apply to all invocations of the generator (CLI and plugins)")),Object(a.b)("h2",{id:"runtime"},"Runtime"),Object(a.b)("p",null,"When you're working with a custom generator, a new generator, or otherwise trying to understand the behavior of the toolset, you may need to attach a remote debugger in order to step through the code."),Object(a.b)("p",null,"The steps are shown here for a specific version of the generator, but apply the same if you're working off master or a feature branch."),Object(a.b)("ul",null,Object(a.b)("li",{parentName:"ul"},"Determine the version of ",Object(a.b)("inlineCode",{parentName:"li"},"openapi-generator")," you're using. For the CLI, this is:  ",Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"openapi-generator version\n"))),Object(a.b)("li",{parentName:"ul"},"Navigate to the ",Object(a.b)("inlineCode",{parentName:"li"},"openapi-generator")," source directory (see ",Object(a.b)("a",Object(o.a)({parentName:"li"},{href:"/docs/contribute-building"}),"building")," docs for obtaining source code and brief introduction)."),Object(a.b)("li",{parentName:"ul"},"Checkout the branch/tag for the target version. Branches are not prefixed, but tags are prefixed with a ",Object(a.b)("inlineCode",{parentName:"li"},"v"),". For instance if you're using version ",Object(a.b)("inlineCode",{parentName:"li"},"3.3.0"),", you will execute:",Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"git checkout v3.3.0\n"))),Object(a.b)("li",{parentName:"ul"},"Open the project in your IDE."),Object(a.b)("li",{parentName:"ul"},"Setup your IDE for remote debugging. You'll want to define a port used for connecting the remote debugger. For this example, we'll use ",Object(a.b)("inlineCode",{parentName:"li"},"5005"),". See external tutorials for ",Object(a.b)("a",Object(o.a)({parentName:"li"},{href:"https://www.jetbrains.com/help/idea/run-debug-configuration-remote-debug.html"}),"IntelliJ")," and ",Object(a.b)("a",Object(o.a)({parentName:"li"},{href:"https://www.ibm.com/developerworks/library/os-eclipse-javadebug/index.html"}),"Eclipse")),Object(a.b)("li",{parentName:"ul"},"Export the debug configuration, specifying ",Object(a.b)("inlineCode",{parentName:"li"},"suspend=y")," so you have time to attach a remote debugger. These are passed as Java system properties, either on command line or as part of the ",Object(a.b)("inlineCode",{parentName:"li"},"JAVA_OPTS")," environment variable. This will look like:",Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),'export JAVA_OPTS="${JAVA_OPTS} -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005"\n'))),Object(a.b)("li",{parentName:"ul"},"Execute the generator with your desired options. You should see the application output ",Object(a.b)("em",{parentName:"li"},"only"),Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"Listening for transport dt_socket at address: 5005\n"))),Object(a.b)("li",{parentName:"ul"},"Set breakpoints in code, and then attach your remote debugger from your IDE (see above). The generator will automatically unblock once the remote debugger is attached. You can now step through the code.")),Object(a.b)("h2",{id:"logs"},"Logs"),Object(a.b)("p",null,"You can try to enable debugging log with ",Object(a.b)("inlineCode",{parentName:"p"},"-Dlog.level=debug")," option to the ",Object(a.b)("inlineCode",{parentName:"p"},"JAVA_OPTS")," environment variable to see more information:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),'export JAVA_OPTS="${JAVA_OPTS} -Dlog.level=debug"\n')),Object(a.b)("p",null,"Set the option then DEBUG logs are printed out:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go ...\n\n...\n...\n[main] DEBUG o.o.codegen.DefaultCodegen - debugging fromProperty for files : class Schema {\n    type: null\n    format: null\n    $ref: #/components/schemas/File\n...\n...\n")))}c.isMDXComponent=!0},312:function(e,n,t){"use strict";t.d(n,"a",(function(){return u})),t.d(n,"b",(function(){return g}));var o=t(0),i=t.n(o);function a(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function l(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);n&&(o=o.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,o)}return t}function r(e){for(var n=1;n<arguments.length;n++){var t=null!=arguments[n]?arguments[n]:{};n%2?l(Object(t),!0).forEach((function(n){a(e,n,t[n])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):l(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))}))}return e}function s(e,n){if(null==e)return{};var t,o,i=function(e,n){if(null==e)return{};var t,o,i={},a=Object.keys(e);for(o=0;o<a.length;o++)t=a[o],n.indexOf(t)>=0||(i[t]=e[t]);return i}(e,n);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o<a.length;o++)t=a[o],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}var p=i.a.createContext({}),c=function(e){var n=i.a.useContext(p),t=n;return e&&(t="function"==typeof e?e(n):r({},n,{},e)),t},u=function(e){var n=c(e.components);return i.a.createElement(p.Provider,{value:n},e.children)},d={inlineCode:"code",wrapper:function(e){var n=e.children;return i.a.createElement(i.a.Fragment,{},n)}},m=Object(o.forwardRef)((function(e,n){var t=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),u=c(t),m=o,g=u["".concat(l,".").concat(m)]||u[m]||d[m]||a;return t?i.a.createElement(g,r({ref:n},p,{components:t})):i.a.createElement(g,r({ref:n},p))}));function g(e,n){var t=arguments,o=n&&n.mdxType;if("string"==typeof e||o){var a=t.length,l=new Array(a);l[0]=m;var r={};for(var s in n)hasOwnProperty.call(n,s)&&(r[s]=n[s]);r.originalType=e,r.mdxType="string"==typeof e?e:o,l[1]=r;for(var p=2;p<a;p++)l[p]=t[p];return i.a.createElement.apply(null,l)}return i.a.createElement.apply(null,t)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/03abeb31.b27e9b33.js b/03abeb31.b27e9b33.js
new file mode 100644
index 00000000000..a80e192cbd1
--- /dev/null
+++ b/03abeb31.b27e9b33.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[8],{134:function(e,n,t){"use strict";t.r(n),t.d(n,"frontMatter",(function(){return l})),t.d(n,"metadata",(function(){return r})),t.d(n,"rightToc",(function(){return s})),t.d(n,"default",(function(){return c}));var o=t(1),i=t(9),a=(t(0),t(312)),l={id:"debugging",title:"Debugging"},r={id:"debugging",title:"Debugging",description:"## Generation",source:"@site/../docs/debugging.md",permalink:"/docs/debugging",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/debugging.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Customization",permalink:"/docs/customization"},next:{title:"Workflow Integrations",permalink:"/docs/integrations"}},s=[{value:"Generation",id:"generation",children:[]},{value:"Templates",id:"templates",children:[]},{value:"Runtime",id:"runtime",children:[]},{value:"Logs",id:"logs",children:[]}],p={rightToc:s};function c(e){var n=e.components,t=Object(i.a)(e,["components"]);return Object(a.b)("wrapper",Object(o.a)({},p,t,{components:n,mdxType:"MDXLayout"}),Object(a.b)("h2",{id:"generation"},"Generation"),Object(a.b)("p",null,"As a user there may be times when generated outputs don't match your expectations it's unclear why. The CLI supports a ",Object(a.b)("inlineCode",{parentName:"p"},"--dry-run")," option which may be used to inspect the anticipated file operations without making changes to the file system."),Object(a.b)("p",null,"Suppose you generate using the ",Object(a.b)("inlineCode",{parentName:"p"},"--minimal-update")," option, and you notice on subsequent generations of a client that no files have changed. This is by design."),Object(a.b)("p",null,"For example, if you generate the aspnetcore generator passing ",Object(a.b)("inlineCode",{parentName:"p"},"--minimal-update --dry-run")," to the sample generation script in the code repository:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),'export JAVA_OPTS="-Dlog.level=off"\n./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run\n')),Object(a.b)("p",null,"You'll see the output similar to the following:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),"$ ./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run\n# START SCRIPT: ./bin/generate-samples.sh\nThis script generates all configs under bin/configs by default.\nYou may generate a targeted script or set of scripts using glob patterns.\n\nFor example:\n    ./bin/generate-samples.sh bin/configs/java-*\n\nYou may generate a single config with additional options if you use -- to\nseparate the single config file from the generator arguments.\n\nFor example:\n    ./bin/generate-samples.sh bin/configs/java-vertx.yaml -- --global-property debugModels=true\n\n\n[main] INFO  o.o.codegen.DefaultGenerator - Generating with dryRun=true\n[main] INFO  o.o.codegen.DefaultGenerator - OpenAPI Generator: lua (client)\n[main] INFO  o.o.codegen.DefaultGenerator - Generator 'lua' is considered beta.\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] INFO  o.o.codegen.DefaultGenerator - Model inline_object (marked as unused due to form parameters) is generated due to the system property skipFormModel=false (default)\n[main] INFO  o.o.codegen.DefaultGenerator - Model inline_object_1 (marked as unused due to form parameters) is generated due to the system property skipFormModel=false (default)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/json)\n[main] WARN  o.o.codegen.DefaultCodegen - Multiple MediaTypes found, using only the first one\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/json)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found in the OAS 'content' section, returning only the first one (application/xml)\n[main] ERROR o.o.codegen.DefaultGenerator - \n\nDry Run Results:\n\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore\nn /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua\n\n\nStates:\n\n  - w Write\n  - n Write if New/Updated\n  - i Ignored\n  - s Skipped Overwrite\n  - k Skipped by user option(s)\n  - e Error evaluating file write state\n\n\n[main] ERROR o.o.codegen.DefaultGenerator - \n\nDry Run Results:\n\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore\nn /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua\nk /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua\n\n\nStates:\n\n  - w Write\n  - n Write if New/Updated\n  - i Ignored\n  - s Skipped Overwrite\n  - k Skipped by user option(s)\n  - e Error evaluating file write state\n\n")),Object(a.b)("p",null,"The output lists the files which would be written in a normal run of the tool. Notice that we skip ",Object(a.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," because the file exists and we don't want to blow away the user's generation rules. Most of these files will overwrite output files only if the contents slated for write are different from those on the filesystem; this is denoted by an ",Object(a.b)("inlineCode",{parentName:"p"},"n")," preceding the filename. Some of the above lines begin with a ",Object(a.b)("inlineCode",{parentName:"p"},"w"),", meaning these files will ",Object(a.b)("em",{parentName:"p"},"always")," result in a write operation."),Object(a.b)("p",null,"If you find an operation that you feel should result in a different state, please ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/issues/new/choose"}),"open an issue")," or ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/compare"}),"submit a pull request")," to change the behavior (we welcome all contributions)."),Object(a.b)("h2",{id:"templates"},"Templates"),Object(a.b)("p",null,"Sometimes, you may have issues with variables in your templates. As discussed in the ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"/docs/templating"}),"templating")," docs, we offer a variety of system properties for inspecting the models bound to templates."),Object(a.b)("dl",null,Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugOpenAPI")),Object(a.b)("dd",null,"Prints out the JSON model of the OpenAPI Document, as seen by OpenAPI Generator"),Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugModels")),Object(a.b)("dd",null,"Prints out the JSON model passed to model templates"),Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugOperations")),Object(a.b)("dd",null,"Prints out the JSON model passed to operation (api) templates"),Object(a.b)("dt",null,Object(a.b)("code",null,"--global-property debugSupportingFiles")),Object(a.b)("dd",null,"Prints out the JSON model passed to supporting files")),Object(a.b)("p",null,"One or more of these properties can be passed alongside other command line options:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugModels,debugOperations\n")),Object(a.b)("p",null,"Or you can add these to your ",Object(a.b)("inlineCode",{parentName:"p"},"JAVA_OPTS")," environment variable (this applies to every invocation of the tool):"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),'export JAVA_OPTS="${JAVA_OPTS} --global-property debugModels,debugOperations"\n')),Object(a.b)("blockquote",null,Object(a.b)("p",{parentName:"blockquote"},"NOTE: Globally available system options like these will apply to all invocations of the generator (CLI and plugins)")),Object(a.b)("h2",{id:"runtime"},"Runtime"),Object(a.b)("p",null,"When you're working with a custom generator, a new generator, or otherwise trying to understand the behavior of the toolset, you may need to attach a remote debugger in order to step through the code."),Object(a.b)("p",null,"The steps are shown here for a specific version of the generator, but apply the same if you're working off master or a feature branch."),Object(a.b)("ul",null,Object(a.b)("li",{parentName:"ul"},"Determine the version of ",Object(a.b)("inlineCode",{parentName:"li"},"openapi-generator")," you're using. For the CLI, this is:  ",Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"openapi-generator version\n"))),Object(a.b)("li",{parentName:"ul"},"Navigate to the ",Object(a.b)("inlineCode",{parentName:"li"},"openapi-generator")," source directory (see ",Object(a.b)("a",Object(o.a)({parentName:"li"},{href:"/docs/contribute-building"}),"building")," docs for obtaining source code and brief introduction)."),Object(a.b)("li",{parentName:"ul"},"Checkout the branch/tag for the target version. Branches are not prefixed, but tags are prefixed with a ",Object(a.b)("inlineCode",{parentName:"li"},"v"),". For instance if you're using version ",Object(a.b)("inlineCode",{parentName:"li"},"3.3.0"),", you will execute:",Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"git checkout v3.3.0\n"))),Object(a.b)("li",{parentName:"ul"},"Open the project in your IDE."),Object(a.b)("li",{parentName:"ul"},"Setup your IDE for remote debugging. You'll want to define a port used for connecting the remote debugger. For this example, we'll use ",Object(a.b)("inlineCode",{parentName:"li"},"5005"),". See external tutorials for ",Object(a.b)("a",Object(o.a)({parentName:"li"},{href:"https://www.jetbrains.com/help/idea/run-debug-configuration-remote-debug.html"}),"IntelliJ")," and ",Object(a.b)("a",Object(o.a)({parentName:"li"},{href:"https://www.ibm.com/developerworks/library/os-eclipse-javadebug/index.html"}),"Eclipse")),Object(a.b)("li",{parentName:"ul"},"Export the debug configuration, specifying ",Object(a.b)("inlineCode",{parentName:"li"},"suspend=y")," so you have time to attach a remote debugger. These are passed as Java system properties, either on command line or as part of the ",Object(a.b)("inlineCode",{parentName:"li"},"JAVA_OPTS")," environment variable. This will look like:",Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),'export JAVA_OPTS="${JAVA_OPTS} -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005"\n'))),Object(a.b)("li",{parentName:"ul"},"Execute the generator with your desired options. You should see the application output ",Object(a.b)("em",{parentName:"li"},"only"),Object(a.b)("pre",{parentName:"li"},Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"Listening for transport dt_socket at address: 5005\n"))),Object(a.b)("li",{parentName:"ul"},"Set breakpoints in code, and then attach your remote debugger from your IDE (see above). The generator will automatically unblock once the remote debugger is attached. You can now step through the code.")),Object(a.b)("h2",{id:"logs"},"Logs"),Object(a.b)("p",null,"You can try to enable debugging log with ",Object(a.b)("inlineCode",{parentName:"p"},"-Dlog.level=debug")," option to the ",Object(a.b)("inlineCode",{parentName:"p"},"JAVA_OPTS")," environment variable to see more information:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),'export JAVA_OPTS="${JAVA_OPTS} -Dlog.level=debug"\n')),Object(a.b)("p",null,"Set the option then DEBUG logs are printed out:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go ...\n\n...\n...\n[main] DEBUG o.o.codegen.DefaultCodegen - debugging fromProperty for files : class Schema {\n    type: null\n    format: null\n    $ref: #/components/schemas/File\n...\n...\n")))}c.isMDXComponent=!0},312:function(e,n,t){"use strict";t.d(n,"a",(function(){return u})),t.d(n,"b",(function(){return g}));var o=t(0),i=t.n(o);function a(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function l(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);n&&(o=o.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,o)}return t}function r(e){for(var n=1;n<arguments.length;n++){var t=null!=arguments[n]?arguments[n]:{};n%2?l(Object(t),!0).forEach((function(n){a(e,n,t[n])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):l(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))}))}return e}function s(e,n){if(null==e)return{};var t,o,i=function(e,n){if(null==e)return{};var t,o,i={},a=Object.keys(e);for(o=0;o<a.length;o++)t=a[o],n.indexOf(t)>=0||(i[t]=e[t]);return i}(e,n);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o<a.length;o++)t=a[o],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}var p=i.a.createContext({}),c=function(e){var n=i.a.useContext(p),t=n;return e&&(t="function"==typeof e?e(n):r({},n,{},e)),t},u=function(e){var n=c(e.components);return i.a.createElement(p.Provider,{value:n},e.children)},d={inlineCode:"code",wrapper:function(e){var n=e.children;return i.a.createElement(i.a.Fragment,{},n)}},m=Object(o.forwardRef)((function(e,n){var t=e.components,o=e.mdxType,a=e.originalType,l=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),u=c(t),m=o,g=u["".concat(l,".").concat(m)]||u[m]||d[m]||a;return t?i.a.createElement(g,r({ref:n},p,{components:t})):i.a.createElement(g,r({ref:n},p))}));function g(e,n){var t=arguments,o=n&&n.mdxType;if("string"==typeof e||o){var a=t.length,l=new Array(a);l[0]=m;var r={};for(var s in n)hasOwnProperty.call(n,s)&&(r[s]=n[s]);r.originalType=e,r.mdxType="string"==typeof e?e:o,l[1]=r;for(var p=2;p<a;p++)l[p]=t[p];return i.a.createElement.apply(null,l)}return i.a.createElement.apply(null,t)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/0cae4475.608d273a.js b/0cae4475.608d273a.js
new file mode 100644
index 00000000000..d2ff371033c
--- /dev/null
+++ b/0cae4475.608d273a.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[15],{141:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return p})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return s}));var a=n(1),o=n(9),r=(n(0),n(312)),p={id:"online",title:"Online"},c={id:"online",title:"Online",description:"## Hosted",source:"@site/../docs/online.md",permalink:"/docs/online",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/online.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Plugins",permalink:"/docs/plugins"},next:{title:"Usage",permalink:"/docs/usage"}},l=[{value:"Hosted",id:"hosted",children:[]},{value:"Docker Image",id:"docker-image",children:[]},{value:"Local/Self-hosting",id:"localself-hosting",children:[]}],i={rightToc:l};function s(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(r.b)("wrapper",Object(a.a)({},i,n,{components:t,mdxType:"MDXLayout"}),Object(r.b)("h2",{id:"hosted"},"Hosted"),Object(r.b)("p",null,"We offer online services, publicly and free of charge:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"latest stable version: ",Object(r.b)("a",Object(a.a)({parentName:"li"},{href:"http://api.openapi-generator.tech"}),"http://api.openapi-generator.tech")),Object(r.b)("li",{parentName:"ul"},"latest master: ",Object(r.b)("a",Object(a.a)({parentName:"li"},{href:"http://api-latest-master.openapi-generator.tech"}),"http://api-latest-master.openapi-generator.tech")," (updated with latest master every hour)")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Hosting Sponsor"),Object(r.b)("br",{parentName:"p"}),"\n",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://www.linode.com/"}),Object(r.b)("img",Object(a.a)({parentName:"a"},{src:"https://www.linode.com/media/images/logos/standard/light/linode-logo_standard_light_small.png",alt:"Linode Logo"}))))),Object(r.b)("p",null,"These services are beta and do not have any guarantee on service level"),Object(r.b)("h2",{id:"docker-image"},"Docker Image"),Object(r.b)("p",null,"The openapi-generator-online Docker image can act as a self-hosted web application and API for generating code. This container can be incorporated into a CI pipeline, and requires at least two HTTP requests and some docker orchestration to access generated code."),Object(r.b)("p",null,"Example usage:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'# Start container at port 8888 and save the container id\nCID=$(docker run -d -p 8888:8080 openapitools/openapi-generator-online)\n\n# allow for startup\nsleep 10\n\n# Get the IP of the running container (optional)\nGEN_IP=$(docker inspect --format \'{{.NetworkSettings.IPAddress}}\'  ${CID})\n\n# Execute an HTTP request to generate a Ruby client\ncurl -X POST --header \'Content-Type: application/json\' \\\n  --header \'Accept: application/json\' \\\n  -d \'{"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}\' \\\n  \'http://localhost:8888/api/gen/clients/ruby\'\n\n# Example output:\n# {"code":"c2d483.3.4672-40e9-91df-b9ffd18d22b8","link":"http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8"}\n\n# Download the generated zip file  (using "code" provided from your output) \nwget http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8\n\n# Unzip the file\nunzip c2d483.3.4672-40e9-91df-b9ffd18d22b8\n\n# Shutdown the openapi generator image\ndocker stop ${CID} && docker rm ${CID}\n')),Object(r.b)("h2",{id:"localself-hosting"},"Local/Self-hosting"),Object(r.b)("p",null,"If you prefer to run the service locally, here are the steps:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"mvn clean install\ncd modules/openapi-generator-online\nmvn spring-boot:run\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"The online openapi-generator can be run via ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"#docker-image"}),"Docker")," as well.")),Object(r.b)("p",null,"For example, to generate Ruby API client, simply send the following HTTP request using curl:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'curl -X POST -H "content-type:application/json" -d \'{"openAPIUrl":"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}\' \\\n    http://localhost:8080/api/gen/clients/ruby\n')),Object(r.b)("p",null,"Then you will receive a JSON response with the URL to download the zipped code."),Object(r.b)("p",null,"To customize the SDK, you can ",Object(r.b)("inlineCode",{parentName:"p"},"POST")," to ",Object(r.b)("inlineCode",{parentName:"p"},"http://localhost:8080/gen/clients/{generator}")," with the following HTTP body:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "options": {},\n  "openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"\n}\n')),Object(r.b)("p",null,"Here, the ",Object(r.b)("inlineCode",{parentName:"p"},"options")," for a language can be obtained by submitting a ",Object(r.b)("inlineCode",{parentName:"p"},"GET")," request to ",Object(r.b)("inlineCode",{parentName:"p"},"http://locahost:8080/api/gen/clients/{generator}"),":"),Object(r.b)("p",null,"For example, ",Object(r.b)("inlineCode",{parentName:"p"},"curl http://localhost:8080/api/gen/clients/python")," returns"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'  "packageName":{\n    "opt":"packageName",\n    "description":"python package name (convention: snake_case).",\n    "type":"string",\n    "default":"openapi_client"\n  },\n  "packageVersion":{\n    "opt":"packageVersion",\n    "description":"python package version.",\n    "type":"string",\n    "default":"1.0.0"\n  },\n  "sortParamsByRequiredFlag":{\n    "opt":"sortParamsByRequiredFlag",\n    "description":"Sort method arguments to place required parameters before optional parameters.",\n    "type":"boolean",\n    "default":"true"\n  }\n\n{}\n')),Object(r.b)("p",null,"To set package name to ",Object(r.b)("inlineCode",{parentName:"p"},"pet_store"),", the HTTP body of the request is as follows:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "options": {\n    "packageName": "pet_store"\n  },\n  "openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"\n}\n')),Object(r.b)("p",null,"and here is the curl command:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'curl -H "Content-type: application/json" \\\n    -X POST \\\n    -d \'{"options": {"packageName": "pet_store"},"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}\' \\\n    http://localhost:8080/api/gen/clients/python\n')),Object(r.b)("p",null,"Instead of using ",Object(r.b)("inlineCode",{parentName:"p"},"openAPIUrl")," with an URL to the OpenAPI spec, one can include the spec in the JSON payload with ",Object(r.b)("inlineCode",{parentName:"p"},"spec"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "options": {},\n  "spec": {\n    "swagger": "2.0",\n    "info": {\n      "version": "1.0.0",\n      "title": "Test API"\n    },\n    ...\n  }\n}\n')))}s.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return m}));var a=n(0),o=n.n(a);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function p(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?p(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):p(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},r=Object.keys(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var i=o.a.createContext({}),s=function(e){var t=o.a.useContext(i),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},b=function(e){var t=s(e.components);return o.a.createElement(i.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,p=e.parentName,i=l(e,["components","mdxType","originalType","parentName"]),b=s(n),d=a,m=b["".concat(p,".").concat(d)]||b[d]||u[d]||r;return n?o.a.createElement(m,c({ref:t},i,{components:n})):o.a.createElement(m,c({ref:t},i))}));function m(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,p=new Array(r);p[0]=d;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:a,p[1]=c;for(var i=2;i<r;i++)p[i]=n[i];return o.a.createElement.apply(null,p)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/0cae4475.982252e5.js b/0cae4475.982252e5.js
deleted file mode 100644
index 361229c8151..00000000000
--- a/0cae4475.982252e5.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[15],{141:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return p})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return s}));var a=n(1),o=n(9),r=(n(0),n(312)),p={id:"online",title:"Online"},c={id:"online",title:"Online",description:"## Hosted",source:"@site/../docs/online.md",permalink:"/docs/online",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/online.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Plugins",permalink:"/docs/plugins"},next:{title:"Usage",permalink:"/docs/usage"}},l=[{value:"Hosted",id:"hosted",children:[]},{value:"Docker Image",id:"docker-image",children:[]},{value:"Local/Self-hosting",id:"localself-hosting",children:[]}],i={rightToc:l};function s(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(r.b)("wrapper",Object(a.a)({},i,n,{components:t,mdxType:"MDXLayout"}),Object(r.b)("h2",{id:"hosted"},"Hosted"),Object(r.b)("p",null,"We offer online services, publicly and free of charge:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"latest stable version: ",Object(r.b)("a",Object(a.a)({parentName:"li"},{href:"http://api.openapi-generator.tech"}),"http://api.openapi-generator.tech")),Object(r.b)("li",{parentName:"ul"},"latest master: ",Object(r.b)("a",Object(a.a)({parentName:"li"},{href:"http://api-latest-master.openapi-generator.tech"}),"http://api-latest-master.openapi-generator.tech")," (updated with latest master every hour)")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Hosting Sponsor"),Object(r.b)("br",{parentName:"p"}),"\n",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://www.linode.com/"}),Object(r.b)("img",Object(a.a)({parentName:"a"},{src:"https://www.linode.com/media/images/logos/standard/light/linode-logo_standard_light_small.png",alt:"Linode Logo"}))))),Object(r.b)("p",null,"These services are beta and do not have any guarantee on service level"),Object(r.b)("h2",{id:"docker-image"},"Docker Image"),Object(r.b)("p",null,"The openapi-generator-online Docker image can act as a self-hosted web application and API for generating code. This container can be incorporated into a CI pipeline, and requires at least two HTTP requests and some docker orchestration to access generated code."),Object(r.b)("p",null,"Example usage:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'# Start container at port 8888 and save the container id\nCID=$(docker run -d -p 8888:8080 openapitools/openapi-generator-online)\n\n# allow for startup\nsleep 10\n\n# Get the IP of the running container (optional)\nGEN_IP=$(docker inspect --format \'{{.NetworkSettings.IPAddress}}\'  ${CID})\n\n# Execute an HTTP request to generate a Ruby client\ncurl -X POST --header \'Content-Type: application/json\' \\\n  --header \'Accept: application/json\' \\\n  -d \'{"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}\' \\\n  \'http://localhost:8888/api/gen/clients/ruby\'\n\n# Example output:\n# {"code":"c2d483.3.4672-40e9-91df-b9ffd18d22b8","link":"http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8"}\n\n# Download the generated zip file  (using "code" provided from your output) \nwget http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8\n\n# Unzip the file\nunzip c2d483.3.4672-40e9-91df-b9ffd18d22b8\n\n# Shutdown the openapi generator image\ndocker stop ${CID} && docker rm ${CID}\n')),Object(r.b)("h2",{id:"localself-hosting"},"Local/Self-hosting"),Object(r.b)("p",null,"If you prefer to run the service locally, here are the steps:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"mvn clean install\ncd modules/openapi-generator-online\nmvn spring-boot:run\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"The online openapi-generator can be run via ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"#docker-image"}),"Docker")," as well.")),Object(r.b)("p",null,"For example, to generate Ruby API client, simply send the following HTTP request using curl:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'curl -X POST -H "content-type:application/json" -d \'{"openAPIUrl":"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}\' \\\n    http://localhost:8080/api/gen/clients/ruby\n')),Object(r.b)("p",null,"Then you will receive a JSON response with the URL to download the zipped code."),Object(r.b)("p",null,"To customize the SDK, you can ",Object(r.b)("inlineCode",{parentName:"p"},"POST")," to ",Object(r.b)("inlineCode",{parentName:"p"},"http://localhost:8080/gen/clients/{generator}")," with the following HTTP body:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "options": {},\n  "openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"\n}\n')),Object(r.b)("p",null,"Here, the ",Object(r.b)("inlineCode",{parentName:"p"},"options")," for a language can be obtained by submitting a ",Object(r.b)("inlineCode",{parentName:"p"},"GET")," request to ",Object(r.b)("inlineCode",{parentName:"p"},"http://locahost:8080/api/gen/clients/{generator}"),":"),Object(r.b)("p",null,"For example, ",Object(r.b)("inlineCode",{parentName:"p"},"curl http://localhost:8080/api/gen/clients/python")," returns"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'  "packageName":{\n    "opt":"packageName",\n    "description":"python package name (convention: snake_case).",\n    "type":"string",\n    "default":"openapi_client"\n  },\n  "packageVersion":{\n    "opt":"packageVersion",\n    "description":"python package version.",\n    "type":"string",\n    "default":"1.0.0"\n  },\n  "sortParamsByRequiredFlag":{\n    "opt":"sortParamsByRequiredFlag",\n    "description":"Sort method arguments to place required parameters before optional parameters.",\n    "type":"boolean",\n    "default":"true"\n  }\n\n{}\n')),Object(r.b)("p",null,"To set package name to ",Object(r.b)("inlineCode",{parentName:"p"},"pet_store"),", the HTTP body of the request is as follows:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "options": {\n    "packageName": "pet_store"\n  },\n  "openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"\n}\n')),Object(r.b)("p",null,"and here is the curl command:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'curl -H "Content-type: application/json" \\\n    -X POST \\\n    -d \'{"options": {"packageName": "pet_store"},"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}\' \\\n    http://localhost:8080/api/gen/clients/python\n')),Object(r.b)("p",null,"Instead of using ",Object(r.b)("inlineCode",{parentName:"p"},"openAPIUrl")," with an URL to the OpenAPI spec, one can include the spec in the JSON payload with ",Object(r.b)("inlineCode",{parentName:"p"},"spec"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "options": {},\n  "spec": {\n    "swagger": "2.0",\n    "info": {\n      "version": "1.0.0",\n      "title": "Test API"\n    },\n    ...\n  }\n}\n')))}s.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return m}));var a=n(0),o=n.n(a);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function p(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?p(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):p(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},r=Object.keys(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var i=o.a.createContext({}),s=function(e){var t=o.a.useContext(i),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},b=function(e){var t=s(e.components);return o.a.createElement(i.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,p=e.parentName,i=l(e,["components","mdxType","originalType","parentName"]),b=s(n),d=a,m=b["".concat(p,".").concat(d)]||b[d]||u[d]||r;return n?o.a.createElement(m,c({ref:t},i,{components:n})):o.a.createElement(m,c({ref:t},i))}));function m(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,p=new Array(r);p[0]=d;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:a,p[1]=c;for(var i=2;i<r;i++)p[i]=n[i];return o.a.createElement.apply(null,p)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/10211c0a.240a2561.js b/10211c0a.240a2561.js
deleted file mode 100644
index 8bc94694382..00000000000
--- a/10211c0a.240a2561.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[16],{142:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return s})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return c}));var a=n(1),r=n(9),o=(n(0),n(312)),i={id:"new-generator",title:"Create a New Generator"},s={id:"new-generator",title:"Create a New Generator",description:"Creating a new generator which will become a part of the officially supported generators in OpenAPI Generator is pretty simple. We've created a helper script to bootstrap the operation. Let's look at the files necessary to create a new generator, then an example of bootstrapping a generator using the `new.sh` script in the root of the repository.",source:"@site/../docs/new-generator.md",permalink:"/docs/new-generator",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/new-generator.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Building the code",permalink:"/docs/contribute-building"},next:{title:"Roadmap",permalink:"/docs/roadmap"}},l=[{value:"Required Files",id:"required-files",children:[]},{value:"new.sh",id:"newsh",children:[{value:"Review Generated Config",id:"review-generated-config",children:[]},{value:"Create templates",id:"create-templates",children:[]},{value:"Build it",id:"build-it",children:[]},{value:"Compile Sample",id:"compile-sample",children:[]},{value:"Verify output",id:"verify-output",children:[]}]}],p={rightToc:l};function c(e){var t=e.components,n=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(a.a)({},p,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"Creating a new generator which will become a part of the officially supported generators in OpenAPI Generator is pretty simple. We've created a helper script to bootstrap the operation. Let's look at the files necessary to create a new generator, then an example of bootstrapping a generator using the ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script in the root of the repository."),Object(o.b)("h2",{id:"required-files"},"Required Files"),Object(o.b)("p",null,"The minimum set of files required to create a new generator are:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},'A "Codegen" file',Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"exists under ",Object(o.b)("inlineCode",{parentName:"li"},"modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/")),Object(o.b)("li",{parentName:"ul"},"defines language options"),Object(o.b)("li",{parentName:"ul"},"defines framework options"),Object(o.b)("li",{parentName:"ul"},"determines OpenAPI feature set"),Object(o.b)("li",{parentName:"ul"},"extends the generation workflow"))),Object(o.b)("li",{parentName:"ul"},"SPI registration",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Above class must be referenced in ",Object(o.b)("inlineCode",{parentName:"li"},"modules/openapi-generator/src/main/resources/META-INF/services/org.openapitools.codegen.CodegenConfig")),Object(o.b)("li",{parentName:"ul"},"Tells the generator that this class exists"),Object(o.b)("li",{parentName:"ul"},"Allows for classpath extension (addition) of generators"))),Object(o.b)("li",{parentName:"ul"},"A minimal template",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Should include a README explaining usage"),Object(o.b)("li",{parentName:"ul"},"Must include an ",Object(o.b)("inlineCode",{parentName:"li"},"api.mustache")),Object(o.b)("li",{parentName:"ul"},"Exists under ",Object(o.b)("inlineCode",{parentName:"li"},"modules/openapi-generator/src/main/resources/")," (plus ",Object(o.b)("inlineCode",{parentName:"li"},"embeddedTemplate")," dir value, see below)"))),Object(o.b)("li",{parentName:"ul"},"Config file under ",Object(o.b)("inlineCode",{parentName:"li"},"./bin/configs"),Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},'Gives users a "real life" example of generated output'),Object(o.b)("li",{parentName:"ul"},"Samples are used by CI to verify generators and test for regressions in some cases")))),Object(o.b)("p",null,"Now, let's generate an example generator and then walk through the pieces. At the end, we'll touch on some known sticking points for new generator authors and provide some suggestions."),Object(o.b)("h2",{id:"newsh"},"new.sh"),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script in the root of the project is meant to simplify this process. Run ",Object(o.b)("inlineCode",{parentName:"p"},"./new.sh --help"),"."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"Stubs out files for new generators\n\nUsage:\n./new.sh [options]\n    Options:\n    -n  Required. Specify generator name, should be kebab-cased.\n    -c  Create a client generator\n    -s  Create a server generator\n    -d  Create a documentation generator\n    -H  Create a schema generator\n    -f  Create a config generator\n    -t  When specified, creates test file(s) for the generator.\n    -h  Display help.\n\nExamples:\n  Create a server generator for ktor:\n  ./new.sh -n kotlin -s\n\n    Creates:\n    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/KotlinServerCodegen.java\n    modules/openapi-generator/src/main/resources/kotlin-server/README.mustache\n    modules/openapi-generator/src/main/resources/kotlin-server/model.mustache\n    modules/openapi-generator/src/main/resources/kotlin-server/api.mustache\n    bin/configs/kotlin-server-petstore-new.yaml\n\n  Create a generic C# server generator:\n  ./new.sh -n csharp -s -t\n    Creates:\n    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CsharpServerCodegen.java\n    modules/openapi-generator/src/main/resources/csharp-server/README.mustache\n    modules/openapi-generator/src/main/resources/csharp-server/model.mustache\n    modules/openapi-generator/src/main/resources/csharp-server/api.mustache\n    bin/configs/csharp-server-petstore-new.yaml\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenTest.java\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenModelTest.java\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenOptionsTest.java\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/options/CsharpServerCodegenOptionsProvider.java\n")),Object(o.b)("p",null,'This script allows us to define a client, server, schema, or documentation generator. We\'ll focus on the simplest generator (documentation). The other generator types may require heavy extension of the "Config" base class, and these docs could very quickly become outdated. When creating a new generator, please review existing generators as a guideline for implementation.'),Object(o.b)("p",null,"Create a new Markdown generator, specifying CommonMark as the name to avoid conflicting with the built-in Markdown generator."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"./new.sh -n common-mark -d\n")),Object(o.b)("p",null,"You should see output similar to the following:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"Creating modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CommonMarkDocumentationCodegen.java\nCreating modules/openapi-generator/src/main/resources/common-mark-documentation/README.mustache\nCreating modules/openapi-generator/src/main/resources/common-mark-documentation/model.mustache\nCreating modules/openapi-generator/src/main/resources/common-mark-documentation/api.mustache\nCreating bin/configs/common-mark-documentation-petstore-new.yaml\nFinished.\n")),Object(o.b)("h3",{id:"review-generated-config"},"Review Generated Config"),Object(o.b)("p",null,'Beginning with the "Codegen" file (',Object(o.b)("inlineCode",{parentName:"p"},"CommonMarkDocumentationCodegen.java"),"), the constructor was created:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'    public CommonMarkDocumentationCodegen() {\n        super();\n\n        outputFolder = "generated-code" + File.separator + "common-mark";\n        modelTemplateFiles.put("model.mustache", ".zz");\n        apiTemplateFiles.put("api.mustache", ".zz");\n        embeddedTemplateDir = templateDir = "common-mark-documentation";\n        apiPackage = File.separator + "Apis";\n        modelPackage = File.separator + "Models";\n        supportingFiles.add(new SupportingFile("README.mustache", "", "README.md"));\n        // TODO: Fill this out.\n    }\n')),Object(o.b)("p",null,"These options are some defaults which may require updating. Let's look line-by-line at the config."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'outputFolder = "generated-code" + File.separator + "common-mark";\n')),Object(o.b)("p",null,"This is the default output location. This will be ",Object(o.b)("inlineCode",{parentName:"p"},"generated-code/common-mark")," on non-Windows machines and ",Object(o.b)("inlineCode",{parentName:"p"},"generated-code\\common-mark")," on Windows. You may change this to any value you'd like, but a user will almost always provide an output directory."),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"When joining paths, always use ",Object(o.b)("inlineCode",{parentName:"p"},"File.seperator"))),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),' modelTemplateFiles.put("model.mustache", ".zz");\n')),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"model.mustache")," file is registered as the template for model generation. The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script doesn't have a way to know your intended file extension, so we default to a ",Object(o.b)("inlineCode",{parentName:"p"},".zz")," extension. This ",Object(o.b)("em",{parentName:"p"},"must")," be changed (unless your generator's target extension is ",Object(o.b)("inlineCode",{parentName:"p"},".zz"),"). For this example, you'd change ",Object(o.b)("inlineCode",{parentName:"p"},".zz")," to ",Object(o.b)("inlineCode",{parentName:"p"},".md")," or ",Object(o.b)("inlineCode",{parentName:"p"},".markdown"),", depending on your preference."),Object(o.b)("p",null,"This model template registration will use ",Object(o.b)("inlineCode",{parentName:"p"},"model.mustache")," to generate a new file for every model defined in your API's specification document."),Object(o.b)("p",null,"The path is considered relative to ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir"),", ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),", or a library subdirectory (refer to the Java client generator implementation for a prime example)."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'apiTemplateFiles.put("api.mustache", ".zz");\n')),Object(o.b)("p",null,"This is the template used for generating API related files. Similar to the above model template, you'll want to change ",Object(o.b)("inlineCode",{parentName:"p"},".zz")," to ",Object(o.b)("inlineCode",{parentName:"p"},".md")," or ",Object(o.b)("inlineCode",{parentName:"p"},".markdown"),"."),Object(o.b)("p",null,"The path is considered relative to ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir"),", ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),", or a library subdirectory (refer to the Java client generator implementation for a prime example)."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'embeddedTemplateDir = templateDir = "common-mark-documentation";\n')),Object(o.b)("p",null,"This line sets the embedded and template directories to ",Object(o.b)("inlineCode",{parentName:"p"},"common-mark-documentation"),". The ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," refers to the directory which will exist under ",Object(o.b)("inlineCode",{parentName:"p"},"modules/openapi-generator/src/main/resources")," and will be published with every release in which your new generator is present."),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),' variable refers to the "current" template directory setting, as defined by the user. That is, the user may invoke with ',Object(o.b)("inlineCode",{parentName:"p"},"-t")," or ",Object(o.b)("inlineCode",{parentName:"p"},"--template-directory")," (or plugin option variants), and override this directory."),Object(o.b)("p",null,"Both of these variables exist because the generator will fallback to files under ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," if they are not defined in the user's custom template directory."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'apiPackage = "Apis";\n')),Object(o.b)("p",null,"This sets the \"package\" location for anything considered an API document. You might want to change this setting if, for instance, your language doesn't support uppercase letters in the path. We don't need to worry about that here."),Object(o.b)("p",null,"Every templated output from ",Object(o.b)("inlineCode",{parentName:"p"},"api.mustache")," (registered via ",Object(o.b)("inlineCode",{parentName:"p"},"apiTemplateFiles")," above) will end up in the directory defined by ",Object(o.b)("inlineCode",{parentName:"p"},"apiPackage")," here."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'modelPackage = "Models";\n')),Object(o.b)("p",null,"Similarly, this sets the package for ",Object(o.b)("inlineCode",{parentName:"p"},"Models"),"."),Object(o.b)("p",null,"Every templated output from ",Object(o.b)("inlineCode",{parentName:"p"},"model.mustache")," (registered via ",Object(o.b)("inlineCode",{parentName:"p"},"modelTemplateFiles")," above) will end up in the directory defined by ",Object(o.b)("inlineCode",{parentName:"p"},"modelPackage")," here."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'supportingFiles.add(new SupportingFile("README.mustache", "", "README.md"));\n')),Object(o.b)("p",null,'A "supporting file" is an extra file which isn\'t created once for every operation or model defined in your specification document. It is a single file which may or may not be templated (determined by the extension of the filename).'),Object(o.b)("p",null,"A supporting file only passes through the Mustache template processor if the filename ends in ",Object(o.b)("inlineCode",{parentName:"p"},".mustache"),"."),Object(o.b)("p",null,"The path is considered relative to ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir"),", ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),", or a library subdirectory (refer to the Java client generator implementation for a prime example)."),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"If you want your readme to be generic (not templated), just rename the file to README.md and change ",Object(o.b)("inlineCode",{parentName:"p"},"README.mustache")," to ",Object(o.b)("inlineCode",{parentName:"p"},"README.md")," above.")),Object(o.b)("h3",{id:"create-templates"},"Create templates"),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," created our three required files. Let's start filling out each of these files."),Object(o.b)("h4",{id:"readmemustache"},"README.mustache"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),'# Documentation for {{appName}}\n\n{{#generateApiDocs}}\n<a name="documentation-for-api-endpoints"></a>\n## Documentation for API Endpoints\n\nAll URIs are relative to *{{{basePath}}}*\n\nClass | Method | HTTP request | Description\n------------ | ------------- | ------------- | -------------\n{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**](Apis/{{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{{summary}}}{{/summary}}\n{{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}\n{{/generateApiDocs}}\n\n{{#generateModelDocs}}\n<a name="documentation-for-models"></a>\n## Documentation for Models\n\n{{#modelPackage}}\n{{#models}}{{#model}} - [{{{modelPackage}}}.{{{classname}}}](Models/{{modelDocPath}}{{{classname}}}.md)\n{{/model}}{{/models}}\n{{/modelPackage}}\n{{^modelPackage}}\nNo model defined in this package\n{{/modelPackage}}\n{{/generateModelDocs}}\n\n<a name="documentation-for-authorization"></a>{{! TODO: optional documentation for authorization? }}\n## Documentation for Authorization\n\n{{^authMethods}}\nAll endpoints do not require authorization.\n{{/authMethods}}\n{{#authMethods}}\n{{#last}}\nAuthentication schemes defined for the API:\n{{/last}}\n{{/authMethods}}\n{{#authMethods}}\n<a name="{{name}}"></a>\n### {{name}}\n\n{{#isApiKey}}- **Type**: API key\n- **API key parameter name**: {{keyParamName}}\n- **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}\n{{/isApiKey}}\n{{#isBasic}}- **Type**: HTTP basic authentication\n{{/isBasic}}\n{{#isOAuth}}- **Type**: OAuth\n- **Flow**: {{flow}}\n- **Authorization URL**: {{authorizationUrl}}\n- **Scopes**: {{^scopes}}N/A{{/scopes}}\n{{#scopes}}  - {{scope}}: {{description}}\n{{/scopes}}\n{{/isOAuth}}\n\n{{/authMethods}}\n')),Object(o.b)("p",null,"Let's not focus too much on the contents of this file.  You may refer to ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/templating"}),"templating")," for more details on the variables bound to these files and to ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/debugging"}),"debugging"),' how to debug the structures. Of note here is that we\'re generating structures in markdown as defined by the objects constructed by our new "Config" class.'),Object(o.b)("h4",{id:"apimustache"},"api.mustache"),Object(o.b)("p",null,"The API documentation might look like this:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),'# {{classname}}{{#description}}\n{{description}}{{/description}}\n\nAll URIs are relative to *{{basePath}}*\n\nMethod | HTTP request | Description\n------------- | ------------- | -------------\n{{#operations}}{{#operation}}[**{{operationId}}**]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{summary}}{{/summary}}\n{{/operation}}{{/operations}}\n\n{{#operations}}\n{{#operation}}\n<a name="{{operationId}}"></a>\n# **{{operationId}}**\n> {{#returnType}}{{returnType}} {{/returnType}}{{operationId}}({{#allParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/allParams}})\n\n{{summary}}{{#notes}}\n\n{{notes}}{{/notes}}\n\n### Parameters\n{{^allParams}}This endpoint does not need any parameter.{{/allParams}}{{#allParams}}{{#-last}}\nName | Type | Description  | Notes\n------------- | ------------- | ------------- | -------------{{/-last}}{{/allParams}}\n{{#allParams}} **{{paramName}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}{{#isFile}}**{{dataType}}**{{/isFile}}{{^isFile}}{{#generateModelDocs}}[**{{dataType}}**]({{baseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{dataType}}**{{/generateModelDocs}}{{/isFile}}{{/isPrimitiveType}}| {{description}} |{{^required}} [optional]{{/required}}{{#defaultValue}} [default to {{defaultValue}}]{{/defaultValue}}{{#allowableValues}} [enum: {{#values}}{{{.}}}{{^-last}}, {{/-last}}{{/values}}]{{/allowableValues}}\n{{/allParams}}\n\n### Return type\n\n{{#returnType}}{{#returnTypeIsPrimitive}}**{{returnType}}**{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}{{#generateModelDocs}}[**{{returnType}}**]({{returnBaseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{returnType}}**{{/generateModelDocs}}{{/returnTypeIsPrimitive}}{{/returnType}}{{^returnType}}null (empty response body){{/returnType}}\n\n### Authorization\n\n{{^authMethods}}No authorization required{{/authMethods}}{{#authMethods}}[{{name}}](../README.md#{{name}}){{^-last}}, {{/-last}}{{/authMethods}}\n\n### HTTP request headers\n\n - **Content-Type**: {{#consumes}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/consumes}}{{^consumes}}Not defined{{/consumes}}\n - **Accept**: {{#produces}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/produces}}{{^produces}}Not defined{{/produces}}\n\n{{/operation}}\n{{/operations}}\n\n')),Object(o.b)("h4",{id:"modelmustache"},"model.mustache"),Object(o.b)("p",null,"The models file could resemble the following."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#models}}\n{{#model}}\n# {{{packageName}}}.{{modelPackage}}.{{{classname}}}\n## Properties\n\nName | Type | Description | Notes\n------------ | ------------- | ------------- | -------------\n{{#parent}}\n{{#parentVars}}\n**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}\n{{/parentVars}}\n{{/parent}}\n{{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}\n{{/vars}}\n\n[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)\n\n{{/model}}\n{{/models}}\n")),Object(o.b)("h3",{id:"build-it"},"Build it"),Object(o.b)("p",null,"To compile quickly to test this out, you can run ",Object(o.b)("inlineCode",{parentName:"p"},"mvn clean package -DskipTests"),"."),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"When implementing a more robust generator, you'll want to run all tests as well: ",Object(o.b)("inlineCode",{parentName:"p"},"mvn clean package"))),Object(o.b)("h3",{id:"compile-sample"},"Compile Sample"),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script created the generation config file ",Object(o.b)("inlineCode",{parentName:"p"},"bin/configs/common-mark-documentation-petstore-new.yaml"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'generatorName: common-mark\noutputDir: samples/documentation/petstore/common/mark\ninputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml\ntemplateDir: modules/openapi-generator/src/main/resources/common-mark\nadditionalProperties:\n  hideGenerationTimestamp: "true"\n')),Object(o.b)("p",null,"This configuration file is passed to the generator's CLI tool during continuous integration builds, and many outputs are compiled and tested as a regression test on every build. Contributors are also asked to run ",Object(o.b)("inlineCode",{parentName:"p"},"./bin/utils/ensure-up-to-date")," before opening a pull request to regenerate all samples defined under ",Object(o.b)("inlineCode",{parentName:"p"},"./bin/configs"),". This allows maintainers to quickly verify whether changes impact other generators."),Object(o.b)("p",null,"Configuration based examples allow us to test the same samples in each tooling option (CLI, Gradle Plugin, Maven Plugin, etc.). "),Object(o.b)("p",null,"You can compile your generator by running:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"./bin/generate-samples.sh bin/configs/common-mark-documentation-petstore-new.yaml\n")),Object(o.b)("p",null,"This configuration file can be used to demonstrate the default options for generation. A common option in most of these configs is to define the template directory as the generator's directory under ",Object(o.b)("inlineCode",{parentName:"p"},"resources"),". This allows template maintainers to modify and test out template changes which don't require recompilation of the entire project. You'd still need to recompile the project in full if you add or modify behaviors to the generator (such as adding a ",Object(o.b)("inlineCode",{parentName:"p"},"CliOption"),")."),Object(o.b)("h3",{id:"verify-output"},"Verify output"),Object(o.b)("p",null,"Creating a new generator will be an iterative task. Once you've generated the sample, you'll want to try it out. For compiled client/server outputs, this would mean running the code or creating a small sample project to consume your artifact just to make sure it works."),Object(o.b)("p",null,"For markdown, you can open in Visual Studio Code or any other editor with a markdown preview. Not all editors support relative links to other markdown documents. To test the output in this guide, install ",Object(o.b)("inlineCode",{parentName:"p"},"markserv"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"npm install --global markserv\n")),Object(o.b)("p",null,"Now, you can serve the output directory directly and test your links:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"markserv samples/documentation/petstore/common/markdown\n")),Object(o.b)("p",null,"That's it! You've created your first generator!"))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return m})),n.d(t,"b",(function(){return b}));var a=n(0),r=n.n(a);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function s(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,r=function(e,t){if(null==e)return{};var n,a,r={},o=Object.keys(e);for(a=0;a<o.length;a++)n=o[a],t.indexOf(n)>=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a<o.length;a++)n=o[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var p=r.a.createContext({}),c=function(e){var t=r.a.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):s({},t,{},e)),n},m=function(e){var t=c(e.components);return r.a.createElement(p.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},u=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,o=e.originalType,i=e.parentName,p=l(e,["components","mdxType","originalType","parentName"]),m=c(n),u=a,b=m["".concat(i,".").concat(u)]||m[u]||d[u]||o;return n?r.a.createElement(b,s({ref:t},p,{components:n})):r.a.createElement(b,s({ref:t},p))}));function b(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=n.length,i=new Array(o);i[0]=u;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var p=2;p<o;p++)i[p]=n[p];return r.a.createElement.apply(null,i)}return r.a.createElement.apply(null,n)}u.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/10211c0a.d66e8115.js b/10211c0a.d66e8115.js
new file mode 100644
index 00000000000..250f473665f
--- /dev/null
+++ b/10211c0a.d66e8115.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[16],{142:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return s})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return c}));var a=n(1),r=n(9),o=(n(0),n(312)),i={id:"new-generator",title:"Create a New Generator"},s={id:"new-generator",title:"Create a New Generator",description:"Creating a new generator which will become a part of the officially supported generators in OpenAPI Generator is pretty simple. We've created a helper script to bootstrap the operation. Let's look at the files necessary to create a new generator, then an example of bootstrapping a generator using the `new.sh` script in the root of the repository.",source:"@site/../docs/new-generator.md",permalink:"/docs/new-generator",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/new-generator.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Building the code",permalink:"/docs/contribute-building"},next:{title:"Roadmap",permalink:"/docs/roadmap"}},l=[{value:"Required Files",id:"required-files",children:[]},{value:"new.sh",id:"newsh",children:[{value:"Review Generated Config",id:"review-generated-config",children:[]},{value:"Create templates",id:"create-templates",children:[]},{value:"Build it",id:"build-it",children:[]},{value:"Compile Sample",id:"compile-sample",children:[]},{value:"Verify output",id:"verify-output",children:[]}]}],p={rightToc:l};function c(e){var t=e.components,n=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(a.a)({},p,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"Creating a new generator which will become a part of the officially supported generators in OpenAPI Generator is pretty simple. We've created a helper script to bootstrap the operation. Let's look at the files necessary to create a new generator, then an example of bootstrapping a generator using the ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script in the root of the repository."),Object(o.b)("h2",{id:"required-files"},"Required Files"),Object(o.b)("p",null,"The minimum set of files required to create a new generator are:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},'A "Codegen" file',Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"exists under ",Object(o.b)("inlineCode",{parentName:"li"},"modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/")),Object(o.b)("li",{parentName:"ul"},"defines language options"),Object(o.b)("li",{parentName:"ul"},"defines framework options"),Object(o.b)("li",{parentName:"ul"},"determines OpenAPI feature set"),Object(o.b)("li",{parentName:"ul"},"extends the generation workflow"))),Object(o.b)("li",{parentName:"ul"},"SPI registration",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Above class must be referenced in ",Object(o.b)("inlineCode",{parentName:"li"},"modules/openapi-generator/src/main/resources/META-INF/services/org.openapitools.codegen.CodegenConfig")),Object(o.b)("li",{parentName:"ul"},"Tells the generator that this class exists"),Object(o.b)("li",{parentName:"ul"},"Allows for classpath extension (addition) of generators"))),Object(o.b)("li",{parentName:"ul"},"A minimal template",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Should include a README explaining usage"),Object(o.b)("li",{parentName:"ul"},"Must include an ",Object(o.b)("inlineCode",{parentName:"li"},"api.mustache")),Object(o.b)("li",{parentName:"ul"},"Exists under ",Object(o.b)("inlineCode",{parentName:"li"},"modules/openapi-generator/src/main/resources/")," (plus ",Object(o.b)("inlineCode",{parentName:"li"},"embeddedTemplate")," dir value, see below)"))),Object(o.b)("li",{parentName:"ul"},"Config file under ",Object(o.b)("inlineCode",{parentName:"li"},"./bin/configs"),Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},'Gives users a "real life" example of generated output'),Object(o.b)("li",{parentName:"ul"},"Samples are used by CI to verify generators and test for regressions in some cases")))),Object(o.b)("p",null,"Now, let's generate an example generator and then walk through the pieces. At the end, we'll touch on some known sticking points for new generator authors and provide some suggestions."),Object(o.b)("h2",{id:"newsh"},"new.sh"),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script in the root of the project is meant to simplify this process. Run ",Object(o.b)("inlineCode",{parentName:"p"},"./new.sh --help"),"."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"Stubs out files for new generators\n\nUsage:\n./new.sh [options]\n    Options:\n    -n  Required. Specify generator name, should be kebab-cased.\n    -c  Create a client generator\n    -s  Create a server generator\n    -d  Create a documentation generator\n    -H  Create a schema generator\n    -f  Create a config generator\n    -t  When specified, creates test file(s) for the generator.\n    -h  Display help.\n\nExamples:\n  Create a server generator for ktor:\n  ./new.sh -n kotlin -s\n\n    Creates:\n    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/KotlinServerCodegen.java\n    modules/openapi-generator/src/main/resources/kotlin-server/README.mustache\n    modules/openapi-generator/src/main/resources/kotlin-server/model.mustache\n    modules/openapi-generator/src/main/resources/kotlin-server/api.mustache\n    bin/configs/kotlin-server-petstore-new.yaml\n\n  Create a generic C# server generator:\n  ./new.sh -n csharp -s -t\n    Creates:\n    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CsharpServerCodegen.java\n    modules/openapi-generator/src/main/resources/csharp-server/README.mustache\n    modules/openapi-generator/src/main/resources/csharp-server/model.mustache\n    modules/openapi-generator/src/main/resources/csharp-server/api.mustache\n    bin/configs/csharp-server-petstore-new.yaml\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenTest.java\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenModelTest.java\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenOptionsTest.java\n    modules/openapi-generator/src/test/java/org/openapitools/codegen/options/CsharpServerCodegenOptionsProvider.java\n")),Object(o.b)("p",null,'This script allows us to define a client, server, schema, or documentation generator. We\'ll focus on the simplest generator (documentation). The other generator types may require heavy extension of the "Config" base class, and these docs could very quickly become outdated. When creating a new generator, please review existing generators as a guideline for implementation.'),Object(o.b)("p",null,"Create a new Markdown generator, specifying CommonMark as the name to avoid conflicting with the built-in Markdown generator."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"./new.sh -n common-mark -d\n")),Object(o.b)("p",null,"You should see output similar to the following:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"Creating modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CommonMarkDocumentationCodegen.java\nCreating modules/openapi-generator/src/main/resources/common-mark-documentation/README.mustache\nCreating modules/openapi-generator/src/main/resources/common-mark-documentation/model.mustache\nCreating modules/openapi-generator/src/main/resources/common-mark-documentation/api.mustache\nCreating bin/configs/common-mark-documentation-petstore-new.yaml\nFinished.\n")),Object(o.b)("h3",{id:"review-generated-config"},"Review Generated Config"),Object(o.b)("p",null,'Beginning with the "Codegen" file (',Object(o.b)("inlineCode",{parentName:"p"},"CommonMarkDocumentationCodegen.java"),"), the constructor was created:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'    public CommonMarkDocumentationCodegen() {\n        super();\n\n        outputFolder = "generated-code" + File.separator + "common-mark";\n        modelTemplateFiles.put("model.mustache", ".zz");\n        apiTemplateFiles.put("api.mustache", ".zz");\n        embeddedTemplateDir = templateDir = "common-mark-documentation";\n        apiPackage = File.separator + "Apis";\n        modelPackage = File.separator + "Models";\n        supportingFiles.add(new SupportingFile("README.mustache", "", "README.md"));\n        // TODO: Fill this out.\n    }\n')),Object(o.b)("p",null,"These options are some defaults which may require updating. Let's look line-by-line at the config."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'outputFolder = "generated-code" + File.separator + "common-mark";\n')),Object(o.b)("p",null,"This is the default output location. This will be ",Object(o.b)("inlineCode",{parentName:"p"},"generated-code/common-mark")," on non-Windows machines and ",Object(o.b)("inlineCode",{parentName:"p"},"generated-code\\common-mark")," on Windows. You may change this to any value you'd like, but a user will almost always provide an output directory."),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"When joining paths, always use ",Object(o.b)("inlineCode",{parentName:"p"},"File.seperator"))),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),' modelTemplateFiles.put("model.mustache", ".zz");\n')),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"model.mustache")," file is registered as the template for model generation. The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script doesn't have a way to know your intended file extension, so we default to a ",Object(o.b)("inlineCode",{parentName:"p"},".zz")," extension. This ",Object(o.b)("em",{parentName:"p"},"must")," be changed (unless your generator's target extension is ",Object(o.b)("inlineCode",{parentName:"p"},".zz"),"). For this example, you'd change ",Object(o.b)("inlineCode",{parentName:"p"},".zz")," to ",Object(o.b)("inlineCode",{parentName:"p"},".md")," or ",Object(o.b)("inlineCode",{parentName:"p"},".markdown"),", depending on your preference."),Object(o.b)("p",null,"This model template registration will use ",Object(o.b)("inlineCode",{parentName:"p"},"model.mustache")," to generate a new file for every model defined in your API's specification document."),Object(o.b)("p",null,"The path is considered relative to ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir"),", ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),", or a library subdirectory (refer to the Java client generator implementation for a prime example)."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'apiTemplateFiles.put("api.mustache", ".zz");\n')),Object(o.b)("p",null,"This is the template used for generating API related files. Similar to the above model template, you'll want to change ",Object(o.b)("inlineCode",{parentName:"p"},".zz")," to ",Object(o.b)("inlineCode",{parentName:"p"},".md")," or ",Object(o.b)("inlineCode",{parentName:"p"},".markdown"),"."),Object(o.b)("p",null,"The path is considered relative to ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir"),", ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),", or a library subdirectory (refer to the Java client generator implementation for a prime example)."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'embeddedTemplateDir = templateDir = "common-mark-documentation";\n')),Object(o.b)("p",null,"This line sets the embedded and template directories to ",Object(o.b)("inlineCode",{parentName:"p"},"common-mark-documentation"),". The ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," refers to the directory which will exist under ",Object(o.b)("inlineCode",{parentName:"p"},"modules/openapi-generator/src/main/resources")," and will be published with every release in which your new generator is present."),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),' variable refers to the "current" template directory setting, as defined by the user. That is, the user may invoke with ',Object(o.b)("inlineCode",{parentName:"p"},"-t")," or ",Object(o.b)("inlineCode",{parentName:"p"},"--template-directory")," (or plugin option variants), and override this directory."),Object(o.b)("p",null,"Both of these variables exist because the generator will fallback to files under ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," if they are not defined in the user's custom template directory."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'apiPackage = "Apis";\n')),Object(o.b)("p",null,"This sets the \"package\" location for anything considered an API document. You might want to change this setting if, for instance, your language doesn't support uppercase letters in the path. We don't need to worry about that here."),Object(o.b)("p",null,"Every templated output from ",Object(o.b)("inlineCode",{parentName:"p"},"api.mustache")," (registered via ",Object(o.b)("inlineCode",{parentName:"p"},"apiTemplateFiles")," above) will end up in the directory defined by ",Object(o.b)("inlineCode",{parentName:"p"},"apiPackage")," here."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'modelPackage = "Models";\n')),Object(o.b)("p",null,"Similarly, this sets the package for ",Object(o.b)("inlineCode",{parentName:"p"},"Models"),"."),Object(o.b)("p",null,"Every templated output from ",Object(o.b)("inlineCode",{parentName:"p"},"model.mustache")," (registered via ",Object(o.b)("inlineCode",{parentName:"p"},"modelTemplateFiles")," above) will end up in the directory defined by ",Object(o.b)("inlineCode",{parentName:"p"},"modelPackage")," here."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'supportingFiles.add(new SupportingFile("README.mustache", "", "README.md"));\n')),Object(o.b)("p",null,'A "supporting file" is an extra file which isn\'t created once for every operation or model defined in your specification document. It is a single file which may or may not be templated (determined by the extension of the filename).'),Object(o.b)("p",null,"A supporting file only passes through the Mustache template processor if the filename ends in ",Object(o.b)("inlineCode",{parentName:"p"},".mustache"),"."),Object(o.b)("p",null,"The path is considered relative to ",Object(o.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir"),", ",Object(o.b)("inlineCode",{parentName:"p"},"templateDir"),", or a library subdirectory (refer to the Java client generator implementation for a prime example)."),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"If you want your readme to be generic (not templated), just rename the file to README.md and change ",Object(o.b)("inlineCode",{parentName:"p"},"README.mustache")," to ",Object(o.b)("inlineCode",{parentName:"p"},"README.md")," above.")),Object(o.b)("h3",{id:"create-templates"},"Create templates"),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," created our three required files. Let's start filling out each of these files."),Object(o.b)("h4",{id:"readmemustache"},"README.mustache"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),'# Documentation for {{appName}}\n\n{{#generateApiDocs}}\n<a name="documentation-for-api-endpoints"></a>\n## Documentation for API Endpoints\n\nAll URIs are relative to *{{{basePath}}}*\n\nClass | Method | HTTP request | Description\n------------ | ------------- | ------------- | -------------\n{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**](Apis/{{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{{summary}}}{{/summary}}\n{{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}\n{{/generateApiDocs}}\n\n{{#generateModelDocs}}\n<a name="documentation-for-models"></a>\n## Documentation for Models\n\n{{#modelPackage}}\n{{#models}}{{#model}} - [{{{modelPackage}}}.{{{classname}}}](Models/{{modelDocPath}}{{{classname}}}.md)\n{{/model}}{{/models}}\n{{/modelPackage}}\n{{^modelPackage}}\nNo model defined in this package\n{{/modelPackage}}\n{{/generateModelDocs}}\n\n<a name="documentation-for-authorization"></a>{{! TODO: optional documentation for authorization? }}\n## Documentation for Authorization\n\n{{^authMethods}}\nAll endpoints do not require authorization.\n{{/authMethods}}\n{{#authMethods}}\n{{#last}}\nAuthentication schemes defined for the API:\n{{/last}}\n{{/authMethods}}\n{{#authMethods}}\n<a name="{{name}}"></a>\n### {{name}}\n\n{{#isApiKey}}- **Type**: API key\n- **API key parameter name**: {{keyParamName}}\n- **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}\n{{/isApiKey}}\n{{#isBasic}}- **Type**: HTTP basic authentication\n{{/isBasic}}\n{{#isOAuth}}- **Type**: OAuth\n- **Flow**: {{flow}}\n- **Authorization URL**: {{authorizationUrl}}\n- **Scopes**: {{^scopes}}N/A{{/scopes}}\n{{#scopes}}  - {{scope}}: {{description}}\n{{/scopes}}\n{{/isOAuth}}\n\n{{/authMethods}}\n')),Object(o.b)("p",null,"Let's not focus too much on the contents of this file.  You may refer to ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/templating"}),"templating")," for more details on the variables bound to these files and to ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/debugging"}),"debugging"),' how to debug the structures. Of note here is that we\'re generating structures in markdown as defined by the objects constructed by our new "Config" class.'),Object(o.b)("h4",{id:"apimustache"},"api.mustache"),Object(o.b)("p",null,"The API documentation might look like this:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),'# {{classname}}{{#description}}\n{{description}}{{/description}}\n\nAll URIs are relative to *{{basePath}}*\n\nMethod | HTTP request | Description\n------------- | ------------- | -------------\n{{#operations}}{{#operation}}[**{{operationId}}**]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{summary}}{{/summary}}\n{{/operation}}{{/operations}}\n\n{{#operations}}\n{{#operation}}\n<a name="{{operationId}}"></a>\n# **{{operationId}}**\n> {{#returnType}}{{returnType}} {{/returnType}}{{operationId}}({{#allParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/allParams}})\n\n{{summary}}{{#notes}}\n\n{{notes}}{{/notes}}\n\n### Parameters\n{{^allParams}}This endpoint does not need any parameter.{{/allParams}}{{#allParams}}{{#-last}}\nName | Type | Description  | Notes\n------------- | ------------- | ------------- | -------------{{/-last}}{{/allParams}}\n{{#allParams}} **{{paramName}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}{{#isFile}}**{{dataType}}**{{/isFile}}{{^isFile}}{{#generateModelDocs}}[**{{dataType}}**]({{baseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{dataType}}**{{/generateModelDocs}}{{/isFile}}{{/isPrimitiveType}}| {{description}} |{{^required}} [optional]{{/required}}{{#defaultValue}} [default to {{defaultValue}}]{{/defaultValue}}{{#allowableValues}} [enum: {{#values}}{{{.}}}{{^-last}}, {{/-last}}{{/values}}]{{/allowableValues}}\n{{/allParams}}\n\n### Return type\n\n{{#returnType}}{{#returnTypeIsPrimitive}}**{{returnType}}**{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}{{#generateModelDocs}}[**{{returnType}}**]({{returnBaseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{returnType}}**{{/generateModelDocs}}{{/returnTypeIsPrimitive}}{{/returnType}}{{^returnType}}null (empty response body){{/returnType}}\n\n### Authorization\n\n{{^authMethods}}No authorization required{{/authMethods}}{{#authMethods}}[{{name}}](../README.md#{{name}}){{^-last}}, {{/-last}}{{/authMethods}}\n\n### HTTP request headers\n\n - **Content-Type**: {{#consumes}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/consumes}}{{^consumes}}Not defined{{/consumes}}\n - **Accept**: {{#produces}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/produces}}{{^produces}}Not defined{{/produces}}\n\n{{/operation}}\n{{/operations}}\n\n')),Object(o.b)("h4",{id:"modelmustache"},"model.mustache"),Object(o.b)("p",null,"The models file could resemble the following."),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#models}}\n{{#model}}\n# {{{packageName}}}.{{modelPackage}}.{{{classname}}}\n## Properties\n\nName | Type | Description | Notes\n------------ | ------------- | ------------- | -------------\n{{#parent}}\n{{#parentVars}}\n**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}\n{{/parentVars}}\n{{/parent}}\n{{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}\n{{/vars}}\n\n[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)\n\n{{/model}}\n{{/models}}\n")),Object(o.b)("h3",{id:"build-it"},"Build it"),Object(o.b)("p",null,"To compile quickly to test this out, you can run ",Object(o.b)("inlineCode",{parentName:"p"},"mvn clean package -DskipTests"),"."),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"When implementing a more robust generator, you'll want to run all tests as well: ",Object(o.b)("inlineCode",{parentName:"p"},"mvn clean package"))),Object(o.b)("h3",{id:"compile-sample"},"Compile Sample"),Object(o.b)("p",null,"The ",Object(o.b)("inlineCode",{parentName:"p"},"new.sh")," script created the generation config file ",Object(o.b)("inlineCode",{parentName:"p"},"bin/configs/common-mark-documentation-petstore-new.yaml"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'generatorName: common-mark\noutputDir: samples/documentation/petstore/common/mark\ninputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml\ntemplateDir: modules/openapi-generator/src/main/resources/common-mark\nadditionalProperties:\n  hideGenerationTimestamp: "true"\n')),Object(o.b)("p",null,"This configuration file is passed to the generator's CLI tool during continuous integration builds, and many outputs are compiled and tested as a regression test on every build. Contributors are also asked to run ",Object(o.b)("inlineCode",{parentName:"p"},"./bin/utils/ensure-up-to-date")," before opening a pull request to regenerate all samples defined under ",Object(o.b)("inlineCode",{parentName:"p"},"./bin/configs"),". This allows maintainers to quickly verify whether changes impact other generators."),Object(o.b)("p",null,"Configuration based examples allow us to test the same samples in each tooling option (CLI, Gradle Plugin, Maven Plugin, etc.). "),Object(o.b)("p",null,"You can compile your generator by running:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"./bin/generate-samples.sh bin/configs/common-mark-documentation-petstore-new.yaml\n")),Object(o.b)("p",null,"This configuration file can be used to demonstrate the default options for generation. A common option in most of these configs is to define the template directory as the generator's directory under ",Object(o.b)("inlineCode",{parentName:"p"},"resources"),". This allows template maintainers to modify and test out template changes which don't require recompilation of the entire project. You'd still need to recompile the project in full if you add or modify behaviors to the generator (such as adding a ",Object(o.b)("inlineCode",{parentName:"p"},"CliOption"),")."),Object(o.b)("h3",{id:"verify-output"},"Verify output"),Object(o.b)("p",null,"Creating a new generator will be an iterative task. Once you've generated the sample, you'll want to try it out. For compiled client/server outputs, this would mean running the code or creating a small sample project to consume your artifact just to make sure it works."),Object(o.b)("p",null,"For markdown, you can open in Visual Studio Code or any other editor with a markdown preview. Not all editors support relative links to other markdown documents. To test the output in this guide, install ",Object(o.b)("inlineCode",{parentName:"p"},"markserv"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"npm install --global markserv\n")),Object(o.b)("p",null,"Now, you can serve the output directory directly and test your links:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"markserv samples/documentation/petstore/common/markdown\n")),Object(o.b)("p",null,"That's it! You've created your first generator!"))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return m})),n.d(t,"b",(function(){return b}));var a=n(0),r=n.n(a);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function s(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,r=function(e,t){if(null==e)return{};var n,a,r={},o=Object.keys(e);for(a=0;a<o.length;a++)n=o[a],t.indexOf(n)>=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a<o.length;a++)n=o[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var p=r.a.createContext({}),c=function(e){var t=r.a.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):s({},t,{},e)),n},m=function(e){var t=c(e.components);return r.a.createElement(p.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},u=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,o=e.originalType,i=e.parentName,p=l(e,["components","mdxType","originalType","parentName"]),m=c(n),u=a,b=m["".concat(i,".").concat(u)]||m[u]||d[u]||o;return n?r.a.createElement(b,s({ref:t},p,{components:n})):r.a.createElement(b,s({ref:t},p))}));function b(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var o=n.length,i=new Array(o);i[0]=u;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,i[1]=s;for(var p=2;p<o;p++)i[p]=n[p];return r.a.createElement.apply(null,i)}return r.a.createElement.apply(null,n)}u.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/1777f326.4e8d33e8.js b/1777f326.4e8d33e8.js
new file mode 100644
index 00000000000..7f45342705a
--- /dev/null
+++ b/1777f326.4e8d33e8.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[21],{147:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return i})),r.d(t,"metadata",(function(){return l})),r.d(t,"rightToc",(function(){return c})),r.d(t,"default",(function(){return u}));var n=r(1),a=r(9),o=(r(0),r(312)),i={id:"roadmap",title:"Roadmap"},l={id:"roadmap",title:"Roadmap",description:"This document lists short-term, medium-term, and long-term goals for the project.",source:"@site/../docs/roadmap.md",permalink:"/docs/roadmap",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/roadmap.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Create a New Generator",permalink:"/docs/new-generator"},next:{title:"Migrating from Swagger Codegen",permalink:"/docs/swagger-codegen-migration"}},c=[{value:"Short-term",id:"short-term",children:[]},{value:"Medium-term",id:"medium-term",children:[{value:"API",id:"api",children:[]},{value:"General",id:"general",children:[]}]},{value:"Long-term",id:"long-term",children:[]}],p={rightToc:c};function u(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},p,r,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"This document lists short-term, medium-term, and long-term goals for the project."),Object(o.b)("hr",null),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"NOTE")),Object(o.b)("p",null,"These are goals, not necessarily commitments. The sections are not intended to represent exclusive focus during these terms. For example, when you start at a college or university you may have a long-term goal to graduate and a short-term goal to find a job for supplemental income. We will similarly work toward many of our medium-term and long-term goals in the near future as we move toward meeting our short-term goals."),Object(o.b)("hr",null),Object(o.b)("h2",{id:"short-term"},"Short-term"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Usability, stability, and marketing.")),Object(o.b)("p",null,"Short term are focused on improving contributor and user productivity (part of this is getting the word out)."),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"CLI improvements",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Search functionality (e.g. what generators support retrofit, what generators are available for kotlin)"))),Object(o.b)("li",{parentName:"ul"},"Build automation improvements"),Object(o.b)("li",{parentName:"ul"},"Discuss consolidating current third-party build systems"),Object(o.b)("li",{parentName:"ul"},"Investigate custom docker containerization for prepared build environments"),Object(o.b)("li",{parentName:"ul"},"Automated release stability"),Object(o.b)("li",{parentName:"ul"},"General"),Object(o.b)("li",{parentName:"ul"},"OAS3.0 features support: anyOf, oneOf, callbacks, etc"),Object(o.b)("li",{parentName:"ul"},"Consider opt-in telemetry about generators being used, limited to a counter of invocations by generator name). This would allow us to make prioritization decisions based on statistics."),Object(o.b)("li",{parentName:"ul"},"Code clean up",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"centralize build scripts"),Object(o.b)("li",{parentName:"ul"},"organize samples/bin scripts according to new generator names"),Object(o.b)("li",{parentName:"ul"},"consolidate typescript generators"),Object(o.b)("li",{parentName:"ul"},"jaxrs => use Swagger core v3 (see ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/issues/27%5B#27%5D"}),"https://github.com/OpenAPITools/openapi-generator/issues/27[#27]"),")"))),Object(o.b)("li",{parentName:"ul"},"Documentation"),Object(o.b)("li",{parentName:"ul"},"Static pages, preferably on gh-pages, devoted to each generator"),Object(o.b)("li",{parentName:"ul"},"Explain generator options"),Object(o.b)("li",{parentName:"ul"},"Centralized docs on generated code usage/examples/configuration")),Object(o.b)("h2",{id:"medium-term"},"Medium-term"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Feature set, well-defined API (code and templates), and extensibility improvements.")),Object(o.b)("h3",{id:"api"},"API"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Typed representation of the model bound to our templates. As it is, everything is treated an an Object, and this can lead to changes in the interface which might be unexpected from the template perspective."),Object(o.b)("li",{parentName:"ul"},"Feature set (potential generators to add; not an exhaustive list)",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Azure functions (node.js, server)"),Object(o.b)("li",{parentName:"ul"},"Finagle HTTP Client (Scala, client)"),Object(o.b)("li",{parentName:"ul"},"Finagle Http Server (Scala, server)"),Object(o.b)("li",{parentName:"ul"},"Finatra (Scala, server)"),Object(o.b)("li",{parentName:"ul"},"Kotlin Spring MVC/Springboot (server)"),Object(o.b)("li",{parentName:"ul"},"C++ Server, any framework (server)")))),Object(o.b)("h3",{id:"general"},"General"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Migrate from Maven to Gradle"),Object(o.b)("li",{parentName:"ul"},"Java 9+ support"),Object(o.b)("li",{parentName:"ul"},"Feature set (other options to investigate)"),Object(o.b)("li",{parentName:"ul"},"SPI plugins",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Templating engine"),Object(o.b)("li",{parentName:"ul"},"Language extensions"),Object(o.b)("li",{parentName:"ul"},"Custom extensions (e.g. allowing users to load support for ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/Azure/azure-rest-api-specs"}),"azure-rest-api-specs"),")"))),Object(o.b)("li",{parentName:"ul"},"Customizable templating engines (handlebars support)"),Object(o.b)("li",{parentName:"ul"},"Unit-testing templates (to previously mentioned explicit type as an interface to the template)"),Object(o.b)("li",{parentName:"ul"},"Reduce coupling"),Object(o.b)("li",{parentName:"ul"},"Make types extending ",Object(o.b)("inlineCode",{parentName:"li"},"CodegenConfig")," become the generation entrypoint"),Object(o.b)("li",{parentName:"ul"},"Allow current ",Object(o.b)("inlineCode",{parentName:"li"},"CodegenConfig")," types to define templating engine"),Object(o.b)("li",{parentName:"ul"},"Allow current ",Object(o.b)("inlineCode",{parentName:"li"},"CodegenConfig")," types to modify workflow (currently encapsulated in ",Object(o.b)("inlineCode",{parentName:"li"},"DefaultGenerator")," and tightly coupled to the template engine"),Object(o.b)("li",{parentName:"ul"},'Clearer reuse of "language" features, outside of "generator" types. That is, rather than enforcing polymorphic sharing of "language" which currently allows the super type to redefine framework-specific mapping functionality, generators could compose one or more language support types.'),Object(o.b)("li",{parentName:"ul"},"Define template deprecation/removal process")),Object(o.b)("h2",{id:"long-term"},"Long-term"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Expanding tooling offered, integrations, potentially SaaS offering to partially fund efforts.")),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Generator UI wrappers",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Move jimschubert/intellij-swagger-codegen plugin under the org, and rename"),Object(o.b)("li",{parentName:"ul"},"Look into an Eclipse UI wrapper around the generator"),Object(o.b)("li",{parentName:"ul"},"Look at Visual Studio Code (and/or Atom, sublime text) integration"))),Object(o.b)("li",{parentName:"ul"},"Provide a native GUI for viewing/editing specs. Most tools are currently geared toward developers, but often times it may be non-technical business users who are interested in an API."),Object(o.b)("li",{parentName:"ul"},"A paid service (SaaS) for generation may be enticing for some users. Such a service would allow for statistics (mentioned earlier in telemetry)"),Object(o.b)("li",{parentName:"ul"},"Additional tools"),Object(o.b)("li",{parentName:"ul"},"node.js build system(s) integration (grunt/gulp/webpack/etc)"),Object(o.b)("li",{parentName:"ul"},"ruby gem"),Object(o.b)("li",{parentName:"ul"},"others (which may require previously mentioned SaaS API)")))}u.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return s})),r.d(t,"b",(function(){return d}));var n=r(0),a=r.n(n);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function l(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?i(Object(r),!0).forEach((function(t){o(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):i(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function c(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},o=Object.keys(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var p=a.a.createContext({}),u=function(e){var t=a.a.useContext(p),r=t;return e&&(r="function"==typeof e?e(t):l({},t,{},e)),r},s=function(e){var t=u(e.components);return a.a.createElement(p.Provider,{value:t},e.children)},b={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,i=e.parentName,p=c(e,["components","mdxType","originalType","parentName"]),s=u(r),m=n,d=s["".concat(i,".").concat(m)]||s[m]||b[m]||o;return r?a.a.createElement(d,l({ref:t},p,{components:r})):a.a.createElement(d,l({ref:t},p))}));function d(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,i=new Array(o);i[0]=m;var l={};for(var c in t)hasOwnProperty.call(t,c)&&(l[c]=t[c]);l.originalType=e,l.mdxType="string"==typeof e?e:n,i[1]=l;for(var p=2;p<o;p++)i[p]=r[p];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,r)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/1777f326.6442d35a.js b/1777f326.6442d35a.js
deleted file mode 100644
index ae80bbb32bb..00000000000
--- a/1777f326.6442d35a.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[21],{147:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return i})),r.d(t,"metadata",(function(){return l})),r.d(t,"rightToc",(function(){return c})),r.d(t,"default",(function(){return p}));var n=r(1),a=r(9),o=(r(0),r(312)),i={id:"roadmap",title:"Roadmap"},l={id:"roadmap",title:"Roadmap",description:"This document lists short-term, medium-term, and long-term goals for the project.",source:"@site/../docs/roadmap.md",permalink:"/docs/roadmap",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/roadmap.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Create a New Generator",permalink:"/docs/new-generator"},next:{title:"Migrating from Swagger Codegen",permalink:"/docs/swagger-codegen-migration"}},c=[{value:"Short-term",id:"short-term",children:[]},{value:"Medium-term",id:"medium-term",children:[{value:"API",id:"api",children:[]},{value:"General",id:"general",children:[]}]},{value:"Long-term",id:"long-term",children:[]}],u={rightToc:c};function p(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},u,r,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"This document lists short-term, medium-term, and long-term goals for the project."),Object(o.b)("hr",null),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"NOTE")),Object(o.b)("p",null,"These are goals, not necessarily commitments. The sections are not intended to represent exclusive focus during these terms. For example, when you start at a college or university you may have a long-term goal to graduate and a short-term goal to find a job for supplemental income. We will similarly work toward many of our medium-term and long-term goals in the near future as we move toward meeting our short-term goals."),Object(o.b)("hr",null),Object(o.b)("h2",{id:"short-term"},"Short-term"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Usability, stability, and marketing.")),Object(o.b)("p",null,"Short term are focused on improving contributor and user productivity (part of this is getting the word out)."),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"CLI improvements",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Search functionality (e.g. what generators support retrofit, what generators are available for kotlin)"))),Object(o.b)("li",{parentName:"ul"},"Build automation improvements"),Object(o.b)("li",{parentName:"ul"},"Discuss consolidating current third-party build systems"),Object(o.b)("li",{parentName:"ul"},"Investigate custom docker containerization for prepared build environments"),Object(o.b)("li",{parentName:"ul"},"Automated release stability"),Object(o.b)("li",{parentName:"ul"},"General"),Object(o.b)("li",{parentName:"ul"},"OAS3.0 features support: anyOf, oneOf, callbacks, etc"),Object(o.b)("li",{parentName:"ul"},"Consider opt-in telemetry about generators being used, limited to a counter of invocations by generator name). This would allow us to make prioritization decisions based on statistics."),Object(o.b)("li",{parentName:"ul"},"Code clean up",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"centralize build scripts"),Object(o.b)("li",{parentName:"ul"},"organize samples/bin scripts according to new generator names"),Object(o.b)("li",{parentName:"ul"},"consolidate typescript generators"),Object(o.b)("li",{parentName:"ul"},"jaxrs => use Swagger core v3 (see ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/issues/27%5B#27%5D"}),"https://github.com/OpenAPITools/openapi-generator/issues/27[#27]"),")"))),Object(o.b)("li",{parentName:"ul"},"Documentation"),Object(o.b)("li",{parentName:"ul"},"Static pages, preferably on gh-pages, devoted to each generator"),Object(o.b)("li",{parentName:"ul"},"Explain generator options"),Object(o.b)("li",{parentName:"ul"},"Centralized docs on generated code usage/examples/configuration")),Object(o.b)("h2",{id:"medium-term"},"Medium-term"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Feature set, well-defined API (code and templates), and extensibility improvements.")),Object(o.b)("h3",{id:"api"},"API"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Typed representation of the model bound to our templates. As it is, everything is treated an an Object, and this can lead to changes in the interface which might be unexpected from the template perspective."),Object(o.b)("li",{parentName:"ul"},"Feature set (potential generators to add; not an exhaustive list)",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Azure functions (node.js, server)"),Object(o.b)("li",{parentName:"ul"},"Finagle HTTP Client (Scala, client)"),Object(o.b)("li",{parentName:"ul"},"Finagle Http Server (Scala, server)"),Object(o.b)("li",{parentName:"ul"},"Finatra (Scala, server)"),Object(o.b)("li",{parentName:"ul"},"Kotlin Spring MVC/Springboot (server)"),Object(o.b)("li",{parentName:"ul"},"C++ Server, any framework (server)")))),Object(o.b)("h3",{id:"general"},"General"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Migrate from Maven to Gradle"),Object(o.b)("li",{parentName:"ul"},"Java 9+ support"),Object(o.b)("li",{parentName:"ul"},"Feature set (other options to investigate)"),Object(o.b)("li",{parentName:"ul"},"SPI plugins",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Templating engine"),Object(o.b)("li",{parentName:"ul"},"Language extensions"),Object(o.b)("li",{parentName:"ul"},"Custom extensions (e.g. allowing users to load support for ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/Azure/azure-rest-api-specs"}),"azure-rest-api-specs"),")"))),Object(o.b)("li",{parentName:"ul"},"Customizable templating engines (handlebars support)"),Object(o.b)("li",{parentName:"ul"},"Unit-testing templates (to previously mentioned explicit type as an interface to the template)"),Object(o.b)("li",{parentName:"ul"},"Reduce coupling"),Object(o.b)("li",{parentName:"ul"},"Make types extending ",Object(o.b)("inlineCode",{parentName:"li"},"CodegenConfig")," become the generation entrypoint"),Object(o.b)("li",{parentName:"ul"},"Allow current ",Object(o.b)("inlineCode",{parentName:"li"},"CodegenConfig")," types to define templating engine"),Object(o.b)("li",{parentName:"ul"},"Allow current ",Object(o.b)("inlineCode",{parentName:"li"},"CodegenConfig")," types to modify workflow (currently encapsulated in ",Object(o.b)("inlineCode",{parentName:"li"},"DefaultGenerator")," and tightly coupled to the template engine"),Object(o.b)("li",{parentName:"ul"},'Clearer reuse of "language" features, outside of "generator" types. That is, rather than enforcing polymorphic sharing of "language" which currently allows the super type to redefine framework-specific mapping functionality, generators could compose one or more language support types.'),Object(o.b)("li",{parentName:"ul"},"Define template deprecation/removal process")),Object(o.b)("h2",{id:"long-term"},"Long-term"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Expanding tooling offered, integrations, potentially SaaS offering to partially fund efforts.")),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Generator UI wrappers",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},"Move jimschubert/intellij-swagger-codegen plugin under the org, and rename"),Object(o.b)("li",{parentName:"ul"},"Look into an Eclipse UI wrapper around the generator"),Object(o.b)("li",{parentName:"ul"},"Look at Visual Studio Code (and/or Atom, sublime text) integration"))),Object(o.b)("li",{parentName:"ul"},"Provide a native GUI for viewing/editing specs. Most tools are currently geared toward developers, but often times it may be non-technical business users who are interested in an API."),Object(o.b)("li",{parentName:"ul"},"A paid service (SaaS) for generation may be enticing for some users. Such a service would allow for statistics (mentioned earlier in telemetry)"),Object(o.b)("li",{parentName:"ul"},"Additional tools"),Object(o.b)("li",{parentName:"ul"},"node.js build system(s) integration (grunt/gulp/webpack/etc)"),Object(o.b)("li",{parentName:"ul"},"ruby gem"),Object(o.b)("li",{parentName:"ul"},"others (which may require previously mentioned SaaS API)")))}p.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return s})),r.d(t,"b",(function(){return d}));var n=r(0),a=r.n(n);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function l(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?i(Object(r),!0).forEach((function(t){o(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):i(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function c(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},o=Object.keys(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var u=a.a.createContext({}),p=function(e){var t=a.a.useContext(u),r=t;return e&&(r="function"==typeof e?e(t):l({},t,{},e)),r},s=function(e){var t=p(e.components);return a.a.createElement(u.Provider,{value:t},e.children)},b={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,i=e.parentName,u=c(e,["components","mdxType","originalType","parentName"]),s=p(r),m=n,d=s["".concat(i,".").concat(m)]||s[m]||b[m]||o;return r?a.a.createElement(d,l({ref:t},u,{components:r})):a.a.createElement(d,l({ref:t},u))}));function d(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,i=new Array(o);i[0]=m;var l={};for(var c in t)hasOwnProperty.call(t,c)&&(l[c]=t[c]);l.originalType=e,l.mdxType="string"==typeof e?e:n,i[1]=l;for(var u=2;u<o;u++)i[u]=r[u];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,r)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/2bbf879d.75ffa3a9.js b/2bbf879d.75ffa3a9.js
deleted file mode 100644
index 327fe1f599d..00000000000
--- a/2bbf879d.75ffa3a9.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[37],{165:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return r})),n.d(t,"metadata",(function(){return p})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return c}));var a=n(1),o=n(9),i=(n(0),n(312)),r={id:"configuration",title:"Configuration Options"},p={id:"configuration",title:"Configuration Options",description:"Our tooling supports the following types of configuration:",source:"@site/../docs/configuration.md",permalink:"/docs/configuration",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/configuration.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Global Properties",permalink:"/docs/globals"},next:{title:"File post-processing",permalink:"/docs/file-post-processing"}},l=[{value:"Tool-specific Declarations",id:"tool-specific-declarations",children:[]},{value:"Discovering Options",id:"discovering-options",children:[]}],s={rightToc:l};function c(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("p",null,"Our tooling supports the following types of configuration:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"/docs/globals"}),"global properties"),Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"properties with cross-cutting concerns which control generation, but  ",Object(i.b)("em",{parentName:"li"},"don't")," belong to individual generators"),Object(i.b)("li",{parentName:"ul"},"Example: ",Object(i.b)("inlineCode",{parentName:"li"},"debugSupportingFiles")," prints the contents of template data bound to supporting files"))),Object(i.b)("li",{parentName:"ul"},"config options",Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"configuration specific to each individual ",Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"/docs/generators/README"}),"generator")),Object(i.b)("li",{parentName:"ul"},"these options are susceptible to validation within the defining generator; a config option of the same name across multiple generators may be validated differently in each"),Object(i.b)("li",{parentName:"ul"},'NOTE: The CLI accepts config options as "additional properties"'))),Object(i.b)("li",{parentName:"ul"},"additional properties",Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"these are the properties which will be passed to templates"),Object(i.b)("li",{parentName:"ul"},"generally used to pass user-defined properties to custom templates"),Object(i.b)("li",{parentName:"ul"},"many config options may also be passed as additional properties, however generators will read/modify/rewrite config options"),Object(i.b)("li",{parentName:"ul"},"users may pass custom additional properties and use these within templates (e.g. a custom ",Object(i.b)("inlineCode",{parentName:"li"},"generatedBy")," key with a value of ",Object(i.b)("inlineCode",{parentName:"li"},"Jim Schubert")," for inclusion in a custom CVS-like header)"))),Object(i.b)("li",{parentName:"ul"},"top-level properties specific to individual tools/plugins used to bootstrap our tooling")),Object(i.b)("h2",{id:"tool-specific-declarations"},"Tool-specific Declarations"),Object(i.b)("p",null,"The READMEs for the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/usage#generate"}),"CLI"),", ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin"}),"Gradle Plugin"),", ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin"}),"Maven Plugin"),", and ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md"}),"SBT Plugin")," may have top-level or tooling specific options which appear to duplicate 'config options' or 'global properties'. Each may also expose user-facing properties slightly differently from the other tools. This may occur due to:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"Conventions used by the underlying tooling"),Object(i.b)("li",{parentName:"ul"},"Limitations in underlying frameworks which define how properties must be declared"),Object(i.b)("li",{parentName:"ul"},'Continuation of support for "legacy" invocation patterns'),Object(i.b)("li",{parentName:"ul"},"Mistakes in documentation and/or contributions (please do ",Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/issues/new?assignees=&labels=Issue%3A+Bug&template=bug_report.md&title=%5BBUG%5D+Issue+with+options"}),"file a bug"),")")),Object(i.b)("p",null,"Take, for example, the CLI option of ",Object(i.b)("inlineCode",{parentName:"p"},"--skip-validate-spec"),". This flag sets the value to true with no option to set it to false (the default internally). The maven and gradle plugins allow for the top-level option ",Object(i.b)("inlineCode",{parentName:"p"},"skipValidateSpec")," to have a value of true or false. The SBT plugin, on the other hand, follows community convention and this property is ",Object(i.b)("inlineCode",{parentName:"p"},"openApiSkipValidateSpec"),"."),Object(i.b)("p",null,Object(i.b)("em",{parentName:"p"},"How")," you provide values to options also depends on the tool. OpenAPI Generator supports global properties for ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/customization/#selective-generation"}),"selective generation")," -- such as ",Object(i.b)("inlineCode",{parentName:"p"},"apis")," -- to have either a blank value or a comma-separated list of selected values. We would define this in CLI as ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property apis")," or ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property apis=Equipment"),". In the Gradle Plugin, these properties are set directly as strings:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'openApiGenerate {\n    globalProperties = [\n        apis: "",\n        models: "User:Pet"\n    ]\n}\n')),Object(i.b)("p",null,"In the Maven plugin, we're limited by XML syntax where ",Object(i.b)("inlineCode",{parentName:"p"},"<apis/>")," and ",Object(i.b)("inlineCode",{parentName:"p"},"<apis></apis>")," are treated the same as if the ",Object(i.b)("inlineCode",{parentName:"p"},"apis"),' node was undefined; there\'s no way to provide an empty string as a default. Instead, we have to extract the global property into its own properties which maintain the two states supported elsewhere (i.e. "all apis" or "select apis"). We have ',Object(i.b)("inlineCode",{parentName:"p"},"generateApis")," which accepts a boolean and ",Object(i.b)("inlineCode",{parentName:"p"},"apisToGenerate")," which accepts a comma-separated selection list."),Object(i.b)("h2",{id:"discovering-options"},"Discovering Options"),Object(i.b)("p",null,"Refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/globals"}),"global properties")," for a list of available global properties and their usage."),Object(i.b)("p",null,"Top-level tooling options are defined in ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/usage/#generate"}),"CLI usage"),". Many of these options directly map to camel case options in other tools, but do refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/plugins"}),"plugin documentation")," for full details or plugin-specific differences."),Object(i.b)("p",null,"Config options for generators are available in ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/generators"}),"documentation online"),". You may also use the CLI to query config options for a target generator using ",Object(i.b)("inlineCode",{parentName:"p"},"openapi-generator config-help -g <generator-name>"),". For example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"$ openapi-generator config-help -g mysql-schema\n\nCONFIG OPTIONS\n\n    defaultDatabaseName\n        Default database name for all MySQL queries (Default: )\n\n    identifierNamingConvention\n        Naming convention of MySQL identifiers(table names and column names). This is not related to database name which is defined by defaultDatabaseName option (Default: original)\n            original - Do not transform original names\n            snake_case - Use snake_case names\n\n    jsonDataTypeEnabled\n        Use special JSON MySQL data type for complex model properties. Requires MySQL version 5.7.8. Generates TEXT data type when disabled (Default: true)\n\n    namedParametersEnabled\n        Generates model prepared SQLs with named parameters, eg. :petName. Question mark placeholder used when option disabled. (Default: false)\n")),Object(i.b)("p",null,"This output provides the name of the configuration option. A set of acceptable values for any constrained values will print as an indented list (e.g. ",Object(i.b)("inlineCode",{parentName:"p"},"identifierNamingConvention")," above)."),Object(i.b)("p",null,"Suppose you want to apply snake case naming to mysql schema outputs. Your configuration might resemble the following examples."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"CLI")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"openapi-generator -g mysql-schema -o out -i spec.yaml --additional-properties=identifierNamingConvention=snake_case\n")),Object(i.b)("p",null,"It may seem like a typo but there are two ",Object(i.b)("inlineCode",{parentName:"p"},"=")," signs in the above example."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"Maven Plugin")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"<execution>\n    <id>mysql-schema</id>\n    <phase>generate-sources</phase>\n    <goals>\n        <goal>generate</goal>\n    </goals>\n    <configuration>\n        <inputSpec>spec.yaml</inputSpec>\n        <generatorName>mysql-schema</generatorName>\n        <configOptions>\n            <identifierNamingConvention>snake_case</identifierNamingConvention>\n        </configOptions>\n        <output>${project.build.directory}/generated-sources/mysql</output>\n    </configuration>\n</execution>\n")),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"Gradle Plugin")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'openApiGenerate {\n    generatorName = "mysql-schema"\n    inputSpec = "$rootDir/spec.yaml".toString()\n    outputDir = "$buildDir/mysql".toString()\n    configOptions = [\n            identifierNamingConvention: "snake_case"\n    ]\n}\n')))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return m}));var a=n(0),o=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function p(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?r(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):r(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),c=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):p({},t,{},e)),n},b=function(e){var t=c(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,r=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),b=c(n),d=a,m=b["".concat(r,".").concat(d)]||b[d]||u[d]||i;return n?o.a.createElement(m,p({ref:t},s,{components:n})):o.a.createElement(m,p({ref:t},s))}));function m(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,r=new Array(i);r[0]=d;var p={};for(var l in t)hasOwnProperty.call(t,l)&&(p[l]=t[l]);p.originalType=e,p.mdxType="string"==typeof e?e:a,r[1]=p;for(var s=2;s<i;s++)r[s]=n[s];return o.a.createElement.apply(null,r)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/2bbf879d.eaee5317.js b/2bbf879d.eaee5317.js
new file mode 100644
index 00000000000..1d4822d457c
--- /dev/null
+++ b/2bbf879d.eaee5317.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[37],{165:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return r})),n.d(t,"metadata",(function(){return p})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return c}));var a=n(1),o=n(9),i=(n(0),n(312)),r={id:"configuration",title:"Configuration Options"},p={id:"configuration",title:"Configuration Options",description:"Our tooling supports the following types of configuration:",source:"@site/../docs/configuration.md",permalink:"/docs/configuration",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/configuration.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Global Properties",permalink:"/docs/globals"},next:{title:"File post-processing",permalink:"/docs/file-post-processing"}},l=[{value:"Tool-specific Declarations",id:"tool-specific-declarations",children:[]},{value:"Discovering Options",id:"discovering-options",children:[]}],s={rightToc:l};function c(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("p",null,"Our tooling supports the following types of configuration:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"/docs/globals"}),"global properties"),Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"properties with cross-cutting concerns which control generation, but  ",Object(i.b)("em",{parentName:"li"},"don't")," belong to individual generators"),Object(i.b)("li",{parentName:"ul"},"Example: ",Object(i.b)("inlineCode",{parentName:"li"},"debugSupportingFiles")," prints the contents of template data bound to supporting files"))),Object(i.b)("li",{parentName:"ul"},"config options",Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"configuration specific to each individual ",Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"/docs/generators/README"}),"generator")),Object(i.b)("li",{parentName:"ul"},"these options are susceptible to validation within the defining generator; a config option of the same name across multiple generators may be validated differently in each"),Object(i.b)("li",{parentName:"ul"},'NOTE: The CLI accepts config options as "additional properties"'))),Object(i.b)("li",{parentName:"ul"},"additional properties",Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"these are the properties which will be passed to templates"),Object(i.b)("li",{parentName:"ul"},"generally used to pass user-defined properties to custom templates"),Object(i.b)("li",{parentName:"ul"},"many config options may also be passed as additional properties, however generators will read/modify/rewrite config options"),Object(i.b)("li",{parentName:"ul"},"users may pass custom additional properties and use these within templates (e.g. a custom ",Object(i.b)("inlineCode",{parentName:"li"},"generatedBy")," key with a value of ",Object(i.b)("inlineCode",{parentName:"li"},"Jim Schubert")," for inclusion in a custom CVS-like header)"))),Object(i.b)("li",{parentName:"ul"},"top-level properties specific to individual tools/plugins used to bootstrap our tooling")),Object(i.b)("h2",{id:"tool-specific-declarations"},"Tool-specific Declarations"),Object(i.b)("p",null,"The READMEs for the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/usage#generate"}),"CLI"),", ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin"}),"Gradle Plugin"),", ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin"}),"Maven Plugin"),", and ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md"}),"SBT Plugin")," may have top-level or tooling specific options which appear to duplicate 'config options' or 'global properties'. Each may also expose user-facing properties slightly differently from the other tools. This may occur due to:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"Conventions used by the underlying tooling"),Object(i.b)("li",{parentName:"ul"},"Limitations in underlying frameworks which define how properties must be declared"),Object(i.b)("li",{parentName:"ul"},'Continuation of support for "legacy" invocation patterns'),Object(i.b)("li",{parentName:"ul"},"Mistakes in documentation and/or contributions (please do ",Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/issues/new?assignees=&labels=Issue%3A+Bug&template=bug_report.md&title=%5BBUG%5D+Issue+with+options"}),"file a bug"),")")),Object(i.b)("p",null,"Take, for example, the CLI option of ",Object(i.b)("inlineCode",{parentName:"p"},"--skip-validate-spec"),". This flag sets the value to true with no option to set it to false (the default internally). The maven and gradle plugins allow for the top-level option ",Object(i.b)("inlineCode",{parentName:"p"},"skipValidateSpec")," to have a value of true or false. The SBT plugin, on the other hand, follows community convention and this property is ",Object(i.b)("inlineCode",{parentName:"p"},"openApiSkipValidateSpec"),"."),Object(i.b)("p",null,Object(i.b)("em",{parentName:"p"},"How")," you provide values to options also depends on the tool. OpenAPI Generator supports global properties for ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/customization/#selective-generation"}),"selective generation")," -- such as ",Object(i.b)("inlineCode",{parentName:"p"},"apis")," -- to have either a blank value or a comma-separated list of selected values. We would define this in CLI as ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property apis")," or ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property apis=Equipment"),". In the Gradle Plugin, these properties are set directly as strings:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'openApiGenerate {\n    globalProperties = [\n        apis: "",\n        models: "User:Pet"\n    ]\n}\n')),Object(i.b)("p",null,"In the Maven plugin, we're limited by XML syntax where ",Object(i.b)("inlineCode",{parentName:"p"},"<apis/>")," and ",Object(i.b)("inlineCode",{parentName:"p"},"<apis></apis>")," are treated the same as if the ",Object(i.b)("inlineCode",{parentName:"p"},"apis"),' node was undefined; there\'s no way to provide an empty string as a default. Instead, we have to extract the global property into its own properties which maintain the two states supported elsewhere (i.e. "all apis" or "select apis"). We have ',Object(i.b)("inlineCode",{parentName:"p"},"generateApis")," which accepts a boolean and ",Object(i.b)("inlineCode",{parentName:"p"},"apisToGenerate")," which accepts a comma-separated selection list."),Object(i.b)("h2",{id:"discovering-options"},"Discovering Options"),Object(i.b)("p",null,"Refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/globals"}),"global properties")," for a list of available global properties and their usage."),Object(i.b)("p",null,"Top-level tooling options are defined in ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/usage/#generate"}),"CLI usage"),". Many of these options directly map to camel case options in other tools, but do refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/plugins"}),"plugin documentation")," for full details or plugin-specific differences."),Object(i.b)("p",null,"Config options for generators are available in ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/generators"}),"documentation online"),". You may also use the CLI to query config options for a target generator using ",Object(i.b)("inlineCode",{parentName:"p"},"openapi-generator config-help -g <generator-name>"),". For example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"$ openapi-generator config-help -g mysql-schema\n\nCONFIG OPTIONS\n\n    defaultDatabaseName\n        Default database name for all MySQL queries (Default: )\n\n    identifierNamingConvention\n        Naming convention of MySQL identifiers(table names and column names). This is not related to database name which is defined by defaultDatabaseName option (Default: original)\n            original - Do not transform original names\n            snake_case - Use snake_case names\n\n    jsonDataTypeEnabled\n        Use special JSON MySQL data type for complex model properties. Requires MySQL version 5.7.8. Generates TEXT data type when disabled (Default: true)\n\n    namedParametersEnabled\n        Generates model prepared SQLs with named parameters, eg. :petName. Question mark placeholder used when option disabled. (Default: false)\n")),Object(i.b)("p",null,"This output provides the name of the configuration option. A set of acceptable values for any constrained values will print as an indented list (e.g. ",Object(i.b)("inlineCode",{parentName:"p"},"identifierNamingConvention")," above)."),Object(i.b)("p",null,"Suppose you want to apply snake case naming to mysql schema outputs. Your configuration might resemble the following examples."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"CLI")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"openapi-generator -g mysql-schema -o out -i spec.yaml --additional-properties=identifierNamingConvention=snake_case\n")),Object(i.b)("p",null,"It may seem like a typo but there are two ",Object(i.b)("inlineCode",{parentName:"p"},"=")," signs in the above example."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"Maven Plugin")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"<execution>\n    <id>mysql-schema</id>\n    <phase>generate-sources</phase>\n    <goals>\n        <goal>generate</goal>\n    </goals>\n    <configuration>\n        <inputSpec>spec.yaml</inputSpec>\n        <generatorName>mysql-schema</generatorName>\n        <configOptions>\n            <identifierNamingConvention>snake_case</identifierNamingConvention>\n        </configOptions>\n        <output>${project.build.directory}/generated-sources/mysql</output>\n    </configuration>\n</execution>\n")),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"Gradle Plugin")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'openApiGenerate {\n    generatorName = "mysql-schema"\n    inputSpec = "$rootDir/spec.yaml".toString()\n    outputDir = "$buildDir/mysql".toString()\n    configOptions = [\n            identifierNamingConvention: "snake_case"\n    ]\n}\n')))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return m}));var a=n(0),o=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function p(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?r(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):r(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),c=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):p({},t,{},e)),n},b=function(e){var t=c(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,r=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),b=c(n),d=a,m=b["".concat(r,".").concat(d)]||b[d]||u[d]||i;return n?o.a.createElement(m,p({ref:t},s,{components:n})):o.a.createElement(m,p({ref:t},s))}));function m(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,r=new Array(i);r[0]=d;var p={};for(var l in t)hasOwnProperty.call(t,l)&&(p[l]=t[l]);p.originalType=e,p.mdxType="string"==typeof e?e:a,r[1]=p;for(var s=2;s<i;s++)r[s]=n[s];return o.a.createElement.apply(null,r)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/342fbc7e.4475dc8f.js b/342fbc7e.4475dc8f.js
new file mode 100644
index 00000000000..db58611b5e7
--- /dev/null
+++ b/342fbc7e.4475dc8f.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[45],{173:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return a})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return p})),n.d(t,"default",(function(){return s}));var r=n(1),o=n(9),i=(n(0),n(312)),a={id:"spec-info",title:"Spec Info"},c={id:"spec-info",title:"Spec Info",description:"## OpenAPI",source:"@site/../docs/specification-info.md",permalink:"/docs/spec-info",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/specification-info.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635},p=[{value:"OpenAPI",id:"openapi",children:[{value:"2.0",id:"20",children:[]},{value:"3.x",id:"3x",children:[]},{value:"Tags",id:"tags",children:[]}]}],l={rightToc:p};function s(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(r.a)({},l,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h2",{id:"openapi"},"OpenAPI"),Object(i.b)("h3",{id:"20"},"2.0"),Object(i.b)("h3",{id:"3x"},"3.x"),Object(i.b)("h3",{id:"tags"},"Tags"),Object(i.b)("p",null,"Tags basically group endpoints into the same API class file. For example, an endpoint with the ",Object(i.b)("inlineCode",{parentName:"p"},"store")," tag will be generated in the StoreApi class file in most generators."),Object(i.b)("p",null,"Ref: ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject"}),"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject")))}s.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return d}));var r=n(0),o=n.n(r);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function p(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n,r,o={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=o.a.createContext({}),s=function(e){var t=o.a.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},u=function(e){var t=s(e.components);return o.a.createElement(l.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},b=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,i=e.originalType,a=e.parentName,l=p(e,["components","mdxType","originalType","parentName"]),u=s(n),b=r,d=u["".concat(a,".").concat(b)]||u[b]||f[b]||i;return n?o.a.createElement(d,c({ref:t},l,{components:n})):o.a.createElement(d,c({ref:t},l))}));function d(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=n.length,a=new Array(i);a[0]=b;var c={};for(var p in t)hasOwnProperty.call(t,p)&&(c[p]=t[p]);c.originalType=e,c.mdxType="string"==typeof e?e:r,a[1]=c;for(var l=2;l<i;l++)a[l]=n[l];return o.a.createElement.apply(null,a)}return o.a.createElement.apply(null,n)}b.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/342fbc7e.50d7b074.js b/342fbc7e.50d7b074.js
deleted file mode 100644
index f68bc8312da..00000000000
--- a/342fbc7e.50d7b074.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[45],{173:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return a})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return p})),n.d(t,"default",(function(){return s}));var r=n(1),o=n(9),i=(n(0),n(312)),a={id:"spec-info",title:"Spec Info"},c={id:"spec-info",title:"Spec Info",description:"## OpenAPI",source:"@site/../docs/specification-info.md",permalink:"/docs/spec-info",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/specification-info.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142},p=[{value:"OpenAPI",id:"openapi",children:[{value:"2.0",id:"20",children:[]},{value:"3.x",id:"3x",children:[]},{value:"Tags",id:"tags",children:[]}]}],l={rightToc:p};function s(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(r.a)({},l,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h2",{id:"openapi"},"OpenAPI"),Object(i.b)("h3",{id:"20"},"2.0"),Object(i.b)("h3",{id:"3x"},"3.x"),Object(i.b)("h3",{id:"tags"},"Tags"),Object(i.b)("p",null,"Tags basically group endpoints into the same API class file. For example, an endpoint with the ",Object(i.b)("inlineCode",{parentName:"p"},"store")," tag will be generated in the StoreApi class file in most generators."),Object(i.b)("p",null,"Ref: ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject"}),"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject")))}s.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return d}));var r=n(0),o=n.n(r);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function p(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n,r,o={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var l=o.a.createContext({}),s=function(e){var t=o.a.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},u=function(e){var t=s(e.components);return o.a.createElement(l.Provider,{value:t},e.children)},f={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},b=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,i=e.originalType,a=e.parentName,l=p(e,["components","mdxType","originalType","parentName"]),u=s(n),b=r,d=u["".concat(a,".").concat(b)]||u[b]||f[b]||i;return n?o.a.createElement(d,c({ref:t},l,{components:n})):o.a.createElement(d,c({ref:t},l))}));function d(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=n.length,a=new Array(i);a[0]=b;var c={};for(var p in t)hasOwnProperty.call(t,p)&&(c[p]=t[p]);c.originalType=e,c.mdxType="string"==typeof e?e:r,a[1]=c;for(var l=2;l<i;l++)a[l]=n[l];return o.a.createElement.apply(null,a)}return o.a.createElement.apply(null,n)}b.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/3d70cde6.3e5453f3.js b/3d70cde6.3e5453f3.js
new file mode 100644
index 00000000000..8ea293ed274
--- /dev/null
+++ b/3d70cde6.3e5453f3.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[49],{177:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return c})),r.d(t,"metadata",(function(){return i})),r.d(t,"rightToc",(function(){return p})),r.d(t,"default",(function(){return u}));var n=r(1),a=r(9),o=(r(0),r(312)),c={id:"faq",title:"FAQ: General"},i={id:"faq",title:"FAQ: General",description:"## Do you have a chat room?",source:"@site/../docs/faq.md",permalink:"/docs/faq",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"faq-sidebar",next:{title:"FAQ: Extending",permalink:"/docs/faq-extending"}},p=[{value:"Do you have a chat room?",id:"do-you-have-a-chat-room",children:[]},{value:"What is the governance structure of the OpenAPI Generator project?",id:"what-is-the-governance-structure-of-the-openapi-generator-project",children:[]},{value:"What is the difference between Swagger Codegen and OpenAPI Generator?",id:"what-is-the-difference-between-swagger-codegen-and-openapi-generator",children:[]}],s={rightToc:p};function u(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},s,r,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"do-you-have-a-chat-room"},"Do you have a chat room?"),Object(o.b)("p",null,Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g"}),Object(o.b)("img",Object(n.a)({parentName:"a"},{src:"https://img.shields.io/badge/Slack-Join%20the%20chat%20room-orange",alt:"Join the Slack chat room"})))),Object(o.b)("h2",{id:"what-is-the-governance-structure-of-the-openapi-generator-project"},"What is the governance structure of the OpenAPI Generator project?"),Object(o.b)("p",null,"OpenAPI generator (openapi-generator) is managed by the members of the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/core-team"}),"core team"),"."),Object(o.b)("h2",{id:"what-is-the-difference-between-swagger-codegen-and-openapi-generator"},"What is the difference between Swagger Codegen and OpenAPI Generator?"),Object(o.b)("p",null,"Swagger Codegen is driven by SmartBear while OpenAPI Generator is driven by the community. More than 40 top contributors and template creators of Swagger Codegen have joined OpenAPI Generator as the founding team members. For more details, see the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/fork-qna"}),"Fork Q&A"),"."),Object(o.b)("p",null,'Swagger is a trademark owned by SmartBear and the use of the term "Swagger" in this project is for demo (reference) purposes only.'))}u.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return d})),r.d(t,"b",(function(){return b}));var n=r(0),a=r.n(n);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function c(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?c(Object(r),!0).forEach((function(t){o(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):c(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function p(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},o=Object.keys(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=a.a.createContext({}),u=function(e){var t=a.a.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):i({},t,{},e)),r},d=function(e){var t=u(e.components);return a.a.createElement(s.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},f=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,c=e.parentName,s=p(e,["components","mdxType","originalType","parentName"]),d=u(r),f=n,b=d["".concat(c,".").concat(f)]||d[f]||l[f]||o;return r?a.a.createElement(b,i({ref:t},s,{components:r})):a.a.createElement(b,i({ref:t},s))}));function b(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,c=new Array(o);c[0]=f;var i={};for(var p in t)hasOwnProperty.call(t,p)&&(i[p]=t[p]);i.originalType=e,i.mdxType="string"==typeof e?e:n,c[1]=i;for(var s=2;s<o;s++)c[s]=r[s];return a.a.createElement.apply(null,c)}return a.a.createElement.apply(null,r)}f.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/3d70cde6.b291aef1.js b/3d70cde6.b291aef1.js
deleted file mode 100644
index 34824c1b935..00000000000
--- a/3d70cde6.b291aef1.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[49],{177:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return c})),r.d(t,"metadata",(function(){return i})),r.d(t,"rightToc",(function(){return p})),r.d(t,"default",(function(){return u}));var n=r(1),a=r(9),o=(r(0),r(312)),c={id:"faq",title:"FAQ: General"},i={id:"faq",title:"FAQ: General",description:"## Do you have a chat room?",source:"@site/../docs/faq.md",permalink:"/docs/faq",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"faq-sidebar",next:{title:"FAQ: Extending",permalink:"/docs/faq-extending"}},p=[{value:"Do you have a chat room?",id:"do-you-have-a-chat-room",children:[]},{value:"What is the governance structure of the OpenAPI Generator project?",id:"what-is-the-governance-structure-of-the-openapi-generator-project",children:[]},{value:"What is the difference between Swagger Codegen and OpenAPI Generator?",id:"what-is-the-difference-between-swagger-codegen-and-openapi-generator",children:[]}],s={rightToc:p};function u(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},s,r,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"do-you-have-a-chat-room"},"Do you have a chat room?"),Object(o.b)("p",null,Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g"}),Object(o.b)("img",Object(n.a)({parentName:"a"},{src:"https://img.shields.io/badge/Slack-Join%20the%20chat%20room-orange",alt:"Join the Slack chat room"})))),Object(o.b)("h2",{id:"what-is-the-governance-structure-of-the-openapi-generator-project"},"What is the governance structure of the OpenAPI Generator project?"),Object(o.b)("p",null,"OpenAPI generator (openapi-generator) is managed by the members of the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/core-team"}),"core team"),"."),Object(o.b)("h2",{id:"what-is-the-difference-between-swagger-codegen-and-openapi-generator"},"What is the difference between Swagger Codegen and OpenAPI Generator?"),Object(o.b)("p",null,"Swagger Codegen is driven by SmartBear while OpenAPI Generator is driven by the community. More than 40 top contributors and template creators of Swagger Codegen have joined OpenAPI Generator as the founding team members. For more details, see the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/fork-qna"}),"Fork Q&A"),"."),Object(o.b)("p",null,'Swagger is a trademark owned by SmartBear and the use of the term "Swagger" in this project is for demo (reference) purposes only.'))}u.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return d})),r.d(t,"b",(function(){return b}));var n=r(0),a=r.n(n);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function c(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?c(Object(r),!0).forEach((function(t){o(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):c(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function p(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},o=Object.keys(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=a.a.createContext({}),u=function(e){var t=a.a.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):i({},t,{},e)),r},d=function(e){var t=u(e.components);return a.a.createElement(s.Provider,{value:t},e.children)},l={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},f=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,c=e.parentName,s=p(e,["components","mdxType","originalType","parentName"]),d=u(r),f=n,b=d["".concat(c,".").concat(f)]||d[f]||l[f]||o;return r?a.a.createElement(b,i({ref:t},s,{components:r})):a.a.createElement(b,i({ref:t},s))}));function b(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,c=new Array(o);c[0]=f;var i={};for(var p in t)hasOwnProperty.call(t,p)&&(i[p]=t[p]);i.originalType=e,i.mdxType="string"==typeof e?e:n,c[1]=i;for(var s=2;s<o;s++)c[s]=r[s];return a.a.createElement.apply(null,c)}return a.a.createElement.apply(null,r)}f.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/404.html b/404.html
index 456d53309c0..96f31efcb8a 100644
--- a/404.html
+++ b/404.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/47462ed9.6f9c0f5b.js b/47462ed9.6f9c0f5b.js
deleted file mode 100644
index cba8bacab99..00000000000
--- a/47462ed9.6f9c0f5b.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[51],{179:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return l})),n.d(t,"rightToc",(function(){return p})),n.d(t,"default",(function(){return s}));var r=n(1),a=n(9),o=(n(0),n(312)),i={id:"file-post-processing",title:"File post-processing"},l={id:"file-post-processing",title:"File post-processing",description:"Each tool (CLI and plugins) supports enabling file post-processing at a high-level. Enabling this option allows for generators which support post-processing to call some external process for each generated file, passing the file path to that tool. The external tool must be defined in an environment variable supported by the generator.",source:"@site/../docs/file-post-processing.md",permalink:"/docs/file-post-processing",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/file-post-processing.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Configuration Options",permalink:"/docs/configuration"},next:{title:"Using Templates",permalink:"/docs/templating"}},p=[{value:"Supported Environment Variables",id:"supported-environment-variables",children:[]},{value:"Example",id:"example",children:[]}],c={rightToc:p};function s(e){var t=e.components,n=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(r.a)({},c,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"Each tool (CLI and plugins) supports enabling file post-processing at a high-level. Enabling this option allows for generators which support post-processing to call some external process for each generated file, passing the file path to that tool. The external tool must be defined in an environment variable supported by the generator."),Object(o.b)("p",null,"Note that:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"this option is ",Object(o.b)("inlineCode",{parentName:"li"},"--enable-post-process-file")," in the CLI and ",Object(o.b)("inlineCode",{parentName:"li"},"enablePostProcessFile")," in plugins"),Object(o.b)("li",{parentName:"ul"},"we require ",Object(o.b)("em",{parentName:"li"},"both")," specifying the environment variable ",Object(o.b)("em",{parentName:"li"},"and")," enabling the option at the tooling level; this feature is opt-in for security "),Object(o.b)("li",{parentName:"ul"},"file processing occurs one at a time"),Object(o.b)("li",{parentName:"ul"},"the external tool may be a custom script which invokes multiple tools")),Object(o.b)("p",null,"Also refer to the relevant documentation for ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/usage"}),"CLI"),", ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md"}),"Maven Plugin"),", ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc"}),"Gradle Plugin"),", or ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md"}),"SBT Plugin"),"."),Object(o.b)("h2",{id:"supported-environment-variables"},"Supported Environment Variables"),Object(o.b)("p",null,"The following environment variables are supported by their respective generators:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"CPP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"CSHARP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"C_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"DART_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"FSHARP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"GO_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"HASKELL_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"JAVA_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"JS_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"KOTLIN_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"OCAML_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"PERL_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"PHP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"POWERSHELL_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"PYTHON_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"RUBY_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"RUST_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"SCALA_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"SWIFT_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"TS_POST_PROCESS_FILE"))),Object(o.b)("h2",{id:"example"},"Example"),Object(o.b)("p",null,"Let's see how to pass Ruby generated files to Rubocop, a static code analysis/linter/formatter tool."),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{}),'# First, export the required environment variable\nexport RUBY_POST_PROCESS_FILE="/usr/local/bin/rubocop -a"\n\nexport OPENAPI_DOC="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"\n\n# Invoke the generator with --enable-post-process-file\nopenapi-generator generate --enable-post-process-file -i $OPENAPI_DOC -g ruby -o .out-ruby/\n')),Object(o.b)("p",null,"You will now see messages logged about which files have been processed:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{}),"[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.rspec\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb\n[main] INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb\n[main] INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb\n[main] INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb\n[main] INFO  o.o.codegen.TemplateManager - Skipped /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator-ignore (Skipped by supportingFiles options supplied by user.)\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/VERSION\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/FILES\n")))}s.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return m}));var r=n(0),a=n.n(r);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function l(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function p(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var c=a.a.createContext({}),s=function(e){var t=a.a.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):l({},t,{},e)),n},b=function(e){var t=s(e.components);return a.a.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},O=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,i=e.parentName,c=p(e,["components","mdxType","originalType","parentName"]),b=s(n),O=r,m=b["".concat(i,".").concat(O)]||b[O]||u[O]||o;return n?a.a.createElement(m,l({ref:t},c,{components:n})):a.a.createElement(m,l({ref:t},c))}));function m(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,i=new Array(o);i[0]=O;var l={};for(var p in t)hasOwnProperty.call(t,p)&&(l[p]=t[p]);l.originalType=e,l.mdxType="string"==typeof e?e:r,i[1]=l;for(var c=2;c<o;c++)i[c]=n[c];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,n)}O.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/47462ed9.77c23de4.js b/47462ed9.77c23de4.js
new file mode 100644
index 00000000000..42de6c5ce61
--- /dev/null
+++ b/47462ed9.77c23de4.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[51],{179:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return l})),n.d(t,"rightToc",(function(){return p})),n.d(t,"default",(function(){return s}));var r=n(1),a=n(9),o=(n(0),n(312)),i={id:"file-post-processing",title:"File post-processing"},l={id:"file-post-processing",title:"File post-processing",description:"Each tool (CLI and plugins) supports enabling file post-processing at a high-level. Enabling this option allows for generators which support post-processing to call some external process for each generated file, passing the file path to that tool. The external tool must be defined in an environment variable supported by the generator.",source:"@site/../docs/file-post-processing.md",permalink:"/docs/file-post-processing",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/file-post-processing.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Configuration Options",permalink:"/docs/configuration"},next:{title:"Using Templates",permalink:"/docs/templating"}},p=[{value:"Supported Environment Variables",id:"supported-environment-variables",children:[]},{value:"Example",id:"example",children:[]}],c={rightToc:p};function s(e){var t=e.components,n=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(r.a)({},c,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"Each tool (CLI and plugins) supports enabling file post-processing at a high-level. Enabling this option allows for generators which support post-processing to call some external process for each generated file, passing the file path to that tool. The external tool must be defined in an environment variable supported by the generator."),Object(o.b)("p",null,"Note that:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"this option is ",Object(o.b)("inlineCode",{parentName:"li"},"--enable-post-process-file")," in the CLI and ",Object(o.b)("inlineCode",{parentName:"li"},"enablePostProcessFile")," in plugins"),Object(o.b)("li",{parentName:"ul"},"we require ",Object(o.b)("em",{parentName:"li"},"both")," specifying the environment variable ",Object(o.b)("em",{parentName:"li"},"and")," enabling the option at the tooling level; this feature is opt-in for security "),Object(o.b)("li",{parentName:"ul"},"file processing occurs one at a time"),Object(o.b)("li",{parentName:"ul"},"the external tool may be a custom script which invokes multiple tools")),Object(o.b)("p",null,"Also refer to the relevant documentation for ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/usage"}),"CLI"),", ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md"}),"Maven Plugin"),", ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc"}),"Gradle Plugin"),", or ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md"}),"SBT Plugin"),"."),Object(o.b)("h2",{id:"supported-environment-variables"},"Supported Environment Variables"),Object(o.b)("p",null,"The following environment variables are supported by their respective generators:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"CPP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"CSHARP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"C_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"DART_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"FSHARP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"GO_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"HASKELL_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"JAVA_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"JS_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"KOTLIN_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"OCAML_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"PERL_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"PHP_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"POWERSHELL_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"PYTHON_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"RUBY_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"RUST_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"SCALA_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"SWIFT_POST_PROCESS_FILE")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"TS_POST_PROCESS_FILE"))),Object(o.b)("h2",{id:"example"},"Example"),Object(o.b)("p",null,"Let's see how to pass Ruby generated files to Rubocop, a static code analysis/linter/formatter tool."),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{}),'# First, export the required environment variable\nexport RUBY_POST_PROCESS_FILE="/usr/local/bin/rubocop -a"\n\nexport OPENAPI_DOC="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"\n\n# Invoke the generator with --enable-post-process-file\nopenapi-generator generate --enable-post-process-file -i $OPENAPI_DOC -g ruby -o .out-ruby/\n')),Object(o.b)("p",null,"You will now see messages logged about which files have been processed:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{}),"[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.rspec\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb\n[main] INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb\n[main] INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb\n[main] INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb\n[main] INFO  o.o.codegen.TemplateManager - Skipped /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator-ignore (Skipped by supportingFiles options supplied by user.)\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/VERSION\n[main] INFO  o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/FILES\n")))}s.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return m}));var r=n(0),a=n.n(r);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function l(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function p(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var c=a.a.createContext({}),s=function(e){var t=a.a.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):l({},t,{},e)),n},b=function(e){var t=s(e.components);return a.a.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},O=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,i=e.parentName,c=p(e,["components","mdxType","originalType","parentName"]),b=s(n),O=r,m=b["".concat(i,".").concat(O)]||b[O]||u[O]||o;return n?a.a.createElement(m,l({ref:t},c,{components:n})):a.a.createElement(m,l({ref:t},c))}));function m(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,i=new Array(o);i[0]=O;var l={};for(var p in t)hasOwnProperty.call(t,p)&&(l[p]=t[p]);l.originalType=e,l.mdxType="string"==typeof e?e:r,i[1]=l;for(var c=2;c<o;c++)i[c]=n[c];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,n)}O.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/5f7cf4b7.3b4dc9f4.js b/5f7cf4b7.3b4dc9f4.js
new file mode 100644
index 00000000000..7e8c67342bd
--- /dev/null
+++ b/5f7cf4b7.3b4dc9f4.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[61],{189:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return s})),n.d(t,"default",(function(){return u}));var o=n(1),r=n(9),a=(n(0),n(312)),i={id:"faq-contributing",title:"FAQ: Contributing"},c={id:"faq-contributing",title:"FAQ: Contributing",description:"## Automated checks on my PR have failed. Do you know what's wrong?",source:"@site/../docs/faq-contributing.md",permalink:"/docs/faq-contributing",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-contributing.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"faq-sidebar",previous:{title:"FAQ: Extending",permalink:"/docs/faq-extending"},next:{title:"FAQ: Generators",permalink:"/docs/faq-generators"}},s=[{value:"Automated checks on my PR have failed. Do you know what's wrong?",id:"automated-checks-on-my-pr-have-failed-do-you-know-whats-wrong",children:[]},{value:"The public petstore server returns status 500, can I run it locally?",id:"the-public-petstore-server-returns-status-500-can-i-run-it-locally",children:[]},{value:"Who should I report a security vulnerability to?",id:"who-should-i-report-a-security-vulnerability-to",children:[]},{value:"How can I rebase my PR on the latest master?",id:"how-can-i-rebase-my-pr-on-the-latest-master",children:[]},{value:"How can I update commits that are not linked to my GitHub account?",id:"how-can-i-update-commits-that-are-not-linked-to-my-github-account",children:[]},{value:"Any useful git tips to share?",id:"any-useful-git-tips-to-share",children:[]},{value:"How can I submit a PR to fix bugs or make enhancements?",id:"how-can-i-submit-a-pr-to-fix-bugs-or-make-enhancements",children:[]}],l={rightToc:s};function u(e){var t=e.components,n=Object(r.a)(e,["components"]);return Object(a.b)("wrapper",Object(o.a)({},l,n,{components:t,mdxType:"MDXLayout"}),Object(a.b)("h2",{id:"automated-checks-on-my-pr-have-failed-do-you-know-whats-wrong"},"Automated checks on my PR have failed. Do you know what's wrong?"),Object(a.b)("p",null,"Please do the following:"),Object(a.b)("ul",null,Object(a.b)("li",{parentName:"ul"},"Click on the failed tests and check the log to see what's causing the errors."),Object(a.b)("li",{parentName:"ul"},"If it's related to connection timeout in downloading dependencies, please restart the CI jobs (which can be done by closing and reopening the PR)"),Object(a.b)("li",{parentName:"ul"},"If it's some other reason, please tag someone on the ",Object(a.b)("a",Object(o.a)({parentName:"li"},{href:"/docs/core-team"}),"core team")," for assistance.")),Object(a.b)("h2",{id:"the-public-petstore-server-returns-status-500-can-i-run-it-locally"},"The public petstore server returns status 500, can I run it locally?"),Object(a.b)("p",null,"Yes, please run the following commands (assuming you've docker installed):"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"docker pull swaggerapi/petstore\ndocker run -d -e SWAGGER_HOST=http://petstore.swagger.io -e SWAGGER_BASE_PATH=/v2 -p 80:8080 swaggerapi/petstore\ndocker ps -a\n")),Object(a.b)("p",null,"Then add the following to your local ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://en.wikipedia.org/wiki/Hosts_%28file%29"}),"hosts")," table:"),Object(a.b)("pre",null,Object(a.b)("code",Object(o.a)({parentName:"pre"},{}),"127.0.0.1    petstore.swagger.io\n")),Object(a.b)("h2",{id:"who-should-i-report-a-security-vulnerability-to"},"Who should I report a security vulnerability to?"),Object(a.b)("p",null,"Please contact team@openapitools.org with the details and we'll follow up with you."),Object(a.b)("h2",{id:"how-can-i-rebase-my-pr-on-the-latest-master"},"How can I rebase my PR on the latest master?"),Object(a.b)("p",null,"Please refer to ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"http://rypress.com/tutorials/git/rebasing"}),"http://rypress.com/tutorials/git/rebasing"),', or follow the steps below (assuming the branch for the PR is "fix_issue_9999"):'),Object(a.b)("ol",null,Object(a.b)("li",{parentName:"ol"},"git checkout master"),Object(a.b)("li",{parentName:"ol"},"git pull upstream master (assuming ",Object(a.b)("inlineCode",{parentName:"li"},"upstream")," is pointing to the official repo)"),Object(a.b)("li",{parentName:"ol"},"git checkout fix_issue_9999"),Object(a.b)("li",{parentName:"ol"},"git rebase master"),Object(a.b)("li",{parentName:"ol"},'Resolve merge conflicts, if any, and run "git commit -a"'),Object(a.b)("li",{parentName:"ol"},"Rebase done (you may need to add --force when doing ",Object(a.b)("inlineCode",{parentName:"li"},"git push"),")")),Object(a.b)("p",null,"(To setup ",Object(a.b)("inlineCode",{parentName:"p"},"upstream")," pointing to the official repo, please run ",Object(a.b)("inlineCode",{parentName:"p"},"git remote add upstream  https://github.com/openapitools/openapi-generator.git"),")"),Object(a.b)("h2",{id:"how-can-i-update-commits-that-are-not-linked-to-my-github-account"},"How can I update commits that are not linked to my GitHub account?"),Object(a.b)("p",null,"Please refer to ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://stackoverflow.com/questions/3042437/how-to-change-the-commit-author-for-one-specific-commit"}),"https://stackoverflow.com/questions/3042437/how-to-change-the-commit-author-for-one-specific-commit")," or you can simply add the email address in the commit as your secondary email address in your GitHub account."),Object(a.b)("h2",{id:"any-useful-git-tips-to-share"},"Any useful git tips to share?"),Object(a.b)("p",null,"Yes, ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"http://www.alexkras.com/19-git-tips-for-everyday-use/"}),"http://www.alexkras.com/19-git-tips-for-everyday-use/")),Object(a.b)("h2",{id:"how-can-i-submit-a-pr-to-fix-bugs-or-make-enhancements"},"How can I submit a PR to fix bugs or make enhancements?"),Object(a.b)("p",null,"Visit ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"),' and then click on the "Fork" button in the upper right corner. Then in your local machine, run the following (assuming your github ID is "your_user_id")'),Object(a.b)("p",null,"1) git clone ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/your_user_id/openapi-generator.git"}),"https://github.com/your_user_id/openapi-generator.git"),"\n2) cd openapi-generator\n3) git checkout -b fix_issue9999\n4) make changes\n5) git commit -a (you may need to use ",Object(a.b)("inlineCode",{parentName:"p"},"git add filename")," to add new files)\n6) git push origin fix_issue9999\n7) Visit ",Object(a.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator")," in your browser and click on the button to file a new PR based on fix_issue9999"))}u.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return p})),n.d(t,"b",(function(){return m}));var o=n(0),r=n.n(o);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,o)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){a(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function s(e,t){if(null==e)return{};var n,o,r=function(e,t){if(null==e)return{};var n,o,r={},a=Object.keys(e);for(o=0;o<a.length;o++)n=a[o],t.indexOf(n)>=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(o=0;o<a.length;o++)n=a[o],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var l=r.a.createContext({}),u=function(e){var t=r.a.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},p=function(e){var t=u(e.components);return r.a.createElement(l.Provider,{value:t},e.children)},b={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},h=Object(o.forwardRef)((function(e,t){var n=e.components,o=e.mdxType,a=e.originalType,i=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),p=u(n),h=o,m=p["".concat(i,".").concat(h)]||p[h]||b[h]||a;return n?r.a.createElement(m,c({ref:t},l,{components:n})):r.a.createElement(m,c({ref:t},l))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var a=n.length,i=new Array(a);i[0]=h;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:o,i[1]=c;for(var l=2;l<a;l++)i[l]=n[l];return r.a.createElement.apply(null,i)}return r.a.createElement.apply(null,n)}h.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/5f7cf4b7.97dacab2.js b/5f7cf4b7.97dacab2.js
deleted file mode 100644
index 242059a3de7..00000000000
--- a/5f7cf4b7.97dacab2.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[61],{189:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return s})),n.d(t,"default",(function(){return u}));var o=n(1),a=n(9),r=(n(0),n(312)),i={id:"faq-contributing",title:"FAQ: Contributing"},c={id:"faq-contributing",title:"FAQ: Contributing",description:"## Automated checks on my PR have failed. Do you know what's wrong?",source:"@site/../docs/faq-contributing.md",permalink:"/docs/faq-contributing",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-contributing.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"faq-sidebar",previous:{title:"FAQ: Extending",permalink:"/docs/faq-extending"},next:{title:"FAQ: Generators",permalink:"/docs/faq-generators"}},s=[{value:"Automated checks on my PR have failed. Do you know what's wrong?",id:"automated-checks-on-my-pr-have-failed-do-you-know-whats-wrong",children:[]},{value:"The public petstore server returns status 500, can I run it locally?",id:"the-public-petstore-server-returns-status-500-can-i-run-it-locally",children:[]},{value:"Who should I report a security vulnerability to?",id:"who-should-i-report-a-security-vulnerability-to",children:[]},{value:"How can I rebase my PR on the latest master?",id:"how-can-i-rebase-my-pr-on-the-latest-master",children:[]},{value:"How can I update commits that are not linked to my GitHub account?",id:"how-can-i-update-commits-that-are-not-linked-to-my-github-account",children:[]},{value:"Any useful git tips to share?",id:"any-useful-git-tips-to-share",children:[]},{value:"How can I submit a PR to fix bugs or make enhancements?",id:"how-can-i-submit-a-pr-to-fix-bugs-or-make-enhancements",children:[]}],l={rightToc:s};function u(e){var t=e.components,n=Object(a.a)(e,["components"]);return Object(r.b)("wrapper",Object(o.a)({},l,n,{components:t,mdxType:"MDXLayout"}),Object(r.b)("h2",{id:"automated-checks-on-my-pr-have-failed-do-you-know-whats-wrong"},"Automated checks on my PR have failed. Do you know what's wrong?"),Object(r.b)("p",null,"Please do the following:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"Click on the failed tests and check the log to see what's causing the errors."),Object(r.b)("li",{parentName:"ul"},"If it's related to connection timeout in downloading dependencies, please restart the CI jobs (which can be done by closing and reopening the PR)"),Object(r.b)("li",{parentName:"ul"},"If it's some other reason, please tag someone on the ",Object(r.b)("a",Object(o.a)({parentName:"li"},{href:"/docs/core-team"}),"core team")," for assistance.")),Object(r.b)("h2",{id:"the-public-petstore-server-returns-status-500-can-i-run-it-locally"},"The public petstore server returns status 500, can I run it locally?"),Object(r.b)("p",null,"Yes, please run the following commands (assuming you've docker installed):"),Object(r.b)("pre",null,Object(r.b)("code",Object(o.a)({parentName:"pre"},{}),"docker pull swaggerapi/petstore\ndocker run -d -e SWAGGER_HOST=http://petstore.swagger.io -e SWAGGER_BASE_PATH=/v2 -p 80:8080 swaggerapi/petstore\ndocker ps -a\n")),Object(r.b)("p",null,"Then add the following to your local ",Object(r.b)("a",Object(o.a)({parentName:"p"},{href:"https://en.wikipedia.org/wiki/Hosts_%28file%29"}),"hosts")," table:"),Object(r.b)("pre",null,Object(r.b)("code",Object(o.a)({parentName:"pre"},{}),"127.0.0.1    petstore.swagger.io\n")),Object(r.b)("h2",{id:"who-should-i-report-a-security-vulnerability-to"},"Who should I report a security vulnerability to?"),Object(r.b)("p",null,"Please contact team@openapitools.org with the details and we'll follow up with you."),Object(r.b)("h2",{id:"how-can-i-rebase-my-pr-on-the-latest-master"},"How can I rebase my PR on the latest master?"),Object(r.b)("p",null,"Please refer to ",Object(r.b)("a",Object(o.a)({parentName:"p"},{href:"http://rypress.com/tutorials/git/rebasing"}),"http://rypress.com/tutorials/git/rebasing"),', or follow the steps below (assuming the branch for the PR is "fix_issue_9999"):'),Object(r.b)("ol",null,Object(r.b)("li",{parentName:"ol"},"git checkout master"),Object(r.b)("li",{parentName:"ol"},"git pull upstream master (assuming ",Object(r.b)("inlineCode",{parentName:"li"},"upstream")," is pointing to the official repo)"),Object(r.b)("li",{parentName:"ol"},"git checkout fix_issue_9999"),Object(r.b)("li",{parentName:"ol"},"git rebase master"),Object(r.b)("li",{parentName:"ol"},'Resolve merge conflicts, if any, and run "git commit -a"'),Object(r.b)("li",{parentName:"ol"},"Rebase done (you may need to add --force when doing ",Object(r.b)("inlineCode",{parentName:"li"},"git push"),")")),Object(r.b)("p",null,"(To setup ",Object(r.b)("inlineCode",{parentName:"p"},"upstream")," pointing to the official repo, please run ",Object(r.b)("inlineCode",{parentName:"p"},"git remote add upstream  https://github.com/openapitools/openapi-generator.git"),")"),Object(r.b)("h2",{id:"how-can-i-update-commits-that-are-not-linked-to-my-github-account"},"How can I update commits that are not linked to my GitHub account?"),Object(r.b)("p",null,"Please refer to ",Object(r.b)("a",Object(o.a)({parentName:"p"},{href:"https://stackoverflow.com/questions/3042437/how-to-change-the-commit-author-for-one-specific-commit"}),"https://stackoverflow.com/questions/3042437/how-to-change-the-commit-author-for-one-specific-commit")," or you can simply add the email address in the commit as your secondary email address in your GitHub account."),Object(r.b)("h2",{id:"any-useful-git-tips-to-share"},"Any useful git tips to share?"),Object(r.b)("p",null,"Yes, ",Object(r.b)("a",Object(o.a)({parentName:"p"},{href:"http://www.alexkras.com/19-git-tips-for-everyday-use/"}),"http://www.alexkras.com/19-git-tips-for-everyday-use/")),Object(r.b)("h2",{id:"how-can-i-submit-a-pr-to-fix-bugs-or-make-enhancements"},"How can I submit a PR to fix bugs or make enhancements?"),Object(r.b)("p",null,"Visit ",Object(r.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"),' and then click on the "Fork" button in the upper right corner. Then in your local machine, run the following (assuming your github ID is "your_user_id")'),Object(r.b)("p",null,"1) git clone ",Object(r.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/your_user_id/openapi-generator.git"}),"https://github.com/your_user_id/openapi-generator.git"),"\n2) cd openapi-generator\n3) git checkout -b fix_issue9999\n4) make changes\n5) git commit -a (you may need to use ",Object(r.b)("inlineCode",{parentName:"p"},"git add filename")," to add new files)\n6) git push origin fix_issue9999\n7) Visit ",Object(r.b)("a",Object(o.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator")," in your browser and click on the button to file a new PR based on fix_issue9999"))}u.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return p})),n.d(t,"b",(function(){return m}));var o=n(0),a=n.n(o);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);t&&(o=o.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,o)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function s(e,t){if(null==e)return{};var n,o,a=function(e,t){if(null==e)return{};var n,o,a={},r=Object.keys(e);for(o=0;o<r.length;o++)n=r[o],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(o=0;o<r.length;o++)n=r[o],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var l=a.a.createContext({}),u=function(e){var t=a.a.useContext(l),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},p=function(e){var t=u(e.components);return a.a.createElement(l.Provider,{value:t},e.children)},b={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},h=Object(o.forwardRef)((function(e,t){var n=e.components,o=e.mdxType,r=e.originalType,i=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),p=u(n),h=o,m=p["".concat(i,".").concat(h)]||p[h]||b[h]||r;return n?a.a.createElement(m,c({ref:t},l,{components:n})):a.a.createElement(m,c({ref:t},l))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=n.length,i=new Array(r);i[0]=h;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:o,i[1]=c;for(var l=2;l<r;l++)i[l]=n[l];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,n)}h.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/6db4087d.0d3d744a.js b/6db4087d.0d3d744a.js
deleted file mode 100644
index 790c9c59198..00000000000
--- a/6db4087d.0d3d744a.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[67],{195:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return o})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return p}));var a=n(1),r=n(9),i=(n(0),n(312)),o={id:"faq-generators",title:"FAQ: Generators"},c={id:"faq-generators",title:"FAQ: Generators",description:"### What are some server generator use cases?",source:"@site/../docs/faq-generators.md",permalink:"/docs/faq-generators",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-generators.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"faq-sidebar",previous:{title:"FAQ: Contributing",permalink:"/docs/faq-contributing"}},l=[{value:"What are some server generator use cases?",id:"what-are-some-server-generator-use-cases",children:[]},{value:"Java",id:"java",children:[{value:"The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?",id:"the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that",children:[]},{value:"How can I customize the Feign client templates?",id:"how-can-i-customize-the-feign-client-templates",children:[]}]},{value:"Android",id:"android",children:[{value:"How can I generate an Android SDK?",id:"how-can-i-generate-an-android-sdk",children:[]}]},{value:"C-Sharp",id:"c-sharp",children:[{value:"How do I fix <code>CSC:  warning CS2002</code> in Xamarin?",id:"how-do-i-fix-csc--warning-cs2002-in-xamarin",children:[]}]},{value:"Objective-C",id:"objective-c",children:[{value:"How do I run integration test with Petstore ObjC API client?",id:"how-do-i-run-integration-test-with-petstore-objc-api-client",children:[]}]},{value:"Swift",id:"swift",children:[{value:"How do I run integration test with Petstore Swift API client?",id:"how-do-i-run-integration-test-with-petstore-swift-api-client",children:[]},{value:"Is Swift (2.x) generator still actively maintained?",id:"is-swift-2x-generator-still-actively-maintained",children:[]}]},{value:"TypeScript",id:"typescript",children:[{value:"The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?",id:"the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming",children:[]}]}],s={rightToc:l};function p(e){var t=e.components,n=Object(r.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h3",{id:"what-are-some-server-generator-use-cases"},"What are some server generator use cases?"),Object(i.b)("p",null,"We have around 40+ server generators, with more added regularly. Some of these include Spring in your choice of Java or Kotlin, the Finch and Scalatra frameworks using Scala, and C# generators for ASP.NET and Azure Functions (to name only a few)."),Object(i.b)("p",null,"Besides generating the server code as a starting point to implement the API backend, here are some use cases of the server generators:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"prototyping")," - one can generate the server code and have a functional API backend very quickly to try different things or features."),Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"mocking")," - easily provide an API backend for mocking based on the examples field defined in the response object."),Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"migration")," - let's say one wants to migrate an API backend from Ruby on Rails to Java Spring. The server generator can save a lot of time in implementing and verify each endpoint in the new API backend."),Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"evaluating"),' - when you want to try a new language or framework, and a typical "Hello, World" is too trivial.')),Object(i.b)("h2",{id:"java"},"Java"),Object(i.b)("h3",{id:"the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that"},"The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?"),Object(i.b)("p",null,"Yes, please refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"http://stackoverflow.com/a/6055903/677735"}),"http://stackoverflow.com/a/6055903/677735")),Object(i.b)("h3",{id:"how-can-i-customize-the-feign-client-templates"},"How can I customize the Feign client templates?"),Object(i.b)("p",null,"You will need to provide customized files in ",Object(i.b)("inlineCode",{parentName:"p"},"Java/libraries/feign")," under the resources folder and pass the location via the ",Object(i.b)("inlineCode",{parentName:"p"},"-t")," option."),Object(i.b)("p",null,"In your Gradle build script, please add the following (example):"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"config.templateDir = 'src/openapi-generator-templates/Java/libraries/feign\n")),Object(i.b)("h2",{id:"android"},"Android"),Object(i.b)("h3",{id:"how-can-i-generate-an-android-sdk"},"How can I generate an Android SDK?"),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"The Java SDK is also compatible with Android.")),Object(i.b)("p",null,"[RECOMMENDED]"," To generate the Java SDK with ",Object(i.b)("inlineCode",{parentName:"p"},"okhttp")," and ",Object(i.b)("inlineCode",{parentName:"p"},"gson")," libraries, run the following:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"mvn clean package\njava -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \\\n  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json \\\n  -l java --library=okhttp-gson \\\n  --additional-properties hideGenerationTimestamp=true \\\n  -o /var/tmp/java/okhttp-gson/ \n")),Object(i.b)("p",null,"You can also generate the Java SDK with other HTTP libraries by replacing ",Object(i.b)("inlineCode",{parentName:"p"},"okhttp-gson")," with ",Object(i.b)("inlineCode",{parentName:"p"},"retrofit")," for example. For a list of support libraries, please run"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -l java\n")),Object(i.b)("p",null,"To generate the Android SDK with ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/mcxiaoke/android-volley"}),Object(i.b)("inlineCode",{parentName:"a"},"volley")),", please run"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"mvn clean package\njava -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \\\n  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json \\\n  -l android --library=volley \\\n  -o /var/tmp/android/volley/ \n")),Object(i.b)("p",null,"We do ",Object(i.b)("strong",{parentName:"p"},"not")," recommend using the default HTTP library (Apache HttpClient) with ",Object(i.b)("inlineCode",{parentName:"p"},"android")," as it's not actively maintained."),Object(i.b)("h2",{id:"c-sharp"},"C-Sharp"),Object(i.b)("h3",{id:"how-do-i-fix-csc--warning-cs2002-in-xamarin"},"How do I fix ",Object(i.b)("inlineCode",{parentName:"h3"},"CSC:  warning CS2002")," in Xamarin?"),Object(i.b)("p",null,"The full warning might look like this: ",Object(i.b)("inlineCode",{parentName:"p"},"CSC:  warning CS2002: Source file 'Api/FakeApi.cs' specified multiple times")),Object(i.b)("p",null,"The warning has no impact on the build process so you should be able to build the solution without issue. The warning should be addressed in the upcoming stable release of Xamarin. "),Object(i.b)("h2",{id:"objective-c"},"Objective-C"),Object(i.b)("h3",{id:"how-do-i-run-integration-test-with-petstore-objc-api-client"},"How do I run integration test with Petstore ObjC API client?"),Object(i.b)("p",null,"Here are the steps:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator/samples/client/petstore/objc/default/OpenAPIClientTests\nmvn integration-test\n")),Object(i.b)("p",null,"Besides ",Object(i.b)("inlineCode",{parentName:"p"},"default")," (folder) ObjC API client, there's also ",Object(i.b)("inlineCode",{parentName:"p"},"core-data")," for another ObjC API client with ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://en.wikipedia.org/wiki/Core_Data"}),"Core Data support"),"."),Object(i.b)("h2",{id:"swift"},"Swift"),Object(i.b)("h3",{id:"how-do-i-run-integration-test-with-petstore-swift-api-client"},"How do I run integration test with Petstore Swift API client?"),Object(i.b)("p",null,"Here are the steps:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator/samples/client/petstore/swift/default/OpenAPIClientTests\nmvn integration-test\n")),Object(i.b)("p",null,"Besides ",Object(i.b)("inlineCode",{parentName:"p"},"default")," (folder), there's another folder ",Object(i.b)("inlineCode",{parentName:"p"},"promisekit")," for Swift API client with ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/mxcl/PromiseKit"}),"PromiseKit support")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator/samples/client/petstore/swift/promisekit/OpenAPIClientTests\nmvn integration-test\n")),Object(i.b)("h3",{id:"is-swift-2x-generator-still-actively-maintained"},"Is Swift (2.x) generator still actively maintained?"),Object(i.b)("p",null,"No, please use ",Object(i.b)("inlineCode",{parentName:"p"},"swift3")," or ",Object(i.b)("inlineCode",{parentName:"p"},"swift4")," generator instead as we want to focus on Swift 3.x, 4.x."),Object(i.b)("h2",{id:"typescript"},"TypeScript"),Object(i.b)("h3",{id:"the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming"},"The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?"),Object(i.b)("p",null,"Yes, please use the following option when generating TypeScript clients:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"    modelPropertyNaming\n        Naming convention for the property: 'camelCase', 'PascalCase', 'snake_case' and 'original', which keeps the original name (Default: camelCase)\n")))}p.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return h}));var a=n(0),r=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,r=function(e,t){if(null==e)return{};var n,a,r={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var s=r.a.createContext({}),p=function(e){var t=r.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},b=function(e){var t=p(e.components);return r.a.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},u=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,o=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),b=p(n),u=a,h=b["".concat(o,".").concat(u)]||b[u]||d[u]||i;return n?r.a.createElement(h,c({ref:t},s,{components:n})):r.a.createElement(h,c({ref:t},s))}));function h(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=u;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:a,o[1]=c;for(var s=2;s<i;s++)o[s]=n[s];return r.a.createElement.apply(null,o)}return r.a.createElement.apply(null,n)}u.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/6db4087d.21fab80e.js b/6db4087d.21fab80e.js
new file mode 100644
index 00000000000..71bbd2ac965
--- /dev/null
+++ b/6db4087d.21fab80e.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[67],{195:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return o})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return p}));var a=n(1),r=n(9),i=(n(0),n(312)),o={id:"faq-generators",title:"FAQ: Generators"},c={id:"faq-generators",title:"FAQ: Generators",description:"### What are some server generator use cases?",source:"@site/../docs/faq-generators.md",permalink:"/docs/faq-generators",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-generators.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"faq-sidebar",previous:{title:"FAQ: Contributing",permalink:"/docs/faq-contributing"}},l=[{value:"What are some server generator use cases?",id:"what-are-some-server-generator-use-cases",children:[]},{value:"Java",id:"java",children:[{value:"The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?",id:"the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that",children:[]},{value:"How can I customize the Feign client templates?",id:"how-can-i-customize-the-feign-client-templates",children:[]}]},{value:"Android",id:"android",children:[{value:"How can I generate an Android SDK?",id:"how-can-i-generate-an-android-sdk",children:[]}]},{value:"C-Sharp",id:"c-sharp",children:[{value:"How do I fix <code>CSC:  warning CS2002</code> in Xamarin?",id:"how-do-i-fix-csc--warning-cs2002-in-xamarin",children:[]}]},{value:"Objective-C",id:"objective-c",children:[{value:"How do I run integration test with Petstore ObjC API client?",id:"how-do-i-run-integration-test-with-petstore-objc-api-client",children:[]}]},{value:"Swift",id:"swift",children:[{value:"How do I run integration test with Petstore Swift API client?",id:"how-do-i-run-integration-test-with-petstore-swift-api-client",children:[]},{value:"Is Swift (2.x) generator still actively maintained?",id:"is-swift-2x-generator-still-actively-maintained",children:[]}]},{value:"TypeScript",id:"typescript",children:[{value:"The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?",id:"the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming",children:[]}]}],s={rightToc:l};function p(e){var t=e.components,n=Object(r.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h3",{id:"what-are-some-server-generator-use-cases"},"What are some server generator use cases?"),Object(i.b)("p",null,"We have around 40+ server generators, with more added regularly. Some of these include Spring in your choice of Java or Kotlin, the Finch and Scalatra frameworks using Scala, and C# generators for ASP.NET and Azure Functions (to name only a few)."),Object(i.b)("p",null,"Besides generating the server code as a starting point to implement the API backend, here are some use cases of the server generators:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"prototyping")," - one can generate the server code and have a functional API backend very quickly to try different things or features."),Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"mocking")," - easily provide an API backend for mocking based on the examples field defined in the response object."),Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"migration")," - let's say one wants to migrate an API backend from Ruby on Rails to Java Spring. The server generator can save a lot of time in implementing and verify each endpoint in the new API backend."),Object(i.b)("li",{parentName:"ul"},Object(i.b)("strong",{parentName:"li"},"evaluating"),' - when you want to try a new language or framework, and a typical "Hello, World" is too trivial.')),Object(i.b)("h2",{id:"java"},"Java"),Object(i.b)("h3",{id:"the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that"},"The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?"),Object(i.b)("p",null,"Yes, please refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"http://stackoverflow.com/a/6055903/677735"}),"http://stackoverflow.com/a/6055903/677735")),Object(i.b)("h3",{id:"how-can-i-customize-the-feign-client-templates"},"How can I customize the Feign client templates?"),Object(i.b)("p",null,"You will need to provide customized files in ",Object(i.b)("inlineCode",{parentName:"p"},"Java/libraries/feign")," under the resources folder and pass the location via the ",Object(i.b)("inlineCode",{parentName:"p"},"-t")," option."),Object(i.b)("p",null,"In your Gradle build script, please add the following (example):"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"config.templateDir = 'src/openapi-generator-templates/Java/libraries/feign\n")),Object(i.b)("h2",{id:"android"},"Android"),Object(i.b)("h3",{id:"how-can-i-generate-an-android-sdk"},"How can I generate an Android SDK?"),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"The Java SDK is also compatible with Android.")),Object(i.b)("p",null,"[RECOMMENDED]"," To generate the Java SDK with ",Object(i.b)("inlineCode",{parentName:"p"},"okhttp")," and ",Object(i.b)("inlineCode",{parentName:"p"},"gson")," libraries, run the following:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"mvn clean package\njava -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \\\n  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json \\\n  -l java --library=okhttp-gson \\\n  --additional-properties hideGenerationTimestamp=true \\\n  -o /var/tmp/java/okhttp-gson/ \n")),Object(i.b)("p",null,"You can also generate the Java SDK with other HTTP libraries by replacing ",Object(i.b)("inlineCode",{parentName:"p"},"okhttp-gson")," with ",Object(i.b)("inlineCode",{parentName:"p"},"retrofit")," for example. For a list of support libraries, please run"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -l java\n")),Object(i.b)("p",null,"To generate the Android SDK with ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/mcxiaoke/android-volley"}),Object(i.b)("inlineCode",{parentName:"a"},"volley")),", please run"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"mvn clean package\njava -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \\\n  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json \\\n  -l android --library=volley \\\n  -o /var/tmp/android/volley/ \n")),Object(i.b)("p",null,"We do ",Object(i.b)("strong",{parentName:"p"},"not")," recommend using the default HTTP library (Apache HttpClient) with ",Object(i.b)("inlineCode",{parentName:"p"},"android")," as it's not actively maintained."),Object(i.b)("h2",{id:"c-sharp"},"C-Sharp"),Object(i.b)("h3",{id:"how-do-i-fix-csc--warning-cs2002-in-xamarin"},"How do I fix ",Object(i.b)("inlineCode",{parentName:"h3"},"CSC:  warning CS2002")," in Xamarin?"),Object(i.b)("p",null,"The full warning might look like this: ",Object(i.b)("inlineCode",{parentName:"p"},"CSC:  warning CS2002: Source file 'Api/FakeApi.cs' specified multiple times")),Object(i.b)("p",null,"The warning has no impact on the build process so you should be able to build the solution without issue. The warning should be addressed in the upcoming stable release of Xamarin. "),Object(i.b)("h2",{id:"objective-c"},"Objective-C"),Object(i.b)("h3",{id:"how-do-i-run-integration-test-with-petstore-objc-api-client"},"How do I run integration test with Petstore ObjC API client?"),Object(i.b)("p",null,"Here are the steps:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator/samples/client/petstore/objc/default/OpenAPIClientTests\nmvn integration-test\n")),Object(i.b)("p",null,"Besides ",Object(i.b)("inlineCode",{parentName:"p"},"default")," (folder) ObjC API client, there's also ",Object(i.b)("inlineCode",{parentName:"p"},"core-data")," for another ObjC API client with ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://en.wikipedia.org/wiki/Core_Data"}),"Core Data support"),"."),Object(i.b)("h2",{id:"swift"},"Swift"),Object(i.b)("h3",{id:"how-do-i-run-integration-test-with-petstore-swift-api-client"},"How do I run integration test with Petstore Swift API client?"),Object(i.b)("p",null,"Here are the steps:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator/samples/client/petstore/swift/default/OpenAPIClientTests\nmvn integration-test\n")),Object(i.b)("p",null,"Besides ",Object(i.b)("inlineCode",{parentName:"p"},"default")," (folder), there's another folder ",Object(i.b)("inlineCode",{parentName:"p"},"promisekit")," for Swift API client with ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/mxcl/PromiseKit"}),"PromiseKit support")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator/samples/client/petstore/swift/promisekit/OpenAPIClientTests\nmvn integration-test\n")),Object(i.b)("h3",{id:"is-swift-2x-generator-still-actively-maintained"},"Is Swift (2.x) generator still actively maintained?"),Object(i.b)("p",null,"No, please use ",Object(i.b)("inlineCode",{parentName:"p"},"swift3")," or ",Object(i.b)("inlineCode",{parentName:"p"},"swift4")," generator instead as we want to focus on Swift 3.x, 4.x."),Object(i.b)("h2",{id:"typescript"},"TypeScript"),Object(i.b)("h3",{id:"the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming"},"The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?"),Object(i.b)("p",null,"Yes, please use the following option when generating TypeScript clients:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"    modelPropertyNaming\n        Naming convention for the property: 'camelCase', 'PascalCase', 'snake_case' and 'original', which keeps the original name (Default: camelCase)\n")))}p.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return h}));var a=n(0),r=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,r=function(e,t){if(null==e)return{};var n,a,r={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var s=r.a.createContext({}),p=function(e){var t=r.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},b=function(e){var t=p(e.components);return r.a.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},u=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,o=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),b=p(n),u=a,h=b["".concat(o,".").concat(u)]||b[u]||d[u]||i;return n?r.a.createElement(h,c({ref:t},s,{components:n})):r.a.createElement(h,c({ref:t},s))}));function h(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=u;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:a,o[1]=c;for(var s=2;s<i;s++)o[s]=n[s];return r.a.createElement.apply(null,o)}return r.a.createElement.apply(null,n)}u.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/726258db.7a6414e5.js b/726258db.7a6414e5.js
deleted file mode 100644
index 7297d1c97e5..00000000000
--- a/726258db.7a6414e5.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[69],{197:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return l})),a.d(t,"metadata",(function(){return p})),a.d(t,"rightToc",(function(){return c})),a.d(t,"default",(function(){return s}));var n=a(1),o=a(9),r=(a(0),a(312)),l={id:"installation",title:"CLI Installation"},p={id:"installation",title:"CLI Installation",description:"There are a number of ways to use OpenAPI Generator. This page documents how to install the CLI artifact.",source:"@site/../docs/installation.md",permalink:"/docs/installation",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/installation.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",next:{title:"Plugins",permalink:"/docs/plugins"}},c=[{value:"npm",id:"npm",children:[]},{value:"Homebrew",id:"homebrew",children:[]},{value:"Scoop",id:"scoop",children:[]},{value:"Docker",id:"docker",children:[]},{value:"JAR",id:"jar",children:[]},{value:"Bash Launcher Script",id:"bash-launcher-script",children:[]}],i={rightToc:c};function s(e){var t=e.components,a=Object(o.a)(e,["components"]);return Object(r.b)("wrapper",Object(n.a)({},i,a,{components:t,mdxType:"MDXLayout"}),Object(r.b)("p",null,"There are a number of ways to use OpenAPI Generator. This page documents how to install the CLI artifact.\nInstalling OpenAPI Generator's CLI tool allows users to generate all available generators from the command line."),Object(r.b)("p",null,"Some of the following are cross-platform options and some are not, these are called out where possible."),Object(r.b)("h2",{id:"npm"},"npm"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows")),Object(r.b)("p",null,"The ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator-cli"}),"npm package wrapper")," is cross-platform wrapper around the .jar artifact. It works by providing a CLI wrapper atop the JAR's command line options. This gives a simple interface layer which normalizes usage of the command line across operating systems, removing some differences in how options or switches are passed to the tool (depending on OS).\n",Object(r.b)("strong",{parentName:"p"},"Install")," the latest version of the tool globally, exposing the CLI on the command line:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"npm install @openapitools/openapi-generator-cli -g\n")),Object(r.b)("p",null,"To install a specific version of the tool, pass the version during installation:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli version-manager set 5.3.0\n")),Object(r.b)("p",null,"To install the tool as a dev dependency in your current project:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"npm install @openapitools/openapi-generator-cli -D\n")),Object(r.b)("p",null,"Then, ",Object(r.b)("strong",{parentName:"p"},"generate")," a ruby client from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"npx @openapitools/openapi-generator-cli generate -i petstore.yaml -g ruby -o /tmp/test/\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("inlineCode",{parentName:"p"},"npx")," will execute a globally available ",Object(r.b)("inlineCode",{parentName:"p"},"openapi-generator"),", and if not found it will fall back to project-local commands. The result is that the above command will work regardless of which installation method you've chosen.")),Object(r.b)("h2",{id:"homebrew"},"Homebrew"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": macOS")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"Install")," via ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://brew.sh/"}),"homebrew"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"brew install openapi-generator\n")),Object(r.b)("p",null,"Then, ",Object(r.b)("strong",{parentName:"p"},"generate")," a ruby client from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -i petstore.yaml -g ruby -o /tmp/test/\n")),Object(r.b)("h2",{id:"scoop"},"Scoop"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Windows")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"Install")," via ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://scoop.sh/"}),"scoop"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{}),"scoop install openapi-generator-cli\n")),Object(r.b)("p",null,"If you don't have java installed, you can also install it via ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/ScoopInstaller/Java/"}),"scoop java bucket"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{}),"scoop bucket add java\nscoop install openjdk\n")),Object(r.b)("p",null,"Then, ",Object(r.b)("strong",{parentName:"p"},"generate")," a ruby client from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{}),"openapi-generator-cli generate -i petstore.yaml -g ruby\n")),Object(r.b)("h2",{id:"docker"},"Docker"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows")),Object(r.b)("p",null,"The OpenAPI Generator Docker image acts as a standalone executable. It can be used as an alternative to installing via homebrew, or for developers who are unable to install Java or upgrade the installed version."),Object(r.b)("p",null,"To generate code from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc with this image, you'll need to mount a local location as a volume.\nYou'll then need to output the generated code to this mapped volume. Everything else works the same as if you ran the command on your host machine."),Object(r.b)("p",null,"Here's an example generating a Go client:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"docker run --rm \\\n  -v ${PWD}:/local openapitools/openapi-generator-cli generate \\\n  -i /local/petstore.yaml \\\n  -g go \\\n  -o /local/out/go\n")),Object(r.b)("h2",{id:"jar"},"JAR"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows")),Object(r.b)("p",null,"If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):"),Object(r.b)("p",null,"JAR location: ",Object(r.b)("inlineCode",{parentName:"p"},"https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar")),Object(r.b)("p",null,"For ",Object(r.b)("strong",{parentName:"p"},"Mac/Linux")," users:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar -O openapi-generator-cli.jar\n")),Object(r.b)("p",null,"For ",Object(r.b)("strong",{parentName:"p"},"Windows")," users, you will need to install ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"http://gnuwin32.sourceforge.net/packages/wget.htm"}),"wget")," or you can use Invoke-WebRequest in PowerShell (3.0+), e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-powershell"}),"Invoke-WebRequest -OutFile openapi-generator-cli.jar https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar\n")),Object(r.b)("p",null,"After downloading the JAR, run ",Object(r.b)("inlineCode",{parentName:"p"},"java -jar openapi-generator-cli.jar help")," to show the usage."),Object(r.b)("p",null,"For Mac users, please make sure Java 8 is installed (Tips: run ",Object(r.b)("inlineCode",{parentName:"p"},"java -version")," to check the version), and export ",Object(r.b)("inlineCode",{parentName:"p"},"JAVA_HOME")," in order to use the supported Java version:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"export JAVA_HOME=`/usr/libexec/java_home -v 1.8`\nexport PATH=${JAVA_HOME}/bin:$PATH\n")),Object(r.b)("h2",{id:"bash-launcher-script"},"Bash Launcher Script"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows (variable)")),Object(r.b)("p",null,"One downside to manual JAR downloads is that you don't keep up-to-date with the latest released version. We have a Bash launcher script at ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh"}),"bin/utils/openapi-generator-cli.sh")," which solves this problem."),Object(r.b)("p",null,"To install the launcher script, copy the contents of the script to a location on your path and make the script executable."),Object(r.b)("p",null,"An example of setting this up (NOTE: Always evaluate scripts curled from external systems before executing them)."),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"mkdir -p ~/bin/openapitools\ncurl https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh > ~/bin/openapitools/openapi-generator-cli\nchmod u+x ~/bin/openapitools/openapi-generator-cli\nexport PATH=$PATH:~/bin/openapitools/\n")),Object(r.b)("p",null,"Now, ",Object(r.b)("inlineCode",{parentName:"p"},"openapi-generator-cli"),' is "installed". On invocation, it will query the GitHub repository for the most recently released version. If this matches the last downloaded jar,\nit will execute as normal. If a newer version is found, the script will download the latest release and execute it.'),Object(r.b)("p",null,"If you need to invoke an older version of the generator, you can define the variable ",Object(r.b)("inlineCode",{parentName:"p"},"OPENAPI_GENERATOR_VERSION")," either ad hoc or globally. You can export this variable if you'd like to persist a specific release version."),Object(r.b)("p",null,"Examples:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),'# Execute latest released openapi-generator-cli\nopenapi-generator-cli version\n\n# Execute version 3.1.0 for the current invocation, regardless of the latest released version\nOPENAPI_GENERATOR_VERSION=3.1.0 openapi-generator-cli version\n\n# Execute version 3.1.0-SNAPSHOT for the current invocation\nOPENAPI_GENERATOR_VERSION=3.1.0-SNAPSHOT openapi-generator-cli version\n\n# Execute version 3.0.2 for every invocation in the current shell session\nexport OPENAPI_GENERATOR_VERSION=3.0.2\nopenapi-generator-cli version # is 3.0.2\nopenapi-generator-cli version # is also 3.0.2\n\n# To "install" a specific version, set the variable in .bashrc/.bash_profile\necho "export OPENAPI_GENERATOR_VERSION=3.0.2" >> ~/.bashrc\nsource ~/.bashrc\nopenapi-generator-cli version # is always 3.0.2, unless any of the above overrides are done ad hoc\n')))}s.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return b})),a.d(t,"b",(function(){return O}));var n=a(0),o=a.n(n);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function l(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function p(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?l(Object(a),!0).forEach((function(t){r(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):l(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function c(e,t){if(null==e)return{};var a,n,o=function(e,t){if(null==e)return{};var a,n,o={},r=Object.keys(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var i=o.a.createContext({}),s=function(e){var t=o.a.useContext(i),a=t;return e&&(a="function"==typeof e?e(t):p({},t,{},e)),a},b=function(e){var t=s(e.components);return o.a.createElement(i.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,l=e.parentName,i=c(e,["components","mdxType","originalType","parentName"]),b=s(a),m=n,O=b["".concat(l,".").concat(m)]||b[m]||u[m]||r;return a?o.a.createElement(O,p({ref:t},i,{components:a})):o.a.createElement(O,p({ref:t},i))}));function O(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,l=new Array(r);l[0]=m;var p={};for(var c in t)hasOwnProperty.call(t,c)&&(p[c]=t[c]);p.originalType=e,p.mdxType="string"==typeof e?e:n,l[1]=p;for(var i=2;i<r;i++)l[i]=a[i];return o.a.createElement.apply(null,l)}return o.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/726258db.c102ce0a.js b/726258db.c102ce0a.js
new file mode 100644
index 00000000000..40f982f1b70
--- /dev/null
+++ b/726258db.c102ce0a.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[69],{197:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return l})),a.d(t,"metadata",(function(){return p})),a.d(t,"rightToc",(function(){return c})),a.d(t,"default",(function(){return s}));var n=a(1),o=a(9),r=(a(0),a(312)),l={id:"installation",title:"CLI Installation"},p={id:"installation",title:"CLI Installation",description:"There are a number of ways to use OpenAPI Generator. This page documents how to install the CLI artifact.",source:"@site/../docs/installation.md",permalink:"/docs/installation",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/installation.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",next:{title:"Plugins",permalink:"/docs/plugins"}},c=[{value:"npm",id:"npm",children:[]},{value:"Homebrew",id:"homebrew",children:[]},{value:"Scoop",id:"scoop",children:[]},{value:"Docker",id:"docker",children:[]},{value:"JAR",id:"jar",children:[]},{value:"Bash Launcher Script",id:"bash-launcher-script",children:[]}],i={rightToc:c};function s(e){var t=e.components,a=Object(o.a)(e,["components"]);return Object(r.b)("wrapper",Object(n.a)({},i,a,{components:t,mdxType:"MDXLayout"}),Object(r.b)("p",null,"There are a number of ways to use OpenAPI Generator. This page documents how to install the CLI artifact.\nInstalling OpenAPI Generator's CLI tool allows users to generate all available generators from the command line."),Object(r.b)("p",null,"Some of the following are cross-platform options and some are not, these are called out where possible."),Object(r.b)("h2",{id:"npm"},"npm"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows")),Object(r.b)("p",null,"The ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator-cli"}),"npm package wrapper")," is cross-platform wrapper around the .jar artifact. It works by providing a CLI wrapper atop the JAR's command line options. This gives a simple interface layer which normalizes usage of the command line across operating systems, removing some differences in how options or switches are passed to the tool (depending on OS).\n",Object(r.b)("strong",{parentName:"p"},"Install")," the latest version of the tool globally, exposing the CLI on the command line:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"npm install @openapitools/openapi-generator-cli -g\n")),Object(r.b)("p",null,"To install a specific version of the tool, pass the version during installation:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli version-manager set 5.3.0\n")),Object(r.b)("p",null,"To install the tool as a dev dependency in your current project:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"npm install @openapitools/openapi-generator-cli -D\n")),Object(r.b)("p",null,"Then, ",Object(r.b)("strong",{parentName:"p"},"generate")," a ruby client from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"npx @openapitools/openapi-generator-cli generate -i petstore.yaml -g ruby -o /tmp/test/\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("inlineCode",{parentName:"p"},"npx")," will execute a globally available ",Object(r.b)("inlineCode",{parentName:"p"},"openapi-generator"),", and if not found it will fall back to project-local commands. The result is that the above command will work regardless of which installation method you've chosen.")),Object(r.b)("h2",{id:"homebrew"},"Homebrew"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": macOS")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"Install")," via ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://brew.sh/"}),"homebrew"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"brew install openapi-generator\n")),Object(r.b)("p",null,"Then, ",Object(r.b)("strong",{parentName:"p"},"generate")," a ruby client from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -i petstore.yaml -g ruby -o /tmp/test/\n")),Object(r.b)("h2",{id:"scoop"},"Scoop"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Windows")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"Install")," via ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://scoop.sh/"}),"scoop"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{}),"scoop install openapi-generator-cli\n")),Object(r.b)("p",null,"If you don't have java installed, you can also install it via ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/ScoopInstaller/Java/"}),"scoop java bucket"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{}),"scoop bucket add java\nscoop install openjdk\n")),Object(r.b)("p",null,"Then, ",Object(r.b)("strong",{parentName:"p"},"generate")," a ruby client from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{}),"openapi-generator-cli generate -i petstore.yaml -g ruby\n")),Object(r.b)("h2",{id:"docker"},"Docker"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows")),Object(r.b)("p",null,"The OpenAPI Generator Docker image acts as a standalone executable. It can be used as an alternative to installing via homebrew, or for developers who are unable to install Java or upgrade the installed version."),Object(r.b)("p",null,"To generate code from a valid ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml")," doc with this image, you'll need to mount a local location as a volume.\nYou'll then need to output the generated code to this mapped volume. Everything else works the same as if you ran the command on your host machine."),Object(r.b)("p",null,"Here's an example generating a Go client:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"docker run --rm \\\n  -v ${PWD}:/local openapitools/openapi-generator-cli generate \\\n  -i /local/petstore.yaml \\\n  -g go \\\n  -o /local/out/go\n")),Object(r.b)("h2",{id:"jar"},"JAR"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows")),Object(r.b)("p",null,"If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):"),Object(r.b)("p",null,"JAR location: ",Object(r.b)("inlineCode",{parentName:"p"},"https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar")),Object(r.b)("p",null,"For ",Object(r.b)("strong",{parentName:"p"},"Mac/Linux")," users:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar -O openapi-generator-cli.jar\n")),Object(r.b)("p",null,"For ",Object(r.b)("strong",{parentName:"p"},"Windows")," users, you will need to install ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"http://gnuwin32.sourceforge.net/packages/wget.htm"}),"wget")," or you can use Invoke-WebRequest in PowerShell (3.0+), e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-powershell"}),"Invoke-WebRequest -OutFile openapi-generator-cli.jar https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar\n")),Object(r.b)("p",null,"After downloading the JAR, run ",Object(r.b)("inlineCode",{parentName:"p"},"java -jar openapi-generator-cli.jar help")," to show the usage."),Object(r.b)("p",null,"For Mac users, please make sure Java 8 is installed (Tips: run ",Object(r.b)("inlineCode",{parentName:"p"},"java -version")," to check the version), and export ",Object(r.b)("inlineCode",{parentName:"p"},"JAVA_HOME")," in order to use the supported Java version:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"export JAVA_HOME=`/usr/libexec/java_home -v 1.8`\nexport PATH=${JAVA_HOME}/bin:$PATH\n")),Object(r.b)("h2",{id:"bash-launcher-script"},"Bash Launcher Script"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Platform(s)"),": Linux, macOS, Windows (variable)")),Object(r.b)("p",null,"One downside to manual JAR downloads is that you don't keep up-to-date with the latest released version. We have a Bash launcher script at ",Object(r.b)("a",Object(n.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh"}),"bin/utils/openapi-generator-cli.sh")," which solves this problem."),Object(r.b)("p",null,"To install the launcher script, copy the contents of the script to a location on your path and make the script executable."),Object(r.b)("p",null,"An example of setting this up (NOTE: Always evaluate scripts curled from external systems before executing them)."),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),"mkdir -p ~/bin/openapitools\ncurl https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh > ~/bin/openapitools/openapi-generator-cli\nchmod u+x ~/bin/openapitools/openapi-generator-cli\nexport PATH=$PATH:~/bin/openapitools/\n")),Object(r.b)("p",null,"Now, ",Object(r.b)("inlineCode",{parentName:"p"},"openapi-generator-cli"),' is "installed". On invocation, it will query the GitHub repository for the most recently released version. If this matches the last downloaded jar,\nit will execute as normal. If a newer version is found, the script will download the latest release and execute it.'),Object(r.b)("p",null,"If you need to invoke an older version of the generator, you can define the variable ",Object(r.b)("inlineCode",{parentName:"p"},"OPENAPI_GENERATOR_VERSION")," either ad hoc or globally. You can export this variable if you'd like to persist a specific release version."),Object(r.b)("p",null,"Examples:"),Object(r.b)("pre",null,Object(r.b)("code",Object(n.a)({parentName:"pre"},{className:"language-bash"}),'# Execute latest released openapi-generator-cli\nopenapi-generator-cli version\n\n# Execute version 3.1.0 for the current invocation, regardless of the latest released version\nOPENAPI_GENERATOR_VERSION=3.1.0 openapi-generator-cli version\n\n# Execute version 3.1.0-SNAPSHOT for the current invocation\nOPENAPI_GENERATOR_VERSION=3.1.0-SNAPSHOT openapi-generator-cli version\n\n# Execute version 3.0.2 for every invocation in the current shell session\nexport OPENAPI_GENERATOR_VERSION=3.0.2\nopenapi-generator-cli version # is 3.0.2\nopenapi-generator-cli version # is also 3.0.2\n\n# To "install" a specific version, set the variable in .bashrc/.bash_profile\necho "export OPENAPI_GENERATOR_VERSION=3.0.2" >> ~/.bashrc\nsource ~/.bashrc\nopenapi-generator-cli version # is always 3.0.2, unless any of the above overrides are done ad hoc\n')))}s.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return b})),a.d(t,"b",(function(){return O}));var n=a(0),o=a.n(n);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function l(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function p(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?l(Object(a),!0).forEach((function(t){r(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):l(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function c(e,t){if(null==e)return{};var a,n,o=function(e,t){if(null==e)return{};var a,n,o={},r=Object.keys(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||(o[a]=e[a]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(n=0;n<r.length;n++)a=r[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(o[a]=e[a])}return o}var i=o.a.createContext({}),s=function(e){var t=o.a.useContext(i),a=t;return e&&(a="function"==typeof e?e(t):p({},t,{},e)),a},b=function(e){var t=s(e.components);return o.a.createElement(i.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,r=e.originalType,l=e.parentName,i=c(e,["components","mdxType","originalType","parentName"]),b=s(a),m=n,O=b["".concat(l,".").concat(m)]||b[m]||u[m]||r;return a?o.a.createElement(O,p({ref:t},i,{components:a})):o.a.createElement(O,p({ref:t},i))}));function O(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var r=a.length,l=new Array(r);l[0]=m;var p={};for(var c in t)hasOwnProperty.call(t,c)&&(p[c]=t[c]);p.originalType=e,p.mdxType="string"==typeof e?e:n,l[1]=p;for(var i=2;i<r;i++)l[i]=a[i];return o.a.createElement.apply(null,l)}return o.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/773b7ddf.956b3208.js b/773b7ddf.956b3208.js
new file mode 100644
index 00000000000..2dfc7c2ff32
--- /dev/null
+++ b/773b7ddf.956b3208.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[71],{199:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return i})),r.d(t,"metadata",(function(){return c})),r.d(t,"rightToc",(function(){return s})),r.d(t,"default",(function(){return p}));var n=r(1),o=r(9),a=(r(0),r(312)),i={id:"fork-qna",title:"Swagger Codegen Fork: Q&A"},c={id:"fork-qna",title:"Swagger Codegen Fork: Q&A",description:"This document aims to answer some questions about the fork for historical reference, where these questions don't fit into other documents related to the project itself.",source:"@site/../docs/qna.md",permalink:"/docs/fork-qna",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/qna.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Migrating from Swagger Codegen",permalink:"/docs/swagger-codegen-migration"},next:{title:"Release Summary",permalink:"/docs/release-summary"}},s=[{value:"Why was it decided to fork Swagger Codegen?",id:"why-was-it-decided-to-fork-swagger-codegen",children:[]},{value:"Are there any changes to the project license?",id:"are-there-any-changes-to-the-project-license",children:[]},{value:"I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?",id:"i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator",children:[]},{value:"Who maintains this Q&A page?",id:"who-maintains-this-qa-page",children:[]}],l={rightToc:s};function p(e){var t=e.components,r=Object(o.a)(e,["components"]);return Object(a.b)("wrapper",Object(n.a)({},l,r,{components:t,mdxType:"MDXLayout"}),Object(a.b)("p",null,"This document aims to answer some questions about the fork for historical reference, where these questions don't fit into other documents related to the project itself."),Object(a.b)("h2",{id:"why-was-it-decided-to-fork-swagger-codegen"},"Why was it decided to fork Swagger Codegen?"),Object(a.b)("p",null,"There are several reasons:"),Object(a.b)("ol",null,Object(a.b)("li",{parentName:"ol"},"The founding members felt that Swagger Codegen 3.0.0 was diverging too much from the philosophy of Swagger Codegen 2.x."),Object(a.b)("li",{parentName:"ol"},"The founding members were concerned that the maintenance overhead of two separate branches (2.x, 3.x) would result in issues similar to those felt in the Python community."),Object(a.b)("li",{parentName:"ol"},"The founding members wanted a more rapid ",Object(a.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/releases/"}),"release cycle")," (weekly patch release, monthly minor release) so users do not need to wait for several months to get a stable release."),Object(a.b)("li",{parentName:"ol"},"Having a community-driven version allows for innovation, reliability, and a ",Object(a.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/docs/roadmap.md"}),"roadmap")," owned by the community.")),Object(a.b)("h2",{id:"are-there-any-changes-to-the-project-license"},"Are there any changes to the project license?"),Object(a.b)("p",null,"No, OpenAPI Generator is still using the ",Object(a.b)("a",Object(n.a)({parentName:"p"},{href:"https://www.apache.org/licenses/LICENSE-2.0"}),"Apache license (version 2)"),"."),Object(a.b)("h2",{id:"i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator"},"I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?"),Object(a.b)("p",null,"OpenAPI Generator is based on Swagger Codegen ",Object(a.b)("inlineCode",{parentName:"p"},"2.4.0-SNAPSHOT")," version so the migration should be relatively straightforward. Refer to the ",Object(a.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/swagger-codegen-migration"}),"migration guide")," for more information. "),Object(a.b)("h2",{id:"who-maintains-this-qa-page"},"Who maintains this Q&A page?"),Object(a.b)("p",null,"This Q&A page is maintained by the ",Object(a.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/core-team"}),"core team members"),". It is not maintained by any single person, nor do these Q&As represent the views of any individual or person."))}p.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return d})),r.d(t,"b",(function(){return h}));var n=r(0),o=r.n(n);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?i(Object(r),!0).forEach((function(t){a(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):i(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function s(e,t){if(null==e)return{};var r,n,o=function(e,t){if(null==e)return{};var r,n,o={},a=Object.keys(e);for(n=0;n<a.length;n++)r=a[n],t.indexOf(r)>=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n<a.length;n++)r=a[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var l=o.a.createContext({}),p=function(e){var t=o.a.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):c({},t,{},e)),r},d=function(e){var t=p(e.components);return o.a.createElement(l.Provider,{value:t},e.children)},g={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},u=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,a=e.originalType,i=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),d=p(r),u=n,h=d["".concat(i,".").concat(u)]||d[u]||g[u]||a;return r?o.a.createElement(h,c({ref:t},l,{components:r})):o.a.createElement(h,c({ref:t},l))}));function h(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var a=r.length,i=new Array(a);i[0]=u;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:n,i[1]=c;for(var l=2;l<a;l++)i[l]=r[l];return o.a.createElement.apply(null,i)}return o.a.createElement.apply(null,r)}u.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/773b7ddf.efe0e210.js b/773b7ddf.efe0e210.js
deleted file mode 100644
index 2525f2ecb63..00000000000
--- a/773b7ddf.efe0e210.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[71],{199:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return i})),r.d(t,"metadata",(function(){return c})),r.d(t,"rightToc",(function(){return s})),r.d(t,"default",(function(){return p}));var n=r(1),o=r(9),a=(r(0),r(312)),i={id:"fork-qna",title:"Swagger Codegen Fork: Q&A"},c={id:"fork-qna",title:"Swagger Codegen Fork: Q&A",description:"This document aims to answer some questions about the fork for historical reference, where these questions don't fit into other documents related to the project itself.",source:"@site/../docs/qna.md",permalink:"/docs/fork-qna",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/qna.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Migrating from Swagger Codegen",permalink:"/docs/swagger-codegen-migration"},next:{title:"Release Summary",permalink:"/docs/release-summary"}},s=[{value:"Why was it decided to fork Swagger Codegen?",id:"why-was-it-decided-to-fork-swagger-codegen",children:[]},{value:"Are there any changes to the project license?",id:"are-there-any-changes-to-the-project-license",children:[]},{value:"I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?",id:"i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator",children:[]},{value:"Who maintains this Q&A page?",id:"who-maintains-this-qa-page",children:[]}],l={rightToc:s};function p(e){var t=e.components,r=Object(o.a)(e,["components"]);return Object(a.b)("wrapper",Object(n.a)({},l,r,{components:t,mdxType:"MDXLayout"}),Object(a.b)("p",null,"This document aims to answer some questions about the fork for historical reference, where these questions don't fit into other documents related to the project itself."),Object(a.b)("h2",{id:"why-was-it-decided-to-fork-swagger-codegen"},"Why was it decided to fork Swagger Codegen?"),Object(a.b)("p",null,"There are several reasons:"),Object(a.b)("ol",null,Object(a.b)("li",{parentName:"ol"},"The founding members felt that Swagger Codegen 3.0.0 was diverging too much from the philosophy of Swagger Codegen 2.x."),Object(a.b)("li",{parentName:"ol"},"The founding members were concerned that the maintenance overhead of two separate branches (2.x, 3.x) would result in issues similar to those felt in the Python community."),Object(a.b)("li",{parentName:"ol"},"The founding members wanted a more rapid ",Object(a.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/releases/"}),"release cycle")," (weekly patch release, monthly minor release) so users do not need to wait for several months to get a stable release."),Object(a.b)("li",{parentName:"ol"},"Having a community-driven version allows for innovation, reliability, and a ",Object(a.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/docs/roadmap.md"}),"roadmap")," owned by the community.")),Object(a.b)("h2",{id:"are-there-any-changes-to-the-project-license"},"Are there any changes to the project license?"),Object(a.b)("p",null,"No, OpenAPI Generator is still using the ",Object(a.b)("a",Object(n.a)({parentName:"p"},{href:"https://www.apache.org/licenses/LICENSE-2.0"}),"Apache license (version 2)"),"."),Object(a.b)("h2",{id:"i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator"},"I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?"),Object(a.b)("p",null,"OpenAPI Generator is based on Swagger Codegen ",Object(a.b)("inlineCode",{parentName:"p"},"2.4.0-SNAPSHOT")," version so the migration should be relatively straightforward. Refer to the ",Object(a.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/swagger-codegen-migration"}),"migration guide")," for more information. "),Object(a.b)("h2",{id:"who-maintains-this-qa-page"},"Who maintains this Q&A page?"),Object(a.b)("p",null,"This Q&A page is maintained by the ",Object(a.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/core-team"}),"core team members"),". It is not maintained by any single person, nor do these Q&As represent the views of any individual or person."))}p.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return d})),r.d(t,"b",(function(){return h}));var n=r(0),o=r.n(n);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function c(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?i(Object(r),!0).forEach((function(t){a(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):i(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function s(e,t){if(null==e)return{};var r,n,o=function(e,t){if(null==e)return{};var r,n,o={},a=Object.keys(e);for(n=0;n<a.length;n++)r=a[n],t.indexOf(r)>=0||(o[r]=e[r]);return o}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n<a.length;n++)r=a[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(o[r]=e[r])}return o}var l=o.a.createContext({}),p=function(e){var t=o.a.useContext(l),r=t;return e&&(r="function"==typeof e?e(t):c({},t,{},e)),r},d=function(e){var t=p(e.components);return o.a.createElement(l.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},g=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,a=e.originalType,i=e.parentName,l=s(e,["components","mdxType","originalType","parentName"]),d=p(r),g=n,h=d["".concat(i,".").concat(g)]||d[g]||u[g]||a;return r?o.a.createElement(h,c({ref:t},l,{components:r})):o.a.createElement(h,c({ref:t},l))}));function h(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var a=r.length,i=new Array(a);i[0]=g;var c={};for(var s in t)hasOwnProperty.call(t,s)&&(c[s]=t[s]);c.originalType=e,c.mdxType="string"==typeof e?e:n,i[1]=c;for(var l=2;l<a;l++)i[l]=r[l];return o.a.createElement.apply(null,i)}return o.a.createElement.apply(null,r)}g.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/7eeb204a.287f1ae6.js b/7eeb204a.287f1ae6.js
deleted file mode 100644
index 7647bf65c62..00000000000
--- a/7eeb204a.287f1ae6.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[78],{206:function(e,a,t){"use strict";t.r(a),t.d(a,"frontMatter",(function(){return n})),t.d(a,"metadata",(function(){return l})),t.d(a,"rightToc",(function(){return s})),t.d(a,"default",(function(){return o}));var r=t(1),c=t(9),b=(t(0),t(312)),n={},l={id:"generators/README",title:"README",description:"\x3c!-- Generate with: openapi-generator list --github-nested-index --\x3e",source:"@site/../docs/generators/README.md",permalink:"/docs/generators/README",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/README.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142},s=[{value:"CLIENT generators",id:"client-generators",children:[]},{value:"SERVER generators",id:"server-generators",children:[]},{value:"DOCUMENTATION generators",id:"documentation-generators",children:[]},{value:"SCHEMA generators",id:"schema-generators",children:[]},{value:"CONFIG generators",id:"config-generators",children:[]}],p={rightToc:s};function o(e){var a=e.components,t=Object(c.a)(e,["components"]);return Object(b.b)("wrapper",Object(r.a)({},p,t,{components:a,mdxType:"MDXLayout"}),Object(b.b)("p",null,"The following generators are available:"),Object(b.b)("h2",{id:"client-generators"},"CLIENT generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ada"}),"ada"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/android"}),"android"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/apex"}),"apex"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/bash"}),"bash"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/c"}),"c"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/clojure"}),"clojure"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"cpp-qt5-client.md"}),"cpp-qt5-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-restsdk"}),"cpp-restsdk"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-tizen"}),"cpp-tizen"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/csharp"}),"csharp"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/csharp-netcore"}),"csharp-netcore"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/dart"}),"dart"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"dart-dio.md"}),"dart-dio"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/eiffel"}),"eiffel"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/elixir"}),"elixir"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/elm"}),"elm"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/erlang-client"}),"erlang-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/erlang-proper"}),"erlang-proper"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go"}),"go"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go-experimental"}),"go-experimental (experimental)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/groovy"}),"groovy"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/haskell-http-client"}),"haskell-http-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java"}),"java"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/javascript"}),"javascript"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/javascript-closure-angular"}),"javascript-closure-angular"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/javascript-flowtyped"}),"javascript-flowtyped"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf-client"}),"jaxrs-cxf-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jmeter"}),"jmeter"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin"}),"kotlin"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/lua"}),"lua"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/nim"}),"nim (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/objc"}),"objc"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ocaml"}),"ocaml"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/perl"}),"perl"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php"}),"php"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-dt"}),"php-dt"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/powershell"}),"powershell"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python"}),"python")),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-legacy"}),"python-legacy")),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/r"}),"r"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ruby"}),"ruby"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/rust"}),"rust"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-akka"}),"scala-akka"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-gatling"}),"scala-gatling"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scalaz"}),"scalaz"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"swift4.md"}),"swift4"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/swift5"}),"swift5 (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-angular"}),"typescript-angular"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"typescript-angularjs.md"}),"typescript-angularjs"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-aurelia"}),"typescript-aurelia"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-axios"}),"typescript-axios"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-fetch"}),"typescript-fetch"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-inversify"}),"typescript-inversify"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-jquery"}),"typescript-jquery"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-node"}),"typescript-node"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-redux-query"}),"typescript-redux-query"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-rxjs"}),"typescript-rxjs"),"  ")),Object(b.b)("h2",{id:"server-generators"},"SERVER generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ada-server"}),"ada-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/aspnetcore"}),"aspnetcore"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-pistache-server"}),"cpp-pistache-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"cpp-qt5-qhttpengine-server.md"}),"cpp-qt5-qhttpengine-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-restbed-server"}),"cpp-restbed-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/erlang-server"}),"erlang-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/fsharp-functions"}),"fsharp-functions (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/fsharp-giraffe-server"}),"fsharp-giraffe-server (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go-gin-server"}),"go-gin-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go-server"}),"go-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/graphql-nodejs-express-server"}),"graphql-nodejs-express-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/haskell"}),"haskell"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-inflector"}),"java-inflector"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-msf4j"}),"java-msf4j"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-pkmst"}),"java-pkmst"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-play-framework"}),"java-play-framework"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-undertow-server"}),"java-undertow-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-vertx"}),"java-vertx"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-vertx-web"}),"java-vertx-web (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf"}),"jaxrs-cxf"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf-cdi"}),"jaxrs-cxf-cdi"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf-extended"}),"jaxrs-cxf-extended"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-jersey"}),"jaxrs-jersey"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-resteasy"}),"jaxrs-resteasy"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-resteasy-eap"}),"jaxrs-resteasy-eap"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-spec"}),"jaxrs-spec"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin-server"}),"kotlin-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin-spring"}),"kotlin-spring"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin-vertx"}),"kotlin-vertx (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/nodejs-express-server"}),"nodejs-express-server (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-laravel"}),"php-laravel"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-lumen"}),"php-lumen"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-mezzio-ph"}),"php-mezzio-ph"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-slim4"}),"php-slim4"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-symfony"}),"php-symfony"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-aiohttp"}),"python-aiohttp"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-blueplanet"}),"python-blueplanet"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-flask"}),"python-flask"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ruby-on-rails"}),"ruby-on-rails"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ruby-sinatra"}),"ruby-sinatra"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/rust-server"}),"rust-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-finch"}),"scala-finch"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-lagom-server"}),"scala-lagom-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-play-server"}),"scala-play-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scalatra"}),"scalatra"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/spring"}),"spring"),"  ")),Object(b.b)("h2",{id:"documentation-generators"},"DOCUMENTATION generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/asciidoc"}),"asciidoc"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cwiki"}),"cwiki"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/dynamic-html"}),"dynamic-html"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/html"}),"html"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/html2"}),"html2"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/markdown"}),"markdown (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/openapi"}),"openapi"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/openapi-yaml"}),"openapi-yaml"),"  ")),Object(b.b)("h2",{id:"schema-generators"},"SCHEMA generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/avro-schema"}),"avro-schema (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/mysql-schema"}),"mysql-schema"),"  ")),Object(b.b)("h2",{id:"config-generators"},"CONFIG generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/apache2"}),"apache2"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/graphql-schema"}),"graphql-schema"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/protobuf-schema"}),"protobuf-schema (beta)"),"  ")))}o.isMDXComponent=!0},312:function(e,a,t){"use strict";t.d(a,"a",(function(){return i})),t.d(a,"b",(function(){return m}));var r=t(0),c=t.n(r);function b(e,a,t){return a in e?Object.defineProperty(e,a,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[a]=t,e}function n(e,a){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);a&&(r=r.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),t.push.apply(t,r)}return t}function l(e){for(var a=1;a<arguments.length;a++){var t=null!=arguments[a]?arguments[a]:{};a%2?n(Object(t),!0).forEach((function(a){b(e,a,t[a])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):n(Object(t)).forEach((function(a){Object.defineProperty(e,a,Object.getOwnPropertyDescriptor(t,a))}))}return e}function s(e,a){if(null==e)return{};var t,r,c=function(e,a){if(null==e)return{};var t,r,c={},b=Object.keys(e);for(r=0;r<b.length;r++)t=b[r],a.indexOf(t)>=0||(c[t]=e[t]);return c}(e,a);if(Object.getOwnPropertySymbols){var b=Object.getOwnPropertySymbols(e);for(r=0;r<b.length;r++)t=b[r],a.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(c[t]=e[t])}return c}var p=c.a.createContext({}),o=function(e){var a=c.a.useContext(p),t=a;return e&&(t="function"==typeof e?e(a):l({},a,{},e)),t},i=function(e){var a=o(e.components);return c.a.createElement(p.Provider,{value:a},e.children)},j={inlineCode:"code",wrapper:function(e){var a=e.children;return c.a.createElement(c.a.Fragment,{},a)}},O=Object(r.forwardRef)((function(e,a){var t=e.components,r=e.mdxType,b=e.originalType,n=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),i=o(t),O=r,m=i["".concat(n,".").concat(O)]||i[O]||j[O]||b;return t?c.a.createElement(m,l({ref:a},p,{components:t})):c.a.createElement(m,l({ref:a},p))}));function m(e,a){var t=arguments,r=a&&a.mdxType;if("string"==typeof e||r){var b=t.length,n=new Array(b);n[0]=O;var l={};for(var s in a)hasOwnProperty.call(a,s)&&(l[s]=a[s]);l.originalType=e,l.mdxType="string"==typeof e?e:r,n[1]=l;for(var p=2;p<b;p++)n[p]=t[p];return c.a.createElement.apply(null,n)}return c.a.createElement.apply(null,t)}O.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/7eeb204a.89e49b42.js b/7eeb204a.89e49b42.js
new file mode 100644
index 00000000000..bcd7866a5fb
--- /dev/null
+++ b/7eeb204a.89e49b42.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[78],{206:function(e,a,t){"use strict";t.r(a),t.d(a,"frontMatter",(function(){return n})),t.d(a,"metadata",(function(){return l})),t.d(a,"rightToc",(function(){return s})),t.d(a,"default",(function(){return i}));var r=t(1),c=t(9),b=(t(0),t(312)),n={},l={id:"generators/README",title:"README",description:"\x3c!-- Generate with: openapi-generator list --github-nested-index --\x3e",source:"@site/../docs/generators/README.md",permalink:"/docs/generators/README",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/README.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635},s=[{value:"CLIENT generators",id:"client-generators",children:[]},{value:"SERVER generators",id:"server-generators",children:[]},{value:"DOCUMENTATION generators",id:"documentation-generators",children:[]},{value:"SCHEMA generators",id:"schema-generators",children:[]},{value:"CONFIG generators",id:"config-generators",children:[]}],p={rightToc:s};function i(e){var a=e.components,t=Object(c.a)(e,["components"]);return Object(b.b)("wrapper",Object(r.a)({},p,t,{components:a,mdxType:"MDXLayout"}),Object(b.b)("p",null,"The following generators are available:"),Object(b.b)("h2",{id:"client-generators"},"CLIENT generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ada"}),"ada"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/android"}),"android"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/apex"}),"apex"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/bash"}),"bash"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/c"}),"c"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/clojure"}),"clojure"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"cpp-qt5-client.md"}),"cpp-qt5-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-restsdk"}),"cpp-restsdk"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-tizen"}),"cpp-tizen"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/csharp"}),"csharp"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/csharp-netcore"}),"csharp-netcore"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/dart"}),"dart"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"dart-dio.md"}),"dart-dio"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/eiffel"}),"eiffel"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/elixir"}),"elixir"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/elm"}),"elm"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/erlang-client"}),"erlang-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/erlang-proper"}),"erlang-proper"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go"}),"go"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go-experimental"}),"go-experimental (experimental)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/groovy"}),"groovy"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/haskell-http-client"}),"haskell-http-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java"}),"java"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/javascript"}),"javascript"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/javascript-closure-angular"}),"javascript-closure-angular"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/javascript-flowtyped"}),"javascript-flowtyped"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf-client"}),"jaxrs-cxf-client"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jmeter"}),"jmeter"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin"}),"kotlin"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/lua"}),"lua"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/nim"}),"nim (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/objc"}),"objc"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ocaml"}),"ocaml"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/perl"}),"perl"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php"}),"php"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-dt"}),"php-dt"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/powershell"}),"powershell"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python"}),"python")),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-legacy"}),"python-legacy")),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/r"}),"r"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ruby"}),"ruby"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/rust"}),"rust"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-akka"}),"scala-akka"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-gatling"}),"scala-gatling"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scalaz"}),"scalaz"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"swift4.md"}),"swift4"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/swift5"}),"swift5 (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-angular"}),"typescript-angular"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"typescript-angularjs.md"}),"typescript-angularjs"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-aurelia"}),"typescript-aurelia"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-axios"}),"typescript-axios"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-fetch"}),"typescript-fetch"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-inversify"}),"typescript-inversify"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-jquery"}),"typescript-jquery"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-node"}),"typescript-node"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-redux-query"}),"typescript-redux-query"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/typescript-rxjs"}),"typescript-rxjs"),"  ")),Object(b.b)("h2",{id:"server-generators"},"SERVER generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ada-server"}),"ada-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/aspnetcore"}),"aspnetcore"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-pistache-server"}),"cpp-pistache-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"cpp-qt5-qhttpengine-server.md"}),"cpp-qt5-qhttpengine-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cpp-restbed-server"}),"cpp-restbed-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/erlang-server"}),"erlang-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/fsharp-functions"}),"fsharp-functions (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/fsharp-giraffe-server"}),"fsharp-giraffe-server (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go-gin-server"}),"go-gin-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/go-server"}),"go-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/graphql-nodejs-express-server"}),"graphql-nodejs-express-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/haskell"}),"haskell"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-inflector"}),"java-inflector"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-msf4j"}),"java-msf4j"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-pkmst"}),"java-pkmst"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-play-framework"}),"java-play-framework"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-undertow-server"}),"java-undertow-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-vertx"}),"java-vertx"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/java-vertx-web"}),"java-vertx-web (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf"}),"jaxrs-cxf"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf-cdi"}),"jaxrs-cxf-cdi"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-cxf-extended"}),"jaxrs-cxf-extended"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-jersey"}),"jaxrs-jersey"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-resteasy"}),"jaxrs-resteasy"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-resteasy-eap"}),"jaxrs-resteasy-eap"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/jaxrs-spec"}),"jaxrs-spec"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin-server"}),"kotlin-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin-spring"}),"kotlin-spring"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/kotlin-vertx"}),"kotlin-vertx (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/nodejs-express-server"}),"nodejs-express-server (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-laravel"}),"php-laravel"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-lumen"}),"php-lumen"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-mezzio-ph"}),"php-mezzio-ph"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-slim4"}),"php-slim4"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/php-symfony"}),"php-symfony"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-aiohttp"}),"python-aiohttp"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-blueplanet"}),"python-blueplanet"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/python-flask"}),"python-flask"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ruby-on-rails"}),"ruby-on-rails"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/ruby-sinatra"}),"ruby-sinatra"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/rust-server"}),"rust-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-finch"}),"scala-finch"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-lagom-server"}),"scala-lagom-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scala-play-server"}),"scala-play-server"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/scalatra"}),"scalatra"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/spring"}),"spring"),"  ")),Object(b.b)("h2",{id:"documentation-generators"},"DOCUMENTATION generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/asciidoc"}),"asciidoc"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/cwiki"}),"cwiki"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/dynamic-html"}),"dynamic-html"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/html"}),"html"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/html2"}),"html2"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/markdown"}),"markdown (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/openapi"}),"openapi"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/openapi-yaml"}),"openapi-yaml"),"  ")),Object(b.b)("h2",{id:"schema-generators"},"SCHEMA generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/avro-schema"}),"avro-schema (beta)"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/mysql-schema"}),"mysql-schema"),"  ")),Object(b.b)("h2",{id:"config-generators"},"CONFIG generators"),Object(b.b)("ul",null,Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/apache2"}),"apache2"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/graphql-schema"}),"graphql-schema"),"  "),Object(b.b)("li",{parentName:"ul"},Object(b.b)("a",Object(r.a)({parentName:"li"},{href:"/docs/generators/protobuf-schema"}),"protobuf-schema (beta)"),"  ")))}i.isMDXComponent=!0},312:function(e,a,t){"use strict";t.d(a,"a",(function(){return o})),t.d(a,"b",(function(){return m}));var r=t(0),c=t.n(r);function b(e,a,t){return a in e?Object.defineProperty(e,a,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[a]=t,e}function n(e,a){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);a&&(r=r.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),t.push.apply(t,r)}return t}function l(e){for(var a=1;a<arguments.length;a++){var t=null!=arguments[a]?arguments[a]:{};a%2?n(Object(t),!0).forEach((function(a){b(e,a,t[a])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):n(Object(t)).forEach((function(a){Object.defineProperty(e,a,Object.getOwnPropertyDescriptor(t,a))}))}return e}function s(e,a){if(null==e)return{};var t,r,c=function(e,a){if(null==e)return{};var t,r,c={},b=Object.keys(e);for(r=0;r<b.length;r++)t=b[r],a.indexOf(t)>=0||(c[t]=e[t]);return c}(e,a);if(Object.getOwnPropertySymbols){var b=Object.getOwnPropertySymbols(e);for(r=0;r<b.length;r++)t=b[r],a.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(c[t]=e[t])}return c}var p=c.a.createContext({}),i=function(e){var a=c.a.useContext(p),t=a;return e&&(t="function"==typeof e?e(a):l({},a,{},e)),t},o=function(e){var a=i(e.components);return c.a.createElement(p.Provider,{value:a},e.children)},j={inlineCode:"code",wrapper:function(e){var a=e.children;return c.a.createElement(c.a.Fragment,{},a)}},O=Object(r.forwardRef)((function(e,a){var t=e.components,r=e.mdxType,b=e.originalType,n=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),o=i(t),O=r,m=o["".concat(n,".").concat(O)]||o[O]||j[O]||b;return t?c.a.createElement(m,l({ref:a},p,{components:t})):c.a.createElement(m,l({ref:a},p))}));function m(e,a){var t=arguments,r=a&&a.mdxType;if("string"==typeof e||r){var b=t.length,n=new Array(b);n[0]=O;var l={};for(var s in a)hasOwnProperty.call(a,s)&&(l[s]=a[s]);l.originalType=e,l.mdxType="string"==typeof e?e:r,n[1]=l;for(var p=2;p<b;p++)n[p]=t[p];return c.a.createElement.apply(null,n)}return c.a.createElement.apply(null,t)}O.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/838bab07.4c814ca2.js b/838bab07.4c814ca2.js
new file mode 100644
index 00000000000..9bdae941797
--- /dev/null
+++ b/838bab07.4c814ca2.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[79],{207:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return u}));var r=n(1),a=n(9),o=(n(0),n(312)),i={id:"contribute-building",title:"Building the code"},c={id:"contribute-building",title:"Building the code",description:"## Using Maven",source:"@site/../docs/building.md",permalink:"/docs/contribute-building",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/building.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Code of Conduct",permalink:"/docs/code-of-conduct"},next:{title:"Create a New Generator",permalink:"/docs/new-generator"}},l=[{value:"Using Maven",id:"using-maven",children:[]},{value:"Using Docker",id:"using-docker",children:[{value:"Docker in Vagrant",id:"docker-in-vagrant",children:[]},{value:"Troubleshooting",id:"troubleshooting",children:[]}]}],p={rightToc:l};function u(e){var t=e.components,n=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(r.a)({},p,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"using-maven"},"Using Maven"),Object(o.b)("p",null,"To build from source, you need the following installed and available in your ",Object(o.b)("inlineCode",{parentName:"p"},"$PATH:")),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://java.oracle.com"}),"Java 8"))),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://maven.apache.org/"}),"Apache maven 3.3.4 or greater")))),Object(o.b)("p",null,"After cloning the project, you can build it from source with this command:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"mvn clean install\n")),Object(o.b)("p",null,"If you don't have maven installed, you may directly use the included ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/takari/maven-wrapper"}),"maven wrapper"),", and build with the command:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"./mvnw clean install\n")),Object(o.b)("h2",{id:"using-docker"},"Using Docker"),Object(o.b)("p",null,"You can use ",Object(o.b)("inlineCode",{parentName:"p"},"run-in-docker.sh")," to do all development. This script maps your local repository to ",Object(o.b)("inlineCode",{parentName:"p"},"/gen"),"\nin the docker container. It also maps ",Object(o.b)("inlineCode",{parentName:"p"},"~/.m2/repository")," to the appropriate container location."),Object(o.b)("p",null,"To execute ",Object(o.b)("inlineCode",{parentName:"p"},"mvn package"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"git clone https://github.com/openapitools/openapi-generator\ncd openapi-generator\n./run-in-docker.sh mvn package\n")),Object(o.b)("p",null,"Build artifacts are now accessible in your working directory."),Object(o.b)("p",null,"Once built, ",Object(o.b)("inlineCode",{parentName:"p"},"run-in-docker.sh")," will act as an executable for openapi-generator-cli. To generate code, you'll need to output to a directory under ",Object(o.b)("inlineCode",{parentName:"p"},"/gen")," (e.g. ",Object(o.b)("inlineCode",{parentName:"p"},"/gen/out"),"). For example:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli\n./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli\n./run-in-docker.sh /gen/bin/generate-samples.sh /gen/bin/configs/go-petstore.yaml  # Builds the Go client\n./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n    -g go -o /gen/out/go-petstore -p packageName=petstore # generates go client, outputs locally to ./out/go-petstore\n")),Object(o.b)("h3",{id:"docker-in-vagrant"},"Docker in Vagrant"),Object(o.b)("p",null,"Prerequisite: install ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://www.vagrantup.com/downloads.html"}),"Vagrant")," and ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://www.virtualbox.org/wiki/Downloads"}),"VirtualBox"),"."),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator\nvagrant up\nvagrant ssh\ncd /vagrant\n./run-in-docker.sh mvn package\n")),Object(o.b)("h3",{id:"troubleshooting"},"Troubleshooting"),Object(o.b)("p",null,"If an error like this occurs, just execute the ",Object(o.b)("strong",{parentName:"p"},"mvn clean install -U")," command:"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test (default-test) on project openapi-generator: A type incompatibility occurred while executing org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test: java.lang.ExceptionInInitializerError cannot be cast to java.io.IOException")),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"./run-in-docker.sh mvn clean install -U\n")),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Failed to execute goal org.fortasoft:gradle-maven-plugin:1.0.8:invoke (default) on project openapi-generator-gradle-plugin-mvn-wrapper: org.gradle.tooling.BuildException: Could not execute build using Gradle distribution '",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://services.gradle.org/distributions/gradle-4.7-bin.zip"}),"https://services.gradle.org/distributions/gradle-4.7-bin.zip"),"'")),Object(o.b)("p",null,"Right now: no solution for this one :|"))}u.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return g}));var r=n(0),a=n.n(r);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=a.a.createContext({}),u=function(e){var t=a.a.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},b=function(e){var t=u(e.components);return a.a.createElement(p.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},d=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,i=e.parentName,p=l(e,["components","mdxType","originalType","parentName"]),b=u(n),d=r,g=b["".concat(i,".").concat(d)]||b[d]||s[d]||o;return n?a.a.createElement(g,c({ref:t},p,{components:n})):a.a.createElement(g,c({ref:t},p))}));function g(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,i=new Array(o);i[0]=d;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:r,i[1]=c;for(var p=2;p<o;p++)i[p]=n[p];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/838bab07.e5a68e27.js b/838bab07.e5a68e27.js
deleted file mode 100644
index be8f24007f7..00000000000
--- a/838bab07.e5a68e27.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[79],{207:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return c})),n.d(t,"metadata",(function(){return i})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return u}));var r=n(1),a=n(9),o=(n(0),n(312)),c={id:"contribute-building",title:"Building the code"},i={id:"contribute-building",title:"Building the code",description:"## Using Maven",source:"@site/../docs/building.md",permalink:"/docs/contribute-building",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/building.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Code of Conduct",permalink:"/docs/code-of-conduct"},next:{title:"Create a New Generator",permalink:"/docs/new-generator"}},l=[{value:"Using Maven",id:"using-maven",children:[]},{value:"Using Docker",id:"using-docker",children:[{value:"Docker in Vagrant",id:"docker-in-vagrant",children:[]},{value:"Troubleshooting",id:"troubleshooting",children:[]}]}],p={rightToc:l};function u(e){var t=e.components,n=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(r.a)({},p,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"using-maven"},"Using Maven"),Object(o.b)("p",null,"To build from source, you need the following installed and available in your ",Object(o.b)("inlineCode",{parentName:"p"},"$PATH:")),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://java.oracle.com"}),"Java 8"))),Object(o.b)("li",{parentName:"ul"},Object(o.b)("p",{parentName:"li"},Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://maven.apache.org/"}),"Apache maven 3.3.4 or greater")))),Object(o.b)("p",null,"After cloning the project, you can build it from source with this command:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"mvn clean install\n")),Object(o.b)("p",null,"If you don't have maven installed, you may directly use the included ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/takari/maven-wrapper"}),"maven wrapper"),", and build with the command:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"./mvnw clean install\n")),Object(o.b)("h2",{id:"using-docker"},"Using Docker"),Object(o.b)("p",null,"You can use ",Object(o.b)("inlineCode",{parentName:"p"},"run-in-docker.sh")," to do all development. This script maps your local repository to ",Object(o.b)("inlineCode",{parentName:"p"},"/gen"),"\nin the docker container. It also maps ",Object(o.b)("inlineCode",{parentName:"p"},"~/.m2/repository")," to the appropriate container location."),Object(o.b)("p",null,"To execute ",Object(o.b)("inlineCode",{parentName:"p"},"mvn package"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"git clone https://github.com/openapitools/openapi-generator\ncd openapi-generator\n./run-in-docker.sh mvn package\n")),Object(o.b)("p",null,"Build artifacts are now accessible in your working directory."),Object(o.b)("p",null,"Once built, ",Object(o.b)("inlineCode",{parentName:"p"},"run-in-docker.sh")," will act as an executable for openapi-generator-cli. To generate code, you'll need to output to a directory under ",Object(o.b)("inlineCode",{parentName:"p"},"/gen")," (e.g. ",Object(o.b)("inlineCode",{parentName:"p"},"/gen/out"),"). For example:"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli\n./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli\n./run-in-docker.sh /gen/bin/generate-samples.sh /gen/bin/configs/go-petstore.yaml  # Builds the Go client\n./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n    -g go -o /gen/out/go-petstore -p packageName=petstore # generates go client, outputs locally to ./out/go-petstore\n")),Object(o.b)("h3",{id:"docker-in-vagrant"},"Docker in Vagrant"),Object(o.b)("p",null,"Prerequisite: install ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://www.vagrantup.com/downloads.html"}),"Vagrant")," and ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://www.virtualbox.org/wiki/Downloads"}),"VirtualBox"),"."),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"git clone https://github.com/openapitools/openapi-generator.git\ncd openapi-generator\nvagrant up\nvagrant ssh\ncd /vagrant\n./run-in-docker.sh mvn package\n")),Object(o.b)("h3",{id:"troubleshooting"},"Troubleshooting"),Object(o.b)("p",null,"If an error like this occurs, just execute the ",Object(o.b)("strong",{parentName:"p"},"mvn clean install -U")," command:"),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test (default-test) on project openapi-generator: A type incompatibility occurred while executing org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test: java.lang.ExceptionInInitializerError cannot be cast to java.io.IOException")),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-bash"}),"./run-in-docker.sh mvn clean install -U\n")),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"Failed to execute goal org.fortasoft:gradle-maven-plugin:1.0.8:invoke (default) on project openapi-generator-gradle-plugin-mvn-wrapper: org.gradle.tooling.BuildException: Could not execute build using Gradle distribution '",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://services.gradle.org/distributions/gradle-4.7-bin.zip"}),"https://services.gradle.org/distributions/gradle-4.7-bin.zip"),"'")),Object(o.b)("p",null,"Right now: no solution for this one :|"))}u.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return g}));var r=n(0),a=n.n(r);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function c(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function i(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?c(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):c(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=a.a.createContext({}),u=function(e){var t=a.a.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):i({},t,{},e)),n},b=function(e){var t=u(e.components);return a.a.createElement(p.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},d=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,c=e.parentName,p=l(e,["components","mdxType","originalType","parentName"]),b=u(n),d=r,g=b["".concat(c,".").concat(d)]||b[d]||s[d]||o;return n?a.a.createElement(g,i({ref:t},p,{components:n})):a.a.createElement(g,i({ref:t},p))}));function g(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,c=new Array(o);c[0]=d;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:r,c[1]=i;for(var p=2;p<o;p++)c[p]=n[p];return a.a.createElement.apply(null,c)}return a.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/912fe03d.5abc8bcb.js b/912fe03d.5abc8bcb.js
deleted file mode 100644
index 55e3b957782..00000000000
--- a/912fe03d.5abc8bcb.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[88],{216:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return r})),n.d(t,"metadata",(function(){return p})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return c}));var a=n(1),o=n(9),i=(n(0),n(312)),r={id:"usage",title:"Usage"},p={id:"usage",title:"Usage",description:"Options for OpenAPI Generator are the same whether you're using the CLI, Maven/Gradle Plugins, or Online generation options.",source:"@site/../docs/usage.md",permalink:"/docs/usage",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/usage.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Online",permalink:"/docs/online"},next:{title:"Global Properties",permalink:"/docs/globals"}},l=[{value:"help",id:"help",children:[]},{value:"version",id:"version",children:[]},{value:"list",id:"list",children:[]},{value:"config-help",id:"config-help",children:[]},{value:"meta",id:"meta",children:[]},{value:"validate",id:"validate",children:[]},{value:"completion",id:"completion",children:[]},{value:"generate",id:"generate",children:[{value:"Examples",id:"examples",children:[]},{value:"Target External Models",id:"target-external-models",children:[]}]},{value:"batch",id:"batch",children:[]},{value:"author",id:"author",children:[{value:"template",id:"template",children:[]}]}],s={rightToc:l};function c(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("p",null,"Options for OpenAPI Generator are the same whether you're using the CLI, Maven/Gradle Plugins, or Online generation options.\nThis page demonstrates navigating the options via CLI. Commands are presented here in a logical progression as a tutorial, but you're welcome to skip directly to the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"#generate"}),"generate")," command."),Object(i.b)("h2",{id:"help"},"help"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"help")," option lists all commands available to the CLI."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help\nusage: openapi-generator-cli <command> [<args>]\n\nThe most commonly used openapi-generator-cli commands are:\n    author        Utilities for authoring generators or customizing templates.\n    batch         Generate code in batch via external configs.\n    config-help   Config help for chosen lang\n    generate      Generate code with the specified generator.\n    help          Display help information about openapi-generator\n    list          Lists the available generators\n    meta          MetaGenerator. Generator for creating a new template set and configuration for Codegen.  The output will be based on the language you specify, and includes default templates to include.\n    validate      Validate specification\n    version       Show version information used in tooling\n\nSee 'openapi-generator-cli help <command>' for more information on a specific\ncommand.\n")),Object(i.b)("h2",{id:"version"},"version"),Object(i.b)("p",null,"The version command provides version information, returning either the version by default, the git commit sha when passed ",Object(i.b)("inlineCode",{parentName:"p"},"--sha"),", or verbose output when passed ",Object(i.b)("inlineCode",{parentName:"p"},"--full"),"."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"NAME\n        openapi-generator-cli version - Show version information used in tooling\n\nSYNOPSIS\n        openapi-generator-cli version [--full] [--sha]\n\nOPTIONS\n        --full\n            Full version details\n\n        --sha\n            Git commit SHA version\n")),Object(i.b)("h2",{id:"list"},"list"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"list")," command outputs a formatted list of every available generator. Pass the ",Object(i.b)("inlineCode",{parentName:"p"},"-s/--short")," option if you would like a CSV output for easy parsing."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help list\nNAME\n        openapi-generator-cli list - Lists the available generators\n\nSYNOPSIS\n        openapi-generator-cli list [(-i <include> | --include <include>)]\n                [(-s | --short)]\n\nOPTIONS\n        -i <include>, --include <include>\n            comma-separated list of stability indexes to include (value:\n            all,beta,stable,experimental,deprecated). Excludes deprecated by\n            default.\n\n        -s, --short\n            shortened output (suitable for scripting)\n")),Object(i.b)("p",null,"Example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli list -s | tr ',' '\\n'\n")),Object(i.b)("p",null,"For the full list of generators, refer to the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/generators"}),"Generators List"),"."),Object(i.b)("h2",{id:"config-help"},"config-help"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"config-help")," option provides details about "),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help config-help\nNAME\n        openapi-generator-cli config-help - Config help for chosen lang\n\nSYNOPSIS\n        openapi-generator-cli config-help\n                [(-f <output format> | --format <output format>)] [--feature-set]\n                [--full-details]\n                [(-g <generator name> | --generator-name <generator name>)]\n                [--import-mappings] [--instantiation-types]\n                [--language-specific-primitive] [--markdown-header] [--named-header]\n                [(-o <output location> | --output <output location>)] [--reserved-words]\n\nOPTIONS\n        -f <output format>, --format <output format>\n            Write output files in the desired format. Options are 'text',\n            'markdown' or 'yamlsample'. Default is 'text'.\n\n        --feature-set\n            displays feature set as supported by the generator\n\n        --full-details\n            displays CLI options as well as other configs/mappings (implies\n            --instantiation-types, --reserved-words,\n            --language-specific-primitives, --import-mappings,\n            --supporting-files)\n\n        -g <generator name>, --generator-name <generator name>\n            generator to get config help for\n\n        --import-mappings\n            displays the default import mappings (types and aliases, and what\n            imports they will pull into the template)\n\n        --instantiation-types\n            displays types used to instantiate simple type/alias names\n\n        --language-specific-primitive\n            displays the language specific primitives (types which require no\n            additional imports, or which may conflict with user defined model\n            names)\n\n        --markdown-header\n            When format=markdown, include this option to write out markdown\n            headers (e.g. for docusaurus).\n\n        --named-header\n            Header includes the generator name, for clarity in output\n\n        -o <output location>, --output <output location>\n            Optionally write help to this location, otherwise default is\n            standard output\n\n        --reserved-words\n            displays the reserved words which may result in renamed model or\n            property names\n")),Object(i.b)("p",null,"The option of note is ",Object(i.b)("inlineCode",{parentName:"p"},"-g/--generator-name")," (other options are exposed for tooling)."),Object(i.b)("p",null,"You may pass any generator name (see ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"#list"}),"list")," command) to ",Object(i.b)("inlineCode",{parentName:"p"},"-g"),", and options specific to that generator will be displayed. Some generators have ",Object(i.b)("em",{parentName:"p"},"many")," options, while others may have only a few."),Object(i.b)("p",null,"Example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli config-help -g go\n")),Object(i.b)("p",null,"Outputs:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"CONFIG OPTIONS\n    packageName\n        Go package name (convention: lowercase). (Default: openapi)\n\n    hideGenerationTimestamp\n        Hides the generation timestamp when files are generated. (Default: true)\n\n    packageVersion\n        Go package version. (Default: 1.0.0)\n\n    withGoCodegenComment\n        whether to include Go codegen comment to disable Go Lint and collapse by default in GitHub PRs and diffs (Default: false)\n\n    withXml\n        whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML) (Default: false)\n\n    prependFormOrBodyParameters\n        Add form or body parameters to the beginning of the parameter list. (Default: false)\n")),Object(i.b)("p",null,"To pass these go client generator-specific options to the ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," command for a go client, use the ",Object(i.b)("inlineCode",{parentName:"p"},"--additional-properties")," option. See the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"#generate"}),"generate")," command section for an example."),Object(i.b)("h2",{id:"meta"},"meta"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"meta")," command creates a new Java class and template files, used for creating your own custom templates."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help meta\nNAME\n        openapi-generator-cli meta - MetaGenerator. Generator for creating a new\n        template set and configuration for Codegen. The output will be based on\n        the language you specify, and includes default templates to include.\n\nSYNOPSIS\n        openapi-generator-cli meta [(-l <language> | --language <language>)]\n                [(-n <name> | --name <name>)]\n                [(-o <output directory> | --output <output directory>)]\n                [(-p <package> | --package <package>)] [(-t <type> | --type <type>)]\n\nOPTIONS\n        -l <language>, --language <language>\n            the implementation language for the generator class\n\n        -n <name>, --name <name>\n            the human-readable name of the generator\n\n        -o <output directory>, --output <output directory>\n            where to write the generated files (current dir by default)\n\n        -p <package>, --package <package>\n            the package to put the main class into (defaults to\n            org.openapitools.codegen)\n\n        -t <type>, --type <type>\n            the type of generator that is created\n")),Object(i.b)("p",null,"For an in-depth example of using the ",Object(i.b)("inlineCode",{parentName:"p"},"meta")," command, see ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"Customization"),"."),Object(i.b)("h2",{id:"validate"},"validate"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"validate")," command allows you to validate an input specification, optionally providing recommendations for error fixes or other improvements (if available)."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help validate\nNAME\n        openapi-generator-cli validate - Validate specification\n\nSYNOPSIS\n        openapi-generator-cli validate\n                (-i <spec file> | --input-spec <spec file>) [--recommend]\n\nOPTIONS\n        -i <spec file>, --input-spec <spec file>\n            location of the OpenAPI spec, as URL or file (required)\n\n        --recommend\n")),Object(i.b)("p",null,"Valid Spec Example (using ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator-gradle-plugin/samples/local-spec/petstore-v3.0.yaml"}),"petstore-v3.0.yaml"),")"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli validate -i petstore-v3.0.yaml\n")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"Validating spec (petstore-v3.0.yaml)\nNo validation issues detected.\n")),Object(i.b)("p",null,"Invalid Spec Example (using ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator-gradle-plugin/samples/local-spec/petstore-v3.0-invalid.yaml"}),"petstore-v3.0-invalid.yaml"),"):"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli validate -i petstore-v3.0-invalid.yaml\n")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"Validating spec (petstore-v3.0-invalid.yaml)\nErrors:\n    -attribute info is missing\n\n[error] Spec has 1 errors.\n")),Object(i.b)("h2",{id:"completion"},"completion"),Object(i.b)("p",null,"Although not documented in the ",Object(i.b)("inlineCode",{parentName:"p"},"help")," output, the CLI offers a ",Object(i.b)("inlineCode",{parentName:"p"},"completion")," command, which can be used for auto-completion."),Object(i.b)("p",null,"This command takes one or more parameters representing the args list you would otherwise pass to ",Object(i.b)("inlineCode",{parentName:"p"},"openapi-generator"),". For example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli completion config-help\n-o\n--output\n--named-header\n-g\n--generator-name\n-f\n--format\n--markdown-header\n")),Object(i.b)("p",null,"An example bash completion script can be found in the repo at ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/scripts/openapi-generator-cli-completion.bash"}),"scripts/openapi-generator-cli-completion.bash"),"."),Object(i.b)("h2",{id:"generate"},"generate"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," command is the workhorse of the generator toolset. As such, it has ",Object(i.b)("em",{parentName:"p"},"many")," more options available than the previous commands. The abbreviated options are below, but you may expand the full descriptions."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help generate\nNAME\n        openapi-generator-cli generate - Generate code with the specified\n        generator.\n\nSYNOPSIS\n        openapi-generator-cli generate\n                [(-a <authorization> | --auth <authorization>)]\n                [--api-name-suffix <api name suffix>] [--api-package <api package>]\n                [--artifact-id <artifact id>] [--artifact-version <artifact version>]\n                [(-c <configuration file> | --config <configuration file>)] [--dry-run]\n                [(-e <templating engine> | --engine <templating engine>)]\n                [--enable-post-process-file]\n                [(-g <generator name> | --generator-name <generator name>)]\n                [--generate-alias-as-model] [--git-host <git host>]\n                [--git-repo-id <git repo id>] [--git-user-id <git user id>]\n                [--global-property <global properties>...] [--group-id <group id>]\n                [--http-user-agent <http user agent>]\n                [(-i <spec file> | --input-spec <spec file>)]\n                [--ignore-file-override <ignore file override location>]\n                [--import-mappings <import mappings>...]\n                [--instantiation-types <instantiation types>...]\n                [--invoker-package <invoker package>]\n                [--language-specific-primitives <language specific primitives>...]\n                [--legacy-discriminator-behavior] [--library <library>]\n                [--log-to-stderr] [--minimal-update]\n                [--model-name-prefix <model name prefix>]\n                [--model-name-suffix <model name suffix>]\n                [--model-package <model package>]\n                [(-o <output directory> | --output <output directory>)] [(-p <additional properties> | --additional-properties <additional properties>)...]\n                [--package-name <package name>] [--release-note <release note>]\n                [--remove-operation-id-prefix]\n                [--reserved-words-mappings <reserved word mappings>...]\n                [(-s | --skip-overwrite)] [--server-variables <server variables>...]\n                [--skip-operation-example] [--skip-validate-spec]\n                [--strict-spec <true/false strict behavior>]\n                [(-t <template directory> | --template-dir <template directory>)]\n                [--type-mappings <type mappings>...] [(-v | --verbose)]\n")),Object(i.b)("details",null,Object(i.b)("summary",null,"generate OPTIONS"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"OPTIONS\n        -a <authorization>, --auth <authorization>\n            adds authorization headers when fetching the OpenAPI definitions\n            remotely. Pass in a URL-encoded string of name:header with a comma\n            separating multiple values\n\n        --api-name-suffix <api name suffix>\n            Suffix that will be appended to all API names ('tags'). Default:\n            Api. e.g. Pet => PetApi. Note: Only ruby, python, jaxrs generators\n            support this feature at the moment.\n\n        --api-package <api package>\n            package for generated api classes\n\n        --artifact-id <artifact id>\n            artifactId in generated pom.xml. This also becomes part of the\n            generated library's filename\n\n        --artifact-version <artifact version>\n            artifact version in generated pom.xml. This also becomes part of the\n            generated library's filename\n\n        -c <configuration file>, --config <configuration file>\n            Path to configuration file. It can be JSON or YAML. If file is JSON,\n            the content should have the format {\"optionKey\":\"optionValue\",\n            \"optionKey1\":\"optionValue1\"...}. If file is YAML, the content should\n            have the format optionKey: optionValue. Supported options can be\n            different for each language. Run config-help -g {generator name}\n            command for language-specific config options.\n\n        --dry-run\n            Try things out and report on potential changes (without actually\n            making changes).\n\n        -e <templating engine>, --engine <templating engine>\n            templating engine: \"mustache\" (default) or \"handlebars\" (beta)\n\n        --enable-post-process-file\n            Enable post-processing file using environment variables.\n\n        -g <generator name>, --generator-name <generator name>\n            generator to use (see list command for list)\n\n        --generate-alias-as-model\n            Generate model implementation for aliases to map and array schemas.\n            An 'alias' is an array, map, or list which is defined inline in a\n            OpenAPI document and becomes a model in the generated code. A 'map'\n            schema is an object that can have undeclared properties, i.e. the\n            'additionalproperties' attribute is set on that object. An 'array'\n            schema is a list of sub schemas in a OAS document\n\n        --git-host <git host>\n            Git host, e.g. gitlab.com.\n\n        --git-repo-id <git repo id>\n            Git repo ID, e.g. openapi-generator.\n\n        --git-user-id <git user id>\n            Git user ID, e.g. openapitools.\n\n        --global-property <global properties>\n            sets specified global properties (previously called 'system\n            properties') in the format of name=value,name=value (or multiple\n            options, each with name=value)\n\n        --group-id <group id>\n            groupId in generated pom.xml\n\n        --http-user-agent <http user agent>\n            HTTP user agent, e.g. codegen_csharp_api_client, default to\n            'OpenAPI-Generator/{packageVersion}/{language}'\n\n        -i <spec file>, --input-spec <spec file>\n            location of the OpenAPI spec, as URL or file (required if not loaded\n            via config using -c)\n\n        --ignore-file-override <ignore file override location>\n            Specifies an override location for the .openapi-generator-ignore\n            file. Most useful on initial generation.\n\n        --import-mappings <import mappings>\n            specifies mappings between a given class and the import that should\n            be used for that class in the format of type=import,type=import. You\n            can also have multiple occurrences of this option.\n\n        --instantiation-types <instantiation types>\n            sets instantiation type mappings in the format of\n            type=instantiatedType,type=instantiatedType.For example (in Java):\n            array=ArrayList,map=HashMap. In other words array types will get\n            instantiated as ArrayList in generated code. You can also have\n            multiple occurrences of this option.\n\n        --invoker-package <invoker package>\n            root package for generated code\n\n        --language-specific-primitives <language specific primitives>\n            specifies additional language specific primitive types in the format\n            of type1,type2,type3,type3. For example:\n            String,boolean,Boolean,Double. You can also have multiple\n            occurrences of this option.\n\n        --legacy-discriminator-behavior\n            Set to false for generators with better support for discriminators.\n            (Python, Java, Go, PowerShell, C#have this enabled by default).\n\n        --library <library>\n            library template (sub-template)\n\n        --log-to-stderr\n            write all log messages (not just errors) to STDOUT. Useful for\n            piping the JSON output of debug options (e.g. `--global-property\n            debugOperations`) to an external parser directly while testing a\n            generator.\n\n        --minimal-update\n            Only write output files that have changed.\n\n        --model-name-prefix <model name prefix>\n            Prefix that will be prepended to all model names.\n\n        --model-name-suffix <model name suffix>\n            Suffix that will be appended to all model names.\n\n        --model-package <model package>\n            package for generated models\n\n        -o <output directory>, --output <output directory>\n            where to write the generated files (current dir by default)\n\n        -p <additional properties>, --additional-properties <additional\n        properties>\n            sets additional properties that can be referenced by the mustache\n            templates in the format of name=value,name=value. You can also have\n            multiple occurrences of this option.\n\n        --package-name <package name>\n            package for generated classes (where supported)\n\n        --release-note <release note>\n            Release note, default to 'Minor update'.\n\n        --remove-operation-id-prefix\n            Remove prefix of operationId, e.g. config_getId => getId\n\n        --reserved-words-mappings <reserved word mappings>\n            specifies how a reserved name should be escaped to. Otherwise, the\n            default _<name> is used. For example id=identifier. You can also\n            have multiple occurrences of this option.\n\n        -s, --skip-overwrite\n            specifies if the existing files should be overwritten during the\n            generation.\n\n        --server-variables <server variables>\n            sets server variables overrides for spec documents which support\n            variable templating of servers.\n\n        --skip-operation-example\n            Skip examples defined in operations to avoid out of memory errors.\n\n        --skip-validate-spec\n            Skips the default behavior of validating an input specification.\n\n        --strict-spec <true/false strict behavior>\n            'MUST' and 'SHALL' wording in OpenAPI spec is strictly adhered to.\n            e.g. when false, no fixes will be applied to documents which pass\n            validation but don't follow the spec.\n\n        -t <template directory>, --template-dir <template directory>\n            folder containing the template files\n\n        --type-mappings <type mappings>\n            sets mappings between OpenAPI spec types and generated code types in\n            the format of OpenAPIType=generatedType,OpenAPIType=generatedType.\n            For example: array=List,map=Map,string=String. You can also have\n            multiple occurrences of this option.\n\n        -v, --verbose\n            verbose mode\n"))),Object(i.b)("p",null,"At a minimum, ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," requires:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"-g")," to specify the generator"),Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"-o")," to specify a meaningful output directory (defaults to the current directory!)"),Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"-i")," to specify the input OpenAPI document")),Object(i.b)("blockquote",null,Object(i.b)("p",{parentName:"blockquote"},Object(i.b)("strong",{parentName:"p"},"NOTE")," You may also pass ",Object(i.b)("inlineCode",{parentName:"p"},"-Dcolor")," as a system property to colorize terminal outputs.")),Object(i.b)("h3",{id:"examples"},"Examples"),Object(i.b)("p",null,"The following examples use ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml"),"."),Object(i.b)("h4",{id:"additional-properties"},"Additional Properties"),Object(i.b)("p",null,"Generator-specific options should be passed as ",Object(i.b)("inlineCode",{parentName:"p"},"--additional-properties"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate -g go --additional-properties=prependFormOrBodyParameters=true \\\n    -o out -i petstore.yaml\n")),Object(i.b)("p",null,"Pass more options via comma delimited key/value pairs:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--additional-properties=key1=value1,key2=value2\n")),Object(i.b)("p",null,"For the full list of generator-specific parameters, refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/generators"}),"generators docs"),"."),Object(i.b)("h4",{id:"type-mappings-and-import-mappings"},"Type Mappings and Import Mappings"),Object(i.b)("p",null,"Most generators allow for types bound to the OpenAPI Specification's types to be remapped to a user's desired types. Not ",Object(i.b)("em",{parentName:"p"},"all")," type mappings can be reassigned, as some generators define mappings which are tightly coupled to the built-in templates."),Object(i.b)("p",null,"If you're not using your own templates with star/glob package imports, you will most likely need to combine ",Object(i.b)("inlineCode",{parentName:"p"},"--type-mappings")," and ",Object(i.b)("inlineCode",{parentName:"p"},"--import-mappings")," together."),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"--type-mappings")," Defines the user's target type"),Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"--import-mappings")," Informs the template of the type to be imported")),Object(i.b)("p",null,"Here's how one might change the ",Object(i.b)("inlineCode",{parentName:"p"},"kotlin-spring")," server generator's default of ",Object(i.b)("inlineCode",{parentName:"p"},"OffsetDateTime")," to ",Object(i.b)("inlineCode",{parentName:"p"},"LocalDateTime"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate \\\n    -i petstore.yaml \\\n    -g kotlin-spring \\\n    -o out \\\n    --additional-properties=library=spring-boot,beanValidations=true,swaggerAnnotations=true,serviceImplementation=true \\\n    --import-mappings=DateTime=java.time.LocalDateTime \\\n    --type-mappings=DateTime=java.time.LocalDateTime\n")),Object(i.b)("blockquote",null,Object(i.b)("p",{parentName:"blockquote"},"NOTE: mappings are applied to ",Object(i.b)("inlineCode",{parentName:"p"},"DateTime"),", as this is the representation of the primitive type. See ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/7cee999543fcc00b7c1eb9f70f0456b707c7f9e2/modules/openapi-generator/src/main/java/org/openapitools/codegen/DefaultCodegen.java#L1431"}),"DefaultCodegen"),".")),Object(i.b)("h4",{id:"file-post-processing"},"File Post-Processing"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"--enable-post-process-file")," option enables specific generators to invoke some external language-specific formatting script. Each filename is passed ",Object(i.b)("em",{parentName:"p"},"individually")," to this external script, allowing for linting, formatting, or other custom clean-up."),Object(i.b)("p",null,"For more details, see ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/file-post-processing"}),"File Post-Processing"),"."),Object(i.b)("h3",{id:"target-external-models"},"Target External Models"),Object(i.b)("p",null,"Sometimes you don't want the codegen to make a model for you--you might want to just include one that already exists in your codebase.  Say you already have a ",Object(i.b)("inlineCode",{parentName:"p"},"User")," object and want to reuse that, which has a different model package from the other generated files:"),Object(i.b)("p",null,"First, indicate that the class is already included by default. This will keep the codegen from trying to generate the class."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--language-specific-primitives=Pet\n")),Object(i.b)("p",null,"This command line option will tell the generator to consider ",Object(i.b)("inlineCode",{parentName:"p"},"Pet"),' a "primitive" type.'),Object(i.b)("p",null,"Next, if the ",Object(i.b)("inlineCode",{parentName:"p"},"Pet")," class is a different package, add an ",Object(i.b)("inlineCode",{parentName:"p"},"--import-mapping")," to tell the generator to include that import wherever ",Object(i.b)("inlineCode",{parentName:"p"},"Pet")," is used:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--import-mappings=Pet=com.yourpackage.models.Pet\n")),Object(i.b)("p",null,"Now the codegen will know what to import from that specific package."),Object(i.b)("p",null,"NOTE: ",Object(i.b)("inlineCode",{parentName:"p"},"import-mappings")," is assigned a key-value pair in this example, but multiple values can be comma-separate. For instance:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--import-mappings=Pet=com.yourpackage.models.Pet,User=com.yourpackage.models.User\n")),Object(i.b)("h4",{id:"configuration-file"},"Configuration File"),Object(i.b)("p",null,"Rather than passing generator options in a CSV of ",Object(i.b)("inlineCode",{parentName:"p"},"--additional-properties"),", you may also provide the settings via JSON file or YAML file."),Object(i.b)("p",null,"For example, one of our typescript samples has the following configuration file:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "npmName": "@swagger/typescript-fetch-petstore",\n  "npmVersion": "1.0.0",\n  "npmRepository" : "https://skimdb.npmjs.com/registry",\n  "snapshot" : false,\n  "supportsES6": true\n}\n')),Object(i.b)("p",null,"These settings can be passed via ",Object(i.b)("inlineCode",{parentName:"p"},"-c filename"),". Here, we've saved the above as ",Object(i.b)("inlineCode",{parentName:"p"},"config.json"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate -i petstore.yaml -g typescript-fetch -o out \\\n    -c config.json\n")),Object(i.b)("p",null,"Same configuration file can be passed into YAML format having following equivalent content:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'npmName: "@swagger/typescript-fetch-petstore"\nnpmVersion: "1.0.0"\nnpmRepository: "https://skimdb.npmjs.com/registry"\nsnapshot: false\nsupportsES6: true\n')),Object(i.b)("p",null,"The settings are passed exactly the same as for ",Object(i.b)("inlineCode",{parentName:"p"},"config.json"),". The most important part is the file extension. Supported values are ",Object(i.b)("inlineCode",{parentName:"p"},"yml")," or ",Object(i.b)("inlineCode",{parentName:"p"},"yaml"),".\nThe name of the file should be ",Object(i.b)("inlineCode",{parentName:"p"},"config.yml")," or ",Object(i.b)("inlineCode",{parentName:"p"},"config.yaml")," (in our example it will be ",Object(i.b)("inlineCode",{parentName:"p"},"config.yaml"),"."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate -i petstore.yaml -g typescript-fetch -o out \\\n    -c config.yaml\n")),Object(i.b)("h2",{id:"batch"},"batch"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"batch")," command allows you to move all CLI arguments supported by the ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," command into a YAML or JSON file."),Object(i.b)("p",null,Object(i.b)("em",{parentName:"p"},"NOTE"),": This command supports an additional ",Object(i.b)("inlineCode",{parentName:"p"},"!include"),' property which may point to another "shared" file, the base path to which can be\nmodified by ',Object(i.b)("inlineCode",{parentName:"p"},"--includes-base-dir"),". Starting with 5.0.0, the ",Object(i.b)("inlineCode",{parentName:"p"},"!batch")," command supports multiple ",Object(i.b)("inlineCode",{parentName:"p"},"!include")," properties, either sequential or nested. In order to support multiple ",Object(i.b)("inlineCode",{parentName:"p"},"!include")," properties in a JSON file, the property name can have a suffix, e.g. ",Object(i.b)("inlineCode",{parentName:"p"},"!include1"),", ",Object(i.b)("inlineCode",{parentName:"p"},"!include2"),", etc. The suffix have no meaning other than providing unique property names."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help batch\nNAME\n        openapi-generator-cli batch - Generate code in batch via external\n        configs.\n\nSYNOPSIS\n        openapi-generator-cli batch [--clean] [--fail-fast]\n                [--includes-base-dir <includes>] [(-r <threads> | --threads <threads>)]\n                [--root-dir <root>] [--timeout <timeout>] [(-v | --verbose)] [--]\n                <configs>...\n\nOPTIONS\n        --clean\n            clean output of previously written files before generation\n\n        --fail-fast\n            fail fast on any errors\n\n        --includes-base-dir <includes>\n            base directory used for includes\n\n        -r <threads>, --threads <threads>\n            thread count\n\n        --root-dir <root>\n            root directory used output/includes (includes can be overridden)\n\n        --timeout <timeout>\n            execution timeout (minutes)\n\n        -v, --verbose\n            verbose mode\n\n        --\n            This option can be used to separate command-line options from the\n            list of argument, (useful when arguments might be mistaken for\n            command-line options\n\n        <configs>\n            Generator configuration files.\n")),Object(i.b)("p",null,"Example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'# create "shared" config\nmkdir shared && cat > shared/common.yaml <<EOF\ninputSpec: https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml\nadditionalProperties:\n    x-ext-name: "Your Name"\nEOF\n\n# create "standard" configs\ncat > kotlin.yaml <<EOF\n\'!include\': \'shared/common.yaml\'\noutputDir: out/kotlin\ngeneratorName: kotlin\nartifactId: kotlin-petstore-string\nadditionalProperties:\n  dateLibrary: string\n  serializableModel: "true"\nEOF\n\ncat > csharp.yaml <<EOF\n\'!include\': \'shared/common.yaml\'\noutputDir: out/csharp-netcore\ngeneratorName: csharp-netcore\nadditionalProperties:\n  packageGuid: "{321C8C3F-0156-40C1-AE42-D59761FB9B6C}"\n  useCompareNetObjects: "true"\nEOF\n\n# Generate them\nopenapi-generator-cli batch *.yaml\n')),Object(i.b)("h2",{id:"author"},"author"),Object(i.b)("p",null,"This command group contains utilities for authoring generators or customizing templates."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help author\nNAME\n        openapi-generator-cli author - Utilities for authoring generators or\n        customizing templates.\n\nSYNOPSIS\n        openapi-generator-cli author\n        openapi-generator-cli author template [--library <library>]\n                [(-v | --verbose)]\n                [(-o <output directory> | --output <output directory>)]\n                (-g <generator name> | --generator-name <generator name>)\n\nOPTIONS\n        --help\n            Display help about the tool\n\n        --version\n            Display full version output\n\nCOMMANDS\n        With no arguments, Display help information about openapi-generator\n\n        template\n            Retrieve templates for local modification\n\n            With --library option, library template (sub-template)\n\n            With --verbose option, verbose mode\n\n            With --output option, where to write the template files (defaults to\n            'out')\n\n            With --generator-name option, generator to use (see list command for\n            list)\n")),Object(i.b)("h3",{id:"template"},"template"),Object(i.b)("p",null,"This command allows user to extract templates from the CLI jar which simplifies customization efforts."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help author template\nNAME\n        openapi-generator-cli author template - Retrieve templates for local\n        modification\n\nSYNOPSIS\n        openapi-generator-cli author template\n                (-g <generator name> | --generator-name <generator name>)\n                [--library <library>]\n                [(-o <output directory> | --output <output directory>)]\n                [(-v | --verbose)]\n\nOPTIONS\n        -g <generator name>, --generator-name <generator name>\n            generator to use (see list command for list)\n\n        --library <library>\n            library template (sub-template)\n\n        -o <output directory>, --output <output directory>\n            where to write the template files (defaults to 'out')\n\n        -v, --verbose\n            verbose mode\n")),Object(i.b)("p",null,"Example:"),Object(i.b)("p",null,"Extract Java templates, limiting to the ",Object(i.b)("inlineCode",{parentName:"p"},"webclient")," library."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli author template -g java --library webclient\n")),Object(i.b)("p",null,"Extract all Java templates:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli author template -g java\n")))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return m})),n.d(t,"b",(function(){return b}));var a=n(0),o=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function p(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?r(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):r(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),c=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):p({},t,{},e)),n},m=function(e){var t=c(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,r=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),m=c(n),d=a,b=m["".concat(r,".").concat(d)]||m[d]||u[d]||i;return n?o.a.createElement(b,p({ref:t},s,{components:n})):o.a.createElement(b,p({ref:t},s))}));function b(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,r=new Array(i);r[0]=d;var p={};for(var l in t)hasOwnProperty.call(t,l)&&(p[l]=t[l]);p.originalType=e,p.mdxType="string"==typeof e?e:a,r[1]=p;for(var s=2;s<i;s++)r[s]=n[s];return o.a.createElement.apply(null,r)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/912fe03d.cb2ebb32.js b/912fe03d.cb2ebb32.js
new file mode 100644
index 00000000000..b44843cb309
--- /dev/null
+++ b/912fe03d.cb2ebb32.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[88],{216:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return r})),n.d(t,"metadata",(function(){return p})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return c}));var a=n(1),o=n(9),i=(n(0),n(312)),r={id:"usage",title:"Usage"},p={id:"usage",title:"Usage",description:"Options for OpenAPI Generator are the same whether you're using the CLI, Maven/Gradle Plugins, or Online generation options.",source:"@site/../docs/usage.md",permalink:"/docs/usage",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/usage.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Online",permalink:"/docs/online"},next:{title:"Global Properties",permalink:"/docs/globals"}},l=[{value:"help",id:"help",children:[]},{value:"version",id:"version",children:[]},{value:"list",id:"list",children:[]},{value:"config-help",id:"config-help",children:[]},{value:"meta",id:"meta",children:[]},{value:"validate",id:"validate",children:[]},{value:"completion",id:"completion",children:[]},{value:"generate",id:"generate",children:[{value:"Examples",id:"examples",children:[]},{value:"Target External Models",id:"target-external-models",children:[]}]},{value:"batch",id:"batch",children:[]},{value:"author",id:"author",children:[{value:"template",id:"template",children:[]}]}],s={rightToc:l};function c(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("p",null,"Options for OpenAPI Generator are the same whether you're using the CLI, Maven/Gradle Plugins, or Online generation options.\nThis page demonstrates navigating the options via CLI. Commands are presented here in a logical progression as a tutorial, but you're welcome to skip directly to the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"#generate"}),"generate")," command."),Object(i.b)("h2",{id:"help"},"help"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"help")," option lists all commands available to the CLI."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help\nusage: openapi-generator-cli <command> [<args>]\n\nThe most commonly used openapi-generator-cli commands are:\n    author        Utilities for authoring generators or customizing templates.\n    batch         Generate code in batch via external configs.\n    config-help   Config help for chosen lang\n    generate      Generate code with the specified generator.\n    help          Display help information about openapi-generator\n    list          Lists the available generators\n    meta          MetaGenerator. Generator for creating a new template set and configuration for Codegen.  The output will be based on the language you specify, and includes default templates to include.\n    validate      Validate specification\n    version       Show version information used in tooling\n\nSee 'openapi-generator-cli help <command>' for more information on a specific\ncommand.\n")),Object(i.b)("h2",{id:"version"},"version"),Object(i.b)("p",null,"The version command provides version information, returning either the version by default, the git commit sha when passed ",Object(i.b)("inlineCode",{parentName:"p"},"--sha"),", or verbose output when passed ",Object(i.b)("inlineCode",{parentName:"p"},"--full"),"."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"NAME\n        openapi-generator-cli version - Show version information used in tooling\n\nSYNOPSIS\n        openapi-generator-cli version [--full] [--sha]\n\nOPTIONS\n        --full\n            Full version details\n\n        --sha\n            Git commit SHA version\n")),Object(i.b)("h2",{id:"list"},"list"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"list")," command outputs a formatted list of every available generator. Pass the ",Object(i.b)("inlineCode",{parentName:"p"},"-s/--short")," option if you would like a CSV output for easy parsing."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help list\nNAME\n        openapi-generator-cli list - Lists the available generators\n\nSYNOPSIS\n        openapi-generator-cli list [(-i <include> | --include <include>)]\n                [(-s | --short)]\n\nOPTIONS\n        -i <include>, --include <include>\n            comma-separated list of stability indexes to include (value:\n            all,beta,stable,experimental,deprecated). Excludes deprecated by\n            default.\n\n        -s, --short\n            shortened output (suitable for scripting)\n")),Object(i.b)("p",null,"Example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli list -s | tr ',' '\\n'\n")),Object(i.b)("p",null,"For the full list of generators, refer to the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/generators"}),"Generators List"),"."),Object(i.b)("h2",{id:"config-help"},"config-help"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"config-help")," option provides details about "),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help config-help\nNAME\n        openapi-generator-cli config-help - Config help for chosen lang\n\nSYNOPSIS\n        openapi-generator-cli config-help\n                [(-f <output format> | --format <output format>)] [--feature-set]\n                [--full-details]\n                [(-g <generator name> | --generator-name <generator name>)]\n                [--import-mappings] [--instantiation-types]\n                [--language-specific-primitive] [--markdown-header] [--named-header]\n                [(-o <output location> | --output <output location>)] [--reserved-words]\n\nOPTIONS\n        -f <output format>, --format <output format>\n            Write output files in the desired format. Options are 'text',\n            'markdown' or 'yamlsample'. Default is 'text'.\n\n        --feature-set\n            displays feature set as supported by the generator\n\n        --full-details\n            displays CLI options as well as other configs/mappings (implies\n            --instantiation-types, --reserved-words,\n            --language-specific-primitives, --import-mappings,\n            --supporting-files)\n\n        -g <generator name>, --generator-name <generator name>\n            generator to get config help for\n\n        --import-mappings\n            displays the default import mappings (types and aliases, and what\n            imports they will pull into the template)\n\n        --instantiation-types\n            displays types used to instantiate simple type/alias names\n\n        --language-specific-primitive\n            displays the language specific primitives (types which require no\n            additional imports, or which may conflict with user defined model\n            names)\n\n        --markdown-header\n            When format=markdown, include this option to write out markdown\n            headers (e.g. for docusaurus).\n\n        --named-header\n            Header includes the generator name, for clarity in output\n\n        -o <output location>, --output <output location>\n            Optionally write help to this location, otherwise default is\n            standard output\n\n        --reserved-words\n            displays the reserved words which may result in renamed model or\n            property names\n")),Object(i.b)("p",null,"The option of note is ",Object(i.b)("inlineCode",{parentName:"p"},"-g/--generator-name")," (other options are exposed for tooling)."),Object(i.b)("p",null,"You may pass any generator name (see ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"#list"}),"list")," command) to ",Object(i.b)("inlineCode",{parentName:"p"},"-g"),", and options specific to that generator will be displayed. Some generators have ",Object(i.b)("em",{parentName:"p"},"many")," options, while others may have only a few."),Object(i.b)("p",null,"Example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli config-help -g go\n")),Object(i.b)("p",null,"Outputs:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"CONFIG OPTIONS\n    packageName\n        Go package name (convention: lowercase). (Default: openapi)\n\n    hideGenerationTimestamp\n        Hides the generation timestamp when files are generated. (Default: true)\n\n    packageVersion\n        Go package version. (Default: 1.0.0)\n\n    withGoCodegenComment\n        whether to include Go codegen comment to disable Go Lint and collapse by default in GitHub PRs and diffs (Default: false)\n\n    withXml\n        whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML) (Default: false)\n\n    prependFormOrBodyParameters\n        Add form or body parameters to the beginning of the parameter list. (Default: false)\n")),Object(i.b)("p",null,"To pass these go client generator-specific options to the ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," command for a go client, use the ",Object(i.b)("inlineCode",{parentName:"p"},"--additional-properties")," option. See the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"#generate"}),"generate")," command section for an example."),Object(i.b)("h2",{id:"meta"},"meta"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"meta")," command creates a new Java class and template files, used for creating your own custom templates."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help meta\nNAME\n        openapi-generator-cli meta - MetaGenerator. Generator for creating a new\n        template set and configuration for Codegen. The output will be based on\n        the language you specify, and includes default templates to include.\n\nSYNOPSIS\n        openapi-generator-cli meta [(-l <language> | --language <language>)]\n                [(-n <name> | --name <name>)]\n                [(-o <output directory> | --output <output directory>)]\n                [(-p <package> | --package <package>)] [(-t <type> | --type <type>)]\n\nOPTIONS\n        -l <language>, --language <language>\n            the implementation language for the generator class\n\n        -n <name>, --name <name>\n            the human-readable name of the generator\n\n        -o <output directory>, --output <output directory>\n            where to write the generated files (current dir by default)\n\n        -p <package>, --package <package>\n            the package to put the main class into (defaults to\n            org.openapitools.codegen)\n\n        -t <type>, --type <type>\n            the type of generator that is created\n")),Object(i.b)("p",null,"For an in-depth example of using the ",Object(i.b)("inlineCode",{parentName:"p"},"meta")," command, see ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"Customization"),"."),Object(i.b)("h2",{id:"validate"},"validate"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"validate")," command allows you to validate an input specification, optionally providing recommendations for error fixes or other improvements (if available)."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help validate\nNAME\n        openapi-generator-cli validate - Validate specification\n\nSYNOPSIS\n        openapi-generator-cli validate\n                (-i <spec file> | --input-spec <spec file>) [--recommend]\n\nOPTIONS\n        -i <spec file>, --input-spec <spec file>\n            location of the OpenAPI spec, as URL or file (required)\n\n        --recommend\n")),Object(i.b)("p",null,"Valid Spec Example (using ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator-gradle-plugin/samples/local-spec/petstore-v3.0.yaml"}),"petstore-v3.0.yaml"),")"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli validate -i petstore-v3.0.yaml\n")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"Validating spec (petstore-v3.0.yaml)\nNo validation issues detected.\n")),Object(i.b)("p",null,"Invalid Spec Example (using ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator-gradle-plugin/samples/local-spec/petstore-v3.0-invalid.yaml"}),"petstore-v3.0-invalid.yaml"),"):"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli validate -i petstore-v3.0-invalid.yaml\n")),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"Validating spec (petstore-v3.0-invalid.yaml)\nErrors:\n    -attribute info is missing\n\n[error] Spec has 1 errors.\n")),Object(i.b)("h2",{id:"completion"},"completion"),Object(i.b)("p",null,"Although not documented in the ",Object(i.b)("inlineCode",{parentName:"p"},"help")," output, the CLI offers a ",Object(i.b)("inlineCode",{parentName:"p"},"completion")," command, which can be used for auto-completion."),Object(i.b)("p",null,"This command takes one or more parameters representing the args list you would otherwise pass to ",Object(i.b)("inlineCode",{parentName:"p"},"openapi-generator"),". For example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli completion config-help\n-o\n--output\n--named-header\n-g\n--generator-name\n-f\n--format\n--markdown-header\n")),Object(i.b)("p",null,"An example bash completion script can be found in the repo at ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/scripts/openapi-generator-cli-completion.bash"}),"scripts/openapi-generator-cli-completion.bash"),"."),Object(i.b)("h2",{id:"generate"},"generate"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," command is the workhorse of the generator toolset. As such, it has ",Object(i.b)("em",{parentName:"p"},"many")," more options available than the previous commands. The abbreviated options are below, but you may expand the full descriptions."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help generate\nNAME\n        openapi-generator-cli generate - Generate code with the specified\n        generator.\n\nSYNOPSIS\n        openapi-generator-cli generate\n                [(-a <authorization> | --auth <authorization>)]\n                [--api-name-suffix <api name suffix>] [--api-package <api package>]\n                [--artifact-id <artifact id>] [--artifact-version <artifact version>]\n                [(-c <configuration file> | --config <configuration file>)] [--dry-run]\n                [(-e <templating engine> | --engine <templating engine>)]\n                [--enable-post-process-file]\n                [(-g <generator name> | --generator-name <generator name>)]\n                [--generate-alias-as-model] [--git-host <git host>]\n                [--git-repo-id <git repo id>] [--git-user-id <git user id>]\n                [--global-property <global properties>...] [--group-id <group id>]\n                [--http-user-agent <http user agent>]\n                [(-i <spec file> | --input-spec <spec file>)]\n                [--ignore-file-override <ignore file override location>]\n                [--import-mappings <import mappings>...]\n                [--instantiation-types <instantiation types>...]\n                [--invoker-package <invoker package>]\n                [--language-specific-primitives <language specific primitives>...]\n                [--legacy-discriminator-behavior] [--library <library>]\n                [--log-to-stderr] [--minimal-update]\n                [--model-name-prefix <model name prefix>]\n                [--model-name-suffix <model name suffix>]\n                [--model-package <model package>]\n                [(-o <output directory> | --output <output directory>)] [(-p <additional properties> | --additional-properties <additional properties>)...]\n                [--package-name <package name>] [--release-note <release note>]\n                [--remove-operation-id-prefix]\n                [--reserved-words-mappings <reserved word mappings>...]\n                [(-s | --skip-overwrite)] [--server-variables <server variables>...]\n                [--skip-operation-example] [--skip-validate-spec]\n                [--strict-spec <true/false strict behavior>]\n                [(-t <template directory> | --template-dir <template directory>)]\n                [--type-mappings <type mappings>...] [(-v | --verbose)]\n")),Object(i.b)("details",null,Object(i.b)("summary",null,"generate OPTIONS"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"OPTIONS\n        -a <authorization>, --auth <authorization>\n            adds authorization headers when fetching the OpenAPI definitions\n            remotely. Pass in a URL-encoded string of name:header with a comma\n            separating multiple values\n\n        --api-name-suffix <api name suffix>\n            Suffix that will be appended to all API names ('tags'). Default:\n            Api. e.g. Pet => PetApi. Note: Only ruby, python, jaxrs generators\n            support this feature at the moment.\n\n        --api-package <api package>\n            package for generated api classes\n\n        --artifact-id <artifact id>\n            artifactId in generated pom.xml. This also becomes part of the\n            generated library's filename\n\n        --artifact-version <artifact version>\n            artifact version in generated pom.xml. This also becomes part of the\n            generated library's filename\n\n        -c <configuration file>, --config <configuration file>\n            Path to configuration file. It can be JSON or YAML. If file is JSON,\n            the content should have the format {\"optionKey\":\"optionValue\",\n            \"optionKey1\":\"optionValue1\"...}. If file is YAML, the content should\n            have the format optionKey: optionValue. Supported options can be\n            different for each language. Run config-help -g {generator name}\n            command for language-specific config options.\n\n        --dry-run\n            Try things out and report on potential changes (without actually\n            making changes).\n\n        -e <templating engine>, --engine <templating engine>\n            templating engine: \"mustache\" (default) or \"handlebars\" (beta)\n\n        --enable-post-process-file\n            Enable post-processing file using environment variables.\n\n        -g <generator name>, --generator-name <generator name>\n            generator to use (see list command for list)\n\n        --generate-alias-as-model\n            Generate model implementation for aliases to map and array schemas.\n            An 'alias' is an array, map, or list which is defined inline in a\n            OpenAPI document and becomes a model in the generated code. A 'map'\n            schema is an object that can have undeclared properties, i.e. the\n            'additionalproperties' attribute is set on that object. An 'array'\n            schema is a list of sub schemas in a OAS document\n\n        --git-host <git host>\n            Git host, e.g. gitlab.com.\n\n        --git-repo-id <git repo id>\n            Git repo ID, e.g. openapi-generator.\n\n        --git-user-id <git user id>\n            Git user ID, e.g. openapitools.\n\n        --global-property <global properties>\n            sets specified global properties (previously called 'system\n            properties') in the format of name=value,name=value (or multiple\n            options, each with name=value)\n\n        --group-id <group id>\n            groupId in generated pom.xml\n\n        --http-user-agent <http user agent>\n            HTTP user agent, e.g. codegen_csharp_api_client, default to\n            'OpenAPI-Generator/{packageVersion}/{language}'\n\n        -i <spec file>, --input-spec <spec file>\n            location of the OpenAPI spec, as URL or file (required if not loaded\n            via config using -c)\n\n        --ignore-file-override <ignore file override location>\n            Specifies an override location for the .openapi-generator-ignore\n            file. Most useful on initial generation.\n\n        --import-mappings <import mappings>\n            specifies mappings between a given class and the import that should\n            be used for that class in the format of type=import,type=import. You\n            can also have multiple occurrences of this option.\n\n        --instantiation-types <instantiation types>\n            sets instantiation type mappings in the format of\n            type=instantiatedType,type=instantiatedType.For example (in Java):\n            array=ArrayList,map=HashMap. In other words array types will get\n            instantiated as ArrayList in generated code. You can also have\n            multiple occurrences of this option.\n\n        --invoker-package <invoker package>\n            root package for generated code\n\n        --language-specific-primitives <language specific primitives>\n            specifies additional language specific primitive types in the format\n            of type1,type2,type3,type3. For example:\n            String,boolean,Boolean,Double. You can also have multiple\n            occurrences of this option.\n\n        --legacy-discriminator-behavior\n            Set to false for generators with better support for discriminators.\n            (Python, Java, Go, PowerShell, C#have this enabled by default).\n\n        --library <library>\n            library template (sub-template)\n\n        --log-to-stderr\n            write all log messages (not just errors) to STDOUT. Useful for\n            piping the JSON output of debug options (e.g. `--global-property\n            debugOperations`) to an external parser directly while testing a\n            generator.\n\n        --minimal-update\n            Only write output files that have changed.\n\n        --model-name-prefix <model name prefix>\n            Prefix that will be prepended to all model names.\n\n        --model-name-suffix <model name suffix>\n            Suffix that will be appended to all model names.\n\n        --model-package <model package>\n            package for generated models\n\n        -o <output directory>, --output <output directory>\n            where to write the generated files (current dir by default)\n\n        -p <additional properties>, --additional-properties <additional\n        properties>\n            sets additional properties that can be referenced by the mustache\n            templates in the format of name=value,name=value. You can also have\n            multiple occurrences of this option.\n\n        --package-name <package name>\n            package for generated classes (where supported)\n\n        --release-note <release note>\n            Release note, default to 'Minor update'.\n\n        --remove-operation-id-prefix\n            Remove prefix of operationId, e.g. config_getId => getId\n\n        --reserved-words-mappings <reserved word mappings>\n            specifies how a reserved name should be escaped to. Otherwise, the\n            default _<name> is used. For example id=identifier. You can also\n            have multiple occurrences of this option.\n\n        -s, --skip-overwrite\n            specifies if the existing files should be overwritten during the\n            generation.\n\n        --server-variables <server variables>\n            sets server variables overrides for spec documents which support\n            variable templating of servers.\n\n        --skip-operation-example\n            Skip examples defined in operations to avoid out of memory errors.\n\n        --skip-validate-spec\n            Skips the default behavior of validating an input specification.\n\n        --strict-spec <true/false strict behavior>\n            'MUST' and 'SHALL' wording in OpenAPI spec is strictly adhered to.\n            e.g. when false, no fixes will be applied to documents which pass\n            validation but don't follow the spec.\n\n        -t <template directory>, --template-dir <template directory>\n            folder containing the template files\n\n        --type-mappings <type mappings>\n            sets mappings between OpenAPI spec types and generated code types in\n            the format of OpenAPIType=generatedType,OpenAPIType=generatedType.\n            For example: array=List,map=Map,string=String. You can also have\n            multiple occurrences of this option.\n\n        -v, --verbose\n            verbose mode\n"))),Object(i.b)("p",null,"At a minimum, ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," requires:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"-g")," to specify the generator"),Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"-o")," to specify a meaningful output directory (defaults to the current directory!)"),Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"-i")," to specify the input OpenAPI document")),Object(i.b)("blockquote",null,Object(i.b)("p",{parentName:"blockquote"},Object(i.b)("strong",{parentName:"p"},"NOTE")," You may also pass ",Object(i.b)("inlineCode",{parentName:"p"},"-Dcolor")," as a system property to colorize terminal outputs.")),Object(i.b)("h3",{id:"examples"},"Examples"),Object(i.b)("p",null,"The following examples use ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}),"petstore.yaml"),"."),Object(i.b)("h4",{id:"additional-properties"},"Additional Properties"),Object(i.b)("p",null,"Generator-specific options should be passed as ",Object(i.b)("inlineCode",{parentName:"p"},"--additional-properties"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate -g go --additional-properties=prependFormOrBodyParameters=true \\\n    -o out -i petstore.yaml\n")),Object(i.b)("p",null,"Pass more options via comma delimited key/value pairs:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--additional-properties=key1=value1,key2=value2\n")),Object(i.b)("p",null,"For the full list of generator-specific parameters, refer to ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/generators"}),"generators docs"),"."),Object(i.b)("h4",{id:"type-mappings-and-import-mappings"},"Type Mappings and Import Mappings"),Object(i.b)("p",null,"Most generators allow for types bound to the OpenAPI Specification's types to be remapped to a user's desired types. Not ",Object(i.b)("em",{parentName:"p"},"all")," type mappings can be reassigned, as some generators define mappings which are tightly coupled to the built-in templates."),Object(i.b)("p",null,"If you're not using your own templates with star/glob package imports, you will most likely need to combine ",Object(i.b)("inlineCode",{parentName:"p"},"--type-mappings")," and ",Object(i.b)("inlineCode",{parentName:"p"},"--import-mappings")," together."),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"--type-mappings")," Defines the user's target type"),Object(i.b)("li",{parentName:"ul"},Object(i.b)("inlineCode",{parentName:"li"},"--import-mappings")," Informs the template of the type to be imported")),Object(i.b)("p",null,"Here's how one might change the ",Object(i.b)("inlineCode",{parentName:"p"},"kotlin-spring")," server generator's default of ",Object(i.b)("inlineCode",{parentName:"p"},"OffsetDateTime")," to ",Object(i.b)("inlineCode",{parentName:"p"},"LocalDateTime"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate \\\n    -i petstore.yaml \\\n    -g kotlin-spring \\\n    -o out \\\n    --additional-properties=library=spring-boot,beanValidations=true,swaggerAnnotations=true,serviceImplementation=true \\\n    --import-mappings=DateTime=java.time.LocalDateTime \\\n    --type-mappings=DateTime=java.time.LocalDateTime\n")),Object(i.b)("blockquote",null,Object(i.b)("p",{parentName:"blockquote"},"NOTE: mappings are applied to ",Object(i.b)("inlineCode",{parentName:"p"},"DateTime"),", as this is the representation of the primitive type. See ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/7cee999543fcc00b7c1eb9f70f0456b707c7f9e2/modules/openapi-generator/src/main/java/org/openapitools/codegen/DefaultCodegen.java#L1431"}),"DefaultCodegen"),".")),Object(i.b)("h4",{id:"file-post-processing"},"File Post-Processing"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"--enable-post-process-file")," option enables specific generators to invoke some external language-specific formatting script. Each filename is passed ",Object(i.b)("em",{parentName:"p"},"individually")," to this external script, allowing for linting, formatting, or other custom clean-up."),Object(i.b)("p",null,"For more details, see ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/file-post-processing"}),"File Post-Processing"),"."),Object(i.b)("h3",{id:"target-external-models"},"Target External Models"),Object(i.b)("p",null,"Sometimes you don't want the codegen to make a model for you--you might want to just include one that already exists in your codebase.  Say you already have a ",Object(i.b)("inlineCode",{parentName:"p"},"User")," object and want to reuse that, which has a different model package from the other generated files:"),Object(i.b)("p",null,"First, indicate that the class is already included by default. This will keep the codegen from trying to generate the class."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--language-specific-primitives=Pet\n")),Object(i.b)("p",null,"This command line option will tell the generator to consider ",Object(i.b)("inlineCode",{parentName:"p"},"Pet"),' a "primitive" type.'),Object(i.b)("p",null,"Next, if the ",Object(i.b)("inlineCode",{parentName:"p"},"Pet")," class is a different package, add an ",Object(i.b)("inlineCode",{parentName:"p"},"--import-mapping")," to tell the generator to include that import wherever ",Object(i.b)("inlineCode",{parentName:"p"},"Pet")," is used:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--import-mappings=Pet=com.yourpackage.models.Pet\n")),Object(i.b)("p",null,"Now the codegen will know what to import from that specific package."),Object(i.b)("p",null,"NOTE: ",Object(i.b)("inlineCode",{parentName:"p"},"import-mappings")," is assigned a key-value pair in this example, but multiple values can be comma-separate. For instance:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"--import-mappings=Pet=com.yourpackage.models.Pet,User=com.yourpackage.models.User\n")),Object(i.b)("h4",{id:"configuration-file"},"Configuration File"),Object(i.b)("p",null,"Rather than passing generator options in a CSV of ",Object(i.b)("inlineCode",{parentName:"p"},"--additional-properties"),", you may also provide the settings via JSON file or YAML file."),Object(i.b)("p",null,"For example, one of our typescript samples has the following configuration file:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "npmName": "@swagger/typescript-fetch-petstore",\n  "npmVersion": "1.0.0",\n  "npmRepository" : "https://skimdb.npmjs.com/registry",\n  "snapshot" : false,\n  "supportsES6": true\n}\n')),Object(i.b)("p",null,"These settings can be passed via ",Object(i.b)("inlineCode",{parentName:"p"},"-c filename"),". Here, we've saved the above as ",Object(i.b)("inlineCode",{parentName:"p"},"config.json"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate -i petstore.yaml -g typescript-fetch -o out \\\n    -c config.json\n")),Object(i.b)("p",null,"Same configuration file can be passed into YAML format having following equivalent content:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'npmName: "@swagger/typescript-fetch-petstore"\nnpmVersion: "1.0.0"\nnpmRepository: "https://skimdb.npmjs.com/registry"\nsnapshot: false\nsupportsES6: true\n')),Object(i.b)("p",null,"The settings are passed exactly the same as for ",Object(i.b)("inlineCode",{parentName:"p"},"config.json"),". The most important part is the file extension. Supported values are ",Object(i.b)("inlineCode",{parentName:"p"},"yml")," or ",Object(i.b)("inlineCode",{parentName:"p"},"yaml"),".\nThe name of the file should be ",Object(i.b)("inlineCode",{parentName:"p"},"config.yml")," or ",Object(i.b)("inlineCode",{parentName:"p"},"config.yaml")," (in our example it will be ",Object(i.b)("inlineCode",{parentName:"p"},"config.yaml"),"."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli generate -i petstore.yaml -g typescript-fetch -o out \\\n    -c config.yaml\n")),Object(i.b)("h2",{id:"batch"},"batch"),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"batch")," command allows you to move all CLI arguments supported by the ",Object(i.b)("inlineCode",{parentName:"p"},"generate")," command into a YAML or JSON file."),Object(i.b)("p",null,Object(i.b)("em",{parentName:"p"},"NOTE"),": This command supports an additional ",Object(i.b)("inlineCode",{parentName:"p"},"!include"),' property which may point to another "shared" file, the base path to which can be\nmodified by ',Object(i.b)("inlineCode",{parentName:"p"},"--includes-base-dir"),". Starting with 5.0.0, the ",Object(i.b)("inlineCode",{parentName:"p"},"!batch")," command supports multiple ",Object(i.b)("inlineCode",{parentName:"p"},"!include")," properties, either sequential or nested. In order to support multiple ",Object(i.b)("inlineCode",{parentName:"p"},"!include")," properties in a JSON file, the property name can have a suffix, e.g. ",Object(i.b)("inlineCode",{parentName:"p"},"!include1"),", ",Object(i.b)("inlineCode",{parentName:"p"},"!include2"),", etc. The suffix have no meaning other than providing unique property names."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help batch\nNAME\n        openapi-generator-cli batch - Generate code in batch via external\n        configs.\n\nSYNOPSIS\n        openapi-generator-cli batch [--clean] [--fail-fast]\n                [--includes-base-dir <includes>] [(-r <threads> | --threads <threads>)]\n                [--root-dir <root>] [--timeout <timeout>] [(-v | --verbose)] [--]\n                <configs>...\n\nOPTIONS\n        --clean\n            clean output of previously written files before generation\n\n        --fail-fast\n            fail fast on any errors\n\n        --includes-base-dir <includes>\n            base directory used for includes\n\n        -r <threads>, --threads <threads>\n            thread count\n\n        --root-dir <root>\n            root directory used output/includes (includes can be overridden)\n\n        --timeout <timeout>\n            execution timeout (minutes)\n\n        -v, --verbose\n            verbose mode\n\n        --\n            This option can be used to separate command-line options from the\n            list of argument, (useful when arguments might be mistaken for\n            command-line options\n\n        <configs>\n            Generator configuration files.\n")),Object(i.b)("p",null,"Example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),'# create "shared" config\nmkdir shared && cat > shared/common.yaml <<EOF\ninputSpec: https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml\nadditionalProperties:\n    x-ext-name: "Your Name"\nEOF\n\n# create "standard" configs\ncat > kotlin.yaml <<EOF\n\'!include\': \'shared/common.yaml\'\noutputDir: out/kotlin\ngeneratorName: kotlin\nartifactId: kotlin-petstore-string\nadditionalProperties:\n  dateLibrary: string\n  serializableModel: "true"\nEOF\n\ncat > csharp.yaml <<EOF\n\'!include\': \'shared/common.yaml\'\noutputDir: out/csharp-netcore\ngeneratorName: csharp-netcore\nadditionalProperties:\n  packageGuid: "{321C8C3F-0156-40C1-AE42-D59761FB9B6C}"\n  useCompareNetObjects: "true"\nEOF\n\n# Generate them\nopenapi-generator-cli batch *.yaml\n')),Object(i.b)("h2",{id:"author"},"author"),Object(i.b)("p",null,"This command group contains utilities for authoring generators or customizing templates."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help author\nNAME\n        openapi-generator-cli author - Utilities for authoring generators or\n        customizing templates.\n\nSYNOPSIS\n        openapi-generator-cli author\n        openapi-generator-cli author template [--library <library>]\n                [(-v | --verbose)]\n                [(-o <output directory> | --output <output directory>)]\n                (-g <generator name> | --generator-name <generator name>)\n\nOPTIONS\n        --help\n            Display help about the tool\n\n        --version\n            Display full version output\n\nCOMMANDS\n        With no arguments, Display help information about openapi-generator\n\n        template\n            Retrieve templates for local modification\n\n            With --library option, library template (sub-template)\n\n            With --verbose option, verbose mode\n\n            With --output option, where to write the template files (defaults to\n            'out')\n\n            With --generator-name option, generator to use (see list command for\n            list)\n")),Object(i.b)("h3",{id:"template"},"template"),Object(i.b)("p",null,"This command allows user to extract templates from the CLI jar which simplifies customization efforts."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"openapi-generator-cli help author template\nNAME\n        openapi-generator-cli author template - Retrieve templates for local\n        modification\n\nSYNOPSIS\n        openapi-generator-cli author template\n                (-g <generator name> | --generator-name <generator name>)\n                [--library <library>]\n                [(-o <output directory> | --output <output directory>)]\n                [(-v | --verbose)]\n\nOPTIONS\n        -g <generator name>, --generator-name <generator name>\n            generator to use (see list command for list)\n\n        --library <library>\n            library template (sub-template)\n\n        -o <output directory>, --output <output directory>\n            where to write the template files (defaults to 'out')\n\n        -v, --verbose\n            verbose mode\n")),Object(i.b)("p",null,"Example:"),Object(i.b)("p",null,"Extract Java templates, limiting to the ",Object(i.b)("inlineCode",{parentName:"p"},"webclient")," library."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli author template -g java --library webclient\n")),Object(i.b)("p",null,"Extract all Java templates:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator-cli author template -g java\n")))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return m})),n.d(t,"b",(function(){return b}));var a=n(0),o=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function p(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?r(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):r(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),c=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):p({},t,{},e)),n},m=function(e){var t=c(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,r=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),m=c(n),d=a,b=m["".concat(r,".").concat(d)]||m[d]||u[d]||i;return n?o.a.createElement(b,p({ref:t},s,{components:n})):o.a.createElement(b,p({ref:t},s))}));function b(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,r=new Array(i);r[0]=d;var p={};for(var l in t)hasOwnProperty.call(t,l)&&(p[l]=t[l]);p.originalType=e,p.mdxType="string"==typeof e?e:a,r[1]=p;for(var s=2;s<i;s++)r[s]=n[s];return o.a.createElement.apply(null,r)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/96fb2cf3.40226c94.js b/96fb2cf3.40226c94.js
new file mode 100644
index 00000000000..7bd9b214a02
--- /dev/null
+++ b/96fb2cf3.40226c94.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[93],{221:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Documentation for the java-micronaut-server Generator"},c={id:"generators/java-micronaut-server",title:"Documentation for the java-micronaut-server Generator",description:"## METADATA",source:"@site/../docs/generators/java-micronaut-server.md",permalink:"/docs/generators/java-micronaut-server",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-server.md",lastUpdatedBy:"Auke Schrijnen",lastUpdatedAt:1650509636},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"SUPPORTED VENDOR EXTENSIONS",id:"supported-vendor-extensions",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("h2",{id:"metadata"},"METADATA"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Value"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Notes"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java-micronaut-server"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator stability"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BETA"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SERVER"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator language"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"mustache"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generates a Java Micronaut Server."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))))),Object(l.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalEnumTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for enum type(class level annotations)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalModelTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactDescription"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact description in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI Java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi-micronaut")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact version in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"bigDecimalAsString"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Treat BigDecimal values as Strings to avoid precision loss."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"get")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"build"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify for which build tool to generate files"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"gradle")),Object(l.b)("dd",null,"Gradle configuration is generated for the project"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"all")),Object(l.b)("dd",null,"Both Gradle and Maven configurations are generated"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"maven")),Object(l.b)("dd",null,"Maven configuration is generated for the project"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"all")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"controllerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The package in which controllers will be generated"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.api")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Option. Date library to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8-localdatetime")),Object(l.b)("dd",null,"Java 8 using LocalDateTime (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8")),Object(l.b)("dd",null,"Java 8 native JSR310 (preferred for jdk 1.8+)"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java8")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"datetimeFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date-time as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerEmail"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer email in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"team@openapitools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer name in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI-Generator Contributors")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganization"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPITools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganizationUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://openapitools.org"}),"http://openapitools.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disableHtmlEscaping"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"discriminatorCaseSensitive"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumUnknownDefaultCase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"No changes to the enum's are made, this is the default option."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"fullJavaUtil"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to use fully qualified name for classes under java.util. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateControllerAsAbstract"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate an abstract class for controller to be extended. (apiPackage is then used for the abstract class, and controllerPackage is used for implementation that extends it.)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateControllerFromExamples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate the implementation of controller and tests from parameter and return examples that will verify that the api works as desired (for testing)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ignoreAnyOfInEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ignore anyOf keyword in enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters in the generated API methods using @ApiImplicitParams annotation."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeadersRegex"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"invokerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"root package for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Unlicense")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://unlicense.org"}),"http://unlicense.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"micronautVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Micronaut version, only ",">","=3.0.0 versions are supported"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"3.3.1")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.model")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openApiNullable"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enable OpenAPI Jackson Nullable library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentArtifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentGroupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"requiredPropertiesInConstructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allow only to create models with all the required properties provided in constructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmDeveloperConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM developer connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean - toggle ",'"',"implements Serializable",'"'," for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"snapshotVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uses a SNAPSHOT version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Use a SnapShot Version"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"Use a Release Version"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"src/main/java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"test"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify which test tool to generate files for"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"junit")),Object(l.b)("dd",null,"Use JUnit as test tool"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"spock")),Object(l.b)("dd",null,"Use Spock as test tool"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"junit")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"testOutput"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set output folder for models and APIs tests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"${project.build.directory}/generated-test-sources/openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"title"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Client service name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to import authorization and to annotate controller methods accordingly"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use BeanValidation API annotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useOptional"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use Optional container for optional parameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"supported-vendor-extensions"},"SUPPORTED VENDOR EXTENSIONS"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Extension name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Applicable for"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default value"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-discriminator-value"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Used with model inheritance to specify value for discriminator that identifies current model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ability to specify interfaces that model must implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"empty array")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-setter-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom annotation that can be specified over java setter for specific field"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"When field is array & uniqueItems, then this extension is used to add ",Object(l.b)("inlineCode",{parentName:"td"},"@JsonDeserialize(as = LinkedHashSet.class)")," over setter, otherwise no value")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-tags"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify multiple swagger tags for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-accepts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Accept' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-content-type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Content-Type' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-class-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-field-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to property"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BigDecimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.math.BigDecimal")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CompletedFileUpload"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"io.micronaut.http.multipart.CompletedFileUpload")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Date")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.io.File")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.LinkedHashSet")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDate"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Map")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Timestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.sql.Timestamp")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"URI"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.net.URI")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UUID"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.UUID")))),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet")))),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Boolean"),Object(l.b)("li",null,"Double"),Object(l.b)("li",null,"Float"),Object(l.b)("li",null,"Integer"),Object(l.b)("li",null,"Long"),Object(l.b)("li",null,"Object"),Object(l.b)("li",null,"String"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"byte[]")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"abstract"),Object(l.b)("li",null,"apiclient"),Object(l.b)("li",null,"apiexception"),Object(l.b)("li",null,"apiresponse"),Object(l.b)("li",null,"application"),Object(l.b)("li",null,"assert"),Object(l.b)("li",null,"authorization"),Object(l.b)("li",null,"body"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"client"),Object(l.b)("li",null,"configuration"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"cookie"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"extends"),Object(l.b)("li",null,"file"),Object(l.b)("li",null,"final"),Object(l.b)("li",null,"finally"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"format"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"header"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"implements"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"instanceof"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"list"),Object(l.b)("li",null,"localreturntype"),Object(l.b)("li",null,"localvaraccept"),Object(l.b)("li",null,"localvaraccepts"),Object(l.b)("li",null,"localvarauthnames"),Object(l.b)("li",null,"localvarcollectionqueryparams"),Object(l.b)("li",null,"localvarcontenttype"),Object(l.b)("li",null,"localvarcontenttypes"),Object(l.b)("li",null,"localvarcookieparams"),Object(l.b)("li",null,"localvarformparams"),Object(l.b)("li",null,"localvarheaderparams"),Object(l.b)("li",null,"localvarpath"),Object(l.b)("li",null,"localvarpostbody"),Object(l.b)("li",null,"localvarqueryparams"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"native"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"null"),Object(l.b)("li",null,"object"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"pathvariable"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"queryparam"),Object(l.b)("li",null,"queryvalue"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"strictfp"),Object(l.b)("li",null,"stringutil"),Object(l.b)("li",null,"super"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"synchronized"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"throws"),Object(l.b)("li",null,"transient"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"while")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uuid"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Null"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"AnyType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Object"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"anyOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"oneOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"not"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return o}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},m=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),m=n,o=p["".concat(r,".").concat(m)]||p[m]||d[m]||l;return a?b.a.createElement(o,c({ref:e},j,{components:a})):b.a.createElement(o,c({ref:e},j))}));function o(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=m;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/96fb2cf3.e7049fd7.js b/96fb2cf3.e7049fd7.js
deleted file mode 100644
index 7a204e17d7c..00000000000
--- a/96fb2cf3.e7049fd7.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[93],{221:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Documentation for the java-micronaut-server Generator"},c={id:"generators/java-micronaut-server",title:"Documentation for the java-micronaut-server Generator",description:"## METADATA",source:"@site/../docs/generators/java-micronaut-server.md",permalink:"/docs/generators/java-micronaut-server",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-server.md",lastUpdatedBy:"Justin Black",lastUpdatedAt:1650213369},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"SUPPORTED VENDOR EXTENSIONS",id:"supported-vendor-extensions",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("h2",{id:"metadata"},"METADATA"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Value"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Notes"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java-micronaut-server"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator stability"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BETA"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SERVER"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator language"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"mustache"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generates a Java Micronaut Server."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))))),Object(l.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalEnumTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for enum type(class level annotations)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalModelTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactDescription"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact description in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI Java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi-micronaut")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact version in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"bigDecimalAsString"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Treat BigDecimal values as Strings to avoid precision loss."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"get")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"build"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify for which build tool to generate files"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"gradle")),Object(l.b)("dd",null,"Gradle configuration is generated for the project"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"all")),Object(l.b)("dd",null,"Both Gradle and Maven configurations are generated"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"maven")),Object(l.b)("dd",null,"Maven configuration is generated for the project"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"all")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"controllerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The package in which controllers will be generated"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.api")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Option. Date library to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8-localdatetime")),Object(l.b)("dd",null,"Java 8 using LocalDateTime (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8")),Object(l.b)("dd",null,"Java 8 native JSR310 (preferred for jdk 1.8+)"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java8")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"datetimeFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date-time as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerEmail"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer email in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"team@openapitools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer name in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI-Generator Contributors")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganization"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPITools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganizationUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://openapitools.org"}),"http://openapitools.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disableHtmlEscaping"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"discriminatorCaseSensitive"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumUnknownDefaultCase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"No changes to the enum's are made, this is the default option."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"fullJavaUtil"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to use fully qualified name for classes under java.util. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateControllerAsAbstract"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate an abstract class for controller to be extended. (apiPackage is then used for the abstract class, and controllerPackage is used for implementation that extends it.)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateControllerFromExamples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate the implementation of controller and tests from parameter and return examples that will verify that the api works as desired (for testing)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ignoreAnyOfInEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ignore anyOf keyword in enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters in the generated API methods using @ApiImplicitParams annotation."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeadersRegex"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"invokerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"root package for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Unlicense")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://unlicense.org"}),"http://unlicense.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"micronautVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Micronaut version, only ",">","=3.0.0 versions are supported"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"3.3.1")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.model")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openApiNullable"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enable OpenAPI Jackson Nullable library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentArtifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentGroupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"requiredPropertiesInConstructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allow only to create models with all the required properties provided in constructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmDeveloperConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM developer connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean - toggle ",'"',"implements Serializable",'"'," for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"snapshotVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uses a SNAPSHOT version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Use a SnapShot Version"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"Use a Release Version"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"src/main/java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"test"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify which test tool to generate files for"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"junit")),Object(l.b)("dd",null,"Use JUnit as test tool"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"spock")),Object(l.b)("dd",null,"Use Spock as test tool"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"junit")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"testOutput"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set output folder for models and APIs tests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"${project.build.directory}/generated-test-sources/openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"title"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Client service name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to import authorization and to annotate controller methods accordingly"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use BeanValidation API annotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"supported-vendor-extensions"},"SUPPORTED VENDOR EXTENSIONS"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Extension name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Applicable for"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default value"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-discriminator-value"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Used with model inheritance to specify value for discriminator that identifies current model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ability to specify interfaces that model must implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"empty array")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-setter-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom annotation that can be specified over java setter for specific field"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"When field is array & uniqueItems, then this extension is used to add ",Object(l.b)("inlineCode",{parentName:"td"},"@JsonDeserialize(as = LinkedHashSet.class)")," over setter, otherwise no value")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-tags"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify multiple swagger tags for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-accepts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Accept' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-content-type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Content-Type' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-class-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-field-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to property"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BigDecimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.math.BigDecimal")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CompletedFileUpload"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"io.micronaut.http.multipart.CompletedFileUpload")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Date")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.io.File")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.LinkedHashSet")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDate"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Map")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Timestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.sql.Timestamp")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"URI"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.net.URI")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UUID"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.UUID")))),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet")))),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Boolean"),Object(l.b)("li",null,"Double"),Object(l.b)("li",null,"Float"),Object(l.b)("li",null,"Integer"),Object(l.b)("li",null,"Long"),Object(l.b)("li",null,"Object"),Object(l.b)("li",null,"String"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"byte[]")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"abstract"),Object(l.b)("li",null,"apiclient"),Object(l.b)("li",null,"apiexception"),Object(l.b)("li",null,"apiresponse"),Object(l.b)("li",null,"application"),Object(l.b)("li",null,"assert"),Object(l.b)("li",null,"authorization"),Object(l.b)("li",null,"body"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"client"),Object(l.b)("li",null,"configuration"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"cookie"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"extends"),Object(l.b)("li",null,"file"),Object(l.b)("li",null,"final"),Object(l.b)("li",null,"finally"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"format"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"header"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"implements"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"instanceof"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"list"),Object(l.b)("li",null,"localreturntype"),Object(l.b)("li",null,"localvaraccept"),Object(l.b)("li",null,"localvaraccepts"),Object(l.b)("li",null,"localvarauthnames"),Object(l.b)("li",null,"localvarcollectionqueryparams"),Object(l.b)("li",null,"localvarcontenttype"),Object(l.b)("li",null,"localvarcontenttypes"),Object(l.b)("li",null,"localvarcookieparams"),Object(l.b)("li",null,"localvarformparams"),Object(l.b)("li",null,"localvarheaderparams"),Object(l.b)("li",null,"localvarpath"),Object(l.b)("li",null,"localvarpostbody"),Object(l.b)("li",null,"localvarqueryparams"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"native"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"null"),Object(l.b)("li",null,"object"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"pathvariable"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"queryparam"),Object(l.b)("li",null,"queryvalue"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"strictfp"),Object(l.b)("li",null,"stringutil"),Object(l.b)("li",null,"super"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"synchronized"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"throws"),Object(l.b)("li",null,"transient"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"while")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uuid"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Null"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"AnyType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Object"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"anyOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"oneOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"not"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return o}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},m=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),m=n,o=p["".concat(r,".").concat(m)]||p[m]||d[m]||l;return a?b.a.createElement(o,c({ref:e},j,{components:a})):b.a.createElement(o,c({ref:e},j))}));function o(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=m;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/9b517c7f.6c3050ec.js b/9b517c7f.6c3050ec.js
new file mode 100644
index 00000000000..6d7d1a6547e
--- /dev/null
+++ b/9b517c7f.6c3050ec.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[96],{224:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return b})),a.d(t,"metadata",(function(){return i})),a.d(t,"rightToc",(function(){return l})),a.d(t,"default",(function(){return c}));var n=a(1),r=a(9),o=(a(0),a(312)),b={id:"swagger-codegen-migration",title:"Migrating from Swagger Codegen"},i={id:"swagger-codegen-migration",title:"Migrating from Swagger Codegen",description:"OpenAPI Generator is a fork of `swagger-codegen` between version `2.3.1` and `2.4.0`. For the reasons behind the fork, please refer to the [Q&A](https://github.com/OpenAPITools/openapi-generator/blob/master/docs/qna.md).",source:"@site/../docs/migration-from-swagger-codegen.md",permalink:"/docs/swagger-codegen-migration",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/migration-from-swagger-codegen.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Roadmap",permalink:"/docs/roadmap"},next:{title:"Swagger Codegen Fork: Q&A",permalink:"/docs/fork-qna"}},l=[{value:"New docker images",id:"new-docker-images",children:[]},{value:"New maven coordinates",id:"new-maven-coordinates",children:[]},{value:"Changes in Maven Plugin",id:"changes-in-maven-plugin",children:[]},{value:"New generators names",id:"new-generators-names",children:[]},{value:"New parameters name",id:"new-parameters-name",children:[]},{value:"Renamed Mustache Template Variables",id:"renamed-mustache-template-variables",children:[]},{value:"Ignore file",id:"ignore-file",children:[]},{value:"Metadata folder",id:"metadata-folder",children:[]},{value:"New default values for the generated code",id:"new-default-values-for-the-generated-code",children:[]},{value:"New fully qualified name for the classes",id:"new-fully-qualified-name-for-the-classes",children:[]},{value:"Body parameter name",id:"body-parameter-name",children:[]},{value:"Default basePath",id:"default-basepath",children:[]},{value:"Nullable",id:"nullable",children:[]}],p={rightToc:l};function c(e){var t=e.components,a=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},p,a,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"OpenAPI Generator is a fork of ",Object(o.b)("inlineCode",{parentName:"p"},"swagger-codegen")," between version ",Object(o.b)("inlineCode",{parentName:"p"},"2.3.1")," and ",Object(o.b)("inlineCode",{parentName:"p"},"2.4.0"),". For the reasons behind the fork, please refer to the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/docs/qna.md"}),"Q&A"),'.\nThis community-driven version called "OpenAPI Generator" provides similar functionalities and can be used as drop-in replacement.\nThis guide explains the major differences in order to help you with the migration.'),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Table of contents")),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-docker-images"}),"New docker images")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-maven-coordinates"}),"New maven coordinates")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#changes-in-maven-plugin"}),"Changes in Maven Plugin")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-generators-names"}),"New generators names")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-parameters-name"}),"New parameters name")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#renamed-mustache-template-variables"}),"Renamed Mustache Template Variables")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#ignore-file"}),"Ignore file")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#metadata-folder"}),"metadata-folder")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-default-values-for-the-generated-code"}),"New default values for the generated code")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-fully-qualified-name-for-the-classes"}),"New fully qualified name for the classes")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#body-parameter-name"}),"Body parameter name")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#default-basepath"}),"Default basePath")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#nullable"}),"Nullable"))),Object(o.b)("h2",{id:"new-docker-images"},"New docker images"),Object(o.b)("p",null,"The docker images are available on DockerHub: ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://hub.docker.com/u/openapitools/"}),"https://hub.docker.com/u/openapitools/")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"CLI for OpenAPI Generator")),Object(o.b)("p",null,"Image to run OpenAPI Generator in the command line (see ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/README.md#openapi-generator-cli-docker-image"}),"OpenAPI Generator CLI Docker Image"),")"),Object(o.b)("p",null,"Old: ",Object(o.b)("inlineCode",{parentName:"p"},"swaggerapi/swagger-codegen-cli")),Object(o.b)("p",null,"New: ",Object(o.b)("inlineCode",{parentName:"p"},"openapitools/openapi-generator-cli")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"OpenAPI Generator as web service")),Object(o.b)("p",null,"Image to run OpenAPI Generator as a web service (see ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/README.md#openapi-generator-online-docker-image"}),"OpenAPI Generator Online Docker Image"),")"),Object(o.b)("p",null,"Old: ",Object(o.b)("inlineCode",{parentName:"p"},"swaggerapi/swagger-generator")),Object(o.b)("p",null,"New: ",Object(o.b)("inlineCode",{parentName:"p"},"openapitools/openapi-generator-online")),Object(o.b)("h2",{id:"new-maven-coordinates"},"New maven coordinates"),Object(o.b)("p",null,"You can find our released artefact on maven central:"),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Core:")),Object(o.b)("p",null,"Old:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger</groupId>\n    <artifactId>swagger-codegen</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"New:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator</artifactId>\n</dependency>\n")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Cli:")),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger</groupId>\n    <artifactId>swagger-codegen-cli</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"New:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator-cli</artifactId>\n</dependency>\n")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Maven plugin:")),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger</groupId>\n    <artifactId>swagger-codegen-maven-plugin</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"New:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator-maven-plugin</artifactId>\n</dependency>\n")),Object(o.b)("h2",{id:"changes-in-maven-plugin"},"Changes in Maven Plugin"),Object(o.b)("p",null,"OpenAPI Generator 3.0.0 has introduced ",Object(o.b)("inlineCode",{parentName:"p"},"<generatorName>")," and deprecated ",Object(o.b)("inlineCode",{parentName:"p"},"<language>"),', because this refers to generator names which embed more than just "language".'),Object(o.b)("p",null,"If both options are present, you'll be presented with an error. If only ",Object(o.b)("inlineCode",{parentName:"p"},"<language>")," is provided, you'll be presented instructions for updating to the new config."),Object(o.b)("h2",{id:"new-generators-names"},"New generators names"),Object(o.b)("p",null,"When you run OpenAPI Generator, you need to select a target generator (",Object(o.b)("inlineCode",{parentName:"p"},"-g")," option in the cli).\nAll languages of ",Object(o.b)("inlineCode",{parentName:"p"},"swagger-codegen")," have been migrated to ",Object(o.b)("inlineCode",{parentName:"p"},"openapi-generator"),", but some names were changed, in order to be more consistent."),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"swagger-codegen")),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"openapi-generator")))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"akka-scala")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"scala-akka"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"scala")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"scala-httpclient"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"jaxrs")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"jaxrs-jersey"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"qt5cpp")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpp-qt5"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpprest")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpp-restsdk"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"tizen")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpp-tizen"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"sinatra")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"ruby-sinatra"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swift")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swift2-deprecated"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"lumen")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"php-lumen"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"slim")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"php-slim"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"ze-ph")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"php-mezzio-ph"))))),Object(o.b)("p",null,"We provide a temporary mapping in code for these old values. You'll receive a warning with instructions to migrate to the new names."),Object(o.b)("h2",{id:"new-parameters-name"},"New parameters name"),Object(o.b)("p",null,'Some parameters were renamed.\nOften you need to replace "Swagger", with "OpenAPI".\nSome examples:'),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"swagger-codegen")),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"openapi-generator")))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"debugSwagger")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"debugOpenAPI"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"GenerateSwaggerMetadata")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"GenerateOpenAPIMetadata"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swagger.codegen.undertow.apipackage")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"openapi.codegen.undertow.apipackage"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swagger.codegen.undertow.modelpackage")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"openapi.codegen.undertow.modelpackage"))))),Object(o.b)("h2",{id:"renamed-mustache-template-variables"},"Renamed Mustache Template Variables"),Object(o.b)("p",null,"The template variable ",Object(o.b)("inlineCode",{parentName:"p"},"{{datatype}}")," was renamed to ",Object(o.b)("inlineCode",{parentName:"p"},"{{dataType}}")," for consistency reason.\nCorresponding java code: ",Object(o.b)("inlineCode",{parentName:"p"},"CodegenProperty.datatype")," is renamed to ",Object(o.b)("inlineCode",{parentName:"p"},"CodegenProperty.dataType"),"."),Object(o.b)("p",null,"(If you're ",Object(o.b)("strong",{parentName:"p"},"not")," using customized templates with the ",Object(o.b)("inlineCode",{parentName:"p"},"-t")," option, you can ignore the mustache variable renaming above.)"),Object(o.b)("h2",{id:"ignore-file"},"Ignore file"),Object(o.b)("p",null,Object(o.b)("inlineCode",{parentName:"p"},".swagger-codegen-ignore")," is replaced by ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore"),".\nThe syntax inside the file stays the same."),Object(o.b)("p",null,"You don't need to rename the file manually, OpenAPI Generator will do it when your run it against an existing output directory.\n(When there is no ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," in a folder, if a ",Object(o.b)("inlineCode",{parentName:"p"},".swagger-codegen-ignore")," file is present it will be considered and renamed to ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore"),")."),Object(o.b)("h2",{id:"metadata-folder"},"Metadata folder"),Object(o.b)("p",null,"The metadata folder (to store the ",Object(o.b)("inlineCode",{parentName:"p"},"VERSION")," file for example) is now called ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator/")," instead of ",Object(o.b)("inlineCode",{parentName:"p"},".swagger-codegen/"),"."),Object(o.b)("h2",{id:"new-default-values-for-the-generated-code"},"New default values for the generated code"),Object(o.b)("p",null,"If you use a generator without specifying each parameter, you might see some differences in the generated code.\nAs example the default package name used in the generated code has changed.\nYou need to have a look at the specific value, depending of your target language, but often ",Object(o.b)("inlineCode",{parentName:"p"},"Swagger")," \xees replaced by ",Object(o.b)("inlineCode",{parentName:"p"},"OpenAPITools")," and ",Object(o.b)("inlineCode",{parentName:"p"},"io.swagger")," is replaced by ",Object(o.b)("inlineCode",{parentName:"p"},"org.openapitools"),".\nConcretely if you did not specify anything when you are generating java code, a file ",Object(o.b)("inlineCode",{parentName:"p"},"org/openapitools/api/PetApi.java"),"  might be generated instead of ",Object(o.b)("inlineCode",{parentName:"p"},"io/swagger/api/PetApi.java"),"."),Object(o.b)("p",null,"If this is a problem for you, you need to explicitly set the the parameter value in order to match with the ",Object(o.b)("inlineCode",{parentName:"p"},"swagger-codgen")," default value (",Object(o.b)("inlineCode",{parentName:"p"},"apiPackage")," == ",Object(o.b)("inlineCode",{parentName:"p"},"io.swagger")," in the previous example with the java generator)."),Object(o.b)("h2",{id:"new-fully-qualified-name-for-the-classes"},"New fully qualified name for the classes"),Object(o.b)("p",null,"If you have extended some generators in your project, and you are looking for a specific class, replace the ",Object(o.b)("inlineCode",{parentName:"p"},"io.swagger.codegen")," package (old name) with ",Object(o.b)("inlineCode",{parentName:"p"},"org.openapitools.codegen")," package (new name)."),Object(o.b)("p",null,"Example: ",Object(o.b)("inlineCode",{parentName:"p"},"org.openapitools.codegen.DefaultGenerator")),Object(o.b)("h2",{id:"body-parameter-name"},"Body parameter name"),Object(o.b)("p",null,"\u203c\ufe0f Since 4.0.0-beta, the body parameter name in OAS v2 is automatically preserved in the vendor extension ",Object(o.b)("inlineCode",{parentName:"p"},"x-codegen-request-body-name")),Object(o.b)("p",null,"In OpenAPI spec v3, there's no body parameter, which is replaced by ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#request-body-object"}),"Request Body Object"),'. The parameter name for Request Body is named automatically based on the model name (e.g. User). To control how the "Request Body" parameter is named, please add the vendor extension ',Object(o.b)("inlineCode",{parentName:"p"},"x-codegen-request-body-name")," to the operation:"),Object(o.b)("p",null,"OpenAPI Spec v3:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-yaml"}),"paths:\n  /pet:\n    post:\n      tags:\n        - pet\n      summary: Add a new pet to the store\n      description: ''\n      operationId: addPet\n      x-codegen-request-body-name: new_body_name\n      responses:\n        '405':\n          description: Invalid input\n      security:\n        - petstore_auth:\n            - 'write:pets'\n            - 'read:pets'\n      requestBody:\n        $ref: '#/components/requestBodies/Pet'\n")),Object(o.b)("p",null,"OpenAPI Spec v2:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-yaml"}),"paths:\n  /pet:\n    post:\n      tags:\n        - pet\n      summary: Add a new pet to the store\n      description: ''\n      operationId: addPet\n      x-codegen-request-body-name: new_body_name\n      consumes:\n        - application/json\n        - application/xml\n      produces:\n        - application/xml\n        - application/json\n      parameters:\n        - in: body\n          name: body\n          description: Pet object that needs to be added to the store\n          required: true\n          schema:\n            $ref: '#/definitions/Pet'\n      responses:\n        '405':\n          description: Invalid input\n      security:\n        - petstore_auth:\n            - 'write:pets'\n            - 'read:pets'\n")),Object(o.b)("p",null,"If your API client is using named parameters in the function call (e.g. Perl required & optional parameters, Ruby optional parameters), you will need to add ",Object(o.b)("inlineCode",{parentName:"p"},"x-codegen-request-body-name")," to the spec to restore the original body parameter name."),Object(o.b)("h2",{id:"default-basepath"},"Default basePath"),Object(o.b)("p",null,"The default ",Object(o.b)("inlineCode",{parentName:"p"},"basePath")," has been changed from ",Object(o.b)("inlineCode",{parentName:"p"},"https://localhost")," to ",Object(o.b)("inlineCode",{parentName:"p"},"http://localhost")," (http without s)"),Object(o.b)("h2",{id:"nullable"},"Nullable"),Object(o.b)("p",null,"OpenAPI spec v3 has better support for ",Object(o.b)("inlineCode",{parentName:"p"},"nullable"),". If you're still using OpenAPI/Swagger spec v2, please use ",Object(o.b)("inlineCode",{parentName:"p"},"x-nullable: true")," instead."))}c.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return d})),a.d(t,"b",(function(){return O}));var n=a(0),r=a.n(n);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function b(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function i(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?b(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):b(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function l(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var p=r.a.createContext({}),c=function(e){var t=r.a.useContext(p),a=t;return e&&(a="function"==typeof e?e(t):i({},t,{},e)),a},d=function(e){var t=c(e.components);return r.a.createElement(p.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},s=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,b=e.parentName,p=l(e,["components","mdxType","originalType","parentName"]),d=c(a),s=n,O=d["".concat(b,".").concat(s)]||d[s]||m[s]||o;return a?r.a.createElement(O,i({ref:t},p,{components:a})):r.a.createElement(O,i({ref:t},p))}));function O(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,b=new Array(o);b[0]=s;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:n,b[1]=i;for(var p=2;p<o;p++)b[p]=a[p];return r.a.createElement.apply(null,b)}return r.a.createElement.apply(null,a)}s.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/9b517c7f.faf51264.js b/9b517c7f.faf51264.js
deleted file mode 100644
index 47cdc2f3877..00000000000
--- a/9b517c7f.faf51264.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[96],{224:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return b})),a.d(t,"metadata",(function(){return i})),a.d(t,"rightToc",(function(){return l})),a.d(t,"default",(function(){return c}));var n=a(1),r=a(9),o=(a(0),a(312)),b={id:"swagger-codegen-migration",title:"Migrating from Swagger Codegen"},i={id:"swagger-codegen-migration",title:"Migrating from Swagger Codegen",description:"OpenAPI Generator is a fork of `swagger-codegen` between version `2.3.1` and `2.4.0`. For the reasons behind the fork, please refer to the [Q&A](https://github.com/OpenAPITools/openapi-generator/blob/master/docs/qna.md).",source:"@site/../docs/migration-from-swagger-codegen.md",permalink:"/docs/swagger-codegen-migration",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/migration-from-swagger-codegen.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Roadmap",permalink:"/docs/roadmap"},next:{title:"Swagger Codegen Fork: Q&A",permalink:"/docs/fork-qna"}},l=[{value:"New docker images",id:"new-docker-images",children:[]},{value:"New maven coordinates",id:"new-maven-coordinates",children:[]},{value:"Changes in Maven Plugin",id:"changes-in-maven-plugin",children:[]},{value:"New generators names",id:"new-generators-names",children:[]},{value:"New parameters name",id:"new-parameters-name",children:[]},{value:"Renamed Mustache Template Variables",id:"renamed-mustache-template-variables",children:[]},{value:"Ignore file",id:"ignore-file",children:[]},{value:"Metadata folder",id:"metadata-folder",children:[]},{value:"New default values for the generated code",id:"new-default-values-for-the-generated-code",children:[]},{value:"New fully qualified name for the classes",id:"new-fully-qualified-name-for-the-classes",children:[]},{value:"Body parameter name",id:"body-parameter-name",children:[]},{value:"Default basePath",id:"default-basepath",children:[]},{value:"Nullable",id:"nullable",children:[]}],p={rightToc:l};function c(e){var t=e.components,a=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},p,a,{components:t,mdxType:"MDXLayout"}),Object(o.b)("p",null,"OpenAPI Generator is a fork of ",Object(o.b)("inlineCode",{parentName:"p"},"swagger-codegen")," between version ",Object(o.b)("inlineCode",{parentName:"p"},"2.3.1")," and ",Object(o.b)("inlineCode",{parentName:"p"},"2.4.0"),". For the reasons behind the fork, please refer to the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/docs/qna.md"}),"Q&A"),'.\nThis community-driven version called "OpenAPI Generator" provides similar functionalities and can be used as drop-in replacement.\nThis guide explains the major differences in order to help you with the migration.'),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Table of contents")),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-docker-images"}),"New docker images")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-maven-coordinates"}),"New maven coordinates")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#changes-in-maven-plugin"}),"Changes in Maven Plugin")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-generators-names"}),"New generators names")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-parameters-name"}),"New parameters name")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#renamed-mustache-template-variables"}),"Renamed Mustache Template Variables")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#ignore-file"}),"Ignore file")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#metadata-folder"}),"metadata-folder")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-default-values-for-the-generated-code"}),"New default values for the generated code")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#new-fully-qualified-name-for-the-classes"}),"New fully qualified name for the classes")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#body-parameter-name"}),"Body parameter name")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#default-basepath"}),"Default basePath")),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"#nullable"}),"Nullable"))),Object(o.b)("h2",{id:"new-docker-images"},"New docker images"),Object(o.b)("p",null,"The docker images are available on DockerHub: ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://hub.docker.com/u/openapitools/"}),"https://hub.docker.com/u/openapitools/")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"CLI for OpenAPI Generator")),Object(o.b)("p",null,"Image to run OpenAPI Generator in the command line (see ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/README.md#openapi-generator-cli-docker-image"}),"OpenAPI Generator CLI Docker Image"),")"),Object(o.b)("p",null,"Old: ",Object(o.b)("inlineCode",{parentName:"p"},"swaggerapi/swagger-codegen-cli")),Object(o.b)("p",null,"New: ",Object(o.b)("inlineCode",{parentName:"p"},"openapitools/openapi-generator-cli")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"OpenAPI Generator as web service")),Object(o.b)("p",null,"Image to run OpenAPI Generator as a web service (see ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/README.md#openapi-generator-online-docker-image"}),"OpenAPI Generator Online Docker Image"),")"),Object(o.b)("p",null,"Old: ",Object(o.b)("inlineCode",{parentName:"p"},"swaggerapi/swagger-generator")),Object(o.b)("p",null,"New: ",Object(o.b)("inlineCode",{parentName:"p"},"openapitools/openapi-generator-online")),Object(o.b)("h2",{id:"new-maven-coordinates"},"New maven coordinates"),Object(o.b)("p",null,"You can find our released artefact on maven central:"),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Core:")),Object(o.b)("p",null,"Old:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger</groupId>\n    <artifactId>swagger-codegen</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"New:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator</artifactId>\n</dependency>\n")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Cli:")),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger</groupId>\n    <artifactId>swagger-codegen-cli</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"New:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator-cli</artifactId>\n</dependency>\n")),Object(o.b)("p",null,Object(o.b)("strong",{parentName:"p"},"Maven plugin:")),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger</groupId>\n    <artifactId>swagger-codegen-maven-plugin</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"New:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator-maven-plugin</artifactId>\n</dependency>\n")),Object(o.b)("h2",{id:"changes-in-maven-plugin"},"Changes in Maven Plugin"),Object(o.b)("p",null,"OpenAPI Generator 3.0.0 has introduced ",Object(o.b)("inlineCode",{parentName:"p"},"<generatorName>")," and deprecated ",Object(o.b)("inlineCode",{parentName:"p"},"<language>"),', because this refers to generator names which embed more than just "language".'),Object(o.b)("p",null,"If both options are present, you'll be presented with an error. If only ",Object(o.b)("inlineCode",{parentName:"p"},"<language>")," is provided, you'll be presented instructions for updating to the new config."),Object(o.b)("h2",{id:"new-generators-names"},"New generators names"),Object(o.b)("p",null,"When you run OpenAPI Generator, you need to select a target generator (",Object(o.b)("inlineCode",{parentName:"p"},"-g")," option in the cli).\nAll languages of ",Object(o.b)("inlineCode",{parentName:"p"},"swagger-codegen")," have been migrated to ",Object(o.b)("inlineCode",{parentName:"p"},"openapi-generator"),", but some names were changed, in order to be more consistent."),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"swagger-codegen")),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"openapi-generator")))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"akka-scala")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"scala-akka"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"scala")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"scala-httpclient"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"jaxrs")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"jaxrs-jersey"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"qt5cpp")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpp-qt5"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpprest")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpp-restsdk"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"tizen")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"cpp-tizen"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"sinatra")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"ruby-sinatra"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swift")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swift2-deprecated"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"lumen")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"php-lumen"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"slim")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"php-slim"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"ze-ph")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"php-mezzio-ph"))))),Object(o.b)("p",null,"We provide a temporary mapping in code for these old values. You'll receive a warning with instructions to migrate to the new names."),Object(o.b)("h2",{id:"new-parameters-name"},"New parameters name"),Object(o.b)("p",null,'Some parameters were renamed.\nOften you need to replace "Swagger", with "OpenAPI".\nSome examples:'),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"swagger-codegen")),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"name in ",Object(o.b)("inlineCode",{parentName:"th"},"openapi-generator")))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"debugSwagger")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"debugOpenAPI"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"GenerateSwaggerMetadata")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"GenerateOpenAPIMetadata"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swagger.codegen.undertow.apipackage")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"openapi.codegen.undertow.apipackage"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"swagger.codegen.undertow.modelpackage")),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"openapi.codegen.undertow.modelpackage"))))),Object(o.b)("h2",{id:"renamed-mustache-template-variables"},"Renamed Mustache Template Variables"),Object(o.b)("p",null,"The template variable ",Object(o.b)("inlineCode",{parentName:"p"},"{{datatype}}")," was renamed to ",Object(o.b)("inlineCode",{parentName:"p"},"{{dataType}}")," for consistency reason.\nCorresponding java code: ",Object(o.b)("inlineCode",{parentName:"p"},"CodegenProperty.datatype")," is renamed to ",Object(o.b)("inlineCode",{parentName:"p"},"CodegenProperty.dataType"),"."),Object(o.b)("p",null,"(If you're ",Object(o.b)("strong",{parentName:"p"},"not")," using customized templates with the ",Object(o.b)("inlineCode",{parentName:"p"},"-t")," option, you can ignore the mustache variable renaming above.)"),Object(o.b)("h2",{id:"ignore-file"},"Ignore file"),Object(o.b)("p",null,Object(o.b)("inlineCode",{parentName:"p"},".swagger-codegen-ignore")," is replaced by ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore"),".\nThe syntax inside the file stays the same."),Object(o.b)("p",null,"You don't need to rename the file manually, OpenAPI Generator will do it when your run it against an existing output directory.\n(When there is no ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," in a folder, if a ",Object(o.b)("inlineCode",{parentName:"p"},".swagger-codegen-ignore")," file is present it will be considered and renamed to ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore"),")."),Object(o.b)("h2",{id:"metadata-folder"},"Metadata folder"),Object(o.b)("p",null,"The metadata folder (to store the ",Object(o.b)("inlineCode",{parentName:"p"},"VERSION")," file for example) is now called ",Object(o.b)("inlineCode",{parentName:"p"},".openapi-generator/")," instead of ",Object(o.b)("inlineCode",{parentName:"p"},".swagger-codegen/"),"."),Object(o.b)("h2",{id:"new-default-values-for-the-generated-code"},"New default values for the generated code"),Object(o.b)("p",null,"If you use a generator without specifying each parameter, you might see some differences in the generated code.\nAs example the default package name used in the generated code has changed.\nYou need to have a look at the specific value, depending of your target language, but often ",Object(o.b)("inlineCode",{parentName:"p"},"Swagger")," \xees replaced by ",Object(o.b)("inlineCode",{parentName:"p"},"OpenAPITools")," and ",Object(o.b)("inlineCode",{parentName:"p"},"io.swagger")," is replaced by ",Object(o.b)("inlineCode",{parentName:"p"},"org.openapitools"),".\nConcretely if you did not specify anything when you are generating java code, a file ",Object(o.b)("inlineCode",{parentName:"p"},"org/openapitools/api/PetApi.java"),"  might be generated instead of ",Object(o.b)("inlineCode",{parentName:"p"},"io/swagger/api/PetApi.java"),"."),Object(o.b)("p",null,"If this is a problem for you, you need to explicitly set the the parameter value in order to match with the ",Object(o.b)("inlineCode",{parentName:"p"},"swagger-codgen")," default value (",Object(o.b)("inlineCode",{parentName:"p"},"apiPackage")," == ",Object(o.b)("inlineCode",{parentName:"p"},"io.swagger")," in the previous example with the java generator)."),Object(o.b)("h2",{id:"new-fully-qualified-name-for-the-classes"},"New fully qualified name for the classes"),Object(o.b)("p",null,"If you have extended some generators in your project, and you are looking for a specific class, replace the ",Object(o.b)("inlineCode",{parentName:"p"},"io.swagger.codegen")," package (old name) with ",Object(o.b)("inlineCode",{parentName:"p"},"org.openapitools.codegen")," package (new name)."),Object(o.b)("p",null,"Example: ",Object(o.b)("inlineCode",{parentName:"p"},"org.openapitools.codegen.DefaultGenerator")),Object(o.b)("h2",{id:"body-parameter-name"},"Body parameter name"),Object(o.b)("p",null,"\u203c\ufe0f Since 4.0.0-beta, the body parameter name in OAS v2 is automatically preserved in the vendor extension ",Object(o.b)("inlineCode",{parentName:"p"},"x-codegen-request-body-name")),Object(o.b)("p",null,"In OpenAPI spec v3, there's no body parameter, which is replaced by ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#request-body-object"}),"Request Body Object"),'. The parameter name for Request Body is named automatically based on the model name (e.g. User). To control how the "Request Body" parameter is named, please add the vendor extension ',Object(o.b)("inlineCode",{parentName:"p"},"x-codegen-request-body-name")," to the operation:"),Object(o.b)("p",null,"OpenAPI Spec v3:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-yaml"}),"paths:\n  /pet:\n    post:\n      tags:\n        - pet\n      summary: Add a new pet to the store\n      description: ''\n      operationId: addPet\n      x-codegen-request-body-name: new_body_name\n      responses:\n        '405':\n          description: Invalid input\n      security:\n        - petstore_auth:\n            - 'write:pets'\n            - 'read:pets'\n      requestBody:\n        $ref: '#/components/requestBodies/Pet'\n")),Object(o.b)("p",null,"OpenAPI Spec v2:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-yaml"}),"paths:\n  /pet:\n    post:\n      tags:\n        - pet\n      summary: Add a new pet to the store\n      description: ''\n      operationId: addPet\n      x-codegen-request-body-name: new_body_name\n      consumes:\n        - application/json\n        - application/xml\n      produces:\n        - application/xml\n        - application/json\n      parameters:\n        - in: body\n          name: body\n          description: Pet object that needs to be added to the store\n          required: true\n          schema:\n            $ref: '#/definitions/Pet'\n      responses:\n        '405':\n          description: Invalid input\n      security:\n        - petstore_auth:\n            - 'write:pets'\n            - 'read:pets'\n")),Object(o.b)("p",null,"If your API client is using named parameters in the function call (e.g. Perl required & optional parameters, Ruby optional parameters), you will need to add ",Object(o.b)("inlineCode",{parentName:"p"},"x-codegen-request-body-name")," to the spec to restore the original body parameter name."),Object(o.b)("h2",{id:"default-basepath"},"Default basePath"),Object(o.b)("p",null,"The default ",Object(o.b)("inlineCode",{parentName:"p"},"basePath")," has been changed from ",Object(o.b)("inlineCode",{parentName:"p"},"https://localhost")," to ",Object(o.b)("inlineCode",{parentName:"p"},"http://localhost")," (http without s)"),Object(o.b)("h2",{id:"nullable"},"Nullable"),Object(o.b)("p",null,"OpenAPI spec v3 has better support for ",Object(o.b)("inlineCode",{parentName:"p"},"nullable"),". If you're still using OpenAPI/Swagger spec v2, please use ",Object(o.b)("inlineCode",{parentName:"p"},"x-nullable: true")," instead."))}c.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return d})),a.d(t,"b",(function(){return O}));var n=a(0),r=a.n(n);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function b(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function i(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?b(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):b(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function l(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var p=r.a.createContext({}),c=function(e){var t=r.a.useContext(p),a=t;return e&&(a="function"==typeof e?e(t):i({},t,{},e)),a},d=function(e){var t=c(e.components);return r.a.createElement(p.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},s=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,b=e.parentName,p=l(e,["components","mdxType","originalType","parentName"]),d=c(a),s=n,O=d["".concat(b,".").concat(s)]||d[s]||m[s]||o;return a?r.a.createElement(O,i({ref:t},p,{components:a})):r.a.createElement(O,i({ref:t},p))}));function O(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,b=new Array(o);b[0]=s;var i={};for(var l in t)hasOwnProperty.call(t,l)&&(i[l]=t[l]);i.originalType=e,i.mdxType="string"==typeof e?e:n,b[1]=i;for(var p=2;p<o;p++)b[p]=a[p];return r.a.createElement.apply(null,b)}return r.a.createElement.apply(null,a)}s.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/9cbcc25e.e39b6862.js b/9cbcc25e.e39b6862.js
new file mode 100644
index 00000000000..ac81df2d0cb
--- /dev/null
+++ b/9cbcc25e.e39b6862.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[97],{225:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return o})),r.d(t,"metadata",(function(){return l})),r.d(t,"rightToc",(function(){return i})),r.d(t,"default",(function(){return p}));var n=r(1),a=r(9),c=(r(0),r(312)),o={id:"release-summary",title:"Release Summary"},l={id:"release-summary",title:"Release Summary",description:"## Versioning",source:"@site/../docs/release-summary.md",permalink:"/docs/release-summary",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/release-summary.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Swagger Codegen Fork: Q&A",permalink:"/docs/fork-qna"},next:{title:"Release Notes: 3.0.0",permalink:"/docs/release-3-0-0"}},i=[{value:"Versioning",id:"versioning",children:[]},{value:"Cadence",id:"cadence",children:[]}],b={rightToc:i};function p(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(c.b)("wrapper",Object(n.a)({},b,r,{components:t,mdxType:"MDXLayout"}),Object(c.b)("h2",{id:"versioning"},"Versioning"),Object(c.b)("p",null,"We version artifacts in the common ",Object(c.b)("inlineCode",{parentName:"p"},"major.minor.patch")," strategy."),Object(c.b)("p",null,"We decided versions should be incremented according to the following rules. The examples provided below are not exhaustive."),Object(c.b)("table",null,Object(c.b)("thead",{parentName:"table"},Object(c.b)("tr",{parentName:"thead"},Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"right"}),"Part"),Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"center"}),"Breaking Changes?"),Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"left"}),"Rule"),Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"left"}),"Examples"))),Object(c.b)("tbody",{parentName:"table"},Object(c.b)("tr",{parentName:"tbody"},Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}),"major"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"YES"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),"breaking changes without fallback"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),Object(c.b)("ul",null,Object(c.b)("li",null,"New Features"),Object(c.b)("li",null,"Large refactors"),Object(c.b)("li",null,"Removal of deprecated code"),Object(c.b)("li",null,"Changes to coding interfaces"),Object(c.b)("li",null,"Large changes to template bound variables")))),Object(c.b)("tr",{parentName:"tbody"},Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}),"minor"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"ALLOWED"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),"breaking changes with fallback"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),Object(c.b)("ul",null,Object(c.b)("li",null,"Adding new generator behavior which doesn't affect custom templates (or does, with config option for old behavior)"),Object(c.b)("li",null,"Changing generator templates in a way in which switching to custom templates results in old behavior"),Object(c.b)("li",null,"Introducing deprecated methods in generators or other shared code")))),Object(c.b)("tr",{parentName:"tbody"},Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}),"patch"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"NO"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),"new features without breaking changes"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),Object(c.b)("ul",null,Object(c.b)("li",null,"New generators"),Object(c.b)("li",null,"Bug fixes in template or generators")))))),Object(c.b)("h2",{id:"cadence"},"Cadence"),Object(c.b)("p",null,"For patch release (e.g. 3.0.5 to 3.0.6), we plan to do it on a ",Object(c.b)("em",{parentName:"p"},"weekly basis"),"."),Object(c.b)("p",null,"For minor release (e.g. 3.1.6 to 3.2.0), we plan to do it on a ",Object(c.b)("em",{parentName:"p"},"monthly basis"),"."),Object(c.b)("p",null,"For major releases (e.g. 3.3.6 to 4.0.0), we plan to do it on a ",Object(c.b)("em",{parentName:"p"},"quarterly basis"),"."))}p.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return s})),r.d(t,"b",(function(){return m}));var n=r(0),a=r.n(n);function c(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function l(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?o(Object(r),!0).forEach((function(t){c(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):o(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function i(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},c=Object.keys(e);for(n=0;n<c.length;n++)r=c[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var c=Object.getOwnPropertySymbols(e);for(n=0;n<c.length;n++)r=c[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var b=a.a.createContext({}),p=function(e){var t=a.a.useContext(b),r=t;return e&&(r="function"==typeof e?e(t):l({},t,{},e)),r},s=function(e){var t=p(e.components);return a.a.createElement(b.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},d=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,c=e.originalType,o=e.parentName,b=i(e,["components","mdxType","originalType","parentName"]),s=p(r),d=n,m=s["".concat(o,".").concat(d)]||s[d]||u[d]||c;return r?a.a.createElement(m,l({ref:t},b,{components:r})):a.a.createElement(m,l({ref:t},b))}));function m(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var c=r.length,o=new Array(c);o[0]=d;var l={};for(var i in t)hasOwnProperty.call(t,i)&&(l[i]=t[i]);l.originalType=e,l.mdxType="string"==typeof e?e:n,o[1]=l;for(var b=2;b<c;b++)o[b]=r[b];return a.a.createElement.apply(null,o)}return a.a.createElement.apply(null,r)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/9cbcc25e.e906fc50.js b/9cbcc25e.e906fc50.js
deleted file mode 100644
index 007fa6e709b..00000000000
--- a/9cbcc25e.e906fc50.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[97],{225:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return o})),r.d(t,"metadata",(function(){return l})),r.d(t,"rightToc",(function(){return i})),r.d(t,"default",(function(){return p}));var n=r(1),a=r(9),c=(r(0),r(312)),o={id:"release-summary",title:"Release Summary"},l={id:"release-summary",title:"Release Summary",description:"## Versioning",source:"@site/../docs/release-summary.md",permalink:"/docs/release-summary",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/release-summary.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Swagger Codegen Fork: Q&A",permalink:"/docs/fork-qna"},next:{title:"Release Notes: 3.0.0",permalink:"/docs/release-3-0-0"}},i=[{value:"Versioning",id:"versioning",children:[]},{value:"Cadence",id:"cadence",children:[]}],b={rightToc:i};function p(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(c.b)("wrapper",Object(n.a)({},b,r,{components:t,mdxType:"MDXLayout"}),Object(c.b)("h2",{id:"versioning"},"Versioning"),Object(c.b)("p",null,"We version artifacts in the common ",Object(c.b)("inlineCode",{parentName:"p"},"major.minor.patch")," strategy."),Object(c.b)("p",null,"We decided versions should be incremented according to the following rules. The examples provided below are not exhaustive."),Object(c.b)("table",null,Object(c.b)("thead",{parentName:"table"},Object(c.b)("tr",{parentName:"thead"},Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"right"}),"Part"),Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"center"}),"Breaking Changes?"),Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"left"}),"Rule"),Object(c.b)("th",Object(n.a)({parentName:"tr"},{align:"left"}),"Examples"))),Object(c.b)("tbody",{parentName:"table"},Object(c.b)("tr",{parentName:"tbody"},Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}),"major"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"YES"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),"breaking changes without fallback"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),Object(c.b)("ul",null,Object(c.b)("li",null,"New Features"),Object(c.b)("li",null,"Large refactors"),Object(c.b)("li",null,"Removal of deprecated code"),Object(c.b)("li",null,"Changes to coding interfaces"),Object(c.b)("li",null,"Large changes to template bound variables")))),Object(c.b)("tr",{parentName:"tbody"},Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}),"minor"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"ALLOWED"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),"breaking changes with fallback"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),Object(c.b)("ul",null,Object(c.b)("li",null,"Adding new generator behavior which doesn't affect custom templates (or does, with config option for old behavior)"),Object(c.b)("li",null,"Changing generator templates in a way in which switching to custom templates results in old behavior"),Object(c.b)("li",null,"Introducing deprecated methods in generators or other shared code")))),Object(c.b)("tr",{parentName:"tbody"},Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"right"}),"patch"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"center"}),"NO"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),"new features without breaking changes"),Object(c.b)("td",Object(n.a)({parentName:"tr"},{align:"left"}),Object(c.b)("ul",null,Object(c.b)("li",null,"New generators"),Object(c.b)("li",null,"Bug fixes in template or generators")))))),Object(c.b)("h2",{id:"cadence"},"Cadence"),Object(c.b)("p",null,"For patch release (e.g. 3.0.5 to 3.0.6), we plan to do it on a ",Object(c.b)("em",{parentName:"p"},"weekly basis"),"."),Object(c.b)("p",null,"For minor release (e.g. 3.1.6 to 3.2.0), we plan to do it on a ",Object(c.b)("em",{parentName:"p"},"monthly basis"),"."),Object(c.b)("p",null,"For major releases (e.g. 3.3.6 to 4.0.0), we plan to do it on a ",Object(c.b)("em",{parentName:"p"},"quarterly basis"),"."))}p.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return s})),r.d(t,"b",(function(){return m}));var n=r(0),a=r.n(n);function c(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function l(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?o(Object(r),!0).forEach((function(t){c(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):o(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function i(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},c=Object.keys(e);for(n=0;n<c.length;n++)r=c[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var c=Object.getOwnPropertySymbols(e);for(n=0;n<c.length;n++)r=c[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var b=a.a.createContext({}),p=function(e){var t=a.a.useContext(b),r=t;return e&&(r="function"==typeof e?e(t):l({},t,{},e)),r},s=function(e){var t=p(e.components);return a.a.createElement(b.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},d=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,c=e.originalType,o=e.parentName,b=i(e,["components","mdxType","originalType","parentName"]),s=p(r),d=n,m=s["".concat(o,".").concat(d)]||s[d]||u[d]||c;return r?a.a.createElement(m,l({ref:t},b,{components:r})):a.a.createElement(m,l({ref:t},b))}));function m(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var c=r.length,o=new Array(c);o[0]=d;var l={};for(var i in t)hasOwnProperty.call(t,i)&&(l[i]=t[i]);l.originalType=e,l.mdxType="string"==typeof e?e:n,o[1]=l;for(var b=2;b<c;b++)o[b]=r[b];return a.a.createElement.apply(null,o)}return a.a.createElement.apply(null,r)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/9d9ec3e3.51da6e88.js b/9d9ec3e3.51da6e88.js
deleted file mode 100644
index c3f543eab6c..00000000000
--- a/9d9ec3e3.51da6e88.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[101],{229:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Documentation for the java-micronaut-client Generator"},c={id:"generators/java-micronaut-client",title:"Documentation for the java-micronaut-client Generator",description:"## METADATA",source:"@site/../docs/generators/java-micronaut-client.md",permalink:"/docs/generators/java-micronaut-client",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-client.md",lastUpdatedBy:"Justin Black",lastUpdatedAt:1650213369},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"SUPPORTED VENDOR EXTENSIONS",id:"supported-vendor-extensions",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("h2",{id:"metadata"},"METADATA"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Value"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Notes"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java-micronaut-client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator stability"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BETA"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CLIENT"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator language"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"mustache"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generates a Java Micronaut Client."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))))),Object(l.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalEnumTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for enum type(class level annotations)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalModelTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated api classes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.api")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactDescription"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact description in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI Java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi-micronaut")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact version in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"bigDecimalAsString"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Treat BigDecimal values as Strings to avoid precision loss."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"get")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"build"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify for which build tool to generate files"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"gradle")),Object(l.b)("dd",null,"Gradle configuration is generated for the project"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"all")),Object(l.b)("dd",null,"Both Gradle and Maven configurations are generated"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"maven")),Object(l.b)("dd",null,"Maven configuration is generated for the project"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"all")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"configureAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Configure all the authorization methods as specified in the file"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Option. Date library to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8-localdatetime")),Object(l.b)("dd",null,"Java 8 using LocalDateTime (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8")),Object(l.b)("dd",null,"Java 8 native JSR310 (preferred for jdk 1.8+)"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java8")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"datetimeFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date-time as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerEmail"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer email in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"team@openapitools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer name in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI-Generator Contributors")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganization"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPITools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganizationUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://openapitools.org"}),"http://openapitools.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disableHtmlEscaping"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"discriminatorCaseSensitive"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumUnknownDefaultCase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"No changes to the enum's are made, this is the default option."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"fullJavaUtil"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to use fully qualified name for classes under java.util. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ignoreAnyOfInEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ignore anyOf keyword in enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters in the generated API methods using @ApiImplicitParams annotation."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeadersRegex"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"invokerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"root package for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Unlicense")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://unlicense.org"}),"http://unlicense.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"micronautVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Micronaut version, only ",">","=3.0.0 versions are supported"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"3.3.1")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.model")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openApiNullable"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enable OpenAPI Jackson Nullable library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentArtifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentGroupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"requiredPropertiesInConstructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allow only to create models with all the required properties provided in constructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmDeveloperConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM developer connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean - toggle ",'"',"implements Serializable",'"'," for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"snapshotVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uses a SNAPSHOT version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Use a SnapShot Version"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"Use a Release Version"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"src/main/java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"test"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify which test tool to generate files for"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"junit")),Object(l.b)("dd",null,"Use JUnit as test tool"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"spock")),Object(l.b)("dd",null,"Use Spock as test tool"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"junit")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"testOutput"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set output folder for models and APIs tests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"${project.build.directory}/generated-test-sources/openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"title"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Client service name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use BeanValidation API annotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"supported-vendor-extensions"},"SUPPORTED VENDOR EXTENSIONS"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Extension name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Applicable for"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default value"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-discriminator-value"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Used with model inheritance to specify value for discriminator that identifies current model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ability to specify interfaces that model must implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"empty array")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-setter-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom annotation that can be specified over java setter for specific field"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"When field is array & uniqueItems, then this extension is used to add ",Object(l.b)("inlineCode",{parentName:"td"},"@JsonDeserialize(as = LinkedHashSet.class)")," over setter, otherwise no value")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-tags"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify multiple swagger tags for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-accepts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Accept' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-content-type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Content-Type' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-class-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-field-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to property"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BigDecimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.math.BigDecimal")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Date")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.io.File")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.LinkedHashSet")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDate"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Map")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Timestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.sql.Timestamp")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"URI"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.net.URI")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UUID"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.UUID")))),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet")))),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Boolean"),Object(l.b)("li",null,"Double"),Object(l.b)("li",null,"Float"),Object(l.b)("li",null,"Integer"),Object(l.b)("li",null,"Long"),Object(l.b)("li",null,"Object"),Object(l.b)("li",null,"String"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"byte[]")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"abstract"),Object(l.b)("li",null,"apiclient"),Object(l.b)("li",null,"apiexception"),Object(l.b)("li",null,"apiresponse"),Object(l.b)("li",null,"application"),Object(l.b)("li",null,"assert"),Object(l.b)("li",null,"authorization"),Object(l.b)("li",null,"body"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"client"),Object(l.b)("li",null,"configuration"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"cookie"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"extends"),Object(l.b)("li",null,"file"),Object(l.b)("li",null,"final"),Object(l.b)("li",null,"finally"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"format"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"header"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"implements"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"instanceof"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"list"),Object(l.b)("li",null,"localreturntype"),Object(l.b)("li",null,"localvaraccept"),Object(l.b)("li",null,"localvaraccepts"),Object(l.b)("li",null,"localvarauthnames"),Object(l.b)("li",null,"localvarcollectionqueryparams"),Object(l.b)("li",null,"localvarcontenttype"),Object(l.b)("li",null,"localvarcontenttypes"),Object(l.b)("li",null,"localvarcookieparams"),Object(l.b)("li",null,"localvarformparams"),Object(l.b)("li",null,"localvarheaderparams"),Object(l.b)("li",null,"localvarpath"),Object(l.b)("li",null,"localvarpostbody"),Object(l.b)("li",null,"localvarqueryparams"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"native"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"null"),Object(l.b)("li",null,"object"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"pathvariable"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"queryparam"),Object(l.b)("li",null,"queryvalue"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"strictfp"),Object(l.b)("li",null,"stringutil"),Object(l.b)("li",null,"super"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"synchronized"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"throws"),Object(l.b)("li",null,"transient"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"while")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uuid"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Null"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"AnyType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Object"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"anyOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"oneOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"not"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return u}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},m=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),m=n,u=p["".concat(r,".").concat(m)]||p[m]||d[m]||l;return a?b.a.createElement(u,c({ref:e},j,{components:a})):b.a.createElement(u,c({ref:e},j))}));function u(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=m;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/9d9ec3e3.93741e5c.js b/9d9ec3e3.93741e5c.js
new file mode 100644
index 00000000000..29b966ec494
--- /dev/null
+++ b/9d9ec3e3.93741e5c.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[101],{229:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Documentation for the java-micronaut-client Generator"},c={id:"generators/java-micronaut-client",title:"Documentation for the java-micronaut-client Generator",description:"## METADATA",source:"@site/../docs/generators/java-micronaut-client.md",permalink:"/docs/generators/java-micronaut-client",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-client.md",lastUpdatedBy:"Auke Schrijnen",lastUpdatedAt:1650509636},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"SUPPORTED VENDOR EXTENSIONS",id:"supported-vendor-extensions",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("h2",{id:"metadata"},"METADATA"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Value"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Notes"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java-micronaut-client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator stability"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BETA"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CLIENT"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator language"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Java"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"mustache"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generates a Java Micronaut Client."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))))),Object(l.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalEnumTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for enum type(class level annotations)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"additionalModelTypeAnnotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated api classes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.api")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactDescription"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact description in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI Java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactId in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi-micronaut")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifactVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"artifact version in generated pom.xml. This also becomes part of the generated library's filename"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"bigDecimalAsString"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Treat BigDecimal values as Strings to avoid precision loss."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set booleanGetterPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"get")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"build"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify for which build tool to generate files"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"gradle")),Object(l.b)("dd",null,"Gradle configuration is generated for the project"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"all")),Object(l.b)("dd",null,"Both Gradle and Maven configurations are generated"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"maven")),Object(l.b)("dd",null,"Maven configuration is generated for the project"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"all")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"configureAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Configure all the authorization methods as specified in the file"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"dateLibrary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Option. Date library to use"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8-localdatetime")),Object(l.b)("dd",null,"Java 8 using LocalDateTime (for legacy app only)"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"java8")),Object(l.b)("dd",null,"Java 8 native JSR310 (preferred for jdk 1.8+)"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java8")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"datetimeFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the format pattern of date-time as a string"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerEmail"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer email in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"team@openapitools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer name in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPI-Generator Contributors")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganization"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenAPITools.org")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developerOrganizationUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"developer organization URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://openapitools.org"}),"http://openapitools.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disableHtmlEscaping"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"discriminatorCaseSensitive"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumUnknownDefaultCase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"No changes to the enum's are made, this is the default option."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"With this option enabled, each enum will have a new case, 'unknown_default_open_api', so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"fullJavaUtil"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to use fully qualified name for classes under java.util. This option only works for Java API client"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"groupId in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ignoreAnyOfInEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ignore anyOf keyword in enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeaders"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters in the generated API methods using @ApiImplicitParams annotation."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"implicitHeadersRegex"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"invokerPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"root package for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Unlicense")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"http://unlicense.org"}),"http://unlicense.org"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"micronautVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Micronaut version, only ",">","=3.0.0 versions are supported"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"3.3.1")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelPackage"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"package for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.model")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openApiNullable"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enable OpenAPI Jackson Nullable library"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentArtifactId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentGroupId"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parentVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"requiredPropertiesInConstructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allow only to create models with all the required properties provided in constructor"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmDeveloperConnection"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM developer connection in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scm:git:git@github.com:openapitools/openapi-generator.git")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"scmUrl"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"SCM URL in generated pom.xml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(n.a)({parentName:"td"},{href:"https://github.com/openapitools/openapi-generator"}),"https://github.com/openapitools/openapi-generator"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"serializableModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean - toggle ",'"',"implements Serializable",'"'," for generated models"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"snapshotVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uses a SNAPSHOT version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Use a SnapShot Version"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"Use a Release Version"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"src/main/java")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"test"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify which test tool to generate files for"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"junit")),Object(l.b)("dd",null,"Use JUnit as test tool"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"spock")),Object(l.b)("dd",null,"Use Spock as test tool"))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"junit")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"testOutput"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set output folder for models and APIs tests"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"${project.build.directory}/generated-test-sources/openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"title"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Client service name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useBeanValidation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use BeanValidation API annotations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useOptional"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use Optional container for optional parameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"supported-vendor-extensions"},"SUPPORTED VENDOR EXTENSIONS"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Extension name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Applicable for"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default value"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-discriminator-value"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Used with model inheritance to specify value for discriminator that identifies current model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Ability to specify interfaces that model must implements"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"empty array")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-setter-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom annotation that can be specified over java setter for specific field"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"When field is array & uniqueItems, then this extension is used to add ",Object(l.b)("inlineCode",{parentName:"td"},"@JsonDeserialize(as = LinkedHashSet.class)")," over setter, otherwise no value")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-tags"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify multiple swagger tags for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-accepts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Accept' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-content-type"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify custom value for 'Content-Type' header for operation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OPERATION"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-class-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MODEL"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"x-field-extra-annotation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List of custom annotations to be added to property"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FIELD"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"null")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BigDecimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.math.BigDecimal")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Date")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.io.File")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.LinkedHashSet")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"List"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDate"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalDateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LocalTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.joda.time.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.Map")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.*")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Timestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.sql.Timestamp")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"URI"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.net.URI")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UUID"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"java.util.UUID")))),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayList")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"map"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"HashMap")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"set"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkedHashSet")))),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Boolean"),Object(l.b)("li",null,"Double"),Object(l.b)("li",null,"Float"),Object(l.b)("li",null,"Integer"),Object(l.b)("li",null,"Long"),Object(l.b)("li",null,"Object"),Object(l.b)("li",null,"String"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"byte[]")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"abstract"),Object(l.b)("li",null,"apiclient"),Object(l.b)("li",null,"apiexception"),Object(l.b)("li",null,"apiresponse"),Object(l.b)("li",null,"application"),Object(l.b)("li",null,"assert"),Object(l.b)("li",null,"authorization"),Object(l.b)("li",null,"body"),Object(l.b)("li",null,"boolean"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"client"),Object(l.b)("li",null,"configuration"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"cookie"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"extends"),Object(l.b)("li",null,"file"),Object(l.b)("li",null,"final"),Object(l.b)("li",null,"finally"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"format"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"header"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"implements"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"instanceof"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"list"),Object(l.b)("li",null,"localreturntype"),Object(l.b)("li",null,"localvaraccept"),Object(l.b)("li",null,"localvaraccepts"),Object(l.b)("li",null,"localvarauthnames"),Object(l.b)("li",null,"localvarcollectionqueryparams"),Object(l.b)("li",null,"localvarcontenttype"),Object(l.b)("li",null,"localvarcontenttypes"),Object(l.b)("li",null,"localvarcookieparams"),Object(l.b)("li",null,"localvarformparams"),Object(l.b)("li",null,"localvarheaderparams"),Object(l.b)("li",null,"localvarpath"),Object(l.b)("li",null,"localvarpostbody"),Object(l.b)("li",null,"localvarqueryparams"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"native"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"null"),Object(l.b)("li",null,"object"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"pathvariable"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"queryparam"),Object(l.b)("li",null,"queryvalue"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"strictfp"),Object(l.b)("li",null,"stringutil"),Object(l.b)("li",null,"super"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"synchronized"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"throws"),Object(l.b)("li",null,"transient"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"while")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Uuid"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Null"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"AnyType"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Object"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"anyOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"oneOf"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"not"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return u}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},m=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),m=n,u=p["".concat(r,".").concat(m)]||p[m]||d[m]||l;return a?b.a.createElement(u,c({ref:e},j,{components:a})):b.a.createElement(u,c({ref:e},j))}));function u(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=m;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/a43f9649.742d4b78.js b/a43f9649.742d4b78.js
new file mode 100644
index 00000000000..fd60bde224b
--- /dev/null
+++ b/a43f9649.742d4b78.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[108],{236:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var b=a(1),n=a(9),l=(a(0),a(312)),r={title:"Documentation for the csharp-netcore-functions Generator"},c={id:"generators/csharp-netcore-functions",title:"Documentation for the csharp-netcore-functions Generator",description:"## METADATA",source:"@site/../docs/generators/csharp-netcore-functions.md",permalink:"/docs/generators/csharp-netcore-functions",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/csharp-netcore-functions.md",lastUpdatedBy:"William Cheng",lastUpdatedAt:1650476423},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(n.a)(t,["components"]);return Object(l.b)("wrapper",Object(b.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("h2",{id:"metadata"},"METADATA"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Property"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Value"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Notes"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator name"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"csharp-netcore-functions"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator stability"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"STABLE"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator type"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"SERVER"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator language"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"C#"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"mustache"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Creates Azure function templates on top of the models/converters created by the C# codegens. This function is contained in a partial class. Default Get/Create/Patch/Post etc. methods are created with an underscore prefix. The assumption is that when the function is implemented, the partial class will be completed with another partial class. The implementing code should be located in a method of the same name, only without the underscore prefix. If no such method is found then the function will throw a Not Implemented exception. This setup allows the endpoints to be specified in the schema at build time, and separated from the implementing function."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}))))),Object(l.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(b.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"azureFunctionsVersion"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Azure functions version: v4, v3"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"v4")),Object(l.b)("dd",null,"Azure Functions v4"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"v3")),Object(l.b)("dd",null,"Azure Functions v3"))),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"v4")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"buildTarget"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Target to build an application or library"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"program")),Object(l.b)("dd",null,"Generate code for a standalone server"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"library")),Object(l.b)("dd",null,"Generate code for a server abstract class library"))),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"program")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"classModifier"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Class Modifier for function classes: Empty string or abstract."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"enumNameSuffix"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Suffix that will be appended to all enum names."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Enum")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"enumValueSuffix"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Suffix that will be appended to all enum values."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Enum")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generateBody"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Generates method body."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"licenseName"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"NoLicense")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(l.b)("a",Object(b.a)({parentName:"td"},{href:"http://localhost"}),"http://localhost"))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"modelClassModifier"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Model Class Modifier can be nothing or partial"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"partial")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"netCoreVersion"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),".NET Core version: 6.0, 5.0, 3.1, 3.0"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"3.0")),Object(l.b)("dd",null,".NET Core 3.0"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"3.1")),Object(l.b)("dd",null,".NET Core 3.1"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"5.0")),Object(l.b)("dd",null,".NET Core 5.0"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"6.0")),Object(l.b)("dd",null,".NET Core 6.0"))),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"3.1")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"newtonsoftVersion"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Version for Newtonsoft.Json for .NET Core 3.0+"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"3.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"nullableReferenceTypes"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Use nullable annotations in the project. Only supported on C# 8 / ASP.NET Core 3.1 or newer."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"operationIsAsync"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Set methods to async or sync (default)."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"operationModifier"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Operation Modifier can be virtual or abstract"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"virtual")),Object(l.b)("dd",null,"Keep method virtual"),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"abstract")),Object(l.b)("dd",null,"Make method abstract"))),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"virtual")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"operationResultTask"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Set methods result to Task","<",">","."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageAuthors"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies Authors property in the .NET Core project file."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OpenAPI")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageCopyright"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies an AssemblyCopyright for the .NET Framework global assembly attributes stored in the AssemblyInfo file."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"No Copyright")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageDescription"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies a AssemblyDescription for the .NET Framework global assembly attributes stored in the AssemblyInfo file."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"A library generated from a OpenAPI doc")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageGuid"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"The GUID that will be associated with the C# project"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"null")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageName"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"C# package name (convention: Title.Case)."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Org.OpenAPITools")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageTitle"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies an AssemblyTitle for the .NET Framework global assembly attributes stored in the AssemblyInfo file."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OpenAPI Library")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageVersion"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"C# package version."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"returnICollection"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Return ICollection","<","T",">"," instead of the concrete type."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"src")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"useCollection"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Deserialize array types to Collection","<","T",">"," instead of List","<","T",">","."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"useDateTimeOffset"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Use DateTimeOffset to model date-time properties"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"useNewtonsoft"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Uses the Newtonsoft JSON library."),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"true")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"array"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"list"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"List")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"map"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Dictionary")))),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Boolean"),Object(l.b)("li",null,"Collection"),Object(l.b)("li",null,"DateTime"),Object(l.b)("li",null,"DateTime?"),Object(l.b)("li",null,"DateTimeOffset"),Object(l.b)("li",null,"DateTimeOffset?"),Object(l.b)("li",null,"Decimal"),Object(l.b)("li",null,"Dictionary"),Object(l.b)("li",null,"Double"),Object(l.b)("li",null,"Float"),Object(l.b)("li",null,"Guid"),Object(l.b)("li",null,"Guid?"),Object(l.b)("li",null,"ICollection"),Object(l.b)("li",null,"Int32"),Object(l.b)("li",null,"Int64"),Object(l.b)("li",null,"List"),Object(l.b)("li",null,"Object"),Object(l.b)("li",null,"String"),Object(l.b)("li",null,"System.IO.Stream"),Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"bool?"),Object(l.b)("li",null,"byte[]"),Object(l.b)("li",null,"decimal"),Object(l.b)("li",null,"decimal?"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"double?"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"float?"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"int?"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"long?"),Object(l.b)("li",null,"string")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"Client"),Object(l.b)("li",null,"Configuration"),Object(l.b)("li",null,"Version"),Object(l.b)("li",null,"abstract"),Object(l.b)("li",null,"as"),Object(l.b)("li",null,"async"),Object(l.b)("li",null,"await"),Object(l.b)("li",null,"base"),Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"checked"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"client"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"decimal"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"delegate"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"dynamic"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"event"),Object(l.b)("li",null,"explicit"),Object(l.b)("li",null,"extern"),Object(l.b)("li",null,"false"),Object(l.b)("li",null,"finally"),Object(l.b)("li",null,"fixed"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"foreach"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"implicit"),Object(l.b)("li",null,"in"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"internal"),Object(l.b)("li",null,"is"),Object(l.b)("li",null,"localVarFileParams"),Object(l.b)("li",null,"localVarFormParams"),Object(l.b)("li",null,"localVarHeaderParams"),Object(l.b)("li",null,"localVarHttpContentType"),Object(l.b)("li",null,"localVarHttpContentTypes"),Object(l.b)("li",null,"localVarHttpHeaderAccept"),Object(l.b)("li",null,"localVarHttpHeaderAccepts"),Object(l.b)("li",null,"localVarPath"),Object(l.b)("li",null,"localVarPathParams"),Object(l.b)("li",null,"localVarPostBody"),Object(l.b)("li",null,"localVarQueryParams"),Object(l.b)("li",null,"localVarResponse"),Object(l.b)("li",null,"localVarStatusCode"),Object(l.b)("li",null,"lock"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"namespace"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"null"),Object(l.b)("li",null,"object"),Object(l.b)("li",null,"operator"),Object(l.b)("li",null,"out"),Object(l.b)("li",null,"override"),Object(l.b)("li",null,"parameter"),Object(l.b)("li",null,"params"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"readonly"),Object(l.b)("li",null,"ref"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"sbyte"),Object(l.b)("li",null,"sealed"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"sizeof"),Object(l.b)("li",null,"stackalloc"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"string"),Object(l.b)("li",null,"struct"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"true"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"typeof"),Object(l.b)("li",null,"uint"),Object(l.b)("li",null,"ulong"),Object(l.b)("li",null,"unchecked"),Object(l.b)("li",null,"unsafe"),Object(l.b)("li",null,"ushort"),Object(l.b)("li",null,"using"),Object(l.b)("li",null,"var"),Object(l.b)("li",null,"virtual"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"while"),Object(l.b)("li",null,"yield")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Uuid"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Null"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"AnyType"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Object"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"allOf"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"anyOf"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"oneOf"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"not"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return u})),a.d(e,"b",(function(){return m}));var b=a(0),n=a.n(b);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var b=Object.getOwnPropertySymbols(t);e&&(b=b.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,b)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,b,n=function(t,e){if(null==t)return{};var a,b,n={},l=Object.keys(t);for(b=0;b<l.length;b++)a=l[b],e.indexOf(a)>=0||(n[a]=t[a]);return n}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(b=0;b<l.length;b++)a=l[b],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(n[a]=t[a])}return n}var j=n.a.createContext({}),i=function(t){var e=n.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},u=function(t){var e=i(t.components);return n.a.createElement(j.Provider,{value:e},t.children)},p={inlineCode:"code",wrapper:function(t){var e=t.children;return n.a.createElement(n.a.Fragment,{},e)}},d=Object(b.forwardRef)((function(t,e){var a=t.components,b=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),u=i(a),d=b,m=u["".concat(r,".").concat(d)]||u[d]||p[d]||l;return a?n.a.createElement(m,c({ref:e},j,{components:a})):n.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,b=e&&e.mdxType;if("string"==typeof t||b){var l=a.length,r=new Array(l);r[0]=d;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:b,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return n.a.createElement.apply(null,r)}return n.a.createElement.apply(null,a)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/a43f9649.d71af5de.js b/a43f9649.d71af5de.js
deleted file mode 100644
index a152eae9f8f..00000000000
--- a/a43f9649.d71af5de.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[108],{236:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var b=a(1),l=a(9),n=(a(0),a(312)),r={title:"Documentation for the csharp-netcore-functions Generator"},c={id:"generators/csharp-netcore-functions",title:"Documentation for the csharp-netcore-functions Generator",description:"## METADATA",source:"@site/../docs/generators/csharp-netcore-functions.md",permalink:"/docs/generators/csharp-netcore-functions",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/csharp-netcore-functions.md",lastUpdatedBy:"Justin Black",lastUpdatedAt:1650213369},O=[{value:"METADATA",id:"metadata",children:[]},{value:"CONFIG OPTIONS",id:"config-options",children:[]},{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(l.a)(t,["components"]);return Object(n.b)("wrapper",Object(b.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(n.b)("h2",{id:"metadata"},"METADATA"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Property"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Value"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Notes"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator name"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"csharp-netcore-functions"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"pass this to the generate command after -g")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator stability"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"STABLE"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator type"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"SERVER"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator language"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"C#"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generator default templating engine"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"mustache"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"helpTxt"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Generates an ASP.NET Core Web API server."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}))))),Object(n.b)("h2",{id:"config-options"},"CONFIG OPTIONS"),Object(n.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(n.b)("a",Object(b.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Option"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Description"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Values"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Default"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"azureFunctionsVersion"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Azure functions version: v4, v3"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(n.b)("dl",null,Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"v4")),Object(n.b)("dd",null,"Azure Functions v4"),Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"v3")),Object(n.b)("dd",null,"Azure Functions v3"))),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"v4")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"buildTarget"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Target to build an application or library"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(n.b)("dl",null,Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"program")),Object(n.b)("dd",null,"Generate code for a standalone server"),Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"library")),Object(n.b)("dd",null,"Generate code for a server abstract class library"))),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"program")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"classModifier"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Class Modifier for function classes: Empty string or abstract."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"enumNameSuffix"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Suffix that will be appended to all enum names."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Enum")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"enumValueSuffix"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Suffix that will be appended to all enum values."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Enum")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"generateBody"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Generates method body."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"true")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"licenseName"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"The name of the license"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"NoLicense")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"licenseUrl"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"The URL of the license"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(n.b)("a",Object(b.a)({parentName:"td"},{href:"http://localhost"}),"http://localhost"))),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"modelClassModifier"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Model Class Modifier can be nothing or partial"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"partial")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"netCoreVersion"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),".NET Core version: 6.0, 5.0, 3.1, 3.0"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(n.b)("dl",null,Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"3.0")),Object(n.b)("dd",null,".NET Core 3.0"),Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"3.1")),Object(n.b)("dd",null,".NET Core 3.1"),Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"5.0")),Object(n.b)("dd",null,".NET Core 5.0"),Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"6.0")),Object(n.b)("dd",null,".NET Core 6.0"))),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"3.1")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"newtonsoftVersion"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Version for Newtonsoft.Json for .NET Core 3.0+"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"3.0.0")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"nullableReferenceTypes"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Use nullable annotations in the project. Only supported on C# 8 / ASP.NET Core 3.1 or newer."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"operationIsAsync"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Set methods to async or sync (default)."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"operationModifier"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Operation Modifier can be virtual or abstract"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),Object(n.b)("dl",null,Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"virtual")),Object(n.b)("dd",null,"Keep method virtual"),Object(n.b)("dt",null,Object(n.b)("strong",{parentName:"td"},"abstract")),Object(n.b)("dd",null,"Make method abstract"))),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"virtual")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"operationResultTask"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Set methods result to Task","<",">","."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageAuthors"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies Authors property in the .NET Core project file."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OpenAPI")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageCopyright"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies an AssemblyCopyright for the .NET Framework global assembly attributes stored in the AssemblyInfo file."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"No Copyright")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageDescription"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies a AssemblyDescription for the .NET Framework global assembly attributes stored in the AssemblyInfo file."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"A library generated from a OpenAPI doc")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageGuid"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"The GUID that will be associated with the C# project"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"null")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageName"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"C# package name (convention: Title.Case)."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Org.OpenAPITools")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageTitle"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Specifies an AssemblyTitle for the .NET Framework global assembly attributes stored in the AssemblyInfo file."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OpenAPI Library")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"packageVersion"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"C# package version."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"returnICollection"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Return ICollection","<","T",">"," instead of the concrete type."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"true")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"sourceFolder"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"source folder for generated code"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"src")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"useCollection"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Deserialize array types to Collection","<","T",">"," instead of List","<","T",">","."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"useDateTimeOffset"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Use DateTimeOffset to model date-time properties"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"false")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"useNewtonsoft"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Uses the Newtonsoft JSON library."),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null})),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"true")))),Object(n.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Imports"))),Object(n.b)("tbody",{parentName:"table"})),Object(n.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"array"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"List")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"list"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"List")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"map"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Dictionary")))),Object(n.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(n.b)("ul",{class:"column-ul"},Object(n.b)("li",null,"Boolean"),Object(n.b)("li",null,"Collection"),Object(n.b)("li",null,"DateTime"),Object(n.b)("li",null,"DateTime?"),Object(n.b)("li",null,"DateTimeOffset"),Object(n.b)("li",null,"DateTimeOffset?"),Object(n.b)("li",null,"Decimal"),Object(n.b)("li",null,"Dictionary"),Object(n.b)("li",null,"Double"),Object(n.b)("li",null,"Float"),Object(n.b)("li",null,"Guid"),Object(n.b)("li",null,"Guid?"),Object(n.b)("li",null,"ICollection"),Object(n.b)("li",null,"Int32"),Object(n.b)("li",null,"Int64"),Object(n.b)("li",null,"List"),Object(n.b)("li",null,"Object"),Object(n.b)("li",null,"String"),Object(n.b)("li",null,"System.IO.Stream"),Object(n.b)("li",null,"bool"),Object(n.b)("li",null,"bool?"),Object(n.b)("li",null,"byte[]"),Object(n.b)("li",null,"decimal"),Object(n.b)("li",null,"decimal?"),Object(n.b)("li",null,"double"),Object(n.b)("li",null,"double?"),Object(n.b)("li",null,"float"),Object(n.b)("li",null,"float?"),Object(n.b)("li",null,"int"),Object(n.b)("li",null,"int?"),Object(n.b)("li",null,"long"),Object(n.b)("li",null,"long?"),Object(n.b)("li",null,"string")),Object(n.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(n.b)("ul",{class:"column-ul"},Object(n.b)("li",null,"Client"),Object(n.b)("li",null,"Configuration"),Object(n.b)("li",null,"Version"),Object(n.b)("li",null,"abstract"),Object(n.b)("li",null,"as"),Object(n.b)("li",null,"async"),Object(n.b)("li",null,"await"),Object(n.b)("li",null,"base"),Object(n.b)("li",null,"bool"),Object(n.b)("li",null,"break"),Object(n.b)("li",null,"byte"),Object(n.b)("li",null,"case"),Object(n.b)("li",null,"catch"),Object(n.b)("li",null,"char"),Object(n.b)("li",null,"checked"),Object(n.b)("li",null,"class"),Object(n.b)("li",null,"client"),Object(n.b)("li",null,"const"),Object(n.b)("li",null,"continue"),Object(n.b)("li",null,"decimal"),Object(n.b)("li",null,"default"),Object(n.b)("li",null,"delegate"),Object(n.b)("li",null,"do"),Object(n.b)("li",null,"double"),Object(n.b)("li",null,"dynamic"),Object(n.b)("li",null,"else"),Object(n.b)("li",null,"enum"),Object(n.b)("li",null,"event"),Object(n.b)("li",null,"explicit"),Object(n.b)("li",null,"extern"),Object(n.b)("li",null,"false"),Object(n.b)("li",null,"finally"),Object(n.b)("li",null,"fixed"),Object(n.b)("li",null,"float"),Object(n.b)("li",null,"for"),Object(n.b)("li",null,"foreach"),Object(n.b)("li",null,"goto"),Object(n.b)("li",null,"if"),Object(n.b)("li",null,"implicit"),Object(n.b)("li",null,"in"),Object(n.b)("li",null,"int"),Object(n.b)("li",null,"interface"),Object(n.b)("li",null,"internal"),Object(n.b)("li",null,"is"),Object(n.b)("li",null,"localVarFileParams"),Object(n.b)("li",null,"localVarFormParams"),Object(n.b)("li",null,"localVarHeaderParams"),Object(n.b)("li",null,"localVarHttpContentType"),Object(n.b)("li",null,"localVarHttpContentTypes"),Object(n.b)("li",null,"localVarHttpHeaderAccept"),Object(n.b)("li",null,"localVarHttpHeaderAccepts"),Object(n.b)("li",null,"localVarPath"),Object(n.b)("li",null,"localVarPathParams"),Object(n.b)("li",null,"localVarPostBody"),Object(n.b)("li",null,"localVarQueryParams"),Object(n.b)("li",null,"localVarResponse"),Object(n.b)("li",null,"localVarStatusCode"),Object(n.b)("li",null,"lock"),Object(n.b)("li",null,"long"),Object(n.b)("li",null,"namespace"),Object(n.b)("li",null,"new"),Object(n.b)("li",null,"null"),Object(n.b)("li",null,"object"),Object(n.b)("li",null,"operator"),Object(n.b)("li",null,"out"),Object(n.b)("li",null,"override"),Object(n.b)("li",null,"parameter"),Object(n.b)("li",null,"params"),Object(n.b)("li",null,"private"),Object(n.b)("li",null,"protected"),Object(n.b)("li",null,"public"),Object(n.b)("li",null,"readonly"),Object(n.b)("li",null,"ref"),Object(n.b)("li",null,"return"),Object(n.b)("li",null,"sbyte"),Object(n.b)("li",null,"sealed"),Object(n.b)("li",null,"short"),Object(n.b)("li",null,"sizeof"),Object(n.b)("li",null,"stackalloc"),Object(n.b)("li",null,"static"),Object(n.b)("li",null,"string"),Object(n.b)("li",null,"struct"),Object(n.b)("li",null,"switch"),Object(n.b)("li",null,"this"),Object(n.b)("li",null,"throw"),Object(n.b)("li",null,"true"),Object(n.b)("li",null,"try"),Object(n.b)("li",null,"typeof"),Object(n.b)("li",null,"uint"),Object(n.b)("li",null,"ulong"),Object(n.b)("li",null,"unchecked"),Object(n.b)("li",null,"unsafe"),Object(n.b)("li",null,"ushort"),Object(n.b)("li",null,"using"),Object(n.b)("li",null,"var"),Object(n.b)("li",null,"virtual"),Object(n.b)("li",null,"void"),Object(n.b)("li",null,"volatile"),Object(n.b)("li",null,"while"),Object(n.b)("li",null,"yield")),Object(n.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(n.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BasePath"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MockServer"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(n.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Custom"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Int32"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Int64"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Float"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Double"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Decimal"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"String"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Byte"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Binary"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Boolean"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Date"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"DateTime"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Password"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"File"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Uuid"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}))),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Array"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Null"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"AnyType"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Object"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Maps"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Enum"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(n.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Readme"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Model"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Api"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(n.b)("h3",{id:"global-feature"},"Global Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Host"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BasePath"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Info"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Schemes"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Consumes"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Produces"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Examples"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(n.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Path"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Query"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Header"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Body"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Cookie"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(n.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Simple"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Composite"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Union"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"allOf"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"anyOf"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"oneOf"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"not"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(n.b)("h3",{id:"security-feature"},"Security Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(n.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(n.b)("table",null,Object(n.b)("thead",{parentName:"table"},Object(n.b)("tr",{parentName:"thead"},Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Name"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Supported"),Object(n.b)("th",Object(b.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(n.b)("tbody",{parentName:"table"},Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"JSON"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"XML"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2713"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(n.b)("tr",{parentName:"tbody"},Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"Custom"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"\u2717"),Object(n.b)("td",Object(b.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return u})),a.d(e,"b",(function(){return m}));var b=a(0),l=a.n(b);function n(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var b=Object.getOwnPropertySymbols(t);e&&(b=b.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,b)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){n(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,b,l=function(t,e){if(null==t)return{};var a,b,l={},n=Object.keys(t);for(b=0;b<n.length;b++)a=n[b],e.indexOf(a)>=0||(l[a]=t[a]);return l}(t,e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);for(b=0;b<n.length;b++)a=n[b],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(l[a]=t[a])}return l}var j=l.a.createContext({}),i=function(t){var e=l.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},u=function(t){var e=i(t.components);return l.a.createElement(j.Provider,{value:e},t.children)},p={inlineCode:"code",wrapper:function(t){var e=t.children;return l.a.createElement(l.a.Fragment,{},e)}},d=Object(b.forwardRef)((function(t,e){var a=t.components,b=t.mdxType,n=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),u=i(a),d=b,m=u["".concat(r,".").concat(d)]||u[d]||p[d]||n;return a?l.a.createElement(m,c({ref:e},j,{components:a})):l.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,b=e&&e.mdxType;if("string"==typeof t||b){var n=a.length,r=new Array(n);r[0]=d;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:b,r[1]=c;for(var j=2;j<n;j++)r[j]=a[j];return l.a.createElement.apply(null,r)}return l.a.createElement.apply(null,a)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/a5c65c7b.1aff2bac.js b/a5c65c7b.1aff2bac.js
deleted file mode 100644
index 0576b7d6de4..00000000000
--- a/a5c65c7b.1aff2bac.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[110],{238:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return l})),a.d(t,"metadata",(function(){return i})),a.d(t,"rightToc",(function(){return b})),a.d(t,"default",(function(){return c}));var n=a(1),r=a(9),o=(a(0),a(312)),l={id:"globals",title:"Global Properties"},i={id:"globals",title:"Global Properties",description:"## Available Global Properties",source:"@site/../docs/global-properties.md",permalink:"/docs/globals",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/global-properties.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Usage",permalink:"/docs/usage"},next:{title:"Configuration Options",permalink:"/docs/configuration"}},b=[{value:"Available Global Properties",id:"available-global-properties",children:[]},{value:"Note on Global Property declaration",id:"note-on-global-property-declaration",children:[]}],p={rightToc:b};function c(e){var t=e.components,a=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},p,a,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"available-global-properties"},"Available Global Properties"),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Acceptable value"))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugOpenAPI"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted and fully parsed OpenAPI document during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugModels"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted template-bound model information during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugOperations"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted template-bound operation information during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugSupportingFiles"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted Supporting File information during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"verbose"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Defines the verbosity"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateAliasAsModel"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Defines whether primitive types defined at the model/schema level will be wrapped in a model"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.codegen.utils.oncelogger.enabled"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),'Enable/disable the "OnceLogger" which reduces noise for select repeated logs'),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"supportingFiles"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define which supporting files will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"no value, or a comma-separated string of file names")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"models"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define which models will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"no value, or a comma-separated string of model names")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apis"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define which apis will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"no value, or a comma-separated string of api names")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiDocs"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if api docs will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelDocs"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if model docs will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiTests"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if api tests will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelTests"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if model tests will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to control support of XML generated constructs, where supported"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")))),Object(o.b)("h2",{id:"note-on-global-property-declaration"},"Note on Global Property declaration"),Object(o.b)("p",null,"There are ",Object(o.b)("em",{parentName:"p"},"two ways"),' to provide selective generation properties or "global properties". First, these can be passed as Java System Properties. Second, these can be passed via the global property tooling option (',Object(o.b)("inlineCode",{parentName:"p"},"--global-property")," in CLI and ",Object(o.b)("inlineCode",{parentName:"p"},"globalProperty")," in Maven and Gradle configurations). This differentiation is new in version 5.0 with the removal of the ",Object(o.b)("inlineCode",{parentName:"p"},"-D")," CLI option and the renaming of ",Object(o.b)("inlineCode",{parentName:"p"},"systemProperties"),". If you're upgrading to OpenAPI Generator 5.0+"),Object(o.b)("p",null,"While the examples seen in ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/customization"}),"Customization")," use the Java System Property syntax, keep in mind that the following are equivalent:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-sh"}),"java -Dmodels {jar} generate {opts}\n")),Object(o.b)("p",null,"and"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-sh"}),"java {jar} generate {opts} --global-property=models\n")),Object(o.b)("p",null,"Why the two differing ways to provide the same properties? We previously accepted a ",Object(o.b)("inlineCode",{parentName:"p"},"-D"),' tooling option which resembled Java System Property declaration. In older versions of OpenAPI Generator, the option modified the SystemProperties collection directly and was truly a "system property". This option changed during the 4.x release in an effort to make OpenAPI Generator thread-safe and isolate its configuration via thread locals. We no longer mutate System Properties. In the 4.x release and earlier, specifying the tooling ',Object(o.b)("inlineCode",{parentName:"p"},"-D")," option with system properties intended for other tools like swagger-parser rather than passing them as true Java System Properties would lead to unexpected behavior for the user; if our tool set the system property ",Object(o.b)("em",{parentName:"p"},"after")," invoking certain code, it would seem to the user like Java System Properties weren't working! "))}c.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return d})),a.d(t,"b",(function(){return u}));var n=a(0),r=a.n(n);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function l(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function i(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?l(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):l(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function b(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var p=r.a.createContext({}),c=function(e){var t=r.a.useContext(p),a=t;return e&&(a="function"==typeof e?e(t):i({},t,{},e)),a},d=function(e){var t=c(e.components);return r.a.createElement(p.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,l=e.parentName,p=b(e,["components","mdxType","originalType","parentName"]),d=c(a),m=n,u=d["".concat(l,".").concat(m)]||d[m]||s[m]||o;return a?r.a.createElement(u,i({ref:t},p,{components:a})):r.a.createElement(u,i({ref:t},p))}));function u(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,l=new Array(o);l[0]=m;var i={};for(var b in t)hasOwnProperty.call(t,b)&&(i[b]=t[b]);i.originalType=e,i.mdxType="string"==typeof e?e:n,l[1]=i;for(var p=2;p<o;p++)l[p]=a[p];return r.a.createElement.apply(null,l)}return r.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/a5c65c7b.e83132ce.js b/a5c65c7b.e83132ce.js
new file mode 100644
index 00000000000..45001c2a737
--- /dev/null
+++ b/a5c65c7b.e83132ce.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[110],{238:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return l})),a.d(t,"metadata",(function(){return i})),a.d(t,"rightToc",(function(){return b})),a.d(t,"default",(function(){return c}));var n=a(1),r=a(9),o=(a(0),a(312)),l={id:"globals",title:"Global Properties"},i={id:"globals",title:"Global Properties",description:"## Available Global Properties",source:"@site/../docs/global-properties.md",permalink:"/docs/globals",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/global-properties.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Usage",permalink:"/docs/usage"},next:{title:"Configuration Options",permalink:"/docs/configuration"}},b=[{value:"Available Global Properties",id:"available-global-properties",children:[]},{value:"Note on Global Property declaration",id:"note-on-global-property-declaration",children:[]}],p={rightToc:b};function c(e){var t=e.components,a=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},p,a,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"available-global-properties"},"Available Global Properties"),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Property"),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(o.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Acceptable value"))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugOpenAPI"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted and fully parsed OpenAPI document during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugModels"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted template-bound model information during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugOperations"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted template-bound operation information during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"debugSupportingFiles"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Dumps JSON formatted Supporting File information during generation"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"verbose"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Defines the verbosity"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateAliasAsModel"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Defines whether primitive types defined at the model/schema level will be wrapped in a model"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"org.openapitools.codegen.utils.oncelogger.enabled"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),'Enable/disable the "OnceLogger" which reduces noise for select repeated logs'),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"supportingFiles"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define which supporting files will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"no value, or a comma-separated string of file names")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"models"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define which models will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"no value, or a comma-separated string of model names")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apis"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define which apis will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"no value, or a comma-separated string of api names")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiDocs"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if api docs will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelDocs"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if model docs will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"apiTests"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if api tests will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"modelTests"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to define if model tests will be generated. Prefer using the more robust ",Object(o.b)("inlineCode",{parentName:"td"},".openapi-generator-ignore"),"."),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(o.b)("inlineCode",{parentName:"td"},"true")," or ",Object(o.b)("inlineCode",{parentName:"td"},"false"))),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Allows the user to control support of XML generated constructs, where supported"),Object(o.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"none")))),Object(o.b)("h2",{id:"note-on-global-property-declaration"},"Note on Global Property declaration"),Object(o.b)("p",null,"There are ",Object(o.b)("em",{parentName:"p"},"two ways"),' to provide selective generation properties or "global properties". First, these can be passed as Java System Properties. Second, these can be passed via the global property tooling option (',Object(o.b)("inlineCode",{parentName:"p"},"--global-property")," in CLI and ",Object(o.b)("inlineCode",{parentName:"p"},"globalProperty")," in Maven and Gradle configurations). This differentiation is new in version 5.0 with the removal of the ",Object(o.b)("inlineCode",{parentName:"p"},"-D")," CLI option and the renaming of ",Object(o.b)("inlineCode",{parentName:"p"},"systemProperties"),". If you're upgrading to OpenAPI Generator 5.0+"),Object(o.b)("p",null,"While the examples seen in ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"/docs/customization"}),"Customization")," use the Java System Property syntax, keep in mind that the following are equivalent:"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-sh"}),"java -Dmodels {jar} generate {opts}\n")),Object(o.b)("p",null,"and"),Object(o.b)("pre",null,Object(o.b)("code",Object(n.a)({parentName:"pre"},{className:"language-sh"}),"java {jar} generate {opts} --global-property=models\n")),Object(o.b)("p",null,"Why the two differing ways to provide the same properties? We previously accepted a ",Object(o.b)("inlineCode",{parentName:"p"},"-D"),' tooling option which resembled Java System Property declaration. In older versions of OpenAPI Generator, the option modified the SystemProperties collection directly and was truly a "system property". This option changed during the 4.x release in an effort to make OpenAPI Generator thread-safe and isolate its configuration via thread locals. We no longer mutate System Properties. In the 4.x release and earlier, specifying the tooling ',Object(o.b)("inlineCode",{parentName:"p"},"-D")," option with system properties intended for other tools like swagger-parser rather than passing them as true Java System Properties would lead to unexpected behavior for the user; if our tool set the system property ",Object(o.b)("em",{parentName:"p"},"after")," invoking certain code, it would seem to the user like Java System Properties weren't working! "))}c.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return d})),a.d(t,"b",(function(){return u}));var n=a(0),r=a.n(n);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function l(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function i(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?l(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):l(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function b(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var p=r.a.createContext({}),c=function(e){var t=r.a.useContext(p),a=t;return e&&(a="function"==typeof e?e(t):i({},t,{},e)),a},d=function(e){var t=c(e.components);return r.a.createElement(p.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return r.a.createElement(r.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,l=e.parentName,p=b(e,["components","mdxType","originalType","parentName"]),d=c(a),m=n,u=d["".concat(l,".").concat(m)]||d[m]||s[m]||o;return a?r.a.createElement(u,i({ref:t},p,{components:a})):r.a.createElement(u,i({ref:t},p))}));function u(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,l=new Array(o);l[0]=m;var i={};for(var b in t)hasOwnProperty.call(t,b)&&(i[b]=t[b]);i.originalType=e,i.mdxType="string"==typeof e?e:n,l[1]=i;for(var p=2;p<o;p++)l[p]=a[p];return r.a.createElement.apply(null,l)}return r.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/ac8b7f2e.2ce29d45.js b/ac8b7f2e.2ce29d45.js
deleted file mode 100644
index 7313201d42b..00000000000
--- a/ac8b7f2e.2ce29d45.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[119],{246:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return c})),r.d(t,"metadata",(function(){return i})),r.d(t,"rightToc",(function(){return p})),r.d(t,"default",(function(){return b}));var n=r(1),a=r(9),o=(r(0),r(312)),c={id:"core-team",title:"Core Team Members"},i={id:"core-team",title:"Core Team Members",description:"* [@wing328](https://github.com/wing328) (2015/07)",source:"@site/../docs/core-team.md",permalink:"/docs/core-team",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/core-team.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142},p=[],u={rightToc:p};function b(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},u,r,{components:t,mdxType:"MDXLayout"}),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/wing328"}),"@wing328")," (2015/07)"),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/jimschubert"}),"@jimschubert")," (2016/05)"),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/cbornet"}),"@cbornet")," (2016/05)"),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/jaz-ah"}),"@jaz-ah")," (2016/05)"),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/JFCote"}),"@JFCote")," (2018/03)"),Object(o.b)("li",{parentName:"ul"},Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/jmini"}),"@jmini")," (2018/04)")))}b.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return l})),r.d(t,"b",(function(){return f}));var n=r(0),a=r.n(n);function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function c(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?c(Object(r),!0).forEach((function(t){o(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):c(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function p(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},o=Object.keys(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)r=o[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var u=a.a.createContext({}),b=function(e){var t=a.a.useContext(u),r=t;return e&&(r="function"==typeof e?e(t):i({},t,{},e)),r},l=function(e){var t=b(e.components);return a.a.createElement(u.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},s=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,o=e.originalType,c=e.parentName,u=p(e,["components","mdxType","originalType","parentName"]),l=b(r),s=n,f=l["".concat(c,".").concat(s)]||l[s]||m[s]||o;return r?a.a.createElement(f,i({ref:t},u,{components:r})):a.a.createElement(f,i({ref:t},u))}));function f(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=r.length,c=new Array(o);c[0]=s;var i={};for(var p in t)hasOwnProperty.call(t,p)&&(i[p]=t[p]);i.originalType=e,i.mdxType="string"==typeof e?e:n,c[1]=i;for(var u=2;u<o;u++)c[u]=r[u];return a.a.createElement.apply(null,c)}return a.a.createElement.apply(null,r)}s.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/ac8b7f2e.73beb1ba.js b/ac8b7f2e.73beb1ba.js
new file mode 100644
index 00000000000..557bdbe4c2a
--- /dev/null
+++ b/ac8b7f2e.73beb1ba.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[119],{246:function(e,t,r){"use strict";r.r(t),r.d(t,"frontMatter",(function(){return o})),r.d(t,"metadata",(function(){return i})),r.d(t,"rightToc",(function(){return p})),r.d(t,"default",(function(){return u}));var n=r(1),a=r(9),c=(r(0),r(312)),o={id:"core-team",title:"Core Team Members"},i={id:"core-team",title:"Core Team Members",description:"* [@wing328](https://github.com/wing328) (2015/07)",source:"@site/../docs/core-team.md",permalink:"/docs/core-team",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/core-team.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635},p=[],b={rightToc:p};function u(e){var t=e.components,r=Object(a.a)(e,["components"]);return Object(c.b)("wrapper",Object(n.a)({},b,r,{components:t,mdxType:"MDXLayout"}),Object(c.b)("ul",null,Object(c.b)("li",{parentName:"ul"},Object(c.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/wing328"}),"@wing328")," (2015/07)"),Object(c.b)("li",{parentName:"ul"},Object(c.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/jimschubert"}),"@jimschubert")," (2016/05)"),Object(c.b)("li",{parentName:"ul"},Object(c.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/cbornet"}),"@cbornet")," (2016/05)"),Object(c.b)("li",{parentName:"ul"},Object(c.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/jaz-ah"}),"@jaz-ah")," (2016/05)"),Object(c.b)("li",{parentName:"ul"},Object(c.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/JFCote"}),"@JFCote")," (2018/03)"),Object(c.b)("li",{parentName:"ul"},Object(c.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/jmini"}),"@jmini")," (2018/04)")))}u.isMDXComponent=!0},312:function(e,t,r){"use strict";r.d(t,"a",(function(){return l})),r.d(t,"b",(function(){return f}));var n=r(0),a=r.n(n);function c(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function o(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function i(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?o(Object(r),!0).forEach((function(t){c(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):o(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function p(e,t){if(null==e)return{};var r,n,a=function(e,t){if(null==e)return{};var r,n,a={},c=Object.keys(e);for(n=0;n<c.length;n++)r=c[n],t.indexOf(r)>=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var c=Object.getOwnPropertySymbols(e);for(n=0;n<c.length;n++)r=c[n],t.indexOf(r)>=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var b=a.a.createContext({}),u=function(e){var t=a.a.useContext(b),r=t;return e&&(r="function"==typeof e?e(t):i({},t,{},e)),r},l=function(e){var t=u(e.components);return a.a.createElement(b.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},s=Object(n.forwardRef)((function(e,t){var r=e.components,n=e.mdxType,c=e.originalType,o=e.parentName,b=p(e,["components","mdxType","originalType","parentName"]),l=u(r),s=n,f=l["".concat(o,".").concat(s)]||l[s]||m[s]||c;return r?a.a.createElement(f,i({ref:t},b,{components:r})):a.a.createElement(f,i({ref:t},b))}));function f(e,t){var r=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var c=r.length,o=new Array(c);o[0]=s;var i={};for(var p in t)hasOwnProperty.call(t,p)&&(i[p]=t[p]);i.originalType=e,i.mdxType="string"==typeof e?e:n,o[1]=i;for(var b=2;b<c;b++)o[b]=r[b];return a.a.createElement.apply(null,o)}return a.a.createElement.apply(null,r)}s.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/b6a32428.1b40b8d9.js b/b6a32428.1b40b8d9.js
deleted file mode 100644
index e15d84763db..00000000000
--- a/b6a32428.1b40b8d9.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[126],{252:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return r})),n.d(t,"metadata",(function(){return l})),n.d(t,"rightToc",(function(){return p})),n.d(t,"default",(function(){return c}));var a=n(1),o=n(9),i=(n(0),n(312)),r={id:"customization",title:"Customization"},l={id:"customization",title:"Customization",description:"## User-defined Templates",source:"@site/../docs/customization.md",permalink:"/docs/customization",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/customization.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Using Templates",permalink:"/docs/templating"},next:{title:"Debugging",permalink:"/docs/debugging"}},p=[{value:"User-defined Templates",id:"user-defined-templates",children:[]},{value:"Custom Generator (and Template)",id:"custom-generator-and-template",children:[{value:"Use your new generator with the CLI",id:"use-your-new-generator-with-the-cli",children:[]},{value:"Use your new generator with the maven plugin",id:"use-your-new-generator-with-the-maven-plugin",children:[]}]},{value:"Selective generation",id:"selective-generation",children:[]},{value:"Ignore file format",id:"ignore-file-format",children:[]},{value:"Customizing the generator",id:"customizing-the-generator",children:[]},{value:"Bringing your own models",id:"bringing-your-own-models",children:[]}],s={rightToc:p};function c(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h2",{id:"user-defined-templates"},"User-defined Templates"),Object(i.b)("p",null,"The most common scenario for user customization is to override the built-in templates with small modifications. That scenario's documentation is in our ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/templating"}),"templating")," page, and differs from user-defined templates."),Object(i.b)("p",null,"Prior to release 5.0.0, whenever a user wanted to include templates which weren't built-in or weren't known to the generator at compile time, they'd need to follow the more involved approach of creating a custom generator as documented later in this document. Beginning in 5.0.0, a user may now provide additional supporting files and extensions to built-in templates via configuration. This feature requires using the external configuration file feature."),Object(i.b)("p",null,"Consider that you might want to add some static documentation such as ",Object(i.b)("inlineCode",{parentName:"p"},"AUTHORS.md")," and a custom tooling script. Rather than a single file for API definitions you also want an implementation file and a separate interface file for each."),Object(i.b)("p",null,"You might have an external configuration file named ",Object(i.b)("inlineCode",{parentName:"p"},"config.yaml")," which defines additional properties like this for a ",Object(i.b)("inlineCode",{parentName:"p"},"kotlin")," client generator:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'additionalProperties:\n  artifactId: kotlin-petstore-client\n  serializableModel: "true"\n  dateLibrary: java8\n')),Object(i.b)("p",null,"You would generate via CLI with the command:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-shell",metastring:"script",script:!0}),"openapi-generator generate -g kotlin -i spec.yaml -o outdir -c config.yaml\n")),Object(i.b)("p",null,"To support the above scenario with custom templates, ensure that you're pointing to your custom template directory and add a ",Object(i.b)("inlineCode",{parentName:"p"},"files")," node with template file definitions to your config:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'templateDir: my_custom_templates\nadditionalProperties:\n  artifactId: kotlin-petstore-client\n  serializableModel: "true"\n  dateLibrary: java8\nfiles:\n  AUTHORS.md: {}\n  api_interfaces.mustache:\n    templateType: API\n    destinationFilename: Interface.kt\n  api.mustache:\n    templateType: API\n    destinationFilename: Impl.kt\n  other/check.mustache:\n    folder: scripts\n    destinationFilename: check.sh\n    templateType: SupportingFiles\n')),Object(i.b)("p",null,"The keys under the ",Object(i.b)("inlineCode",{parentName:"p"},"files")," node are your template filenames. These honor the same resolution order as all other templates."),Object(i.b)("p",null,"The above configuration will do the following:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"Copy ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/AUTHORS.md")," to the generated output directory without processing via the template engine (due to template file extension). The empty object definition following ",Object(i.b)("inlineCode",{parentName:"li"},"AUTHORS.md")," allows the tool to infer the target output filename in the root of the output directory."),Object(i.b)("li",{parentName:"ul"},"Compile a user-provided ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/api_interfaces.mustache")," following our usual API template compilation logic. That is, one file will be created per API; APIs are generated defined according to tags in your spec documentation. The destination filename of ",Object(i.b)("inlineCode",{parentName:"li"},"Interface.kt")," will act as a suffix for the filename. So, a tag of ",Object(i.b)("inlineCode",{parentName:"li"},"Equipment")," will output a corresponding ",Object(i.b)("inlineCode",{parentName:"li"},"EquipmentInterface.kt"),"."),Object(i.b)("li",{parentName:"ul"},"Because ",Object(i.b)("inlineCode",{parentName:"li"},"api.mustache")," is the same mustache filename as used in your target generator (",Object(i.b)("inlineCode",{parentName:"li"},"kotlin")," in this example), we support the following:",Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"The destination filename provides a suffix for the generated output. APIs generate per tag in your specification. So, a tag of ",Object(i.b)("inlineCode",{parentName:"li"},"Equipment")," will output a corresponding ",Object(i.b)("inlineCode",{parentName:"li"},"EquipmentImpl.kt"),". This option will be used whether ",Object(i.b)("inlineCode",{parentName:"li"},"api.mustache")," targets a user customized template or a built-in template."),Object(i.b)("li",{parentName:"ul"},"The built-in template will be used if you haven't provided an customized template. The kotlin generator defines the suffix as simply ",Object(i.b)("inlineCode",{parentName:"li"},".kt"),", so this scenario would modify only the generated file suffixes according to the previous bullet point."),Object(i.b)("li",{parentName:"ul"},"Your ",Object(i.b)("inlineCode",{parentName:"li"},"api.mustache")," will be used if it exists in your custom template directory. For generators with library options, such as ",Object(i.b)("inlineCode",{parentName:"li"},"jvm-okhttp3")," in the kotlin generator, your file must exist in the same relative location as the embedded template. For kotlin using the ",Object(i.b)("inlineCode",{parentName:"li"},"jvm-okhttp3")," library option, this file would need to be located at ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/libraries/jvm-okhttp/api.mustache"),". See ",Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"/docs/templating"}),"templating")," for more details."))),Object(i.b)("li",{parentName:"ul"},"Compile ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/other/check.mustache")," with the supporting files bundle, and output to ",Object(i.b)("inlineCode",{parentName:"li"},"scripts/check.sh")," in your output directory. Note that we don't currently support setting file flags on output, so scripts such as these will either have to be sourced rather than executed, or have file flags set separately after generation (external to our tooling).")),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"templateType")," option will default to ",Object(i.b)("inlineCode",{parentName:"p"},"SupportingFiles"),", so the option for ",Object(i.b)("inlineCode",{parentName:"p"},"other/check.mustache")," is redundant and provided to demonstrate the full template file configuration options. The available template types are:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"API"),Object(i.b)("li",{parentName:"ul"},"APIDocs"),Object(i.b)("li",{parentName:"ul"},"APITests"),Object(i.b)("li",{parentName:"ul"},"Model"),Object(i.b)("li",{parentName:"ul"},"ModelDocs"),Object(i.b)("li",{parentName:"ul"},"ModelTests"),Object(i.b)("li",{parentName:"ul"},"SupportingFiles")),Object(i.b)("p",null,"Excluding ",Object(i.b)("inlineCode",{parentName:"p"},"SupportingFiles"),", each of the above options may result in multiple files. API related types create a file per API. Model related types create a file for each model."),Object(i.b)("p",null,"Note that user-defined templates will merge with built-in template definitions. If a supporting file with the sample template file path exists, it will be replaced with the user-defined template, otherwise the user-defined template will be added to the list of template files to compile. If the generator's built-in template is ",Object(i.b)("inlineCode",{parentName:"p"},"model_docs.mustache")," and you define ",Object(i.b)("inlineCode",{parentName:"p"},"model-docs.mustache"),", this will result in duplicated model docs (if ",Object(i.b)("inlineCode",{parentName:"p"},"destinationFilename")," differs) or undefined behavior as whichever template compiles last will overwrite the previous model docs (if ",Object(i.b)("inlineCode",{parentName:"p"},"destinationFilename")," matches the extension or suffix in the generator's code)."),Object(i.b)("h2",{id:"custom-generator-and-template"},"Custom Generator (and Template)"),Object(i.b)("a",{id:"creating-a-new-template"})," If none of the built-in generators suit your needs and you need to do more than just modify the mustache templates to tweak generated code, you can create a brand new generator and its associated templates. OpenAPI Generator can help with this, using the `meta` command:",Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar meta \\\n  -o out/generators/my-codegen -n my-codegen -p com.my.company.codegen\n")),Object(i.b)("p",null,"This will create a new directory ",Object(i.b)("inlineCode",{parentName:"p"},"out/generators/my-codegen"),", with all the files you need to get started - including a ",Object(i.b)("inlineCode",{parentName:"p"},"README.md"),". Once modified and compiled, you can use your new codegen just like any other, with your own custom-rolled logic."),Object(i.b)("p",null,"These names can be anything you like. If you are building a client for the whitespace language, maybe  you'd use the options ",Object(i.b)("inlineCode",{parentName:"p"},"-o out/generators/whitespace -n whitespace"),". They can be the same, or different, it doesn't matter. The ",Object(i.b)("inlineCode",{parentName:"p"},"-n")," value will be become the template name."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"NOTE")," Convention is to use kebab casing for names passed to ",Object(i.b)("inlineCode",{parentName:"p"},"-n"),". Example, ",Object(i.b)("inlineCode",{parentName:"p"},"scala-finatra")," would become ",Object(i.b)("inlineCode",{parentName:"p"},"ScalaFinatraGenerator"),"."),Object(i.b)("h3",{id:"use-your-new-generator-with-the-cli"},"Use your new generator with the CLI"),Object(i.b)("p",null,"To compile your library, enter the ",Object(i.b)("inlineCode",{parentName:"p"},"out/generators/my-codegen")," directory, run ",Object(i.b)("inlineCode",{parentName:"p"},"mvn package"),"."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"NOTE")," Running your custom generator requires adding it to the classpath. This differs on ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/windows/classpath.html"}),"Windows")," slightly from ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/unix/classpath.html"}),"unix"),".\nIf you are running a Windows Subsystem for Linux or a shell such as gitbash, and have issues with the unix variant, try the Windows syntax below."),Object(i.b)("p",null,"Now, execute the generator:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -cp out/generators/my-codegen/target/my-codegen-openapi-generator-1.0.0.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar org.openapitools.codegen.OpenAPIGenerator\n")),Object(i.b)("p",null,"For Windows users, you will need to use ",Object(i.b)("inlineCode",{parentName:"p"},";")," instead of ",Object(i.b)("inlineCode",{parentName:"p"},":")," in the classpath, e.g."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'java -cp "out/generators/my-codegen/target/my-codegen-openapi-generator-1.0.0.jar;modules/openapi-generator-cli/target/openapi-generator-cli.jar" org.openapitools.codegen.OpenAPIGenerator\n')),Object(i.b)("p",null,"Note the ",Object(i.b)("inlineCode",{parentName:"p"},"my-codegen")," is an option for ",Object(i.b)("inlineCode",{parentName:"p"},"-g")," now, and you can use the usual arguments for generating your code:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -cp out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \\\n  org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \\\n  -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n  -o ./out/myClient\n")),Object(i.b)("p",null,"For Windows users:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'java -cp "out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar;modules/openapi-generator-cli/target/openapi-generator-cli.jar" \\\n  org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \\\n  -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n  -o ./out/myClient\n')),Object(i.b)("h3",{id:"use-your-new-generator-with-the-maven-plugin"},"Use your new generator with the maven plugin"),Object(i.b)("p",null,"Install your library to your local maven repository by running:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"mvn clean install -f out/generators/my-codegen\n")),Object(i.b)("p",null,"This will install ",Object(i.b)("inlineCode",{parentName:"p"},"org.openapitools:my-codegen-openapi-generator:1.0.0")," to your local maven repository."),Object(i.b)("p",null,"You can use this as additional dependency of the ",Object(i.b)("inlineCode",{parentName:"p"},"openapi-generator-maven-plugin")," plugin and use ",Object(i.b)("inlineCode",{parentName:"p"},"my-codegen")," as ",Object(i.b)("inlineCode",{parentName:"p"},"generatorName")," value:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<plugin>\n  <groupId>org.openapitools</groupId>\n  <artifactId>openapi-generator-maven-plugin</artifactId>\n  <version>${openapi-generator-version}</version>\n  <executions>\n    <execution>\n      <id>generate-client-code</id>\n      <goals>\n        <goal>generate</goal>\n      </goals>\n      <configuration>\n        <generatorName>my-codegen</generatorName>\n        \x3c!-- other configuration ... --\x3e\n      </configuration>\n    </execution>\n  </executions>\n  <dependencies>\n    <dependency>\n      <groupId>org.openapitools</groupId>\n      <artifactId>my-codegen-openapi-generator</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n  </dependencies>\n</plugin>\n")),Object(i.b)("p",null,"If you publish your artifact to a distant maven repository, do not forget to add this repository as ",Object(i.b)("inlineCode",{parentName:"p"},"pluginRepository")," for your project."),Object(i.b)("h2",{id:"selective-generation"},"Selective generation"),Object(i.b)("p",null,"You may not want to generate ",Object(i.b)("em",{parentName:"p"},"all")," models in your project. Likewise, you may want just one or two apis to be written.  If that's the case, you can use system properties or ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/globals"}),"global properties")," to control the output."),Object(i.b)("p",null,"The default is generate ",Object(i.b)("em",{parentName:"p"},"everything")," supported by the specific library. Once you enable a feature, it will restrict the contents generated:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"# generate only models\n--global-property models\n\n# generate only apis\n--global-property apis\n\n# generate only supporting files\n--global-property supportingFiles\n\n# generate models and supporting files\n--global-property models,supportingFiles\n")),Object(i.b)("p",null,"To control the specific files being generated, you can pass a CSV list of what you want:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),'# generate the User and Pet models only\n--global-property models="User:Pet"\n\n# generate the User model and the supportingFile `StringUtil.java`:\n--global-property models=User,supportingFiles=StringUtil.java\n')),Object(i.b)("p",null,"To control generation of docs and tests for api and models, pass false to the option. For api, these options are  ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property apiTests=false,apiDocs=false"),". For models, ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property modelTests=false,modelDocs=false"),".\nThese options default to true and don't limit the generation of the feature options listed above (like ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property api"),"):"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),'# generate only models (with tests and documentation)\n--global-property models\n\n# generate only models (with tests but no documentation)\n--global-property models,modelDocs=false\n\n# generate only User and Pet models (no tests and no documentation)\n--global-property models="User:Pet",modelTests=false\n\n# generate only apis (without tests)\n--global-property apis,apiTests=false\n\n# generate only apis (modelTests option is ignored)\n--global-property apis,modelTests=false\n')),Object(i.b)("p",null,"When using selective generation, ",Object(i.b)("em",{parentName:"p"},"only")," the templates needed for the specific generation will be used."),Object(i.b)("p",null,'To skip models defined as the form parameters in "requestBody", please use ',Object(i.b)("inlineCode",{parentName:"p"},"skipFormModel")," (default to ",Object(i.b)("inlineCode",{parentName:"p"},"true"),") (this option is introduced at v3.2.2 and ",Object(i.b)("inlineCode",{parentName:"p"},"true")," by default starting from v5.x)."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"--global-property skipFormModel=true\n")),Object(i.b)("p",null,"This option will be helpful to skip model generation due to the form parameter, which is defined differently in OAS3 as there's no form parameter in OAS3"),Object(i.b)("h2",{id:"ignore-file-format"},"Ignore file format"),Object(i.b)("p",null,"OpenAPI Generator supports a ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," file, similar to ",Object(i.b)("inlineCode",{parentName:"p"},".gitignore")," or ",Object(i.b)("inlineCode",{parentName:"p"},".dockerignore")," you're probably already familiar with."),Object(i.b)("p",null,"The ignore file allows for better control over overwriting existing files than the ",Object(i.b)("inlineCode",{parentName:"p"},"--skip-overwrite")," flag. With the ignore file, you can specify individual files or directories can be ignored. This can be useful, for example if you only want a subset of the generated code."),Object(i.b)("p",null,"Examples:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"# OpenAPI Generator Ignore\n# Lines beginning with a # are comments\n\n# This should match build.sh located anywhere.\nbuild.sh\n\n# Matches build.sh in the root\n/build.sh\n\n# Exclude all recursively\ndocs/**\n\n# Explicitly allow files excluded by other rules\n!docs/UserApi.md\n\n# Recursively exclude directories named Api\n# You can't negate files below this directory.\nsrc/**/Api/\n\n# When this file is nested under /Api (excluded above),\n# this rule is ignored because parent directory is excluded by previous rule.\n!src/**/PetApiTests.cs\n\n# Exclude a single, nested file explicitly\nsrc/Org.OpenAPITools.Test/Model/AnimalFarmTests.cs\n")),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," file must exist in the root of the output directory."),Object(i.b)("p",null,"Upon first code generation, you may also pass the CLI option ",Object(i.b)("inlineCode",{parentName:"p"},"--ignore-file-override=/path/to/ignore_file")," for greater control over generated outputs. Note that this is a complete override, and will override the ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," file in an output directory when regenerating code."),Object(i.b)("p",null,"Editor support for ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," files is available in IntelliJ via the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://plugins.jetbrains.com/plugin/7495--ignore"}),".ignore plugin"),"."),Object(i.b)("h2",{id:"customizing-the-generator"},"Customizing the generator"),Object(i.b)("p",null,"There are different aspects of customizing the code generator beyond just creating or modifying templates.  Each language has a supporting configuration file to handle different type mappings, etc:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"$ ls -1 modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/\nAbstractJavaJAXRSServerCodegen.java\nAbstractTypeScriptClientCodegen.java\n... (results omitted)\nTypeScriptAngularClientCodegen.java\nTypeScriptNodeClientCodegen.java\n")),Object(i.b)("p",null,"Each of these files creates reasonable defaults so you can get running quickly.  But if you want to configure package names, prefixes, model folders, etc. you can use a json config file to pass the values."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \\\n  -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n  -g java \\\n  -o samples/client/petstore/java \\\n  -c path/to/config.json\n")),Object(i.b)("p",null,"and ",Object(i.b)("inlineCode",{parentName:"p"},"config.json")," contains the following as an example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "apiPackage" : "petstore"\n}\n')),Object(i.b)("p",null,"You can use also ",Object(i.b)("inlineCode",{parentName:"p"},"config.yml")," with following equivalent example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'apiPackage: "petstore"\n')),Object(i.b)("p",null,"Supported config options can be different per language. Running ",Object(i.b)("inlineCode",{parentName:"p"},"config-help -g {lang}")," will show available options.\n",Object(i.b)("strong",{parentName:"p"},"These options are applied via configuration file (e.g. config.json or config.yml) or by passing them with ",Object(i.b)("inlineCode",{parentName:"strong"},"-p {optionName}={optionValue}")),". (If ",Object(i.b)("inlineCode",{parentName:"p"},"-p {optionName}")," does not work, please open a ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/issues/new"}),"ticket")," and we'll look into it)"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g java\n")),Object(i.b)("p",null,"Output"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"CONFIG OPTIONS\n    modelPackage\n        package for generated models\n\n    apiPackage\n        package for generated api classes\n...... (results omitted)\n    library\n        library template (sub-template) to use:\n        jersey1 - HTTP client: Jersey client 1.18. JSON processing: Jackson 2.4.2\n        jersey2 - HTTP client: Jersey client 2.6\n        feign - HTTP client: Netflix Feign 8.1.1.  JSON processing: Jackson 2.6.3\n        okhttp-gson (default) - HTTP client: OkHttp 2.4.0. JSON processing: Gson 2.3.1\n        retrofit - HTTP client: OkHttp 2.4.0. JSON processing: Gson 2.3.1 (Retrofit 1.9.0)\n        retrofit2 - HTTP client: OkHttp 2.5.0. JSON processing: Gson 2.4 (Retrofit 2.0.0-beta2)\n        google-api-client - HTTP client: google-api-client 1.23.0. JSON processing: Jackson 2.8.9\n        rest-assured - HTTP client: rest-assured : 4.3.0. JSON processing: Gson 2.8.6. Only for Java8\n")),Object(i.b)("p",null,"Your config file for Java can look like"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "groupId":"com.my.company",\n  "artifactId":"MyClient",\n  "artifactVersion":"1.2.0",\n  "library":"feign"\n}\n')),Object(i.b)("p",null,"Or if you prefer yaml format it can look like"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'groupId: "com.my.company"\nartifactId: "MyClient"\nartifactVersion: "1.2.0"\nlibrary: "feign"\n')),Object(i.b)("p",null,"For all the unspecified options default values will be used."),Object(i.b)("p",null,"Another way to override default options is to extend the config class for the specific language.\nTo change, for example, the prefix for the Objective-C generated files, simply subclass the ",Object(i.b)("inlineCode",{parentName:"p"},"ObjcClientCodegen.java"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'package com.mycompany.openapitools.codegen;\n\nimport org.openapitools.codegen.languages.*;\n\npublic class MyObjcCodegen extends ObjcClientCodegen {\n    static {\n        PREFIX = "HELLO";\n    }\n}\n')),Object(i.b)("p",null,"and specify the ",Object(i.b)("inlineCode",{parentName:"p"},"classname")," when running the generator:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"-g com.mycompany.openapitools.codegen.MyObjcCodegen\n")),Object(i.b)("p",null,"Your subclass will now be loaded and overrides the ",Object(i.b)("inlineCode",{parentName:"p"},"PREFIX")," value in the superclass."),Object(i.b)("h2",{id:"bringing-your-own-models"},"Bringing your own models"),Object(i.b)("p",null,"Sometimes you don't want a model generated.  In this case, you can simply specify an import mapping to tell\nthe codegen what ",Object(i.b)("em",{parentName:"p"},"not")," to create.  When doing this, every location that references a specific model will\nrefer back to your classes.  Note, this may not apply to all languages..."),Object(i.b)("p",null,"To specify an import mapping, use the ",Object(i.b)("inlineCode",{parentName:"p"},"--import-mappings")," argument and specify the model-to-import logic as such:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"--import-mappings Pet=my.models.MyPet\n")),Object(i.b)("p",null,"Or for multiple mappings:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"--import-mappings Pet=my.models.MyPet,Order=my.models.MyOrder\n")),Object(i.b)("p",null,"or"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"--import-mappings Pet=my.models.MyPet --import-mappings Order=my.models.MyOrder\n")))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return m}));var a=n(0),o=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?r(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):r(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function p(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),c=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):l({},t,{},e)),n},u=function(e){var t=c(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},b={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,r=e.parentName,s=p(e,["components","mdxType","originalType","parentName"]),u=c(n),d=a,m=u["".concat(r,".").concat(d)]||u[d]||b[d]||i;return n?o.a.createElement(m,l({ref:t},s,{components:n})):o.a.createElement(m,l({ref:t},s))}));function m(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,r=new Array(i);r[0]=d;var l={};for(var p in t)hasOwnProperty.call(t,p)&&(l[p]=t[p]);l.originalType=e,l.mdxType="string"==typeof e?e:a,r[1]=l;for(var s=2;s<i;s++)r[s]=n[s];return o.a.createElement.apply(null,r)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/b6a32428.7992dd6c.js b/b6a32428.7992dd6c.js
new file mode 100644
index 00000000000..0d35203ead7
--- /dev/null
+++ b/b6a32428.7992dd6c.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[126],{252:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return r})),n.d(t,"metadata",(function(){return l})),n.d(t,"rightToc",(function(){return p})),n.d(t,"default",(function(){return c}));var a=n(1),o=n(9),i=(n(0),n(312)),r={id:"customization",title:"Customization"},l={id:"customization",title:"Customization",description:"## User-defined Templates",source:"@site/../docs/customization.md",permalink:"/docs/customization",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/customization.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Using Templates",permalink:"/docs/templating"},next:{title:"Debugging",permalink:"/docs/debugging"}},p=[{value:"User-defined Templates",id:"user-defined-templates",children:[]},{value:"Custom Generator (and Template)",id:"custom-generator-and-template",children:[{value:"Use your new generator with the CLI",id:"use-your-new-generator-with-the-cli",children:[]},{value:"Use your new generator with the maven plugin",id:"use-your-new-generator-with-the-maven-plugin",children:[]}]},{value:"Selective generation",id:"selective-generation",children:[]},{value:"Ignore file format",id:"ignore-file-format",children:[]},{value:"Customizing the generator",id:"customizing-the-generator",children:[]},{value:"Bringing your own models",id:"bringing-your-own-models",children:[]}],s={rightToc:p};function c(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(a.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h2",{id:"user-defined-templates"},"User-defined Templates"),Object(i.b)("p",null,"The most common scenario for user customization is to override the built-in templates with small modifications. That scenario's documentation is in our ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/templating"}),"templating")," page, and differs from user-defined templates."),Object(i.b)("p",null,"Prior to release 5.0.0, whenever a user wanted to include templates which weren't built-in or weren't known to the generator at compile time, they'd need to follow the more involved approach of creating a custom generator as documented later in this document. Beginning in 5.0.0, a user may now provide additional supporting files and extensions to built-in templates via configuration. This feature requires using the external configuration file feature."),Object(i.b)("p",null,"Consider that you might want to add some static documentation such as ",Object(i.b)("inlineCode",{parentName:"p"},"AUTHORS.md")," and a custom tooling script. Rather than a single file for API definitions you also want an implementation file and a separate interface file for each."),Object(i.b)("p",null,"You might have an external configuration file named ",Object(i.b)("inlineCode",{parentName:"p"},"config.yaml")," which defines additional properties like this for a ",Object(i.b)("inlineCode",{parentName:"p"},"kotlin")," client generator:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'additionalProperties:\n  artifactId: kotlin-petstore-client\n  serializableModel: "true"\n  dateLibrary: java8\n')),Object(i.b)("p",null,"You would generate via CLI with the command:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-shell",metastring:"script",script:!0}),"openapi-generator generate -g kotlin -i spec.yaml -o outdir -c config.yaml\n")),Object(i.b)("p",null,"To support the above scenario with custom templates, ensure that you're pointing to your custom template directory and add a ",Object(i.b)("inlineCode",{parentName:"p"},"files")," node with template file definitions to your config:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'templateDir: my_custom_templates\nadditionalProperties:\n  artifactId: kotlin-petstore-client\n  serializableModel: "true"\n  dateLibrary: java8\nfiles:\n  AUTHORS.md: {}\n  api_interfaces.mustache:\n    templateType: API\n    destinationFilename: Interface.kt\n  api.mustache:\n    templateType: API\n    destinationFilename: Impl.kt\n  other/check.mustache:\n    folder: scripts\n    destinationFilename: check.sh\n    templateType: SupportingFiles\n')),Object(i.b)("p",null,"The keys under the ",Object(i.b)("inlineCode",{parentName:"p"},"files")," node are your template filenames. These honor the same resolution order as all other templates."),Object(i.b)("p",null,"The above configuration will do the following:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"Copy ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/AUTHORS.md")," to the generated output directory without processing via the template engine (due to template file extension). The empty object definition following ",Object(i.b)("inlineCode",{parentName:"li"},"AUTHORS.md")," allows the tool to infer the target output filename in the root of the output directory."),Object(i.b)("li",{parentName:"ul"},"Compile a user-provided ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/api_interfaces.mustache")," following our usual API template compilation logic. That is, one file will be created per API; APIs are generated defined according to tags in your spec documentation. The destination filename of ",Object(i.b)("inlineCode",{parentName:"li"},"Interface.kt")," will act as a suffix for the filename. So, a tag of ",Object(i.b)("inlineCode",{parentName:"li"},"Equipment")," will output a corresponding ",Object(i.b)("inlineCode",{parentName:"li"},"EquipmentInterface.kt"),"."),Object(i.b)("li",{parentName:"ul"},"Because ",Object(i.b)("inlineCode",{parentName:"li"},"api.mustache")," is the same mustache filename as used in your target generator (",Object(i.b)("inlineCode",{parentName:"li"},"kotlin")," in this example), we support the following:",Object(i.b)("ul",{parentName:"li"},Object(i.b)("li",{parentName:"ul"},"The destination filename provides a suffix for the generated output. APIs generate per tag in your specification. So, a tag of ",Object(i.b)("inlineCode",{parentName:"li"},"Equipment")," will output a corresponding ",Object(i.b)("inlineCode",{parentName:"li"},"EquipmentImpl.kt"),". This option will be used whether ",Object(i.b)("inlineCode",{parentName:"li"},"api.mustache")," targets a user customized template or a built-in template."),Object(i.b)("li",{parentName:"ul"},"The built-in template will be used if you haven't provided an customized template. The kotlin generator defines the suffix as simply ",Object(i.b)("inlineCode",{parentName:"li"},".kt"),", so this scenario would modify only the generated file suffixes according to the previous bullet point."),Object(i.b)("li",{parentName:"ul"},"Your ",Object(i.b)("inlineCode",{parentName:"li"},"api.mustache")," will be used if it exists in your custom template directory. For generators with library options, such as ",Object(i.b)("inlineCode",{parentName:"li"},"jvm-okhttp3")," in the kotlin generator, your file must exist in the same relative location as the embedded template. For kotlin using the ",Object(i.b)("inlineCode",{parentName:"li"},"jvm-okhttp3")," library option, this file would need to be located at ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/libraries/jvm-okhttp/api.mustache"),". See ",Object(i.b)("a",Object(a.a)({parentName:"li"},{href:"/docs/templating"}),"templating")," for more details."))),Object(i.b)("li",{parentName:"ul"},"Compile ",Object(i.b)("inlineCode",{parentName:"li"},"my_custom_templates/other/check.mustache")," with the supporting files bundle, and output to ",Object(i.b)("inlineCode",{parentName:"li"},"scripts/check.sh")," in your output directory. Note that we don't currently support setting file flags on output, so scripts such as these will either have to be sourced rather than executed, or have file flags set separately after generation (external to our tooling).")),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},"templateType")," option will default to ",Object(i.b)("inlineCode",{parentName:"p"},"SupportingFiles"),", so the option for ",Object(i.b)("inlineCode",{parentName:"p"},"other/check.mustache")," is redundant and provided to demonstrate the full template file configuration options. The available template types are:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"API"),Object(i.b)("li",{parentName:"ul"},"APIDocs"),Object(i.b)("li",{parentName:"ul"},"APITests"),Object(i.b)("li",{parentName:"ul"},"Model"),Object(i.b)("li",{parentName:"ul"},"ModelDocs"),Object(i.b)("li",{parentName:"ul"},"ModelTests"),Object(i.b)("li",{parentName:"ul"},"SupportingFiles")),Object(i.b)("p",null,"Excluding ",Object(i.b)("inlineCode",{parentName:"p"},"SupportingFiles"),", each of the above options may result in multiple files. API related types create a file per API. Model related types create a file for each model."),Object(i.b)("p",null,"Note that user-defined templates will merge with built-in template definitions. If a supporting file with the sample template file path exists, it will be replaced with the user-defined template, otherwise the user-defined template will be added to the list of template files to compile. If the generator's built-in template is ",Object(i.b)("inlineCode",{parentName:"p"},"model_docs.mustache")," and you define ",Object(i.b)("inlineCode",{parentName:"p"},"model-docs.mustache"),", this will result in duplicated model docs (if ",Object(i.b)("inlineCode",{parentName:"p"},"destinationFilename")," differs) or undefined behavior as whichever template compiles last will overwrite the previous model docs (if ",Object(i.b)("inlineCode",{parentName:"p"},"destinationFilename")," matches the extension or suffix in the generator's code)."),Object(i.b)("h2",{id:"custom-generator-and-template"},"Custom Generator (and Template)"),Object(i.b)("a",{id:"creating-a-new-template"})," If none of the built-in generators suit your needs and you need to do more than just modify the mustache templates to tweak generated code, you can create a brand new generator and its associated templates. OpenAPI Generator can help with this, using the `meta` command:",Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar meta \\\n  -o out/generators/my-codegen -n my-codegen -p com.my.company.codegen\n")),Object(i.b)("p",null,"This will create a new directory ",Object(i.b)("inlineCode",{parentName:"p"},"out/generators/my-codegen"),", with all the files you need to get started - including a ",Object(i.b)("inlineCode",{parentName:"p"},"README.md"),". Once modified and compiled, you can use your new codegen just like any other, with your own custom-rolled logic."),Object(i.b)("p",null,"These names can be anything you like. If you are building a client for the whitespace language, maybe  you'd use the options ",Object(i.b)("inlineCode",{parentName:"p"},"-o out/generators/whitespace -n whitespace"),". They can be the same, or different, it doesn't matter. The ",Object(i.b)("inlineCode",{parentName:"p"},"-n")," value will be become the template name."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"NOTE")," Convention is to use kebab casing for names passed to ",Object(i.b)("inlineCode",{parentName:"p"},"-n"),". Example, ",Object(i.b)("inlineCode",{parentName:"p"},"scala-finatra")," would become ",Object(i.b)("inlineCode",{parentName:"p"},"ScalaFinatraGenerator"),"."),Object(i.b)("h3",{id:"use-your-new-generator-with-the-cli"},"Use your new generator with the CLI"),Object(i.b)("p",null,"To compile your library, enter the ",Object(i.b)("inlineCode",{parentName:"p"},"out/generators/my-codegen")," directory, run ",Object(i.b)("inlineCode",{parentName:"p"},"mvn package"),"."),Object(i.b)("p",null,Object(i.b)("strong",{parentName:"p"},"NOTE")," Running your custom generator requires adding it to the classpath. This differs on ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/windows/classpath.html"}),"Windows")," slightly from ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/unix/classpath.html"}),"unix"),".\nIf you are running a Windows Subsystem for Linux or a shell such as gitbash, and have issues with the unix variant, try the Windows syntax below."),Object(i.b)("p",null,"Now, execute the generator:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -cp out/generators/my-codegen/target/my-codegen-openapi-generator-1.0.0.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar org.openapitools.codegen.OpenAPIGenerator\n")),Object(i.b)("p",null,"For Windows users, you will need to use ",Object(i.b)("inlineCode",{parentName:"p"},";")," instead of ",Object(i.b)("inlineCode",{parentName:"p"},":")," in the classpath, e.g."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'java -cp "out/generators/my-codegen/target/my-codegen-openapi-generator-1.0.0.jar;modules/openapi-generator-cli/target/openapi-generator-cli.jar" org.openapitools.codegen.OpenAPIGenerator\n')),Object(i.b)("p",null,"Note the ",Object(i.b)("inlineCode",{parentName:"p"},"my-codegen")," is an option for ",Object(i.b)("inlineCode",{parentName:"p"},"-g")," now, and you can use the usual arguments for generating your code:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -cp out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \\\n  org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \\\n  -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n  -o ./out/myClient\n")),Object(i.b)("p",null,"For Windows users:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),'java -cp "out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar;modules/openapi-generator-cli/target/openapi-generator-cli.jar" \\\n  org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \\\n  -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n  -o ./out/myClient\n')),Object(i.b)("h3",{id:"use-your-new-generator-with-the-maven-plugin"},"Use your new generator with the maven plugin"),Object(i.b)("p",null,"Install your library to your local maven repository by running:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"mvn clean install -f out/generators/my-codegen\n")),Object(i.b)("p",null,"This will install ",Object(i.b)("inlineCode",{parentName:"p"},"org.openapitools:my-codegen-openapi-generator:1.0.0")," to your local maven repository."),Object(i.b)("p",null,"You can use this as additional dependency of the ",Object(i.b)("inlineCode",{parentName:"p"},"openapi-generator-maven-plugin")," plugin and use ",Object(i.b)("inlineCode",{parentName:"p"},"my-codegen")," as ",Object(i.b)("inlineCode",{parentName:"p"},"generatorName")," value:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<plugin>\n  <groupId>org.openapitools</groupId>\n  <artifactId>openapi-generator-maven-plugin</artifactId>\n  <version>${openapi-generator-version}</version>\n  <executions>\n    <execution>\n      <id>generate-client-code</id>\n      <goals>\n        <goal>generate</goal>\n      </goals>\n      <configuration>\n        <generatorName>my-codegen</generatorName>\n        \x3c!-- other configuration ... --\x3e\n      </configuration>\n    </execution>\n  </executions>\n  <dependencies>\n    <dependency>\n      <groupId>org.openapitools</groupId>\n      <artifactId>my-codegen-openapi-generator</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n  </dependencies>\n</plugin>\n")),Object(i.b)("p",null,"If you publish your artifact to a distant maven repository, do not forget to add this repository as ",Object(i.b)("inlineCode",{parentName:"p"},"pluginRepository")," for your project."),Object(i.b)("h2",{id:"selective-generation"},"Selective generation"),Object(i.b)("p",null,"You may not want to generate ",Object(i.b)("em",{parentName:"p"},"all")," models in your project. Likewise, you may want just one or two apis to be written.  If that's the case, you can use system properties or ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/globals"}),"global properties")," to control the output."),Object(i.b)("p",null,"The default is generate ",Object(i.b)("em",{parentName:"p"},"everything")," supported by the specific library. Once you enable a feature, it will restrict the contents generated:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"# generate only models\n--global-property models\n\n# generate only apis\n--global-property apis\n\n# generate only supporting files\n--global-property supportingFiles\n\n# generate models and supporting files\n--global-property models,supportingFiles\n")),Object(i.b)("p",null,"To control the specific files being generated, you can pass a CSV list of what you want:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),'# generate the User and Pet models only\n--global-property models="User:Pet"\n\n# generate the User model and the supportingFile `StringUtil.java`:\n--global-property models=User,supportingFiles=StringUtil.java\n')),Object(i.b)("p",null,"To control generation of docs and tests for api and models, pass false to the option. For api, these options are  ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property apiTests=false,apiDocs=false"),". For models, ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property modelTests=false,modelDocs=false"),".\nThese options default to true and don't limit the generation of the feature options listed above (like ",Object(i.b)("inlineCode",{parentName:"p"},"--global-property api"),"):"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),'# generate only models (with tests and documentation)\n--global-property models\n\n# generate only models (with tests but no documentation)\n--global-property models,modelDocs=false\n\n# generate only User and Pet models (no tests and no documentation)\n--global-property models="User:Pet",modelTests=false\n\n# generate only apis (without tests)\n--global-property apis,apiTests=false\n\n# generate only apis (modelTests option is ignored)\n--global-property apis,modelTests=false\n')),Object(i.b)("p",null,"When using selective generation, ",Object(i.b)("em",{parentName:"p"},"only")," the templates needed for the specific generation will be used."),Object(i.b)("p",null,'To skip models defined as the form parameters in "requestBody", please use ',Object(i.b)("inlineCode",{parentName:"p"},"skipFormModel")," (default to ",Object(i.b)("inlineCode",{parentName:"p"},"true"),") (this option is introduced at v3.2.2 and ",Object(i.b)("inlineCode",{parentName:"p"},"true")," by default starting from v5.x)."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"--global-property skipFormModel=true\n")),Object(i.b)("p",null,"This option will be helpful to skip model generation due to the form parameter, which is defined differently in OAS3 as there's no form parameter in OAS3"),Object(i.b)("h2",{id:"ignore-file-format"},"Ignore file format"),Object(i.b)("p",null,"OpenAPI Generator supports a ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," file, similar to ",Object(i.b)("inlineCode",{parentName:"p"},".gitignore")," or ",Object(i.b)("inlineCode",{parentName:"p"},".dockerignore")," you're probably already familiar with."),Object(i.b)("p",null,"The ignore file allows for better control over overwriting existing files than the ",Object(i.b)("inlineCode",{parentName:"p"},"--skip-overwrite")," flag. With the ignore file, you can specify individual files or directories can be ignored. This can be useful, for example if you only want a subset of the generated code."),Object(i.b)("p",null,"Examples:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"# OpenAPI Generator Ignore\n# Lines beginning with a # are comments\n\n# This should match build.sh located anywhere.\nbuild.sh\n\n# Matches build.sh in the root\n/build.sh\n\n# Exclude all recursively\ndocs/**\n\n# Explicitly allow files excluded by other rules\n!docs/UserApi.md\n\n# Recursively exclude directories named Api\n# You can't negate files below this directory.\nsrc/**/Api/\n\n# When this file is nested under /Api (excluded above),\n# this rule is ignored because parent directory is excluded by previous rule.\n!src/**/PetApiTests.cs\n\n# Exclude a single, nested file explicitly\nsrc/Org.OpenAPITools.Test/Model/AnimalFarmTests.cs\n")),Object(i.b)("p",null,"The ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," file must exist in the root of the output directory."),Object(i.b)("p",null,"Upon first code generation, you may also pass the CLI option ",Object(i.b)("inlineCode",{parentName:"p"},"--ignore-file-override=/path/to/ignore_file")," for greater control over generated outputs. Note that this is a complete override, and will override the ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," file in an output directory when regenerating code."),Object(i.b)("p",null,"Editor support for ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," files is available in IntelliJ via the ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://plugins.jetbrains.com/plugin/7495--ignore"}),".ignore plugin"),"."),Object(i.b)("h2",{id:"customizing-the-generator"},"Customizing the generator"),Object(i.b)("p",null,"There are different aspects of customizing the code generator beyond just creating or modifying templates.  Each language has a supporting configuration file to handle different type mappings, etc:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"$ ls -1 modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/\nAbstractJavaJAXRSServerCodegen.java\nAbstractTypeScriptClientCodegen.java\n... (results omitted)\nTypeScriptAngularClientCodegen.java\nTypeScriptNodeClientCodegen.java\n")),Object(i.b)("p",null,"Each of these files creates reasonable defaults so you can get running quickly.  But if you want to configure package names, prefixes, model folders, etc. you can use a json config file to pass the values."),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \\\n  -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \\\n  -g java \\\n  -o samples/client/petstore/java \\\n  -c path/to/config.json\n")),Object(i.b)("p",null,"and ",Object(i.b)("inlineCode",{parentName:"p"},"config.json")," contains the following as an example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "apiPackage" : "petstore"\n}\n')),Object(i.b)("p",null,"You can use also ",Object(i.b)("inlineCode",{parentName:"p"},"config.yml")," with following equivalent example:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'apiPackage: "petstore"\n')),Object(i.b)("p",null,"Supported config options can be different per language. Running ",Object(i.b)("inlineCode",{parentName:"p"},"config-help -g {lang}")," will show available options.\n",Object(i.b)("strong",{parentName:"p"},"These options are applied via configuration file (e.g. config.json or config.yml) or by passing them with ",Object(i.b)("inlineCode",{parentName:"strong"},"-p {optionName}={optionValue}")),". (If ",Object(i.b)("inlineCode",{parentName:"p"},"-p {optionName}")," does not work, please open a ",Object(i.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/issues/new"}),"ticket")," and we'll look into it)"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-sh"}),"java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g java\n")),Object(i.b)("p",null,"Output"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"CONFIG OPTIONS\n    modelPackage\n        package for generated models\n\n    apiPackage\n        package for generated api classes\n...... (results omitted)\n    library\n        library template (sub-template) to use:\n        jersey1 - HTTP client: Jersey client 1.18. JSON processing: Jackson 2.4.2\n        jersey2 - HTTP client: Jersey client 2.6\n        feign - HTTP client: Netflix Feign 8.1.1.  JSON processing: Jackson 2.6.3\n        okhttp-gson (default) - HTTP client: OkHttp 2.4.0. JSON processing: Gson 2.3.1\n        retrofit - HTTP client: OkHttp 2.4.0. JSON processing: Gson 2.3.1 (Retrofit 1.9.0)\n        retrofit2 - HTTP client: OkHttp 2.5.0. JSON processing: Gson 2.4 (Retrofit 2.0.0-beta2)\n        google-api-client - HTTP client: google-api-client 1.23.0. JSON processing: Jackson 2.8.9\n        rest-assured - HTTP client: rest-assured : 4.3.0. JSON processing: Gson 2.8.6. Only for Java8\n")),Object(i.b)("p",null,"Your config file for Java can look like"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'{\n  "groupId":"com.my.company",\n  "artifactId":"MyClient",\n  "artifactVersion":"1.2.0",\n  "library":"feign"\n}\n')),Object(i.b)("p",null,"Or if you prefer yaml format it can look like"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'groupId: "com.my.company"\nartifactId: "MyClient"\nartifactVersion: "1.2.0"\nlibrary: "feign"\n')),Object(i.b)("p",null,"For all the unspecified options default values will be used."),Object(i.b)("p",null,"Another way to override default options is to extend the config class for the specific language.\nTo change, for example, the prefix for the Objective-C generated files, simply subclass the ",Object(i.b)("inlineCode",{parentName:"p"},"ObjcClientCodegen.java"),":"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'package com.mycompany.openapitools.codegen;\n\nimport org.openapitools.codegen.languages.*;\n\npublic class MyObjcCodegen extends ObjcClientCodegen {\n    static {\n        PREFIX = "HELLO";\n    }\n}\n')),Object(i.b)("p",null,"and specify the ",Object(i.b)("inlineCode",{parentName:"p"},"classname")," when running the generator:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"-g com.mycompany.openapitools.codegen.MyObjcCodegen\n")),Object(i.b)("p",null,"Your subclass will now be loaded and overrides the ",Object(i.b)("inlineCode",{parentName:"p"},"PREFIX")," value in the superclass."),Object(i.b)("h2",{id:"bringing-your-own-models"},"Bringing your own models"),Object(i.b)("p",null,"Sometimes you don't want a model generated.  In this case, you can simply specify an import mapping to tell\nthe codegen what ",Object(i.b)("em",{parentName:"p"},"not")," to create.  When doing this, every location that references a specific model will\nrefer back to your classes.  Note, this may not apply to all languages..."),Object(i.b)("p",null,"To specify an import mapping, use the ",Object(i.b)("inlineCode",{parentName:"p"},"--import-mappings")," argument and specify the model-to-import logic as such:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"--import-mappings Pet=my.models.MyPet\n")),Object(i.b)("p",null,"Or for multiple mappings:"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"--import-mappings Pet=my.models.MyPet,Order=my.models.MyOrder\n")),Object(i.b)("p",null,"or"),Object(i.b)("pre",null,Object(i.b)("code",Object(a.a)({parentName:"pre"},{}),"--import-mappings Pet=my.models.MyPet --import-mappings Order=my.models.MyOrder\n")))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return m}));var a=n(0),o=n.n(a);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?r(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):r(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function p(e,t){if(null==e)return{};var n,a,o=function(e,t){if(null==e)return{};var n,a,o={},i=Object.keys(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a<i.length;a++)n=i[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),c=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):l({},t,{},e)),n},b=function(e){var t=c(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,r=e.parentName,s=p(e,["components","mdxType","originalType","parentName"]),b=c(n),d=a,m=b["".concat(r,".").concat(d)]||b[d]||u[d]||i;return n?o.a.createElement(m,l({ref:t},s,{components:n})):o.a.createElement(m,l({ref:t},s))}));function m(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,r=new Array(i);r[0]=d;var l={};for(var p in t)hasOwnProperty.call(t,p)&&(l[p]=t[p]);l.originalType=e,l.mdxType="string"==typeof e?e:a,r[1]=l;for(var s=2;s<i;s++)r[s]=n[s];return o.a.createElement.apply(null,r)}return o.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/bdaab79f.01df211b.js b/bdaab79f.01df211b.js
new file mode 100644
index 00000000000..86b2ed6e510
--- /dev/null
+++ b/bdaab79f.01df211b.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[132],{258:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Config Options for tiny-cpp",sidebar_label:"tiny-cpp"},c={id:"generators/tiny-cpp",title:"Config Options for tiny-cpp",description:"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to [configuration docs](https://openapi-generator.tech/docs/configuration) for more details.",source:"@site/../docs/generators/tiny-cpp.md",permalink:"/docs/generators/tiny-cpp",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/tiny-cpp.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar_label:"tiny-cpp"},O=[{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"controller"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"name of microcontroller (e.g esp32 or esp8266)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"esp32")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"reservedWordPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Prefix to prepend to reserved words in order to avoid conflicts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"r_")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"variableNameFirstCharacterUppercase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Make first character of variable name uppercase (eg. value -",">"," Value)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"std::string")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"alignas"),Object(l.b)("li",null,"alignof"),Object(l.b)("li",null,"and"),Object(l.b)("li",null,"and_eq"),Object(l.b)("li",null,"asm"),Object(l.b)("li",null,"auto"),Object(l.b)("li",null,"bitand"),Object(l.b)("li",null,"bitor"),Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"char16_t"),Object(l.b)("li",null,"char32_t"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"compl"),Object(l.b)("li",null,"concept"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"const_cast"),Object(l.b)("li",null,"constexpr"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"decltype"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"delete"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"dynamic_cast"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"explicit"),Object(l.b)("li",null,"export"),Object(l.b)("li",null,"extern"),Object(l.b)("li",null,"false"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"friend"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"inline"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"linux"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"mutable"),Object(l.b)("li",null,"namespace"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"noexcept"),Object(l.b)("li",null,"not"),Object(l.b)("li",null,"not_eq"),Object(l.b)("li",null,"nullptr"),Object(l.b)("li",null,"operator"),Object(l.b)("li",null,"or"),Object(l.b)("li",null,"or_eq"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"register"),Object(l.b)("li",null,"reinterpret_cast"),Object(l.b)("li",null,"requires"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"signed"),Object(l.b)("li",null,"sizeof"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"static_assert"),Object(l.b)("li",null,"static_cast"),Object(l.b)("li",null,"struct"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"template"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"thread_local"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"true"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"typedef"),Object(l.b)("li",null,"typeid"),Object(l.b)("li",null,"typename"),Object(l.b)("li",null,"union"),Object(l.b)("li",null,"unsigned"),Object(l.b)("li",null,"using"),Object(l.b)("li",null,"virtual"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"wchar_t"),Object(l.b)("li",null,"while"),Object(l.b)("li",null,"xor"),Object(l.b)("li",null,"xor_eq")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return m}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},d=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),d=n,m=p["".concat(r,".").concat(d)]||p[d]||u[d]||l;return a?b.a.createElement(m,c({ref:e},j,{components:a})):b.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=d;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/bdaab79f.1ff1951f.js b/bdaab79f.1ff1951f.js
deleted file mode 100644
index 0ed1df3d3c5..00000000000
--- a/bdaab79f.1ff1951f.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[132],{258:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Config Options for tiny-cpp",sidebar_label:"tiny-cpp"},c={id:"generators/tiny-cpp",title:"Config Options for tiny-cpp",description:"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to [configuration docs](https://openapi-generator.tech/docs/configuration) for more details.",source:"@site/../docs/generators/tiny-cpp.md",permalink:"/docs/generators/tiny-cpp",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/tiny-cpp.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar_label:"tiny-cpp"},O=[{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("p",null,"These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to ",Object(l.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/configuration"}),"configuration docs")," for more details."),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"allowUnicodeIdentifiers"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"boolean, toggles whether unicode identifiers are allowed in names or not, default is false"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"controller"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"name of microcontroller (e.g esp32 or esp8266)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"esp32")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"If false, the 'additionalProperties' implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"Keep the old (incorrect) behaviour that 'additionalProperties' is set to false by default."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ensureUniqueParams"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Whether to ensure parameter names are unique in an operation (rename parameters that are not)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"legacyDiscriminatorBehavior"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"reservedWordPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Prefix to prepend to reserved words in order to avoid conflicts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"r_")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortModelPropertiesByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort model properties to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"sortParamsByRequiredFlag"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Sort method arguments to place required parameters before optional parameters."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"variableNameFirstCharacterUppercase"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Make first character of variable name uppercase (eg. value -",">"," Value)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"std::string")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"alignas"),Object(l.b)("li",null,"alignof"),Object(l.b)("li",null,"and"),Object(l.b)("li",null,"and_eq"),Object(l.b)("li",null,"asm"),Object(l.b)("li",null,"auto"),Object(l.b)("li",null,"bitand"),Object(l.b)("li",null,"bitor"),Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"catch"),Object(l.b)("li",null,"char"),Object(l.b)("li",null,"char16_t"),Object(l.b)("li",null,"char32_t"),Object(l.b)("li",null,"class"),Object(l.b)("li",null,"compl"),Object(l.b)("li",null,"concept"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"const_cast"),Object(l.b)("li",null,"constexpr"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"decltype"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"delete"),Object(l.b)("li",null,"do"),Object(l.b)("li",null,"double"),Object(l.b)("li",null,"dynamic_cast"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"enum"),Object(l.b)("li",null,"explicit"),Object(l.b)("li",null,"export"),Object(l.b)("li",null,"extern"),Object(l.b)("li",null,"false"),Object(l.b)("li",null,"float"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"friend"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"inline"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"linux"),Object(l.b)("li",null,"long"),Object(l.b)("li",null,"mutable"),Object(l.b)("li",null,"namespace"),Object(l.b)("li",null,"new"),Object(l.b)("li",null,"noexcept"),Object(l.b)("li",null,"not"),Object(l.b)("li",null,"not_eq"),Object(l.b)("li",null,"nullptr"),Object(l.b)("li",null,"operator"),Object(l.b)("li",null,"or"),Object(l.b)("li",null,"or_eq"),Object(l.b)("li",null,"private"),Object(l.b)("li",null,"protected"),Object(l.b)("li",null,"public"),Object(l.b)("li",null,"register"),Object(l.b)("li",null,"reinterpret_cast"),Object(l.b)("li",null,"requires"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"short"),Object(l.b)("li",null,"signed"),Object(l.b)("li",null,"sizeof"),Object(l.b)("li",null,"static"),Object(l.b)("li",null,"static_assert"),Object(l.b)("li",null,"static_cast"),Object(l.b)("li",null,"struct"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"template"),Object(l.b)("li",null,"this"),Object(l.b)("li",null,"thread_local"),Object(l.b)("li",null,"throw"),Object(l.b)("li",null,"true"),Object(l.b)("li",null,"try"),Object(l.b)("li",null,"typedef"),Object(l.b)("li",null,"typeid"),Object(l.b)("li",null,"typename"),Object(l.b)("li",null,"union"),Object(l.b)("li",null,"unsigned"),Object(l.b)("li",null,"using"),Object(l.b)("li",null,"virtual"),Object(l.b)("li",null,"void"),Object(l.b)("li",null,"volatile"),Object(l.b)("li",null,"wchar_t"),Object(l.b)("li",null,"while"),Object(l.b)("li",null,"xor"),Object(l.b)("li",null,"xor_eq")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return m}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},u={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},d=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),d=n,m=p["".concat(r,".").concat(d)]||p[d]||u[d]||l;return a?b.a.createElement(m,c({ref:e},j,{components:a})):b.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=d;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/blog/2018/12/24/new-website/index.html b/blog/2018/12/24/new-website/index.html
index f127d32356e..bd23ead4033 100644
--- a/blog/2018/12/24/new-website/index.html
+++ b/blog/2018/12/24/new-website/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/blog/index.html b/blog/index.html
index 321afb5e54d..b7adaef7237 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/cf67c7b0.2531a3d1.js b/cf67c7b0.2531a3d1.js
new file mode 100644
index 00000000000..838b723ac11
--- /dev/null
+++ b/cf67c7b0.2531a3d1.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[145],{269:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return o})),n.d(t,"metadata",(function(){return l})),n.d(t,"rightToc",(function(){return s})),n.d(t,"default",(function(){return c}));var a=n(1),i=n(9),r=(n(0),n(312)),o={id:"templating",title:"Using Templates"},l={id:"templating",title:"Using Templates",description:"It's easy to work with templates for codegen!",source:"@site/../docs/templating.md",permalink:"/docs/templating",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/templating.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"File post-processing",permalink:"/docs/file-post-processing"},next:{title:"Customization",permalink:"/docs/customization"}},s=[{value:"Modifying Templates",id:"modifying-templates",children:[{value:"Retrieving Templates",id:"retrieving-templates",children:[]},{value:"Custom Logic",id:"custom-logic",children:[]},{value:"Custom Engines",id:"custom-engines",children:[]}]},{value:"Structures",id:"structures",children:[{value:"Operations",id:"operations",children:[]},{value:"Models",id:"models",children:[]},{value:"supportingFiles",id:"supportingfiles",children:[]}]},{value:"Variables",id:"variables",children:[]},{value:"Mustache Lambdas",id:"mustache-lambdas",children:[]},{value:"Extensions",id:"extensions",children:[{value:"All generators (core)",id:"all-generators-core",children:[]},{value:"ObjC",id:"objc",children:[]},{value:"Java (Feign)",id:"java-feign",children:[]},{value:"x-content-type",id:"x-content-type",children:[]},{value:"Rust-server",id:"rust-server",children:[]},{value:"MySQL Schema",id:"mysql-schema",children:[]}]},{value:"Mustache Tips",id:"mustache-tips",children:[{value:"First/Last",id:"firstlast",children:[]},{value:"This",id:"this",children:[]},{value:"Index",id:"index",children:[]}]}],p={rightToc:s};function c(e){var t=e.components,n=Object(i.a)(e,["components"]);return Object(r.b)("wrapper",Object(a.a)({},p,n,{components:t,mdxType:"MDXLayout"}),Object(r.b)("p",null,"It's easy to work with templates for codegen!"),Object(r.b)("p",null,"For maybe 90% of use cases, you will only need to modify the mustache template files to create your own custom generated code. If you need to include additional files in your generated output, manipulate the OpenAPI document inputs, or implement your own vendor extensions or other logic, you'll want to read ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," after you read this document. Be sure to start here first, because templating is the easier concept and you'll need it for more advanced use cases."),Object(r.b)("p",null,"The generator workflow has ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages"}),"transforming logic")," as well as templates for each generation of code."),Object(r.b)("p",null,"Each generator will create a data structure from the OpenAPI document; OpenAPI 2.0 and OpenAPI 3.x documents are normalized into the same API model within the generator. This model is then applied to the templates.  While generators do not need to perform transformations, it's often necessary in order to add more advanced support for your language or framework. You may need to refer to the generator implementation to understand some of the logic while creating or customizing templates (see ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/ScalaFinchServerCodegen.java"}),"ScalaFinchServerCodegen.java")," for an advanced example)."),Object(r.b)("p",null,"The transform logic needs to implement ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/CodegenConfig.java"}),"CodegenConfig.java")," and is most easily done by extending ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/DefaultCodegen.java"}),"DefaultCodegen.java"),".  Take a look at the various implementations as a guideline while the instructions get more complete."),Object(r.b)("h2",{id:"modifying-templates"},"Modifying Templates"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"OpenAPI Generator applies user-defined templates via options:  "),Object(r.b)("ul",{parentName:"blockquote"},Object(r.b)("li",{parentName:"ul"},"CLI: ",Object(r.b)("inlineCode",{parentName:"li"},"-t/--template")," CLI options"),Object(r.b)("li",{parentName:"ul"},"Maven Plugin: ",Object(r.b)("inlineCode",{parentName:"li"},"templateDirectory")),Object(r.b)("li",{parentName:"ul"},"Gradle Plugin: ",Object(r.b)("inlineCode",{parentName:"li"},"templateDir")))),Object(r.b)("p",null,"Built-in templates are written in Mustache and processed by ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/samskivert/jmustache"}),"jmustache"),". Beginning with version 4.0.0, we support experimental Handlebars and user-defined template engines via plugins."),Object(r.b)("p",null,"OpenAPI Generator supports user-defined templates. This approach is often the easiest when creating a custom template. Our generators implement a combination of language and framework features, and it's fully possible to use an existing generator to implement a custom template for a different framework. Suppose you have internal utilities which you'd like to incorporate into generated code (e.g. logging, monitoring, fault-handling)... this is easy to add via custom templates."),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Note:")," You cannot use this approach to create new templates, only override existing ones. If you'd like to create a new generator to contribute back to the project, see ",Object(r.b)("inlineCode",{parentName:"p"},"new.sh")," in the repository root. If you'd like to create a private generator for more templating control, see the ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," docs.")),Object(r.b)("p",null,"OpenAPI Generator not only supports local files for templating, but also templates defined on the classpath. This is a great option if you want to reuse templates across multiple projects. To load a template via classpath, you'll need to generate a little differently. For example, if you've created an artifact called ",Object(r.b)("inlineCode",{parentName:"p"},"template-classpath-example")," which contains extended templates for the ",Object(r.b)("inlineCode",{parentName:"p"},"htmlDocs")," generator with the following structure:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),"\u2514\u2500\u2500 src\n    \u251c\u2500\u2500 main\n    \u2502\xa0\xa0 \u251c\u2500\u2500 java\n    \u2502\xa0\xa0 \u2514\u2500\u2500 resources\n    \u2502\xa0\xa0     \u2514\u2500\u2500 templates\n    \u2502\xa0\xa0         \u2514\u2500\u2500 htmlDocs\n    \u2502\xa0\xa0             \u251c\u2500\u2500 index.mustache\n    \u2502\xa0\xa0             \u2514\u2500\u2500 style.css.mustache\n")),Object(r.b)("p",null,"You can define your classpath to contain your JAR and the openapi-generator-cli ",Object(r.b)("em",{parentName:"p"},"fat jar"),", then invoke main class ",Object(r.b)("inlineCode",{parentName:"p"},"org.openapitools.codegen.OpenAPIGenerator"),". For instance,"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"java -cp /path/totemplate-classpath-example-1.0-SNAPSHOT.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \\\n    org.openapitools.codegen.OpenAPIGenerator generate \\\n    -i https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml \\\n    -g html -o template-example -t templates/htmlDocs\n")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"NOTE")," Running your custom generator in the example above requires adding it to the classpath. This differs on ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/windows/classpath.html"}),"Windows")," slightly from ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/unix/classpath.html"}),"unix"),"."),Object(r.b)("p",null,"Take note that our template directory is relative to the resource directory of the JAR defined on the classpath."),Object(r.b)("h3",{id:"retrieving-templates"},"Retrieving Templates"),Object(r.b)("p",null,"You will need to find and retrieve the templates for your desired generator in order to redefine structures, documentation, or API logic. We cover template customization in the following sections."),Object(r.b)("p",null,"In OpenAPI Generator 5.0 and later, you can use the CLI command ",Object(r.b)("inlineCode",{parentName:"p"},"author template")," to extract embedded templates for your target generator. For example:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),"openapi-generator author template -g java --library webclient\n")),Object(r.b)("p",null,"For OpenAPI Generator versions prior to 5.0, you will want to find the ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources"}),"resources directory")," for the generator you want to extend. This is generally easy to find as directories commonly follow the convention of ",Object(r.b)("inlineCode",{parentName:"p"},"resources/<generator name>"),". In cases where you're unsure, you will need to find the ",Object(r.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," assignment in your desired generator. This is almost always assigned in the constructor of the generator class. The C# .Net Core generator assigns this as:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),'embeddedTemplateDir = templateDir = "csharp-netcore";\n')),Object(r.b)("p",null,"These templates are in our source repository at ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/csharp-netcore"}),"modules/openapi-generator/src/main/resources/csharp-netcore"),". Be sure to select the tag or branch for the version of OpenAPI Generator you're using before grabbing the templates."),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"NOTE")," If you have specific logic you'd like to modify such as modifying the generated README, you ",Object(r.b)("em",{parentName:"p"},"only")," need to pull and modify this individual template. OpenAPI Generator will lookup templates in this order:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"User customized library path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"custom_template/libraries/feign/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"User customized generator top-level path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"custom_template/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"Embedded library path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"resources/Java/libraries/feign/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"Embedded top-level path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"resources/Java/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"Common embedded path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"resources/_common/model.mustache"),")")),Object(r.b)("h3",{id:"custom-logic"},"Custom Logic"),Object(r.b)("p",null,"For this example, let's modify a Java client to use AOP via ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/jcabi/jcabi-aspects"}),"jcabi/jcabi-aspects"),". We'll log API method execution at the ",Object(r.b)("inlineCode",{parentName:"p"},"INFO")," level. The jcabi-aspects project could also be used to implement method retries on failures; this would be a great exercise to further play around with templating."),Object(r.b)("p",null,"The Java generator supports a ",Object(r.b)("inlineCode",{parentName:"p"},"library"),' option. This option works by defining base templates, then applying library-specific template overrides. This allows for template reuse for libraries sharing the same programming language. Templates defined as a library need only modify or extend the templates concerning the library, and generation falls back to the root templates (the "defaults") when not extended by the library. Generators which support the ',Object(r.b)("inlineCode",{parentName:"p"},"library")," option will only support the libraries known by the generator at compile time, and will throw a runtime error if you try to provide a custom library name."),Object(r.b)("p",null,"To get started, we will need to copy our target generator's directory in full."),Object(r.b)("p",null,"The directory will be located under ",Object(r.b)("inlineCode",{parentName:"p"},"modules/openapi-generator/src/main/resources/{generator}"),". In general, the generator directory matches the generator name (what you would pass to the ",Object(r.b)("inlineCode",{parentName:"p"},"generator")," option), but this is not a requirement-- if you are having a hard time finding the template directory, look at the ",Object(r.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," option in your target generator's implementation."),Object(r.b)("p",null,"If you've already cloned openapi-generator, find and copy the ",Object(r.b)("inlineCode",{parentName:"p"},"modules/openapi-generator/src/main/resources/Java")," directory. If you have the ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/sindresorhus/refined-github"}),"Refined GitHub"),' Chrome or Firefox Extension, you can navigate to this directory on GitHub and click the "Download" button. Or, to pull the directory from latest master:'),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"mkdir -p ~/.openapi-generator/templates/ && cd $_\ncurl -L https://api.github.com/repos/OpenAPITools/openapi-generator/tarball | tar xz\nmv `ls`/modules/openapi-generator/src/main/resources/Java ./Java\n\\rm -rf OpenAPITools-openapi-generator-*\ncd Java\n")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"Optional"),": Before modifying your templates, you may want to ",Object(r.b)("inlineCode",{parentName:"p"},"git init && git add . && git commit -am 'initial'")," so you can easily revert to the base templates."),Object(r.b)("p",null,"At this point, you have ",Object(r.b)("em",{parentName:"p"},"every")," Java library's template locally. Let's delete all libraries except the ",Object(r.b)("inlineCode",{parentName:"p"},"resteasy")," library we'll be extending:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"ls -d libraries/* | grep -v resteasy | xargs rm -rf\n")),Object(r.b)("p",null,"Execute ",Object(r.b)("inlineCode",{parentName:"p"},"tree")," in this Java directory and inspect the mustache files and directory structure. You'll notice there are quite a few templates in the directory root, but extending this root to support resteasy only requires modifying a handful of files:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"tree libraries/resteasy/\nlibraries/resteasy/\n\u251c\u2500\u2500 ApiClient.mustache\n\u251c\u2500\u2500 JSON.mustache\n\u251c\u2500\u2500 api.mustache\n\u251c\u2500\u2500 build.gradle.mustache\n\u251c\u2500\u2500 build.sbt.mustache\n\u2514\u2500\u2500 pom.mustache\n\n0 directories, 6 files\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"NOTE: Some generators may be sensitive to ",Object(r.b)("em",{parentName:"p"},"which")," files exist. If you're concerned with redundant files like ",Object(r.b)("inlineCode",{parentName:"p"},"pom.mustache")," and ",Object(r.b)("inlineCode",{parentName:"p"},"build.sbt.mustache"),", you can try deleting them. If the generator you're customizing fails at runtime, just ",Object(r.b)("inlineCode",{parentName:"p"},"touch")," these files to create an empty file.")),Object(r.b)("p",null,"First, let's add our new dependency to ",Object(r.b)("inlineCode",{parentName:"p"},"libraries/resteasy/build.gradle.mustache"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),'diff --git a/libraries/resteasy/build.gradle.mustache b/libraries/resteasy/build.gradle.mustache\nindex 3b40702..a6d12e0 100644\n--- a/libraries/resteasy/build.gradle.mustache\n+++ b/libraries/resteasy/build.gradle.mustache\n@@ -134,6 +134,7 @@ ext {\n }\n\n dependencies {\n+    compile "com.jcabi:jcabi-aspects:0.22.6"\n     compile "io.swagger:swagger-annotations:$swagger_annotations_version"\n     compile "org.jboss.resteasy:resteasy-client:$resteasy_version"\n     compile "org.jboss.resteasy:resteasy-multipart-provider:$resteasy_version"\n\n')),Object(r.b)("p",null,"Then, we'll add the necessary import to ",Object(r.b)("inlineCode",{parentName:"p"},"api.mustache"),". This file is the template which becomes the API invoking class (e.g. ",Object(r.b)("inlineCode",{parentName:"p"},"PetApi")," or ",Object(r.b)("inlineCode",{parentName:"p"},"StoreApi"),")."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),"diff --git a/libraries/resteasy/api.mustache b/libraries/resteasy/api.mustache\nindex a4d0f9f..49b17c7 100644\n--- a/libraries/resteasy/api.mustache\n+++ b/libraries/resteasy/api.mustache\n@@ -1,5 +1,6 @@\n package {{package}};\n\n+import com.jcabi.aspects.Loggable;\n import {{invokerPackage}}.ApiException;\n import {{invokerPackage}}.ApiClient;\n import {{invokerPackage}}.Configuration;\n\n")),Object(r.b)("p",null,"Next, we'll find the code which generates API methods. You'll see ",Object(r.b)("inlineCode",{parentName:"p"},"{{#operations}}{{#operation}}"),' which is a mustache "loop" which executes the template logic if the model applied to the template has an ',Object(r.b)("inlineCode",{parentName:"p"},"operations")," array, and a non-null ",Object(r.b)("inlineCode",{parentName:"p"},"operation")," instance in that array. You can pass ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugOpenAPI=true")," when generating via CLI to inspect the full object model."),Object(r.b)("p",null,"Further down in ",Object(r.b)("inlineCode",{parentName:"p"},"api.mustache"),", find implementation of the method call, and add the ",Object(r.b)("inlineCode",{parentName:"p"},"@Loggable")," annotation. This template is easy because it has a single method implementation."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),"diff --git a/libraries/resteasy/api.mustache b/libraries/resteasy/api.mustache\nindex 49b17c7..16ee191 100644\n--- a/libraries/resteasy/api.mustache\n+++ b/libraries/resteasy/api.mustache\n@@ -57,6 +57,7 @@ public class {{classname}} {\n   {{#isDeprecated}}\n   @Deprecated\n   {{/isDeprecated}}\n+  @Loggable(Loggable.INFO)\n   public {{#returnType}}{{{returnType}}} {{/returnType}}{{^returnType}}void {{/returnType}}{{operationId}}({{#allParams}}{{{dataType}}} {{paramName}}{{^-last}}, {{/-last}}{{/allParams}}) throws ApiException {\n     Object {{localVariablePrefix}}localVarPostBody = {{#bodyParam}}{{paramName}}{{/bodyParam}}{{^bodyParam}}new Object(){{/bodyParam}};\n     {{#allParams}}{{#required}}\n\n")),Object(r.b)("p",null,"Finally, because our new dependency relies on AspectJ and code weaving, let's modify the ",Object(r.b)("inlineCode",{parentName:"p"},"build.gradle.mustache")," again to set this up."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),'diff --git a/build.gradle.mustache b/build.gradle.mustache\nindex 04a9d55..7a93c50 100644\n--- a/build.gradle.mustache\n+++ b/build.gradle.mustache\n@@ -1,5 +1,6 @@\n apply plugin: \'idea\'\n apply plugin: \'eclipse\'\n+apply plugin: \'aspectj\'\n\n group = \'{{groupId}}\'\n version = \'{{artifactVersion}}\'\n@@ -12,6 +13,7 @@ buildscript {\n     dependencies {\n         classpath \'com.android.tools.build:gradle:2.3.+\'\n         classpath \'com.github.dcendents:android-maven-gradle-plugin:1.5\'\n+        classpath "net.uberfoo.gradle:gradle-aspectj:2.2"\n     }\n }\n\n@@ -140,9 +142,18 @@ ext {\n     jersey_version = "1.19.4"\n     jodatime_version = "2.9.9"\n     junit_version = "4.13"\n+    aspectjVersion = \'1.9.0\'\n }\n\n+sourceCompatibility = \'1.8\'\n+targetCompatibility = \'1.8\'\n+\n dependencies {\n+    compile "com.jcabi:jcabi-aspects:0.22.6"\n+    aspectpath "com.jcabi:jcabi-aspects:0.22.6"\n+    // usually, client code leaves logging implementation to the consumer code\n+    compile "org.apache.logging.log4j:log4j-slf4j-impl:2.8.2"\n+    compile "org.apache.logging.log4j:log4j-core:2.8.2"\n     compile "io.swagger:swagger-annotations:$swagger_annotations_version"\n     compile "com.sun.jersey:jersey-client:$jersey_version"\n     compile "com.sun.jersey.contribs:jersey-multipart:$jersey_version"\n\n')),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"NOTE: This example includes log4j-slf4j-impl to demonstrate that our new code is working. Generally you'll want to leave logging implementations up to your consumers.")),Object(r.b)("p",null,"And because the java client generates with an outdated Gradle 2.6, let's update the gradle version in the default template (",Object(r.b)("inlineCode",{parentName:"p"},"Java/gradle-wrapper.properties.mustache"),"):"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),"diff --git a/gradle-wrapper.properties.mustache b/gradle-wrapper.properties.mustache\nindex b7a3647..3d9d088 100644\n--- a/gradle-wrapper.properties.mustache\n+++ b/gradle-wrapper.properties.mustache\n@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME\n distributionPath=wrapper/dists\n zipStoreBase=GRADLE_USER_HOME\n zipStorePath=wrapper/dists\n-distributionUrl=https\\://services.gradle.org/distributions/gradle-2.6-bin.zip\n+distributionUrl=https\\://services.gradle.org/distributions/gradle-4.8-bin.zip\n\n")),Object(r.b)("p",null,"Now we're ready to generate the client with our simple changes. When we pass the template directory option to our toolset, we ",Object(r.b)("em",{parentName:"p"},"must")," pass the generator's root directory and ",Object(r.b)("em",{parentName:"p"},"not")," the library-only directory."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g java --library resteasy \\\n    -t ~/.openapi-generator/templates/Java \\\n    -o ~/.openapi-generator/example \\\n    -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml\n")),Object(r.b)("p",null,"Make sure your custom template compiles:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"cd ~/.openapi-generator/example\ngradle assemble\n# or, regenerate the wrapper\ngradle wrapper --gradle-version 4.8 --distribution-type all\n./gradlew assemble\n")),Object(r.b)("p",null,"You should see a log message showing our added dependency being downloaded:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"\u2026\nDownload https://jcenter.bintray.com/com/jcabi/jcabi-aspects/0.22.6/jcabi-aspects-0.22.6.pom\n\u2026\n")),Object(r.b)("p",null,"And for the sake of verifying our AOP modifications work, let's create a ",Object(r.b)("inlineCode",{parentName:"p"},"src/main/resources/log4j2.properties")," file in our new client code:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-properties"}),"status = error\ndest = err\nname = PropertiesConfig\n\nproperty.filename = target/rolling/rollingtest.log\n\nfilter.threshold.type = ThresholdFilter\nfilter.threshold.level = debug\n\nappender.console.type = Console\nappender.console.name = STDOUT\nappender.console.layout.type = PatternLayout\nappender.console.layout.pattern = %m%n\nappender.console.filter.threshold.type = ThresholdFilter\nappender.console.filter.threshold.level = error\n\nappender.rolling.type = RollingFile\nappender.rolling.name = RollingFile\nappender.rolling.fileName = ${filename}\nappender.rolling.filePattern = target/rolling2/test1-%d{MM-dd-yy-HH-mm-ss}-%i.log.gz\nappender.rolling.layout.type = PatternLayout\nappender.rolling.layout.pattern = %d %p %C{1.} [%t] %m%n\nappender.rolling.policies.type = Policies\nappender.rolling.policies.time.type = TimeBasedTriggeringPolicy\nappender.rolling.policies.time.interval = 2\nappender.rolling.policies.time.modulate = true\nappender.rolling.policies.size.type = SizeBasedTriggeringPolicy\nappender.rolling.policies.size.size=100MB\nappender.rolling.strategy.type = DefaultRolloverStrategy\nappender.rolling.strategy.max = 5\n\nlogger.rolling.name = org.openapitools.client.api.PetApi\nlogger.rolling.level = debug\nlogger.rolling.additivity = false\nlogger.rolling.appenderRef.rolling.ref = RollingFile\n\nrootLogger.level = info\nrootLogger.appenderRef.stdout.ref = STDOUT\n")),Object(r.b)("p",null,"Execute ",Object(r.b)("inlineCode",{parentName:"p"},"./gradlew build")," and then ",Object(r.b)("inlineCode",{parentName:"p"},"cat target/rolling/rollingtest.log"),". You should see messages logged for every call in PetApi with a stubbed unit test."),Object(r.b)("p",null,"Congratulations! You've now modified one of the built-in templates to meet your client code's needs."),Object(r.b)("p",null,"Adding/modifying template logic simply requires a little bit of ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://mustache.github.io/"}),"mustache"),", for which you can use existing templates as a guide."),Object(r.b)("h3",{id:"custom-engines"},"Custom Engines"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Custom template engine support is ",Object(r.b)("em",{parentName:"p"},"experimental"))),Object(r.b)("p",null,"If Mustache or the experimental Handlebars engines don't suit your needs, you can define an adapter to your templating engine of choice. To do this, you'll need to define a new project which consumes the ",Object(r.b)("inlineCode",{parentName:"p"},"openapi-generator-core")," artifact, and at a minimum implement ",Object(r.b)("inlineCode",{parentName:"p"},"TemplatingEngineAdapter"),"."),Object(r.b)("p",null,"This example:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"creates an adapter providing the fundamental logic to compile ",Object(r.b)("a",Object(a.a)({parentName:"li"},{href:"https://pebbletemplates.io"}),"Pebble Templates")),Object(r.b)("li",{parentName:"ul"},"will be implemented in Kotlin to demonstrate ServiceLoader configuration specific to Kotlin (Java will be similar)"),Object(r.b)("li",{parentName:"ul"},"requires Gradle 5.0+"),Object(r.b)("li",{parentName:"ul"},"provides project setup instructions for IntelliJ")),Object(r.b)("p",null,"To begin, create a ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://www.jetbrains.com/help/idea/getting-started-with-gradle.html"}),"new Gradle project")," with Kotlin support. To do this, go to ",Object(r.b)("inlineCode",{parentName:"p"},"File")," \u279e ",Object(r.b)("inlineCode",{parentName:"p"},"New")," \u279e ",Object(r.b)("inlineCode",{parentName:"p"},"Project"),', choose "Gradle" and "Kotlin". Specify groupId ',Object(r.b)("inlineCode",{parentName:"p"},"org.openapitools.examples")," and artifactId ",Object(r.b)("inlineCode",{parentName:"p"},"pebble-template-adapter"),"."),Object(r.b)("p",null,"Ensure the new project uses Gradle 5.0. Navigate to the newly created directory and execute:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"gradle wrapper --gradle-version 5.0\n")),Object(r.b)("p",null,"In ",Object(r.b)("inlineCode",{parentName:"p"},"build.gradle"),", we'll add a dependency for OpenAPI Tools core which defines the interface and an abstract helper type for implementing the adapter. We'll also pull in the Pebble artifact. We'll be evaluating this new artifact locally, so we'll also add the Maven plugin for installing to the local maven repository. We'll also create a fatjar using the ",Object(r.b)("inlineCode",{parentName:"p"},"shadow")," plugin to simplify our classpath."),Object(r.b)("p",null,"Modifications to the new project's ",Object(r.b)("inlineCode",{parentName:"p"},"build.gradle")," should be made in the ",Object(r.b)("inlineCode",{parentName:"p"},"plugins")," and ",Object(r.b)("inlineCode",{parentName:"p"},"dependencies")," nodes:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),' plugins {\n    id \'org.jetbrains.kotlin.jvm\' version \'1.3.11\'\n    id "com.github.johnrengelman.shadow" version "5.0.0"\n }\n\n dependencies {\n    compile "org.jetbrains.kotlin:kotlin-stdlib-jdk8"\n    compile "org.openapitools:openapi-generator-core:4.0.0-SNAPSHOT"\n    compile "io.pebbletemplates:pebble:3.0.8"\n }\n')),Object(r.b)("p",null,"The above configuration for the ",Object(r.b)("inlineCode",{parentName:"p"},"shadow")," plugin is strictly optional. It is not needed, for instance, if you plan to publish your adapter and consume it via the Maven or Gradle plugins."),Object(r.b)("p",null,"Next, create a new class file called ",Object(r.b)("inlineCode",{parentName:"p"},"PebbleTemplateEngineAdapter")," under ",Object(r.b)("inlineCode",{parentName:"p"},"src/kotlin"),". We'll define the template adapter's name as ",Object(r.b)("inlineCode",{parentName:"p"},"pebble")," and we'll also list this as the only supported file extension. We'll implement the adapter by extending ",Object(r.b)("inlineCode",{parentName:"p"},"AbstractTemplatingEngineAdapter"),", which includes reusable logic, such as retrieving a list of all possible template names for our provided template extensions(s)."),Object(r.b)("p",null,"The class in its simplest form looks like this (with inline comments):"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-kotlin"}),'// Allows specifying engine by class name\n// e.g. -e org.openapitools.examples.templating.PebbleTemplateAdapter\n@file:JvmName("PebbleTemplateAdapter")\npackage org.openapitools.examples.templating\n\n// imports\n\nclass PebbleTemplateAdapter : AbstractTemplatingEngineAdapter() {\n    // initialize the template compilation engine\n    private val engine: PebbleEngine = PebbleEngine.Builder()\n        .cacheActive(false)\n        .loader(DelegatingLoader(listOf(FileLoader(), ClasspathLoader())))\n        .build()\n\n    // allows targeting engine by id/name: -e pebble\n    override fun getIdentifier(): String = "pebble"\n\n    override fun compileTemplate(\n        generator: TemplatingGenerator?,\n        bundle: MutableMap<String, Any>?,\n        templateFile: String?\n    ): String {\n        // This will convert, for example, model.mustache to model.pebble\n        val modifiedTemplate = this.getModifiedFileLocation(templateFile).first()\n\n        // Uses generator built-in template resolution strategy to find the full template file\n        val filePath = generator?.getFullTemplatePath(modifiedTemplate)\n\n        val writer = StringWriter()\n        // Conditionally writes out the template if found.\n        if (filePath != null) {\n            engine.getTemplate(filePath.toAbsolutePath().toString())?.evaluate(writer, bundle)\n        }\n        return writer.toString()\n    }\n\n    override fun getFileExtensions(): Array<String> = arrayOf("pebble")\n}\n')),Object(r.b)("p",null,"Lastly, create a file ",Object(r.b)("inlineCode",{parentName:"p"},"resources/META-INF/services/org.openapitools.codegen.api.TemplatingEngineAdapter"),", containing the full class path to the above class:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),"org.openapitools.examples.templating.PebbleTemplateAdapter\n")),Object(r.b)("p",null,"This allows the adapter to load via ServiceLoader, and to be referenced via the identifier ",Object(r.b)("inlineCode",{parentName:"p"},"pebble"),". This is optional; if you don't provide the above file and contents, you'll only be able to load the engine via full class name (explained in a bit)."),Object(r.b)("p",null,"Now, build the fatjar for this new adapter:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"./gradlew shadowJar\n")),Object(r.b)("p",null,"To test compilation of some templates, we'll need to first create one or more template files. Create a temp directory at ",Object(r.b)("inlineCode",{parentName:"p"},"/tmp/pebble-example/templates")," and add the following files."),Object(r.b)("p",null,Object(r.b)("em",{parentName:"p"},"api.pebble")),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),'package {{packageName}}\n\nimport (\n    "net/http"\n{% for item in imports %}\n    "{{item.import}}"\n{% endfor %}\n)\n\ntype Generated{{classname}}Servicer\n\n// etc\n')),Object(r.b)("p",null,Object(r.b)("em",{parentName:"p"},"model.pebble")),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),'package {{packageName}}\n\n{% for item in models %}\n{% if item.isEnum %}\n// TODO: enum\n{% else %}\n{% if item.description is not empty %}// {{item.description}}{% endif %}\ntype {{item.classname}} struct {\n{% for var in item.model.vars %}\n    {% if var.description is not empty %}// {{var.description}}{% endif %}\n    {{var.name}} {% if var.isNullable %}*{% endif %}{{var.dataType}} `json:"{{var.baseName}}{% if var.required == false %},omitempty{% endif %}"{% if var.withXml == true %} xml:"{{var.baseName}}{% if var.isXmlAttribute %},attr{% endif %}"{% endif %}`\n{% endfor %}\n}\n{% endif %}\n{{model.name}}\n{% endfor %}\n')),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Find object structures passed to templates later in this document's ",Object(r.b)("strong",{parentName:"p"},"Structures")," section.")),Object(r.b)("p",null,"Finally, we can compile some code by explicitly defining our classpath and jar entrypoint for CLI (be sure to modify ",Object(r.b)("inlineCode",{parentName:"p"},"/your/path")," below)"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"java $JAVA_OPTS -cp /your/path/build/libs/pebble-template-adapter-1.0-SNAPSHOT-all.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \\\n    org.openapitools.codegen.OpenAPIGenerator \\\n    generate \\\n    -g go \\\n    -i https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v2.0/json/petstore-minimal.json \\\n    -e pebble \\\n    -o /tmp/pebble-example/out \\\n    -t /tmp/pebble-example/templates \\\n    --global-property models,modelDocs,modelTests,apis,apiTests,apiDocs\n")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"NOTE")," Running your custom generator requires adding it to the classpath. This differs on ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/windows/classpath.html"}),"Windows")," slightly from ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/unix/classpath.html"}),"unix"),"."),Object(r.b)("p",null,"In the above example, we've targeted our custom template engine adapter via ",Object(r.b)("inlineCode",{parentName:"p"},"-e pebble"),". If you don't include the SPI file under ",Object(r.b)("inlineCode",{parentName:"p"},"META-INF/services"),", you'll need to specify the exact classpath: ",Object(r.b)("inlineCode",{parentName:"p"},"org.openapitools.examples.templating.PebbleTemplateAdapter"),". Notice that the target class here matches the Kotlin class name. This is because of the ",Object(r.b)("inlineCode",{parentName:"p"},"@file:JvmName")," annotation."),Object(r.b)("p",null,"Congratulations on creating a custom templating engine adapter!"),Object(r.b)("h2",{id:"structures"},"Structures"),Object(r.b)("p",null,"Aside from transforming an API document, the implementing class gets to decide how to apply the data structure to templates. We can decide which data structure to apply to which template files. You have the following structures at your disposal."),Object(r.b)("p",null,"Examples for the following structures will be presented using the following spec document:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'  swagger: "2.0"\n  info:\n    version: "1.0.0"\n    title: "Swagger Petstore"\n    description: "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification"\n    termsOfService: "http://swagger.io/terms/"\n    contact:\n      name: "Swagger API Team"\n    license:\n      name: "MIT"\n  host: "petstore.swagger.io"\n  basePath: "/api"\n  schemes:\n    - "http"\n  consumes:\n    - "application/json"\n  produces:\n    - "application/json"\n  paths:\n    /pets:\n      get:\n        description: "Returns all pets from the system that the user has access to"\n        produces:\n          - "application/json"\n        responses:\n          "200":\n            description: "A list of pets."\n            schema:\n              type: "array"\n              items:\n                $ref: "#/definitions/Pet"\n  definitions:\n    Pet:\n      type: "object"\n      required:\n        - "id"\n        - "name"\n      properties:\n        id:\n          type: "integer"\n          format: "int64"\n        name:\n          type: "string"\n        tag:\n          type: "string"\n\n')),Object(r.b)("h3",{id:"operations"},"Operations"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Inspect operation structures passed to templates with system property ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugOpenAPI=true")),Object(r.b)("p",{parentName:"blockquote"},"Example:"),Object(r.b)("pre",{parentName:"blockquote"},Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugOpenAPI=true\n"))),Object(r.b)("p",null,"There is a data structure which represents all the operations that are defined in the OpenAPI specification.  A single API file is created for each ",Object(r.b)("inlineCode",{parentName:"p"},"OperationGroup"),", which is essentially a grouping of different operations.  See the ",Object(r.b)("inlineCode",{parentName:"p"},"addOperationToGroup")," in ",Object(r.b)("inlineCode",{parentName:"p"},"DefaultCodegen.java")," for details on this operation."),Object(r.b)("p",null,"You can have many files created for each ",Object(r.b)("inlineCode",{parentName:"p"},"OperationGroup")," by processing multiple templates and assigning a different file naming pattern to them.  So for a single file per operation:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'// process the `api.mustache` template and output a single file with suffix `.java`:\napiTemplateFiles.put("api.mustache", ".java");\n')),Object(r.b)("p",null,"For C-like languages which also require header files, you may create two files per operation."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-objectivec"}),'// create a header and implementation for each operation group:\napiTemplateFiles.put("api-header.mustache", ".h");\napiTemplateFiles.put("api-body.mustache", ".m");\n')),Object(r.b)("p",null,"Here, an Operation with tag ",Object(r.b)("inlineCode",{parentName:"p"},"Pet")," will generate two files: ",Object(r.b)("inlineCode",{parentName:"p"},"SWGPetApi.h")," and ",Object(r.b)("inlineCode",{parentName:"p"},"SWGPetApi.m"),". The ",Object(r.b)("inlineCode",{parentName:"p"},"SWG")," prefix and ",Object(r.b)("inlineCode",{parentName:"p"},"Api")," suffix are options specific to the Objective-C generator."),Object(r.b)("h3",{id:"models"},"Models"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Inspect models passed to templates with system property ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugModels=true")),Object(r.b)("p",{parentName:"blockquote"},"Execute:"),Object(r.b)("pre",{parentName:"blockquote"},Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugModels=true\n"))),Object(r.b)("p",null,"Each model identified inside the generator will be passed into the ",Object(r.b)("inlineCode",{parentName:"p"},"Models")," data structure and will generate a new model file (or files) for each model."),Object(r.b)("p",null,"A ",Object(r.b)("inlineCode",{parentName:"p"},"Pet")," model with three properties will provide a ",Object(r.b)("em",{parentName:"p"},"lot")," of information about the type and properties. The output from ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugModels=true")," is presented in truncated format here."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'[ {\n  "importPath" : "openapi.Pet",\n  "model" : {\n    "name" : "Pet",\n    "classname" : "Pet",\n    "classVarName" : "Pet",\n    "modelJson" : "{\\n  \\"required\\" : [ \\"id\\", \\"name\\" ],\\n  \\"type\\" : \\"object\\",\\n  \\"properties\\" : {\\n    \\"id\\" : {\\n      \\"type\\" : \\"integer\\",\\n      \\"format\\" : \\"int64\\"\\n    },\\n    \\"name\\" : {\\n      \\"type\\" : \\"string\\"\\n    },\\n    \\"tag\\" : {\\n      \\"type\\" : \\"string\\"\\n    }\\n  }\\n}",\n    "dataType" : "map[string]interface{}",\n    "classFilename" : "model_pet",\n    "isAlias" : false,\n    "isString" : false,\n    "isInteger" : false,\n    "vars" : [ {\n      "baseName" : "id",\n      "getter" : "getId",\n      "setter" : "setId",\n      "dataType" : "int64",\n      "datatypeWithEnum" : "int64",\n      "dataFormat" : "int64",\n      "name" : "Id",\n      "defaultValueWithParam" : " = data.id;",\n      "baseType" : "int64",\n      "example" : "null",\n      "jsonSchema" : "{\\n  \\"type\\" : \\"integer\\",\\n  \\"format\\" : \\"int64\\"\\n}",\n      "exclusiveMinimum" : false,\n      "exclusiveMaximum" : false,\n      "required" : true,\n      "hasMoreNonReadOnly" : true,\n      "isPrimitiveType" : true,\n      "isModel" : false,\n      "isContainer" : false,\n      "isNotContainer" : true,\n      "isString" : false,\n      "isNumeric" : true,\n      "isInteger" : false,\n      "isLong" : true,\n      "isNumber" : false,\n      "isFloat" : false,\n      "isDouble" : false,\n      "isByteArray" : false,\n      "isBinary" : false,\n      "isFile" : false,\n      "isBoolean" : false,\n      "isDate" : false,\n      "isDateTime" : false,\n      "isUuid" : false,\n      "isEmail" : false,\n      "isFreeFormObject" : false,\n      "isArray" : false,\n      "isMap" : false,\n      "isEnum" : false,\n      "isReadOnly" : false,\n      "isWriteOnly" : false,\n      "isNullable" : false,\n      "vendorExtensions" : { },\n      "hasValidation" : false,\n      "isInherited" : false,\n      "nameInCamelCase" : "Id",\n      "nameInSnakeCase" : "ID",\n      "isXmlAttribute" : false,\n      "isXmlWrapped" : false,\n      "datatype" : "int64",\n      "iexclusiveMaximum" : false\n    }, {\n      "baseName" : "name",\n      "getter" : "getName",\n      "setter" : "setName",\n      "dataType" : "string",\n      "datatypeWithEnum" : "string",\n      "name" : "Name",\n      "defaultValueWithParam" : " = data.name;",\n      "baseType" : "string",\n      "example" : "null",\n      "jsonSchema" : "{\\n  \\"type\\" : \\"string\\"\\n}",\n      "exclusiveMinimum" : false,\n      "exclusiveMaximum" : false,\n      "required" : true,\n      "hasMoreNonReadOnly" : true,\n      "isPrimitiveType" : true,\n      "isModel" : false,\n      "isContainer" : false,\n      "isNotContainer" : true,\n      "isString" : true,\n      "isNumeric" : false,\n      "isInteger" : false,\n      "isLong" : false,\n      "isNumber" : false,\n      "isFloat" : false,\n      "isDouble" : false,\n      "isByteArray" : false,\n      "isBinary" : false,\n      "isFile" : false,\n      "isBoolean" : false,\n      "isDate" : false,\n      "isDateTime" : false,\n      "isUuid" : false,\n      "isEmail" : false,\n      "isFreeFormObject" : false,\n      "isArray" : false,\n      "isMap" : false,\n      "isEnum" : false,\n      "isReadOnly" : false,\n      "isWriteOnly" : false,\n      "isNullable" : false,\n      "vendorExtensions" : { },\n      "hasValidation" : false,\n      "isInherited" : false,\n      "nameInCamelCase" : "Name",\n      "nameInSnakeCase" : "NAME",\n      "isXmlAttribute" : false,\n      "isXmlWrapped" : false,\n      "datatype" : "string",\n      "iexclusiveMaximum" : false\n    }, {\n      "baseName" : "tag",\n      "getter" : "getTag",\n      "setter" : "setTag",\n      "dataType" : "string",\n      "datatypeWithEnum" : "string",\n      "name" : "Tag",\n      "defaultValueWithParam" : " = data.tag;",\n      "baseType" : "string",\n      "example" : "null",\n      "jsonSchema" : "{\\n  \\"type\\" : \\"string\\"\\n}",\n      "exclusiveMinimum" : false,\n      "exclusiveMaximum" : false,\n      "required" : false,\n      "hasMoreNonReadOnly" : false,\n      "isPrimitiveType" : true,\n      "isModel" : false,\n      "isContainer" : false,\n      "isNotContainer" : true,\n      "isString" : true,\n      "isNumeric" : false,\n      "isInteger" : false,\n      "isLong" : false,\n      "isNumber" : false,\n      "isFloat" : false,\n      "isDouble" : false,\n      "isByteArray" : false,\n      "isBinary" : false,\n      "isFile" : false,\n      "isBoolean" : false,\n      "isDate" : false,\n      "isDateTime" : false,\n      "isUuid" : false,\n      "isEmail" : false,\n      "isFreeFormObject" : false,\n      "isArray" : false,\n      "isMap" : false,\n      "isEnum" : false,\n      "isReadOnly" : false,\n      "isWriteOnly" : false,\n      "isNullable" : false,\n      "vendorExtensions" : { },\n      "hasValidation" : false,\n      "isInherited" : false,\n      "nameInCamelCase" : "Tag",\n      "nameInSnakeCase" : "TAG",\n      "isXmlAttribute" : false,\n      "isXmlWrapped" : false,\n      "datatype" : "string",\n      "iexclusiveMaximum" : false\n    } ],\n    "requiredVars" : [ /* id, name */ ],\n    "optionalVars" : [ /* tag */ ],\n    "readOnlyVars" : [ ],\n    "readWriteVars" : [ /* lists metadata for all three properties */ ],\n    "allVars" : [ /* lists all properties */],\n    "parentVars" : [ ],\n    "mandatory" : [ "id", "name" ],\n    "allMandatory" : [ "id", "name" ],\n    "imports" : [ ],\n    "hasVars" : true,\n    "emptyVars" : false,\n    "hasMoreModels" : false,\n    "hasEnums" : false,\n    "isEnum" : false,\n    "hasRequired" : true,\n    "hasOptional" : true,\n    "isArray" : false,\n    "hasChildren" : false,\n    "isMap" : false,\n    "hasOnlyReadOnly" : false,\n    "vendorExtensions" : { }\n  }\n} ]\n')),Object(r.b)("p",null,"Templates are passed redundant properties, depending on the semantics of the array. For example:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"vars")," lists all defined model properties"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"requiredVars")," lists all model properties marked with ",Object(r.b)("inlineCode",{parentName:"li"},"required")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"optionalVars")," lists all model properties ",Object(r.b)("em",{parentName:"li"},"not")," marked with ",Object(r.b)("inlineCode",{parentName:"li"},"required")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"readWriteVars")," lists all model properties ",Object(r.b)("em",{parentName:"li"},"not")," marked with ",Object(r.b)("inlineCode",{parentName:"li"},"readonly")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"readOnlyVars")," lists all model properties marked with ",Object(r.b)("inlineCode",{parentName:"li"},"readonly")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"allVars")," lists all model properties. This may include the same set as ",Object(r.b)("inlineCode",{parentName:"li"},"vars"),", but may also include generator-defined properties")),Object(r.b)("p",null,'We expose the same properties in multiple sets because this allows us to conditionally iterate over properties based on some condition ("is it required" or "is it readonly"). This is driven by the use of the logic-less Mustache templates. It is possible that models passed to the templating engine may be cleaned up as we support more template engines, but such an effort will go through a deprecation phase and would be communicated at runtime through log messages.'),Object(r.b)("h3",{id:"supportingfiles"},"supportingFiles"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Inspect supportingFiles passed to templates with system property ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugSupportingFiles=true")),Object(r.b)("p",{parentName:"blockquote"},"Execute:"),Object(r.b)("pre",{parentName:"blockquote"},Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugSupportingFiles=true\n"))),Object(r.b)("p",null,'This is a "catch-all" which gives you the entire structure--operations, model, etc--so you can create "single-file" code from them.'),Object(r.b)("p",null,"Supporting files can either be processed through the templating engine or copied as-is. When creating your own templates, you're limited to the files and extensions expected by the generator implementation. For more control over the supporting files produced by a generator, see our ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," documentation."),Object(r.b)("h2",{id:"variables"},"Variables"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"This is a very limited list of variable name explanations. Feel free to ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/pull/new/master"}),"open a pull request")," to add to this documentation!")),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("strong",{parentName:"li"},"complexType"),": stores the name of the model (e.g. Pet)"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("strong",{parentName:"li"},"isContainer"),": true if the parameter or property is an array or a map."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("strong",{parentName:"li"},"isPrimitiveType"),": true if the parameter or property type is a primitive type (e.g. string, integer, etc) as defined in the spec.")),Object(r.b)("h2",{id:"mustache-lambdas"},"Mustache Lambdas"),Object(r.b)("p",null,"Many generators (",Object(r.b)("em",{parentName:"p"},"those extending DefaultCodegen"),") come with a small set of lambda functions available under the key ",Object(r.b)("inlineCode",{parentName:"p"},"lambda"),":"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"lowercase")," - Converts all of the characters in this fragment to lower case using the rules of the ",Object(r.b)("inlineCode",{parentName:"li"},"ROOT")," locale."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"uppercase")," - Converts all of the characters in this fragment to upper case using the rules of the ",Object(r.b)("inlineCode",{parentName:"li"},"ROOT")," locale."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"titlecase")," - Converts text in a fragment to title case. For example ",Object(r.b)("inlineCode",{parentName:"li"},"once upon a time")," to ",Object(r.b)("inlineCode",{parentName:"li"},"Once Upon A Time"),"."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"camelcase")," - Converts text in a fragment to camelCase. For example ",Object(r.b)("inlineCode",{parentName:"li"},"Input-text")," to ",Object(r.b)("inlineCode",{parentName:"li"},"inputText"),"."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented")," - Prepends 4 spaces indention from second line of a fragment on. First line will be indented by Mustache."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented_8")," - Prepends 8 spaces indention from second line of a fragment on. First line will be indented by Mustache."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented_12")," - Prepends 12 spaces indention from second line of a fragment on. First line will be indented by Mustache."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented_16")," -Prepends 16 spaces indention from second line of a fragment on. First line will be indented by Mustache.")),Object(r.b)("p",null,"Lambda is invoked by ",Object(r.b)("inlineCode",{parentName:"p"},"lambda.[lambda name]")," expression. For example: ",Object(r.b)("inlineCode",{parentName:"p"},"{{#lambda.lowercase}}FRAGMENT TO LOWERCASE{{/lambda.lowercase}}")," to lower case text between ",Object(r.b)("inlineCode",{parentName:"p"},"lambda.lowercase"),"."),Object(r.b)("h2",{id:"extensions"},"Extensions"),Object(r.b)("p",null,'OpenAPI supports a concept called "Extensions". These are called "Specification Extensions" ',Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#specificationExtensions"}),"in 3.x"),' and "Vendor Extensions" ',Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#vendorExtensions"}),"in 2.0"),'.\nYou\'ll see them referred to as "Vendor Extensions" in most places in this project.'),Object(r.b)("p",null,"Vendor extensions allow you to provide vendor-specific configurations to your specification document."),Object(r.b)("p",null,"For example, suppose you use your specification document for code generation with a (hypothetical) C# OpenAPI generator supporting a desired operationId prefix where the extension is ",Object(r.b)("inlineCode",{parentName:"p"},"x-csharp-operationid"),", you can define this property alongside the object you'd like to extend (which would be a Path Object in this case). You could then apply additional extensions alongside this property, whether they're for another language or other tooling."),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Well-defined vendor extensions don't cause conflicts with other tooling.")),Object(r.b)("p",null,'The following are vendor extensions supported by OpenAPI Generator. The list may not be up-to-date, the best way is to look for "x-" in the built-in mustache templates.'),Object(r.b)("h3",{id:"all-generators-core"},"All generators (core)"),Object(r.b)("h4",{id:"enum"},"Enum"),Object(r.b)("p",null,Object(r.b)("inlineCode",{parentName:"p"},"x-enum-varnames")," can be used to have an other enum name for the corresponding value.\nThis is used to define names of the enum items."),Object(r.b)("p",null,Object(r.b)("inlineCode",{parentName:"p"},"x-enum-descriptions")," can be used to provide an individual description for each value.\nThis is used for comments in the code (like javadoc if the target language is java)."),Object(r.b)("p",null,Object(r.b)("inlineCode",{parentName:"p"},"x-enum-descriptions")," and ",Object(r.b)("inlineCode",{parentName:"p"},"x-enum-varnames")," are each expected to be list of items containing the same number of items as ",Object(r.b)("inlineCode",{parentName:"p"},"enum"),".\nThe order of the items in the list matters: their position is used to group them together."),Object(r.b)("p",null,"Example:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"WeatherType:\n  type: integer\n  format: int32\n  enum:\n    - 42\n    - 18\n    - 56\n  x-enum-descriptions:\n    - 'Blue sky'\n    - 'Slightly overcast'\n    - 'Take an umbrella with you'\n  x-enum-varnames:\n    - Sunny\n    - Cloudy\n    - Rainy\n")),Object(r.b)("p",null,"In the example for the integer value ",Object(r.b)("inlineCode",{parentName:"p"},"42"),", the description will be ",Object(r.b)("inlineCode",{parentName:"p"},"Blue sky")," and the name of the enum item will be ",Object(r.b)("inlineCode",{parentName:"p"},"Sunny")," (some generators changes it to ",Object(r.b)("inlineCode",{parentName:"p"},"SUNNY")," to respect some coding convention)."),Object(r.b)("h3",{id:"objc"},"ObjC"),Object(r.b)("h4",{id:"x-objc-operationid"},"x-objc-operationId"),Object(r.b)("p",null,"To customize the method name, you can provide a different name in x-objc-operationId, e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"summary: Add a new pet to the store\ndescription: ''\noperationId: addPet\nx-objc-operationId: CreateNewPet\n")),Object(r.b)("h3",{id:"java-feign"},"Java (Feign)"),Object(r.b)("h4",{id:"x-accepts"},"x-accepts"),Object(r.b)("p",null,"A single ",Object(r.b)("inlineCode",{parentName:"p"},"Accepts")," value as the Feign API client needs a single value for ",Object(r.b)("inlineCode",{parentName:"p"},"Accepts")," header, e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"consumes:\n  - application/json\n  - application/xml\nx-accepts: application/json\n")),Object(r.b)("h3",{id:"x-content-type"},"x-content-type"),Object(r.b)("p",null,'A single "Content-Type" value as the Feign API client needs a single value for ',Object(r.b)("inlineCode",{parentName:"p"},"Content-Type")," header, e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"produces:\n  - application/xml\n  - application/json\nx-content-type: application/json\n")),Object(r.b)("h3",{id:"rust-server"},"Rust-server"),Object(r.b)("h4",{id:"x-response-id"},"x-response-id"),Object(r.b)("p",null,"Each response may specify a unique ",Object(r.b)("inlineCode",{parentName:"p"},"x-response-id"),". ",Object(r.b)("inlineCode",{parentName:"p"},"rust-server")," will use this to name the corresponding enum variant in the code. e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"paths:\n  /ping:\n    get:\n      responses:\n        200:\n          description: OK\n          x-response-id: Pong\n")),Object(r.b)("h3",{id:"mysql-schema"},"MySQL Schema"),Object(r.b)("h4",{id:"x-mysqlschema"},"x-mysqlSchema"),Object(r.b)("p",null,"MySQL schema generator creates vendor extensions based on openapi ",Object(r.b)("inlineCode",{parentName:"p"},"dataType")," and ",Object(r.b)("inlineCode",{parentName:"p"},"dataFormat"),". When user defined extensions with same key already exists codegen accepts those as is. It means it won't validate properties or correct it for you. Every model in ",Object(r.b)("inlineCode",{parentName:"p"},"definitions")," can contain table related and column related extensions like in example below:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"definitions:\n  Order:\n    description: This should be most common InnoDB table\n    type: object\n    properties:\n      id:\n        description: >-\n          This column should be unsigned BIGINT with AUTO_INCREMENT\n        type: integer\n        format: int64\n        x-mysqlSchema:\n          columnDefinition:\n            colName: id\n            colDataType: DECIMAL\n            colDataTypeArguments:\n              - argumentValue: 16\n                isString: false\n              - argumentValue: 4\n                isString: false\n            colUnsigned: true\n            colNotNull: true\n            colDefault:\n              defaultValue: AUTO_INCREMENT\n              isString: false\n              isNumeric: false\n              isKeyword: true\n            colComment: >-\n              Column comment. This column should be unsigned BIGINT with AUTO_INCREMENT\n    x-mysqlSchema:\n      tableDefinition:\n        tblName: orders\n        tblStorageEngine: InnoDB\n        tblComment: >-\n          Table comment. This should be most common InnoDB table\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"There are properties that are not implemented by now(",Object(r.b)("inlineCode",{parentName:"p"},"tblStorageEngine"),"), but you can see how generator can be enhanced in future.")),Object(r.b)("h2",{id:"mustache-tips"},"Mustache Tips"),Object(r.b)("p",null,"Here are a few tips we've found useful for new template authors.\nFor more details on Mustache see ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://mustache.github.io/mustache.5.html"}),"mustache.5"),". See also ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/samskivert/jmustache"}),"samskivert/jmustache")," for implementation-specific details."),Object(r.b)("h3",{id:"firstlast"},"First/Last"),Object(r.b)("p",null,"To access the first or last element in a list using Mustache:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#vars}}{{#-first}} this is the first element {{.}} {{/-first}}{{/vars}}\n{{#vars}}{{#-last}} this is the last element {{.}} {{/-last}}{{/vars}}\n")),Object(r.b)("h3",{id:"this"},"This"),Object(r.b)("p",null,"Mustache evaluates template variables contextually. If the variable isn't found in the immediate object, mustache will search the parent. This is similar to JavaScript's prototype object (if you're familiar with the concept)."),Object(r.b)("p",null,"You can inspect this entire context by outputting ",Object(r.b)("inlineCode",{parentName:"p"},"{{this}}"),". For example:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#operations}}{{this}}{{/operations}}\n")),Object(r.b)("h3",{id:"index"},"Index"),Object(r.b)("p",null,"If you'd like a 1-based index in your array traversal, you can use ",Object(r.b)("inlineCode",{parentName:"p"},"{{-index}}"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#enums}}{{-index}} {{enum}}{{/enums}}\n")))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return u}));var a=n(0),i=n.n(a);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function s(e,t){if(null==e)return{};var n,a,i=function(e,t){if(null==e)return{};var n,a,i={},r=Object.keys(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var p=i.a.createContext({}),c=function(e){var t=i.a.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):l({},t,{},e)),n},b=function(e){var t=c(e.components);return i.a.createElement(p.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return i.a.createElement(i.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,o=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),b=c(n),d=a,u=b["".concat(o,".").concat(d)]||b[d]||m[d]||r;return n?i.a.createElement(u,l({ref:t},p,{components:n})):i.a.createElement(u,l({ref:t},p))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,o=new Array(r);o[0]=d;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l.mdxType="string"==typeof e?e:a,o[1]=l;for(var p=2;p<r;p++)o[p]=n[p];return i.a.createElement.apply(null,o)}return i.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/cf67c7b0.983797a8.js b/cf67c7b0.983797a8.js
deleted file mode 100644
index cfafcd6f072..00000000000
--- a/cf67c7b0.983797a8.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[145],{269:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return o})),n.d(t,"metadata",(function(){return l})),n.d(t,"rightToc",(function(){return s})),n.d(t,"default",(function(){return c}));var a=n(1),i=n(9),r=(n(0),n(312)),o={id:"templating",title:"Using Templates"},l={id:"templating",title:"Using Templates",description:"It's easy to work with templates for codegen!",source:"@site/../docs/templating.md",permalink:"/docs/templating",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/templating.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"File post-processing",permalink:"/docs/file-post-processing"},next:{title:"Customization",permalink:"/docs/customization"}},s=[{value:"Modifying Templates",id:"modifying-templates",children:[{value:"Retrieving Templates",id:"retrieving-templates",children:[]},{value:"Custom Logic",id:"custom-logic",children:[]},{value:"Custom Engines",id:"custom-engines",children:[]}]},{value:"Structures",id:"structures",children:[{value:"Operations",id:"operations",children:[]},{value:"Models",id:"models",children:[]},{value:"supportingFiles",id:"supportingfiles",children:[]}]},{value:"Variables",id:"variables",children:[]},{value:"Mustache Lambdas",id:"mustache-lambdas",children:[]},{value:"Extensions",id:"extensions",children:[{value:"All generators (core)",id:"all-generators-core",children:[]},{value:"ObjC",id:"objc",children:[]},{value:"Java (Feign)",id:"java-feign",children:[]},{value:"x-content-type",id:"x-content-type",children:[]},{value:"Rust-server",id:"rust-server",children:[]},{value:"MySQL Schema",id:"mysql-schema",children:[]}]},{value:"Mustache Tips",id:"mustache-tips",children:[{value:"First/Last",id:"firstlast",children:[]},{value:"This",id:"this",children:[]},{value:"Index",id:"index",children:[]}]}],p={rightToc:s};function c(e){var t=e.components,n=Object(i.a)(e,["components"]);return Object(r.b)("wrapper",Object(a.a)({},p,n,{components:t,mdxType:"MDXLayout"}),Object(r.b)("p",null,"It's easy to work with templates for codegen!"),Object(r.b)("p",null,"For maybe 90% of use cases, you will only need to modify the mustache template files to create your own custom generated code. If you need to include additional files in your generated output, manipulate the OpenAPI document inputs, or implement your own vendor extensions or other logic, you'll want to read ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," after you read this document. Be sure to start here first, because templating is the easier concept and you'll need it for more advanced use cases."),Object(r.b)("p",null,"The generator workflow has ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages"}),"transforming logic")," as well as templates for each generation of code."),Object(r.b)("p",null,"Each generator will create a data structure from the OpenAPI document; OpenAPI 2.0 and OpenAPI 3.x documents are normalized into the same API model within the generator. This model is then applied to the templates.  While generators do not need to perform transformations, it's often necessary in order to add more advanced support for your language or framework. You may need to refer to the generator implementation to understand some of the logic while creating or customizing templates (see ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/ScalaFinchServerCodegen.java"}),"ScalaFinchServerCodegen.java")," for an advanced example)."),Object(r.b)("p",null,"The transform logic needs to implement ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/CodegenConfig.java"}),"CodegenConfig.java")," and is most easily done by extending ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/blob/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/DefaultCodegen.java"}),"DefaultCodegen.java"),".  Take a look at the various implementations as a guideline while the instructions get more complete."),Object(r.b)("h2",{id:"modifying-templates"},"Modifying Templates"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"OpenAPI Generator applies user-defined templates via options:  "),Object(r.b)("ul",{parentName:"blockquote"},Object(r.b)("li",{parentName:"ul"},"CLI: ",Object(r.b)("inlineCode",{parentName:"li"},"-t/--template")," CLI options"),Object(r.b)("li",{parentName:"ul"},"Maven Plugin: ",Object(r.b)("inlineCode",{parentName:"li"},"templateDirectory")),Object(r.b)("li",{parentName:"ul"},"Gradle Plugin: ",Object(r.b)("inlineCode",{parentName:"li"},"templateDir")))),Object(r.b)("p",null,"Built-in templates are written in Mustache and processed by ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/samskivert/jmustache"}),"jmustache"),". Beginning with version 4.0.0, we support experimental Handlebars and user-defined template engines via plugins."),Object(r.b)("p",null,"OpenAPI Generator supports user-defined templates. This approach is often the easiest when creating a custom template. Our generators implement a combination of language and framework features, and it's fully possible to use an existing generator to implement a custom template for a different framework. Suppose you have internal utilities which you'd like to incorporate into generated code (e.g. logging, monitoring, fault-handling)... this is easy to add via custom templates."),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},Object(r.b)("strong",{parentName:"p"},"Note:")," You cannot use this approach to create new templates, only override existing ones. If you'd like to create a new generator to contribute back to the project, see ",Object(r.b)("inlineCode",{parentName:"p"},"new.sh")," in the repository root. If you'd like to create a private generator for more templating control, see the ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," docs.")),Object(r.b)("p",null,"OpenAPI Generator not only supports local files for templating, but also templates defined on the classpath. This is a great option if you want to reuse templates across multiple projects. To load a template via classpath, you'll need to generate a little differently. For example, if you've created an artifact called ",Object(r.b)("inlineCode",{parentName:"p"},"template-classpath-example")," which contains extended templates for the ",Object(r.b)("inlineCode",{parentName:"p"},"htmlDocs")," generator with the following structure:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),"\u2514\u2500\u2500 src\n    \u251c\u2500\u2500 main\n    \u2502\xa0\xa0 \u251c\u2500\u2500 java\n    \u2502\xa0\xa0 \u2514\u2500\u2500 resources\n    \u2502\xa0\xa0     \u2514\u2500\u2500 templates\n    \u2502\xa0\xa0         \u2514\u2500\u2500 htmlDocs\n    \u2502\xa0\xa0             \u251c\u2500\u2500 index.mustache\n    \u2502\xa0\xa0             \u2514\u2500\u2500 style.css.mustache\n")),Object(r.b)("p",null,"You can define your classpath to contain your JAR and the openapi-generator-cli ",Object(r.b)("em",{parentName:"p"},"fat jar"),", then invoke main class ",Object(r.b)("inlineCode",{parentName:"p"},"org.openapitools.codegen.OpenAPIGenerator"),". For instance,"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"java -cp /path/totemplate-classpath-example-1.0-SNAPSHOT.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \\\n    org.openapitools.codegen.OpenAPIGenerator generate \\\n    -i https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml \\\n    -g html -o template-example -t templates/htmlDocs\n")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"NOTE")," Running your custom generator in the example above requires adding it to the classpath. This differs on ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/windows/classpath.html"}),"Windows")," slightly from ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/unix/classpath.html"}),"unix"),"."),Object(r.b)("p",null,"Take note that our template directory is relative to the resource directory of the JAR defined on the classpath."),Object(r.b)("h3",{id:"retrieving-templates"},"Retrieving Templates"),Object(r.b)("p",null,"You will need to find and retrieve the templates for your desired generator in order to redefine structures, documentation, or API logic. We cover template customization in the following sections."),Object(r.b)("p",null,"In OpenAPI Generator 5.0 and later, you can use the CLI command ",Object(r.b)("inlineCode",{parentName:"p"},"author template")," to extract embedded templates for your target generator. For example:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),"openapi-generator author template -g java --library webclient\n")),Object(r.b)("p",null,"For OpenAPI Generator versions prior to 5.0, you will want to find the ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources"}),"resources directory")," for the generator you want to extend. This is generally easy to find as directories commonly follow the convention of ",Object(r.b)("inlineCode",{parentName:"p"},"resources/<generator name>"),". In cases where you're unsure, you will need to find the ",Object(r.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," assignment in your desired generator. This is almost always assigned in the constructor of the generator class. The C# .Net Core generator assigns this as:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),'embeddedTemplateDir = templateDir = "csharp-netcore";\n')),Object(r.b)("p",null,"These templates are in our source repository at ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources/csharp-netcore"}),"modules/openapi-generator/src/main/resources/csharp-netcore"),". Be sure to select the tag or branch for the version of OpenAPI Generator you're using before grabbing the templates."),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"NOTE")," If you have specific logic you'd like to modify such as modifying the generated README, you ",Object(r.b)("em",{parentName:"p"},"only")," need to pull and modify this individual template. OpenAPI Generator will lookup templates in this order:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"User customized library path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"custom_template/libraries/feign/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"User customized generator top-level path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"custom_template/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"Embedded library path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"resources/Java/libraries/feign/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"Embedded top-level path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"resources/Java/model.mustache"),")"),Object(r.b)("li",{parentName:"ul"},"Common embedded path (e.g. ",Object(r.b)("inlineCode",{parentName:"li"},"resources/_common/model.mustache"),")")),Object(r.b)("h3",{id:"custom-logic"},"Custom Logic"),Object(r.b)("p",null,"For this example, let's modify a Java client to use AOP via ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/jcabi/jcabi-aspects"}),"jcabi/jcabi-aspects"),". We'll log API method execution at the ",Object(r.b)("inlineCode",{parentName:"p"},"INFO")," level. The jcabi-aspects project could also be used to implement method retries on failures; this would be a great exercise to further play around with templating."),Object(r.b)("p",null,"The Java generator supports a ",Object(r.b)("inlineCode",{parentName:"p"},"library"),' option. This option works by defining base templates, then applying library-specific template overrides. This allows for template reuse for libraries sharing the same programming language. Templates defined as a library need only modify or extend the templates concerning the library, and generation falls back to the root templates (the "defaults") when not extended by the library. Generators which support the ',Object(r.b)("inlineCode",{parentName:"p"},"library")," option will only support the libraries known by the generator at compile time, and will throw a runtime error if you try to provide a custom library name."),Object(r.b)("p",null,"To get started, we will need to copy our target generator's directory in full."),Object(r.b)("p",null,"The directory will be located under ",Object(r.b)("inlineCode",{parentName:"p"},"modules/openapi-generator/src/main/resources/{generator}"),". In general, the generator directory matches the generator name (what you would pass to the ",Object(r.b)("inlineCode",{parentName:"p"},"generator")," option), but this is not a requirement-- if you are having a hard time finding the template directory, look at the ",Object(r.b)("inlineCode",{parentName:"p"},"embeddedTemplateDir")," option in your target generator's implementation."),Object(r.b)("p",null,"If you've already cloned openapi-generator, find and copy the ",Object(r.b)("inlineCode",{parentName:"p"},"modules/openapi-generator/src/main/resources/Java")," directory. If you have the ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/sindresorhus/refined-github"}),"Refined GitHub"),' Chrome or Firefox Extension, you can navigate to this directory on GitHub and click the "Download" button. Or, to pull the directory from latest master:'),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"mkdir -p ~/.openapi-generator/templates/ && cd $_\ncurl -L https://api.github.com/repos/OpenAPITools/openapi-generator/tarball | tar xz\nmv `ls`/modules/openapi-generator/src/main/resources/Java ./Java\n\\rm -rf OpenAPITools-openapi-generator-*\ncd Java\n")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"Optional"),": Before modifying your templates, you may want to ",Object(r.b)("inlineCode",{parentName:"p"},"git init && git add . && git commit -am 'initial'")," so you can easily revert to the base templates."),Object(r.b)("p",null,"At this point, you have ",Object(r.b)("em",{parentName:"p"},"every")," Java library's template locally. Let's delete all libraries except the ",Object(r.b)("inlineCode",{parentName:"p"},"resteasy")," library we'll be extending:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"ls -d libraries/* | grep -v resteasy | xargs rm -rf\n")),Object(r.b)("p",null,"Execute ",Object(r.b)("inlineCode",{parentName:"p"},"tree")," in this Java directory and inspect the mustache files and directory structure. You'll notice there are quite a few templates in the directory root, but extending this root to support resteasy only requires modifying a handful of files:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"tree libraries/resteasy/\nlibraries/resteasy/\n\u251c\u2500\u2500 ApiClient.mustache\n\u251c\u2500\u2500 JSON.mustache\n\u251c\u2500\u2500 api.mustache\n\u251c\u2500\u2500 build.gradle.mustache\n\u251c\u2500\u2500 build.sbt.mustache\n\u2514\u2500\u2500 pom.mustache\n\n0 directories, 6 files\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"NOTE: Some generators may be sensitive to ",Object(r.b)("em",{parentName:"p"},"which")," files exist. If you're concerned with redundant files like ",Object(r.b)("inlineCode",{parentName:"p"},"pom.mustache")," and ",Object(r.b)("inlineCode",{parentName:"p"},"build.sbt.mustache"),", you can try deleting them. If the generator you're customizing fails at runtime, just ",Object(r.b)("inlineCode",{parentName:"p"},"touch")," these files to create an empty file.")),Object(r.b)("p",null,"First, let's add our new dependency to ",Object(r.b)("inlineCode",{parentName:"p"},"libraries/resteasy/build.gradle.mustache"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),'diff --git a/libraries/resteasy/build.gradle.mustache b/libraries/resteasy/build.gradle.mustache\nindex 3b40702..a6d12e0 100644\n--- a/libraries/resteasy/build.gradle.mustache\n+++ b/libraries/resteasy/build.gradle.mustache\n@@ -134,6 +134,7 @@ ext {\n }\n\n dependencies {\n+    compile "com.jcabi:jcabi-aspects:0.22.6"\n     compile "io.swagger:swagger-annotations:$swagger_annotations_version"\n     compile "org.jboss.resteasy:resteasy-client:$resteasy_version"\n     compile "org.jboss.resteasy:resteasy-multipart-provider:$resteasy_version"\n\n')),Object(r.b)("p",null,"Then, we'll add the necessary import to ",Object(r.b)("inlineCode",{parentName:"p"},"api.mustache"),". This file is the template which becomes the API invoking class (e.g. ",Object(r.b)("inlineCode",{parentName:"p"},"PetApi")," or ",Object(r.b)("inlineCode",{parentName:"p"},"StoreApi"),")."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),"diff --git a/libraries/resteasy/api.mustache b/libraries/resteasy/api.mustache\nindex a4d0f9f..49b17c7 100644\n--- a/libraries/resteasy/api.mustache\n+++ b/libraries/resteasy/api.mustache\n@@ -1,5 +1,6 @@\n package {{package}};\n\n+import com.jcabi.aspects.Loggable;\n import {{invokerPackage}}.ApiException;\n import {{invokerPackage}}.ApiClient;\n import {{invokerPackage}}.Configuration;\n\n")),Object(r.b)("p",null,"Next, we'll find the code which generates API methods. You'll see ",Object(r.b)("inlineCode",{parentName:"p"},"{{#operations}}{{#operation}}"),' which is a mustache "loop" which executes the template logic if the model applied to the template has an ',Object(r.b)("inlineCode",{parentName:"p"},"operations")," array, and a non-null ",Object(r.b)("inlineCode",{parentName:"p"},"operation")," instance in that array. You can pass ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugOpenAPI=true")," when generating via CLI to inspect the full object model."),Object(r.b)("p",null,"Further down in ",Object(r.b)("inlineCode",{parentName:"p"},"api.mustache"),", find implementation of the method call, and add the ",Object(r.b)("inlineCode",{parentName:"p"},"@Loggable")," annotation. This template is easy because it has a single method implementation."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),"diff --git a/libraries/resteasy/api.mustache b/libraries/resteasy/api.mustache\nindex 49b17c7..16ee191 100644\n--- a/libraries/resteasy/api.mustache\n+++ b/libraries/resteasy/api.mustache\n@@ -57,6 +57,7 @@ public class {{classname}} {\n   {{#isDeprecated}}\n   @Deprecated\n   {{/isDeprecated}}\n+  @Loggable(Loggable.INFO)\n   public {{#returnType}}{{{returnType}}} {{/returnType}}{{^returnType}}void {{/returnType}}{{operationId}}({{#allParams}}{{{dataType}}} {{paramName}}{{^-last}}, {{/-last}}{{/allParams}}) throws ApiException {\n     Object {{localVariablePrefix}}localVarPostBody = {{#bodyParam}}{{paramName}}{{/bodyParam}}{{^bodyParam}}new Object(){{/bodyParam}};\n     {{#allParams}}{{#required}}\n\n")),Object(r.b)("p",null,"Finally, because our new dependency relies on AspectJ and code weaving, let's modify the ",Object(r.b)("inlineCode",{parentName:"p"},"build.gradle.mustache")," again to set this up."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),'diff --git a/build.gradle.mustache b/build.gradle.mustache\nindex 04a9d55..7a93c50 100644\n--- a/build.gradle.mustache\n+++ b/build.gradle.mustache\n@@ -1,5 +1,6 @@\n apply plugin: \'idea\'\n apply plugin: \'eclipse\'\n+apply plugin: \'aspectj\'\n\n group = \'{{groupId}}\'\n version = \'{{artifactVersion}}\'\n@@ -12,6 +13,7 @@ buildscript {\n     dependencies {\n         classpath \'com.android.tools.build:gradle:2.3.+\'\n         classpath \'com.github.dcendents:android-maven-gradle-plugin:1.5\'\n+        classpath "net.uberfoo.gradle:gradle-aspectj:2.2"\n     }\n }\n\n@@ -140,9 +142,18 @@ ext {\n     jersey_version = "1.19.4"\n     jodatime_version = "2.9.9"\n     junit_version = "4.13"\n+    aspectjVersion = \'1.9.0\'\n }\n\n+sourceCompatibility = \'1.8\'\n+targetCompatibility = \'1.8\'\n+\n dependencies {\n+    compile "com.jcabi:jcabi-aspects:0.22.6"\n+    aspectpath "com.jcabi:jcabi-aspects:0.22.6"\n+    // usually, client code leaves logging implementation to the consumer code\n+    compile "org.apache.logging.log4j:log4j-slf4j-impl:2.8.2"\n+    compile "org.apache.logging.log4j:log4j-core:2.8.2"\n     compile "io.swagger:swagger-annotations:$swagger_annotations_version"\n     compile "com.sun.jersey:jersey-client:$jersey_version"\n     compile "com.sun.jersey.contribs:jersey-multipart:$jersey_version"\n\n')),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"NOTE: This example includes log4j-slf4j-impl to demonstrate that our new code is working. Generally you'll want to leave logging implementations up to your consumers.")),Object(r.b)("p",null,"And because the java client generates with an outdated Gradle 2.6, let's update the gradle version in the default template (",Object(r.b)("inlineCode",{parentName:"p"},"Java/gradle-wrapper.properties.mustache"),"):"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),"diff --git a/gradle-wrapper.properties.mustache b/gradle-wrapper.properties.mustache\nindex b7a3647..3d9d088 100644\n--- a/gradle-wrapper.properties.mustache\n+++ b/gradle-wrapper.properties.mustache\n@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME\n distributionPath=wrapper/dists\n zipStoreBase=GRADLE_USER_HOME\n zipStorePath=wrapper/dists\n-distributionUrl=https\\://services.gradle.org/distributions/gradle-2.6-bin.zip\n+distributionUrl=https\\://services.gradle.org/distributions/gradle-4.8-bin.zip\n\n")),Object(r.b)("p",null,"Now we're ready to generate the client with our simple changes. When we pass the template directory option to our toolset, we ",Object(r.b)("em",{parentName:"p"},"must")," pass the generator's root directory and ",Object(r.b)("em",{parentName:"p"},"not")," the library-only directory."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g java --library resteasy \\\n    -t ~/.openapi-generator/templates/Java \\\n    -o ~/.openapi-generator/example \\\n    -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml\n")),Object(r.b)("p",null,"Make sure your custom template compiles:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"cd ~/.openapi-generator/example\ngradle assemble\n# or, regenerate the wrapper\ngradle wrapper --gradle-version 4.8 --distribution-type all\n./gradlew assemble\n")),Object(r.b)("p",null,"You should see a log message showing our added dependency being downloaded:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-text"}),"\u2026\nDownload https://jcenter.bintray.com/com/jcabi/jcabi-aspects/0.22.6/jcabi-aspects-0.22.6.pom\n\u2026\n")),Object(r.b)("p",null,"And for the sake of verifying our AOP modifications work, let's create a ",Object(r.b)("inlineCode",{parentName:"p"},"src/main/resources/log4j2.properties")," file in our new client code:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-properties"}),"status = error\ndest = err\nname = PropertiesConfig\n\nproperty.filename = target/rolling/rollingtest.log\n\nfilter.threshold.type = ThresholdFilter\nfilter.threshold.level = debug\n\nappender.console.type = Console\nappender.console.name = STDOUT\nappender.console.layout.type = PatternLayout\nappender.console.layout.pattern = %m%n\nappender.console.filter.threshold.type = ThresholdFilter\nappender.console.filter.threshold.level = error\n\nappender.rolling.type = RollingFile\nappender.rolling.name = RollingFile\nappender.rolling.fileName = ${filename}\nappender.rolling.filePattern = target/rolling2/test1-%d{MM-dd-yy-HH-mm-ss}-%i.log.gz\nappender.rolling.layout.type = PatternLayout\nappender.rolling.layout.pattern = %d %p %C{1.} [%t] %m%n\nappender.rolling.policies.type = Policies\nappender.rolling.policies.time.type = TimeBasedTriggeringPolicy\nappender.rolling.policies.time.interval = 2\nappender.rolling.policies.time.modulate = true\nappender.rolling.policies.size.type = SizeBasedTriggeringPolicy\nappender.rolling.policies.size.size=100MB\nappender.rolling.strategy.type = DefaultRolloverStrategy\nappender.rolling.strategy.max = 5\n\nlogger.rolling.name = org.openapitools.client.api.PetApi\nlogger.rolling.level = debug\nlogger.rolling.additivity = false\nlogger.rolling.appenderRef.rolling.ref = RollingFile\n\nrootLogger.level = info\nrootLogger.appenderRef.stdout.ref = STDOUT\n")),Object(r.b)("p",null,"Execute ",Object(r.b)("inlineCode",{parentName:"p"},"./gradlew build")," and then ",Object(r.b)("inlineCode",{parentName:"p"},"cat target/rolling/rollingtest.log"),". You should see messages logged for every call in PetApi with a stubbed unit test."),Object(r.b)("p",null,"Congratulations! You've now modified one of the built-in templates to meet your client code's needs."),Object(r.b)("p",null,"Adding/modifying template logic simply requires a little bit of ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://mustache.github.io/"}),"mustache"),", for which you can use existing templates as a guide."),Object(r.b)("h3",{id:"custom-engines"},"Custom Engines"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Custom template engine support is ",Object(r.b)("em",{parentName:"p"},"experimental"))),Object(r.b)("p",null,"If Mustache or the experimental Handlebars engines don't suit your needs, you can define an adapter to your templating engine of choice. To do this, you'll need to define a new project which consumes the ",Object(r.b)("inlineCode",{parentName:"p"},"openapi-generator-core")," artifact, and at a minimum implement ",Object(r.b)("inlineCode",{parentName:"p"},"TemplatingEngineAdapter"),"."),Object(r.b)("p",null,"This example:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},"creates an adapter providing the fundamental logic to compile ",Object(r.b)("a",Object(a.a)({parentName:"li"},{href:"https://pebbletemplates.io"}),"Pebble Templates")),Object(r.b)("li",{parentName:"ul"},"will be implemented in Kotlin to demonstrate ServiceLoader configuration specific to Kotlin (Java will be similar)"),Object(r.b)("li",{parentName:"ul"},"requires Gradle 5.0+"),Object(r.b)("li",{parentName:"ul"},"provides project setup instructions for IntelliJ")),Object(r.b)("p",null,"To begin, create a ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://www.jetbrains.com/help/idea/getting-started-with-gradle.html"}),"new Gradle project")," with Kotlin support. To do this, go to ",Object(r.b)("inlineCode",{parentName:"p"},"File")," \u279e ",Object(r.b)("inlineCode",{parentName:"p"},"New")," \u279e ",Object(r.b)("inlineCode",{parentName:"p"},"Project"),', choose "Gradle" and "Kotlin". Specify groupId ',Object(r.b)("inlineCode",{parentName:"p"},"org.openapitools.examples")," and artifactId ",Object(r.b)("inlineCode",{parentName:"p"},"pebble-template-adapter"),"."),Object(r.b)("p",null,"Ensure the new project uses Gradle 5.0. Navigate to the newly created directory and execute:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"gradle wrapper --gradle-version 5.0\n")),Object(r.b)("p",null,"In ",Object(r.b)("inlineCode",{parentName:"p"},"build.gradle"),", we'll add a dependency for OpenAPI Tools core which defines the interface and an abstract helper type for implementing the adapter. We'll also pull in the Pebble artifact. We'll be evaluating this new artifact locally, so we'll also add the Maven plugin for installing to the local maven repository. We'll also create a fatjar using the ",Object(r.b)("inlineCode",{parentName:"p"},"shadow")," plugin to simplify our classpath."),Object(r.b)("p",null,"Modifications to the new project's ",Object(r.b)("inlineCode",{parentName:"p"},"build.gradle")," should be made in the ",Object(r.b)("inlineCode",{parentName:"p"},"plugins")," and ",Object(r.b)("inlineCode",{parentName:"p"},"dependencies")," nodes:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-diff"}),' plugins {\n    id \'org.jetbrains.kotlin.jvm\' version \'1.3.11\'\n    id "com.github.johnrengelman.shadow" version "5.0.0"\n }\n\n dependencies {\n    compile "org.jetbrains.kotlin:kotlin-stdlib-jdk8"\n    compile "org.openapitools:openapi-generator-core:4.0.0-SNAPSHOT"\n    compile "io.pebbletemplates:pebble:3.0.8"\n }\n')),Object(r.b)("p",null,"The above configuration for the ",Object(r.b)("inlineCode",{parentName:"p"},"shadow")," plugin is strictly optional. It is not needed, for instance, if you plan to publish your adapter and consume it via the Maven or Gradle plugins."),Object(r.b)("p",null,"Next, create a new class file called ",Object(r.b)("inlineCode",{parentName:"p"},"PebbleTemplateEngineAdapter")," under ",Object(r.b)("inlineCode",{parentName:"p"},"src/kotlin"),". We'll define the template adapter's name as ",Object(r.b)("inlineCode",{parentName:"p"},"pebble")," and we'll also list this as the only supported file extension. We'll implement the adapter by extending ",Object(r.b)("inlineCode",{parentName:"p"},"AbstractTemplatingEngineAdapter"),", which includes reusable logic, such as retrieving a list of all possible template names for our provided template extensions(s)."),Object(r.b)("p",null,"The class in its simplest form looks like this (with inline comments):"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-kotlin"}),'// Allows specifying engine by class name\n// e.g. -e org.openapitools.examples.templating.PebbleTemplateAdapter\n@file:JvmName("PebbleTemplateAdapter")\npackage org.openapitools.examples.templating\n\n// imports\n\nclass PebbleTemplateAdapter : AbstractTemplatingEngineAdapter() {\n    // initialize the template compilation engine\n    private val engine: PebbleEngine = PebbleEngine.Builder()\n        .cacheActive(false)\n        .loader(DelegatingLoader(listOf(FileLoader(), ClasspathLoader())))\n        .build()\n\n    // allows targeting engine by id/name: -e pebble\n    override fun getIdentifier(): String = "pebble"\n\n    override fun compileTemplate(\n        generator: TemplatingGenerator?,\n        bundle: MutableMap<String, Any>?,\n        templateFile: String?\n    ): String {\n        // This will convert, for example, model.mustache to model.pebble\n        val modifiedTemplate = this.getModifiedFileLocation(templateFile).first()\n\n        // Uses generator built-in template resolution strategy to find the full template file\n        val filePath = generator?.getFullTemplatePath(modifiedTemplate)\n\n        val writer = StringWriter()\n        // Conditionally writes out the template if found.\n        if (filePath != null) {\n            engine.getTemplate(filePath.toAbsolutePath().toString())?.evaluate(writer, bundle)\n        }\n        return writer.toString()\n    }\n\n    override fun getFileExtensions(): Array<String> = arrayOf("pebble")\n}\n')),Object(r.b)("p",null,"Lastly, create a file ",Object(r.b)("inlineCode",{parentName:"p"},"resources/META-INF/services/org.openapitools.codegen.api.TemplatingEngineAdapter"),", containing the full class path to the above class:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),"org.openapitools.examples.templating.PebbleTemplateAdapter\n")),Object(r.b)("p",null,"This allows the adapter to load via ServiceLoader, and to be referenced via the identifier ",Object(r.b)("inlineCode",{parentName:"p"},"pebble"),". This is optional; if you don't provide the above file and contents, you'll only be able to load the engine via full class name (explained in a bit)."),Object(r.b)("p",null,"Now, build the fatjar for this new adapter:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"./gradlew shadowJar\n")),Object(r.b)("p",null,"To test compilation of some templates, we'll need to first create one or more template files. Create a temp directory at ",Object(r.b)("inlineCode",{parentName:"p"},"/tmp/pebble-example/templates")," and add the following files."),Object(r.b)("p",null,Object(r.b)("em",{parentName:"p"},"api.pebble")),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),'package {{packageName}}\n\nimport (\n    "net/http"\n{% for item in imports %}\n    "{{item.import}}"\n{% endfor %}\n)\n\ntype Generated{{classname}}Servicer\n\n// etc\n')),Object(r.b)("p",null,Object(r.b)("em",{parentName:"p"},"model.pebble")),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{}),'package {{packageName}}\n\n{% for item in models %}\n{% if item.isEnum %}\n// TODO: enum\n{% else %}\n{% if item.description is not empty %}// {{item.description}}{% endif %}\ntype {{item.classname}} struct {\n{% for var in item.model.vars %}\n    {% if var.description is not empty %}// {{var.description}}{% endif %}\n    {{var.name}} {% if var.isNullable %}*{% endif %}{{var.dataType}} `json:"{{var.baseName}}{% if var.required == false %},omitempty{% endif %}"{% if var.withXml == true %} xml:"{{var.baseName}}{% if var.isXmlAttribute %},attr{% endif %}"{% endif %}`\n{% endfor %}\n}\n{% endif %}\n{{model.name}}\n{% endfor %}\n')),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Find object structures passed to templates later in this document's ",Object(r.b)("strong",{parentName:"p"},"Structures")," section.")),Object(r.b)("p",null,"Finally, we can compile some code by explicitly defining our classpath and jar entrypoint for CLI (be sure to modify ",Object(r.b)("inlineCode",{parentName:"p"},"/your/path")," below)"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"java $JAVA_OPTS -cp /your/path/build/libs/pebble-template-adapter-1.0-SNAPSHOT-all.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \\\n    org.openapitools.codegen.OpenAPIGenerator \\\n    generate \\\n    -g go \\\n    -i https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v2.0/json/petstore-minimal.json \\\n    -e pebble \\\n    -o /tmp/pebble-example/out \\\n    -t /tmp/pebble-example/templates \\\n    --global-property models,modelDocs,modelTests,apis,apiTests,apiDocs\n")),Object(r.b)("p",null,Object(r.b)("strong",{parentName:"p"},"NOTE")," Running your custom generator requires adding it to the classpath. This differs on ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/windows/classpath.html"}),"Windows")," slightly from ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.oracle.com/javase/8/docs/technotes/tools/unix/classpath.html"}),"unix"),"."),Object(r.b)("p",null,"In the above example, we've targeted our custom template engine adapter via ",Object(r.b)("inlineCode",{parentName:"p"},"-e pebble"),". If you don't include the SPI file under ",Object(r.b)("inlineCode",{parentName:"p"},"META-INF/services"),", you'll need to specify the exact classpath: ",Object(r.b)("inlineCode",{parentName:"p"},"org.openapitools.examples.templating.PebbleTemplateAdapter"),". Notice that the target class here matches the Kotlin class name. This is because of the ",Object(r.b)("inlineCode",{parentName:"p"},"@file:JvmName")," annotation."),Object(r.b)("p",null,"Congratulations on creating a custom templating engine adapter!"),Object(r.b)("h2",{id:"structures"},"Structures"),Object(r.b)("p",null,"Aside from transforming an API document, the implementing class gets to decide how to apply the data structure to templates. We can decide which data structure to apply to which template files. You have the following structures at your disposal."),Object(r.b)("p",null,"Examples for the following structures will be presented using the following spec document:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),'  swagger: "2.0"\n  info:\n    version: "1.0.0"\n    title: "Swagger Petstore"\n    description: "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification"\n    termsOfService: "http://swagger.io/terms/"\n    contact:\n      name: "Swagger API Team"\n    license:\n      name: "MIT"\n  host: "petstore.swagger.io"\n  basePath: "/api"\n  schemes:\n    - "http"\n  consumes:\n    - "application/json"\n  produces:\n    - "application/json"\n  paths:\n    /pets:\n      get:\n        description: "Returns all pets from the system that the user has access to"\n        produces:\n          - "application/json"\n        responses:\n          "200":\n            description: "A list of pets."\n            schema:\n              type: "array"\n              items:\n                $ref: "#/definitions/Pet"\n  definitions:\n    Pet:\n      type: "object"\n      required:\n        - "id"\n        - "name"\n      properties:\n        id:\n          type: "integer"\n          format: "int64"\n        name:\n          type: "string"\n        tag:\n          type: "string"\n\n')),Object(r.b)("h3",{id:"operations"},"Operations"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Inspect operation structures passed to templates with system property ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugOpenAPI=true")),Object(r.b)("p",{parentName:"blockquote"},"Example:"),Object(r.b)("pre",{parentName:"blockquote"},Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugOpenAPI=true\n"))),Object(r.b)("p",null,"There is a data structure which represents all the operations that are defined in the OpenAPI specification.  A single API file is created for each ",Object(r.b)("inlineCode",{parentName:"p"},"OperationGroup"),", which is essentially a grouping of different operations.  See the ",Object(r.b)("inlineCode",{parentName:"p"},"addOperationToGroup")," in ",Object(r.b)("inlineCode",{parentName:"p"},"DefaultCodegen.java")," for details on this operation."),Object(r.b)("p",null,"You can have many files created for each ",Object(r.b)("inlineCode",{parentName:"p"},"OperationGroup")," by processing multiple templates and assigning a different file naming pattern to them.  So for a single file per operation:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-java"}),'// process the `api.mustache` template and output a single file with suffix `.java`:\napiTemplateFiles.put("api.mustache", ".java");\n')),Object(r.b)("p",null,"For C-like languages which also require header files, you may create two files per operation."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-objectivec"}),'// create a header and implementation for each operation group:\napiTemplateFiles.put("api-header.mustache", ".h");\napiTemplateFiles.put("api-body.mustache", ".m");\n')),Object(r.b)("p",null,"Here, an Operation with tag ",Object(r.b)("inlineCode",{parentName:"p"},"Pet")," will generate two files: ",Object(r.b)("inlineCode",{parentName:"p"},"SWGPetApi.h")," and ",Object(r.b)("inlineCode",{parentName:"p"},"SWGPetApi.m"),". The ",Object(r.b)("inlineCode",{parentName:"p"},"SWG")," prefix and ",Object(r.b)("inlineCode",{parentName:"p"},"Api")," suffix are options specific to the Objective-C generator."),Object(r.b)("h3",{id:"models"},"Models"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Inspect models passed to templates with system property ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugModels=true")),Object(r.b)("p",{parentName:"blockquote"},"Execute:"),Object(r.b)("pre",{parentName:"blockquote"},Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugModels=true\n"))),Object(r.b)("p",null,"Each model identified inside the generator will be passed into the ",Object(r.b)("inlineCode",{parentName:"p"},"Models")," data structure and will generate a new model file (or files) for each model."),Object(r.b)("p",null,"A ",Object(r.b)("inlineCode",{parentName:"p"},"Pet")," model with three properties will provide a ",Object(r.b)("em",{parentName:"p"},"lot")," of information about the type and properties. The output from ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugModels=true")," is presented in truncated format here."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-json"}),'[ {\n  "importPath" : "openapi.Pet",\n  "model" : {\n    "name" : "Pet",\n    "classname" : "Pet",\n    "classVarName" : "Pet",\n    "modelJson" : "{\\n  \\"required\\" : [ \\"id\\", \\"name\\" ],\\n  \\"type\\" : \\"object\\",\\n  \\"properties\\" : {\\n    \\"id\\" : {\\n      \\"type\\" : \\"integer\\",\\n      \\"format\\" : \\"int64\\"\\n    },\\n    \\"name\\" : {\\n      \\"type\\" : \\"string\\"\\n    },\\n    \\"tag\\" : {\\n      \\"type\\" : \\"string\\"\\n    }\\n  }\\n}",\n    "dataType" : "map[string]interface{}",\n    "classFilename" : "model_pet",\n    "isAlias" : false,\n    "isString" : false,\n    "isInteger" : false,\n    "vars" : [ {\n      "baseName" : "id",\n      "getter" : "getId",\n      "setter" : "setId",\n      "dataType" : "int64",\n      "datatypeWithEnum" : "int64",\n      "dataFormat" : "int64",\n      "name" : "Id",\n      "defaultValueWithParam" : " = data.id;",\n      "baseType" : "int64",\n      "example" : "null",\n      "jsonSchema" : "{\\n  \\"type\\" : \\"integer\\",\\n  \\"format\\" : \\"int64\\"\\n}",\n      "exclusiveMinimum" : false,\n      "exclusiveMaximum" : false,\n      "required" : true,\n      "hasMoreNonReadOnly" : true,\n      "isPrimitiveType" : true,\n      "isModel" : false,\n      "isContainer" : false,\n      "isNotContainer" : true,\n      "isString" : false,\n      "isNumeric" : true,\n      "isInteger" : false,\n      "isLong" : true,\n      "isNumber" : false,\n      "isFloat" : false,\n      "isDouble" : false,\n      "isByteArray" : false,\n      "isBinary" : false,\n      "isFile" : false,\n      "isBoolean" : false,\n      "isDate" : false,\n      "isDateTime" : false,\n      "isUuid" : false,\n      "isEmail" : false,\n      "isFreeFormObject" : false,\n      "isArray" : false,\n      "isMap" : false,\n      "isEnum" : false,\n      "isReadOnly" : false,\n      "isWriteOnly" : false,\n      "isNullable" : false,\n      "vendorExtensions" : { },\n      "hasValidation" : false,\n      "isInherited" : false,\n      "nameInCamelCase" : "Id",\n      "nameInSnakeCase" : "ID",\n      "isXmlAttribute" : false,\n      "isXmlWrapped" : false,\n      "datatype" : "int64",\n      "iexclusiveMaximum" : false\n    }, {\n      "baseName" : "name",\n      "getter" : "getName",\n      "setter" : "setName",\n      "dataType" : "string",\n      "datatypeWithEnum" : "string",\n      "name" : "Name",\n      "defaultValueWithParam" : " = data.name;",\n      "baseType" : "string",\n      "example" : "null",\n      "jsonSchema" : "{\\n  \\"type\\" : \\"string\\"\\n}",\n      "exclusiveMinimum" : false,\n      "exclusiveMaximum" : false,\n      "required" : true,\n      "hasMoreNonReadOnly" : true,\n      "isPrimitiveType" : true,\n      "isModel" : false,\n      "isContainer" : false,\n      "isNotContainer" : true,\n      "isString" : true,\n      "isNumeric" : false,\n      "isInteger" : false,\n      "isLong" : false,\n      "isNumber" : false,\n      "isFloat" : false,\n      "isDouble" : false,\n      "isByteArray" : false,\n      "isBinary" : false,\n      "isFile" : false,\n      "isBoolean" : false,\n      "isDate" : false,\n      "isDateTime" : false,\n      "isUuid" : false,\n      "isEmail" : false,\n      "isFreeFormObject" : false,\n      "isArray" : false,\n      "isMap" : false,\n      "isEnum" : false,\n      "isReadOnly" : false,\n      "isWriteOnly" : false,\n      "isNullable" : false,\n      "vendorExtensions" : { },\n      "hasValidation" : false,\n      "isInherited" : false,\n      "nameInCamelCase" : "Name",\n      "nameInSnakeCase" : "NAME",\n      "isXmlAttribute" : false,\n      "isXmlWrapped" : false,\n      "datatype" : "string",\n      "iexclusiveMaximum" : false\n    }, {\n      "baseName" : "tag",\n      "getter" : "getTag",\n      "setter" : "setTag",\n      "dataType" : "string",\n      "datatypeWithEnum" : "string",\n      "name" : "Tag",\n      "defaultValueWithParam" : " = data.tag;",\n      "baseType" : "string",\n      "example" : "null",\n      "jsonSchema" : "{\\n  \\"type\\" : \\"string\\"\\n}",\n      "exclusiveMinimum" : false,\n      "exclusiveMaximum" : false,\n      "required" : false,\n      "hasMoreNonReadOnly" : false,\n      "isPrimitiveType" : true,\n      "isModel" : false,\n      "isContainer" : false,\n      "isNotContainer" : true,\n      "isString" : true,\n      "isNumeric" : false,\n      "isInteger" : false,\n      "isLong" : false,\n      "isNumber" : false,\n      "isFloat" : false,\n      "isDouble" : false,\n      "isByteArray" : false,\n      "isBinary" : false,\n      "isFile" : false,\n      "isBoolean" : false,\n      "isDate" : false,\n      "isDateTime" : false,\n      "isUuid" : false,\n      "isEmail" : false,\n      "isFreeFormObject" : false,\n      "isArray" : false,\n      "isMap" : false,\n      "isEnum" : false,\n      "isReadOnly" : false,\n      "isWriteOnly" : false,\n      "isNullable" : false,\n      "vendorExtensions" : { },\n      "hasValidation" : false,\n      "isInherited" : false,\n      "nameInCamelCase" : "Tag",\n      "nameInSnakeCase" : "TAG",\n      "isXmlAttribute" : false,\n      "isXmlWrapped" : false,\n      "datatype" : "string",\n      "iexclusiveMaximum" : false\n    } ],\n    "requiredVars" : [ /* id, name */ ],\n    "optionalVars" : [ /* tag */ ],\n    "readOnlyVars" : [ ],\n    "readWriteVars" : [ /* lists metadata for all three properties */ ],\n    "allVars" : [ /* lists all properties */],\n    "parentVars" : [ ],\n    "mandatory" : [ "id", "name" ],\n    "allMandatory" : [ "id", "name" ],\n    "imports" : [ ],\n    "hasVars" : true,\n    "emptyVars" : false,\n    "hasMoreModels" : false,\n    "hasEnums" : false,\n    "isEnum" : false,\n    "hasRequired" : true,\n    "hasOptional" : true,\n    "isArray" : false,\n    "hasChildren" : false,\n    "isMap" : false,\n    "hasOnlyReadOnly" : false,\n    "vendorExtensions" : { }\n  }\n} ]\n')),Object(r.b)("p",null,"Templates are passed redundant properties, depending on the semantics of the array. For example:"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"vars")," lists all defined model properties"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"requiredVars")," lists all model properties marked with ",Object(r.b)("inlineCode",{parentName:"li"},"required")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"optionalVars")," lists all model properties ",Object(r.b)("em",{parentName:"li"},"not")," marked with ",Object(r.b)("inlineCode",{parentName:"li"},"required")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"readWriteVars")," lists all model properties ",Object(r.b)("em",{parentName:"li"},"not")," marked with ",Object(r.b)("inlineCode",{parentName:"li"},"readonly")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"readOnlyVars")," lists all model properties marked with ",Object(r.b)("inlineCode",{parentName:"li"},"readonly")," in the spec document"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"allVars")," lists all model properties. This may include the same set as ",Object(r.b)("inlineCode",{parentName:"li"},"vars"),", but may also include generator-defined properties")),Object(r.b)("p",null,'We expose the same properties in multiple sets because this allows us to conditionally iterate over properties based on some condition ("is it required" or "is it readonly"). This is driven by the use of the logic-less Mustache templates. It is possible that models passed to the templating engine may be cleaned up as we support more template engines, but such an effort will go through a deprecation phase and would be communicated at runtime through log messages.'),Object(r.b)("h3",{id:"supportingfiles"},"supportingFiles"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Inspect supportingFiles passed to templates with system property ",Object(r.b)("inlineCode",{parentName:"p"},"--global-property debugSupportingFiles=true")),Object(r.b)("p",{parentName:"blockquote"},"Execute:"),Object(r.b)("pre",{parentName:"blockquote"},Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"openapi-generator generate -g go \\\n    -o out \\\n    -i petstore-minimal.yaml \\\n    --global-property debugSupportingFiles=true\n"))),Object(r.b)("p",null,'This is a "catch-all" which gives you the entire structure--operations, model, etc--so you can create "single-file" code from them.'),Object(r.b)("p",null,"Supporting files can either be processed through the templating engine or copied as-is. When creating your own templates, you're limited to the files and extensions expected by the generator implementation. For more control over the supporting files produced by a generator, see our ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," documentation."),Object(r.b)("h2",{id:"variables"},"Variables"),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"This is a very limited list of variable name explanations. Feel free to ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/pull/new/master"}),"open a pull request")," to add to this documentation!")),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("strong",{parentName:"li"},"complexType"),": stores the name of the model (e.g. Pet)"),Object(r.b)("li",{parentName:"ul"},Object(r.b)("strong",{parentName:"li"},"isContainer"),": true if the parameter or property is an array or a map."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("strong",{parentName:"li"},"isPrimitiveType"),": true if the parameter or property type is a primitive type (e.g. string, integer, etc) as defined in the spec.")),Object(r.b)("h2",{id:"mustache-lambdas"},"Mustache Lambdas"),Object(r.b)("p",null,"Many generators (",Object(r.b)("em",{parentName:"p"},"those extending DefaultCodegen"),") come with a small set of lambda functions available under the key ",Object(r.b)("inlineCode",{parentName:"p"},"lambda"),":"),Object(r.b)("ul",null,Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"lowercase")," - Converts all of the characters in this fragment to lower case using the rules of the ",Object(r.b)("inlineCode",{parentName:"li"},"ROOT")," locale."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"uppercase")," - Converts all of the characters in this fragment to upper case using the rules of the ",Object(r.b)("inlineCode",{parentName:"li"},"ROOT")," locale."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"titlecase")," - Converts text in a fragment to title case. For example ",Object(r.b)("inlineCode",{parentName:"li"},"once upon a time")," to ",Object(r.b)("inlineCode",{parentName:"li"},"Once Upon A Time"),"."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"camelcase")," - Converts text in a fragment to camelCase. For example ",Object(r.b)("inlineCode",{parentName:"li"},"Input-text")," to ",Object(r.b)("inlineCode",{parentName:"li"},"inputText"),"."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented")," - Prepends 4 spaces indention from second line of a fragment on. First line will be indented by Mustache."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented_8")," - Prepends 8 spaces indention from second line of a fragment on. First line will be indented by Mustache."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented_12")," - Prepends 12 spaces indention from second line of a fragment on. First line will be indented by Mustache."),Object(r.b)("li",{parentName:"ul"},Object(r.b)("inlineCode",{parentName:"li"},"indented_16")," -Prepends 16 spaces indention from second line of a fragment on. First line will be indented by Mustache.")),Object(r.b)("p",null,"Lambda is invoked by ",Object(r.b)("inlineCode",{parentName:"p"},"lambda.[lambda name]")," expression. For example: ",Object(r.b)("inlineCode",{parentName:"p"},"{{#lambda.lowercase}}FRAGMENT TO LOWERCASE{{/lambda.lowercase}}")," to lower case text between ",Object(r.b)("inlineCode",{parentName:"p"},"lambda.lowercase"),"."),Object(r.b)("h2",{id:"extensions"},"Extensions"),Object(r.b)("p",null,'OpenAPI supports a concept called "Extensions". These are called "Specification Extensions" ',Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#specificationExtensions"}),"in 3.x"),' and "Vendor Extensions" ',Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#vendorExtensions"}),"in 2.0"),'.\nYou\'ll see them referred to as "Vendor Extensions" in most places in this project.'),Object(r.b)("p",null,"Vendor extensions allow you to provide vendor-specific configurations to your specification document."),Object(r.b)("p",null,"For example, suppose you use your specification document for code generation with a (hypothetical) C# OpenAPI generator supporting a desired operationId prefix where the extension is ",Object(r.b)("inlineCode",{parentName:"p"},"x-csharp-operationid"),", you can define this property alongside the object you'd like to extend (which would be a Path Object in this case). You could then apply additional extensions alongside this property, whether they're for another language or other tooling."),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"Well-defined vendor extensions don't cause conflicts with other tooling.")),Object(r.b)("p",null,'The following are vendor extensions supported by OpenAPI Generator. The list may not be up-to-date, the best way is to look for "x-" in the built-in mustache templates.'),Object(r.b)("h3",{id:"all-generators-core"},"All generators (core)"),Object(r.b)("h4",{id:"enum"},"Enum"),Object(r.b)("p",null,Object(r.b)("inlineCode",{parentName:"p"},"x-enum-varnames")," can be used to have an other enum name for the corresponding value.\nThis is used to define names of the enum items."),Object(r.b)("p",null,Object(r.b)("inlineCode",{parentName:"p"},"x-enum-descriptions")," can be used to provide an individual description for each value.\nThis is used for comments in the code (like javadoc if the target language is java)."),Object(r.b)("p",null,Object(r.b)("inlineCode",{parentName:"p"},"x-enum-descriptions")," and ",Object(r.b)("inlineCode",{parentName:"p"},"x-enum-varnames")," are each expected to be list of items containing the same number of items as ",Object(r.b)("inlineCode",{parentName:"p"},"enum"),".\nThe order of the items in the list matters: their position is used to group them together."),Object(r.b)("p",null,"Example:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"WeatherType:\n  type: integer\n  format: int32\n  enum:\n    - 42\n    - 18\n    - 56\n  x-enum-descriptions:\n    - 'Blue sky'\n    - 'Slightly overcast'\n    - 'Take an umbrella with you'\n  x-enum-varnames:\n    - Sunny\n    - Cloudy\n    - Rainy\n")),Object(r.b)("p",null,"In the example for the integer value ",Object(r.b)("inlineCode",{parentName:"p"},"42"),", the description will be ",Object(r.b)("inlineCode",{parentName:"p"},"Blue sky")," and the name of the enum item will be ",Object(r.b)("inlineCode",{parentName:"p"},"Sunny")," (some generators changes it to ",Object(r.b)("inlineCode",{parentName:"p"},"SUNNY")," to respect some coding convention)."),Object(r.b)("h3",{id:"objc"},"ObjC"),Object(r.b)("h4",{id:"x-objc-operationid"},"x-objc-operationId"),Object(r.b)("p",null,"To customize the method name, you can provide a different name in x-objc-operationId, e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"summary: Add a new pet to the store\ndescription: ''\noperationId: addPet\nx-objc-operationId: CreateNewPet\n")),Object(r.b)("h3",{id:"java-feign"},"Java (Feign)"),Object(r.b)("h4",{id:"x-accepts"},"x-accepts"),Object(r.b)("p",null,"A single ",Object(r.b)("inlineCode",{parentName:"p"},"Accepts")," value as the Feign API client needs a single value for ",Object(r.b)("inlineCode",{parentName:"p"},"Accepts")," header, e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"consumes:\n  - application/json\n  - application/xml\nx-accepts: application/json\n")),Object(r.b)("h3",{id:"x-content-type"},"x-content-type"),Object(r.b)("p",null,'A single "Content-Type" value as the Feign API client needs a single value for ',Object(r.b)("inlineCode",{parentName:"p"},"Content-Type")," header, e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"produces:\n  - application/xml\n  - application/json\nx-content-type: application/json\n")),Object(r.b)("h3",{id:"rust-server"},"Rust-server"),Object(r.b)("h4",{id:"x-response-id"},"x-response-id"),Object(r.b)("p",null,"Each response may specify a unique ",Object(r.b)("inlineCode",{parentName:"p"},"x-response-id"),". ",Object(r.b)("inlineCode",{parentName:"p"},"rust-server")," will use this to name the corresponding enum variant in the code. e.g."),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"paths:\n  /ping:\n    get:\n      responses:\n        200:\n          description: OK\n          x-response-id: Pong\n")),Object(r.b)("h3",{id:"mysql-schema"},"MySQL Schema"),Object(r.b)("h4",{id:"x-mysqlschema"},"x-mysqlSchema"),Object(r.b)("p",null,"MySQL schema generator creates vendor extensions based on openapi ",Object(r.b)("inlineCode",{parentName:"p"},"dataType")," and ",Object(r.b)("inlineCode",{parentName:"p"},"dataFormat"),". When user defined extensions with same key already exists codegen accepts those as is. It means it won't validate properties or correct it for you. Every model in ",Object(r.b)("inlineCode",{parentName:"p"},"definitions")," can contain table related and column related extensions like in example below:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-yaml"}),"definitions:\n  Order:\n    description: This should be most common InnoDB table\n    type: object\n    properties:\n      id:\n        description: >-\n          This column should be unsigned BIGINT with AUTO_INCREMENT\n        type: integer\n        format: int64\n        x-mysqlSchema:\n          columnDefinition:\n            colName: id\n            colDataType: DECIMAL\n            colDataTypeArguments:\n              - argumentValue: 16\n                isString: false\n              - argumentValue: 4\n                isString: false\n            colUnsigned: true\n            colNotNull: true\n            colDefault:\n              defaultValue: AUTO_INCREMENT\n              isString: false\n              isNumeric: false\n              isKeyword: true\n            colComment: >-\n              Column comment. This column should be unsigned BIGINT with AUTO_INCREMENT\n    x-mysqlSchema:\n      tableDefinition:\n        tblName: orders\n        tblStorageEngine: InnoDB\n        tblComment: >-\n          Table comment. This should be most common InnoDB table\n")),Object(r.b)("blockquote",null,Object(r.b)("p",{parentName:"blockquote"},"There are properties that are not implemented by now(",Object(r.b)("inlineCode",{parentName:"p"},"tblStorageEngine"),"), but you can see how generator can be enhanced in future.")),Object(r.b)("h2",{id:"mustache-tips"},"Mustache Tips"),Object(r.b)("p",null,"Here are a few tips we've found useful for new template authors.\nFor more details on Mustache see ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://mustache.github.io/mustache.5.html"}),"mustache.5"),". See also ",Object(r.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/samskivert/jmustache"}),"samskivert/jmustache")," for implementation-specific details."),Object(r.b)("h3",{id:"firstlast"},"First/Last"),Object(r.b)("p",null,"To access the first or last element in a list using Mustache:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#vars}}{{#-first}} this is the first element {{.}} {{/-first}}{{/vars}}\n{{#vars}}{{#-last}} this is the last element {{.}} {{/-last}}{{/vars}}\n")),Object(r.b)("h3",{id:"this"},"This"),Object(r.b)("p",null,"Mustache evaluates template variables contextually. If the variable isn't found in the immediate object, mustache will search the parent. This is similar to JavaScript's prototype object (if you're familiar with the concept)."),Object(r.b)("p",null,"You can inspect this entire context by outputting ",Object(r.b)("inlineCode",{parentName:"p"},"{{this}}"),". For example:"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#operations}}{{this}}{{/operations}}\n")),Object(r.b)("h3",{id:"index"},"Index"),Object(r.b)("p",null,"If you'd like a 1-based index in your array traversal, you can use ",Object(r.b)("inlineCode",{parentName:"p"},"{{-index}}"),":"),Object(r.b)("pre",null,Object(r.b)("code",Object(a.a)({parentName:"pre"},{className:"language-mustache"}),"{{#enums}}{{-index}} {{enum}}{{/enums}}\n")))}c.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return b})),n.d(t,"b",(function(){return u}));var a=n(0),i=n.n(a);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function s(e,t){if(null==e)return{};var n,a,i=function(e,t){if(null==e)return{};var n,a,i={},r=Object.keys(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a<r.length;a++)n=r[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var p=i.a.createContext({}),c=function(e){var t=i.a.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):l({},t,{},e)),n},b=function(e){var t=c(e.components);return i.a.createElement(p.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return i.a.createElement(i.a.Fragment,{},t)}},d=Object(a.forwardRef)((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,o=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),b=c(n),d=a,u=b["".concat(o,".").concat(d)]||b[d]||m[d]||r;return n?i.a.createElement(u,l({ref:t},p,{components:n})):i.a.createElement(u,l({ref:t},p))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,o=new Array(r);o[0]=d;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l.mdxType="string"==typeof e?e:a,o[1]=l;for(var p=2;p<r;p++)o[p]=n[p];return i.a.createElement.apply(null,o)}return i.a.createElement.apply(null,n)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/d9b8b8b3.bc7f414b.js b/d9b8b8b3.bc7f414b.js
new file mode 100644
index 00000000000..d6d92511a18
--- /dev/null
+++ b/d9b8b8b3.bc7f414b.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[150],{274:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return p})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return b}));var r=n(1),a=n(9),o=(n(0),n(312)),i={id:"integrations",title:"Workflow Integrations"},p={id:"integrations",title:"Workflow Integrations",description:"## Workflow Integration (Gradle, Maven, GitHub, CI/CD)",source:"@site/../docs/integration.md",permalink:"/docs/integrations",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/integration.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Debugging",permalink:"/docs/debugging"},next:{title:"Guidelines For Contributing",permalink:"/docs/contributing"}},l=[{value:"Workflow Integration (Gradle, Maven, GitHub, CI/CD)",id:"workflow-integration-gradle-maven-github-cicd",children:[{value:"Gradle Integration",id:"gradle-integration",children:[]},{value:"Maven Integration",id:"maven-integration",children:[]},{value:"sbt Integration",id:"sbt-integration",children:[]},{value:"Bazel Integration",id:"bazel-integration",children:[]},{value:"Cake Addin",id:"cake-addin",children:[]},{value:"GitHub Integration",id:"github-integration",children:[]},{value:"CI/CD",id:"cicd",children:[]}]}],c={rightToc:l};function b(e){var t=e.components,n=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(r.a)({},c,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"workflow-integration-gradle-maven-github-cicd"},"Workflow Integration (Gradle, Maven, GitHub, CI/CD)"),Object(o.b)("h3",{id:"gradle-integration"},"Gradle Integration"),Object(o.b)("p",null,"See the ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc"}),"openapi-generator-gradle-plugin README")," for details related to configuring and using the Gradle Plugin."),Object(o.b)("p",null,"Supported tasks include:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Listing generators"),Object(o.b)("li",{parentName:"ul"},"Validation of Open API 2.0 and 3.0 Specs"),Object(o.b)("li",{parentName:"ul"},'Generating "Meta" generators'),Object(o.b)("li",{parentName:"ul"},"Generating all generators supported by OpenAPI Generator")),Object(o.b)("h3",{id:"maven-integration"},"Maven Integration"),Object(o.b)("p",null,"See the ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md"}),"openapi-generator-maven-plugin README")," for details related to configuring and using the Maven Plugin."),Object(o.b)("h3",{id:"sbt-integration"},"sbt Integration"),Object(o.b)("p",null,"Please refer to ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/sbt-openapi-generator"}),"https://github.com/OpenAPITools/sbt-openapi-generator")),Object(o.b)("h3",{id:"bazel-integration"},"Bazel Integration"),Object(o.b)("p",null,"Please refer to ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator-bazel"}),"https://github.com/OpenAPITools/openapi-generator-bazel")),Object(o.b)("h3",{id:"cake-addin"},"Cake Addin"),Object(o.b)("p",null,"3rd-party Cake Addin provided by ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/lukoerfer"}),"Lukas K\xf6rfer"),": ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/lukoerfer/cake-openapi-generator"}),"https://github.com/lukoerfer/cake-openapi-generator")),Object(o.b)("h3",{id:"github-integration"},"GitHub Integration"),Object(o.b)("p",null,"To push the auto-generated SDK to GitHub, we provide ",Object(o.b)("inlineCode",{parentName:"p"},"git_push.sh")," to streamline the process. For example:"),Object(o.b)("p",null," 1) Create a new repository in GitHub (Ref: ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://help.github.com/articles/creating-a-new-repository/"}),"https://help.github.com/articles/creating-a-new-repository/"),")"),Object(o.b)("p",null," 2) Generate the SDK"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-sh"}),' java -jar openapi-generator-cli.jar generate \\\n -i modules/openapi-generator/src/test/resources/3_0/petstore.json -g perl \\\n --git-user-id "wing328" \\\n --git-repo-id "petstore-perl" \\\n --release-note "GitHub integration demo" \\\n -o /var/tmp/perl/petstore\n')),Object(o.b)("p",null," 3) Push the SDK to GitHub"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-sh"}),"cd /var/tmp/perl/petstore\n/bin/sh ./git_push.sh\n")),Object(o.b)("h3",{id:"cicd"},"CI/CD"),Object(o.b)("p",null,"Some generators also generate CI/CD configuration files (.travis.yml) so that the output will be ready to be tested by the CI (e.g. Travis)"),Object(o.b)("p",null,"If you're looking for the configuration files of a particular CI that is not yet supported, please open an ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/issues/new"}),"issue")," to let us know."))}b.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return d}));var r=n(0),a=n.n(r);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function p(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var c=a.a.createContext({}),b=function(e){var t=a.a.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):p({},t,{},e)),n},u=function(e){var t=b(e.components);return a.a.createElement(c.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},g=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,i=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),u=b(n),g=r,d=u["".concat(i,".").concat(g)]||u[g]||s[g]||o;return n?a.a.createElement(d,p({ref:t},c,{components:n})):a.a.createElement(d,p({ref:t},c))}));function d(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,i=new Array(o);i[0]=g;var p={};for(var l in t)hasOwnProperty.call(t,l)&&(p[l]=t[l]);p.originalType=e,p.mdxType="string"==typeof e?e:r,i[1]=p;for(var c=2;c<o;c++)i[c]=n[c];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,n)}g.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/d9b8b8b3.e0b8f5ee.js b/d9b8b8b3.e0b8f5ee.js
deleted file mode 100644
index 0b1966e04e9..00000000000
--- a/d9b8b8b3.e0b8f5ee.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[150],{274:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return i})),n.d(t,"metadata",(function(){return p})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return b}));var r=n(1),a=n(9),o=(n(0),n(312)),i={id:"integrations",title:"Workflow Integrations"},p={id:"integrations",title:"Workflow Integrations",description:"## Workflow Integration (Gradle, Maven, GitHub, CI/CD)",source:"@site/../docs/integration.md",permalink:"/docs/integrations",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/integration.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Debugging",permalink:"/docs/debugging"},next:{title:"Guidelines For Contributing",permalink:"/docs/contributing"}},l=[{value:"Workflow Integration (Gradle, Maven, GitHub, CI/CD)",id:"workflow-integration-gradle-maven-github-cicd",children:[{value:"Gradle Integration",id:"gradle-integration",children:[]},{value:"Maven Integration",id:"maven-integration",children:[]},{value:"sbt Integration",id:"sbt-integration",children:[]},{value:"Bazel Integration",id:"bazel-integration",children:[]},{value:"Cake Addin",id:"cake-addin",children:[]},{value:"GitHub Integration",id:"github-integration",children:[]},{value:"CI/CD",id:"cicd",children:[]}]}],c={rightToc:l};function b(e){var t=e.components,n=Object(a.a)(e,["components"]);return Object(o.b)("wrapper",Object(r.a)({},c,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"workflow-integration-gradle-maven-github-cicd"},"Workflow Integration (Gradle, Maven, GitHub, CI/CD)"),Object(o.b)("h3",{id:"gradle-integration"},"Gradle Integration"),Object(o.b)("p",null,"See the ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc"}),"openapi-generator-gradle-plugin README")," for details related to configuring and using the Gradle Plugin."),Object(o.b)("p",null,"Supported tasks include:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Listing generators"),Object(o.b)("li",{parentName:"ul"},"Validation of Open API 2.0 and 3.0 Specs"),Object(o.b)("li",{parentName:"ul"},'Generating "Meta" generators'),Object(o.b)("li",{parentName:"ul"},"Generating all generators supported by OpenAPI Generator")),Object(o.b)("h3",{id:"maven-integration"},"Maven Integration"),Object(o.b)("p",null,"See the ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md"}),"openapi-generator-maven-plugin README")," for details related to configuring and using the Maven Plugin."),Object(o.b)("h3",{id:"sbt-integration"},"sbt Integration"),Object(o.b)("p",null,"Please refer to ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/sbt-openapi-generator"}),"https://github.com/OpenAPITools/sbt-openapi-generator")),Object(o.b)("h3",{id:"bazel-integration"},"Bazel Integration"),Object(o.b)("p",null,"Please refer to ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator-bazel"}),"https://github.com/OpenAPITools/openapi-generator-bazel")),Object(o.b)("h3",{id:"cake-addin"},"Cake Addin"),Object(o.b)("p",null,"3rd-party Cake Addin provided by ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/lukoerfer"}),"Lukas K\xf6rfer"),": ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/lukoerfer/cake-openapi-generator"}),"https://github.com/lukoerfer/cake-openapi-generator")),Object(o.b)("h3",{id:"github-integration"},"GitHub Integration"),Object(o.b)("p",null,"To push the auto-generated SDK to GitHub, we provide ",Object(o.b)("inlineCode",{parentName:"p"},"git_push.sh")," to streamline the process. For example:"),Object(o.b)("p",null," 1) Create a new repository in GitHub (Ref: ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://help.github.com/articles/creating-a-new-repository/"}),"https://help.github.com/articles/creating-a-new-repository/"),")"),Object(o.b)("p",null," 2) Generate the SDK"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-sh"}),' java -jar openapi-generator-cli.jar generate \\\n -i modules/openapi-generator/src/test/resources/3_0/petstore.json -g perl \\\n --git-user-id "wing328" \\\n --git-repo-id "petstore-perl" \\\n --release-note "GitHub integration demo" \\\n -o /var/tmp/perl/petstore\n')),Object(o.b)("p",null," 3) Push the SDK to GitHub"),Object(o.b)("pre",null,Object(o.b)("code",Object(r.a)({parentName:"pre"},{className:"language-sh"}),"cd /var/tmp/perl/petstore\n/bin/sh ./git_push.sh\n")),Object(o.b)("h3",{id:"cicd"},"CI/CD"),Object(o.b)("p",null,"Some generators also generate CI/CD configuration files (.travis.yml) so that the output will be ready to be tested by the CI (e.g. Travis)"),Object(o.b)("p",null,"If you're looking for the configuration files of a particular CI that is not yet supported, please open an ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/issues/new"}),"issue")," to let us know."))}b.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return d}));var r=n(0),a=n.n(r);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function p(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?i(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):i(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,a=function(e,t){if(null==e)return{};var n,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var c=a.a.createContext({}),b=function(e){var t=a.a.useContext(c),n=t;return e&&(n="function"==typeof e?e(t):p({},t,{},e)),n},u=function(e){var t=b(e.components);return a.a.createElement(c.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return a.a.createElement(a.a.Fragment,{},t)}},g=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,i=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),u=b(n),g=r,d=u["".concat(i,".").concat(g)]||u[g]||s[g]||o;return n?a.a.createElement(d,p({ref:t},c,{components:n})):a.a.createElement(d,p({ref:t},c))}));function d(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,i=new Array(o);i[0]=g;var p={};for(var l in t)hasOwnProperty.call(t,l)&&(p[l]=t[l]);p.originalType=e,p.mdxType="string"==typeof e?e:r,i[1]=p;for(var c=2;c<o;c++)i[c]=n[c];return a.a.createElement.apply(null,i)}return a.a.createElement.apply(null,n)}g.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/da5134d7.6d299e19.js b/da5134d7.6d299e19.js
deleted file mode 100644
index ebb645042ce..00000000000
--- a/da5134d7.6d299e19.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[151],{275:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Config Options for go-experimental",sidebar_label:"go-experimental"},c={id:"generators/go-experimental",title:"Config Options for go-experimental",description:"| Option | Description | Values | Default |",source:"@site/../docs/generators/go-experimental.md",permalink:"/docs/generators/go-experimental",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/go-experimental.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar_label:"go-experimental"},O=[{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document. If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents:  1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed.  2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumClassPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Prefix enum with class name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateInterfaces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate interfaces for api classes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"isGoSubmodule"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether the generated Go module is a submodule"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"packageName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Go package name (convention: lowercase)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"packageVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Go package version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"structPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to prefix struct with the class name. e.g. DeletePetOpts =",">"," PetApiDeletePetOpts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useOneOfDiscriminatorLookup"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use the discriminator's mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf's schemas) will be skipped."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"skipReadonlyPropertiesInInt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip default values to the readOnly properties in the model init function./ /false/"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withAWSV4Signature"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include AWS v4 signature support"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withGoCodegenComment"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include Go codegen comment to disable Go Lint and collapse by default in GitHub PRs and diffs"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"complex128"),Object(l.b)("li",null,"complex64"),Object(l.b)("li",null,"float32"),Object(l.b)("li",null,"float64"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"int32"),Object(l.b)("li",null,"int64"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"map[string]interface"),Object(l.b)("li",null,"rune"),Object(l.b)("li",null,"string"),Object(l.b)("li",null,"uint"),Object(l.b)("li",null,"uint32"),Object(l.b)("li",null,"uint64")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"chan"),Object(l.b)("li",null,"complex128"),Object(l.b)("li",null,"complex64"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"defer"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"error"),Object(l.b)("li",null,"fallthrough"),Object(l.b)("li",null,"float32"),Object(l.b)("li",null,"float64"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"func"),Object(l.b)("li",null,"go"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"int16"),Object(l.b)("li",null,"int32"),Object(l.b)("li",null,"int64"),Object(l.b)("li",null,"int8"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"map"),Object(l.b)("li",null,"nil"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"range"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"rune"),Object(l.b)("li",null,"select"),Object(l.b)("li",null,"string"),Object(l.b)("li",null,"struct"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"type"),Object(l.b)("li",null,"uint"),Object(l.b)("li",null,"uint16"),Object(l.b)("li",null,"uint32"),Object(l.b)("li",null,"uint64"),Object(l.b)("li",null,"uint8"),Object(l.b)("li",null,"uintptr"),Object(l.b)("li",null,"var")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return m}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},u=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),u=n,m=p["".concat(r,".").concat(u)]||p[u]||d[u]||l;return a?b.a.createElement(m,c({ref:e},j,{components:a})):b.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=u;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}u.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/da5134d7.e68f5ed7.js b/da5134d7.e68f5ed7.js
new file mode 100644
index 00000000000..3a04bfe0f28
--- /dev/null
+++ b/da5134d7.e68f5ed7.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[151],{275:function(t,e,a){"use strict";a.r(e),a.d(e,"frontMatter",(function(){return r})),a.d(e,"metadata",(function(){return c})),a.d(e,"rightToc",(function(){return O})),a.d(e,"default",(function(){return i}));var n=a(1),b=a(9),l=(a(0),a(312)),r={title:"Config Options for go-experimental",sidebar_label:"go-experimental"},c={id:"generators/go-experimental",title:"Config Options for go-experimental",description:"| Option | Description | Values | Default |",source:"@site/../docs/generators/go-experimental.md",permalink:"/docs/generators/go-experimental",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/go-experimental.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar_label:"go-experimental"},O=[{value:"IMPORT MAPPING",id:"import-mapping",children:[]},{value:"INSTANTIATION TYPES",id:"instantiation-types",children:[]},{value:"LANGUAGE PRIMITIVES",id:"language-primitives",children:[]},{value:"RESERVED WORDS",id:"reserved-words",children:[]},{value:"FEATURE SET",id:"feature-set",children:[{value:"Client Modification Feature",id:"client-modification-feature",children:[]},{value:"Data Type Feature",id:"data-type-feature",children:[]},{value:"Documentation Feature",id:"documentation-feature",children:[]},{value:"Global Feature",id:"global-feature",children:[]},{value:"Parameter Feature",id:"parameter-feature",children:[]},{value:"Schema Support Feature",id:"schema-support-feature",children:[]},{value:"Security Feature",id:"security-feature",children:[]},{value:"Wire Format Feature",id:"wire-format-feature",children:[]}]}],j={rightToc:O};function i(t){var e=t.components,a=Object(b.a)(t,["components"]);return Object(l.b)("wrapper",Object(n.a)({},j,a,{components:e,mdxType:"MDXLayout"}),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Option"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Description"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Values"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Default"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"disallowAdditionalPropertiesIfNotPresent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Specify the behavior when the 'additionalProperties' keyword is not present in the OAS document. If false: the 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications. If true: when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents:  1) When the 'additionalProperties' keyword is not present in a 2.0 schema, additional properties are NOT allowed.  2) Boolean values of the 'additionalProperties' keyword are ignored. It's as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),Object(l.b)("dl",null,Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"false")),Object(l.b)("dd",null,"The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications."),Object(l.b)("dt",null,Object(l.b)("strong",{parentName:"td"},"true")),Object(l.b)("dd",null,"when the 'additionalProperties' keyword is not present in a schema, the value of 'additionalProperties' is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior."))),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"enumClassPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Prefix enum with class name"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"generateInterfaces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Generate interfaces for api classes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"hideGenerationTimestamp"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Hides the generation timestamp when files are generated."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"true")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"isGoSubmodule"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether the generated Go module is a submodule"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"packageName"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Go package name (convention: lowercase)."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"openapi")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"packageVersion"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Go package version."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"1.0.0")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"prependFormOrBodyParameters"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Add form or body parameters to the beginning of the parameter list."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"structPrefix"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to prefix struct with the class name. e.g. DeletePetOpts =",">"," PetApiDeletePetOpts"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"useOneOfDiscriminatorLookup"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Use the discriminator's mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf's schemas) will be skipped."),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"skipReadonlyPropertiesInInt"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Skip default values to the readOnly properties in the model init function./ /false/"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}))),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withAWSV4Signature"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include AWS v4 signature support"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withGoCodegenComment"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include Go codegen comment to disable Go Lint and collapse by default in GitHub PRs and diffs"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"withXml"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null})),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"false")))),Object(l.b)("h2",{id:"import-mapping"},"IMPORT MAPPING"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Imports"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"instantiation-types"},"INSTANTIATION TYPES"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Type/Alias"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Instantiated By"))),Object(l.b)("tbody",{parentName:"table"})),Object(l.b)("h2",{id:"language-primitives"},"LANGUAGE PRIMITIVES"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"complex128"),Object(l.b)("li",null,"complex64"),Object(l.b)("li",null,"float32"),Object(l.b)("li",null,"float64"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"int32"),Object(l.b)("li",null,"int64"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"map[string]interface"),Object(l.b)("li",null,"rune"),Object(l.b)("li",null,"string"),Object(l.b)("li",null,"uint"),Object(l.b)("li",null,"uint32"),Object(l.b)("li",null,"uint64")),Object(l.b)("h2",{id:"reserved-words"},"RESERVED WORDS"),Object(l.b)("ul",{class:"column-ul"},Object(l.b)("li",null,"bool"),Object(l.b)("li",null,"break"),Object(l.b)("li",null,"byte"),Object(l.b)("li",null,"case"),Object(l.b)("li",null,"chan"),Object(l.b)("li",null,"complex128"),Object(l.b)("li",null,"complex64"),Object(l.b)("li",null,"const"),Object(l.b)("li",null,"continue"),Object(l.b)("li",null,"default"),Object(l.b)("li",null,"defer"),Object(l.b)("li",null,"else"),Object(l.b)("li",null,"error"),Object(l.b)("li",null,"fallthrough"),Object(l.b)("li",null,"float32"),Object(l.b)("li",null,"float64"),Object(l.b)("li",null,"for"),Object(l.b)("li",null,"func"),Object(l.b)("li",null,"go"),Object(l.b)("li",null,"goto"),Object(l.b)("li",null,"if"),Object(l.b)("li",null,"import"),Object(l.b)("li",null,"int"),Object(l.b)("li",null,"int16"),Object(l.b)("li",null,"int32"),Object(l.b)("li",null,"int64"),Object(l.b)("li",null,"int8"),Object(l.b)("li",null,"interface"),Object(l.b)("li",null,"map"),Object(l.b)("li",null,"nil"),Object(l.b)("li",null,"package"),Object(l.b)("li",null,"range"),Object(l.b)("li",null,"return"),Object(l.b)("li",null,"rune"),Object(l.b)("li",null,"select"),Object(l.b)("li",null,"string"),Object(l.b)("li",null,"struct"),Object(l.b)("li",null,"switch"),Object(l.b)("li",null,"type"),Object(l.b)("li",null,"uint"),Object(l.b)("li",null,"uint16"),Object(l.b)("li",null,"uint32"),Object(l.b)("li",null,"uint64"),Object(l.b)("li",null,"uint8"),Object(l.b)("li",null,"uintptr"),Object(l.b)("li",null,"var")),Object(l.b)("h2",{id:"feature-set"},"FEATURE SET"),Object(l.b)("h3",{id:"client-modification-feature"},"Client Modification Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Authorizations"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"UserAgent"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MockServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"data-type-feature"},"Data Type Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int32"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Int64"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Float"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Double"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Decimal"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"String"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Byte"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Binary"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Boolean"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Date"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"DateTime"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"File"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Array"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Maps"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormat"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"CollectionFormatMulti"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Enum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ArrayOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfPrimitives"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfModel"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MapOfCollectionOfEnum"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"documentation-feature"},"Documentation Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Readme"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Model"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Api"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")))),Object(l.b)("h3",{id:"global-feature"},"Global Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Host"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasePath"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Info"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Schemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PartialSchemes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Consumes"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Produces"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ExternalDocumentation"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Examples"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XMLStructureDefinitions"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"MultiServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterizedServer"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ParameterStyling"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Callbacks"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"LinkObjects"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"parameter-feature"},"Parameter Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Path"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Query"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Header"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Body"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormUnencoded"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"FormMultipart"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Cookie"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"schema-support-feature"},"Schema Support Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Simple"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Composite"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Polymorphism"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Union"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")))),Object(l.b)("h3",{id:"security-feature"},"Security Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BasicAuth"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ApiKey"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OpenIDConnect"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"BearerToken"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Implicit"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_Password"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_ClientCredentials"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAuth2_AuthorizationCode"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))),Object(l.b)("h3",{id:"wire-format-feature"},"Wire Format Feature"),Object(l.b)("table",null,Object(l.b)("thead",{parentName:"table"},Object(l.b)("tr",{parentName:"thead"},Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Name"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Supported"),Object(l.b)("th",Object(n.a)({parentName:"tr"},{align:null}),"Defined By"))),Object(l.b)("tbody",{parentName:"table"},Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"JSON"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"XML"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2713"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"PROTOBUF"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"ToolingExtension")),Object(l.b)("tr",{parentName:"tbody"},Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"Custom"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"\u2717"),Object(l.b)("td",Object(n.a)({parentName:"tr"},{align:null}),"OAS2,OAS3")))))}i.isMDXComponent=!0},312:function(t,e,a){"use strict";a.d(e,"a",(function(){return p})),a.d(e,"b",(function(){return m}));var n=a(0),b=a.n(n);function l(t,e,a){return e in t?Object.defineProperty(t,e,{value:a,enumerable:!0,configurable:!0,writable:!0}):t[e]=a,t}function r(t,e){var a=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e&&(n=n.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),a.push.apply(a,n)}return a}function c(t){for(var e=1;e<arguments.length;e++){var a=null!=arguments[e]?arguments[e]:{};e%2?r(Object(a),!0).forEach((function(e){l(t,e,a[e])})):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(e){Object.defineProperty(t,e,Object.getOwnPropertyDescriptor(a,e))}))}return t}function O(t,e){if(null==t)return{};var a,n,b=function(t,e){if(null==t)return{};var a,n,b={},l=Object.keys(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||(b[a]=t[a]);return b}(t,e);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(t);for(n=0;n<l.length;n++)a=l[n],e.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(t,a)&&(b[a]=t[a])}return b}var j=b.a.createContext({}),i=function(t){var e=b.a.useContext(j),a=e;return t&&(a="function"==typeof t?t(e):c({},e,{},t)),a},p=function(t){var e=i(t.components);return b.a.createElement(j.Provider,{value:e},t.children)},d={inlineCode:"code",wrapper:function(t){var e=t.children;return b.a.createElement(b.a.Fragment,{},e)}},u=Object(n.forwardRef)((function(t,e){var a=t.components,n=t.mdxType,l=t.originalType,r=t.parentName,j=O(t,["components","mdxType","originalType","parentName"]),p=i(a),u=n,m=p["".concat(r,".").concat(u)]||p[u]||d[u]||l;return a?b.a.createElement(m,c({ref:e},j,{components:a})):b.a.createElement(m,c({ref:e},j))}));function m(t,e){var a=arguments,n=e&&e.mdxType;if("string"==typeof t||n){var l=a.length,r=new Array(l);r[0]=u;var c={};for(var O in e)hasOwnProperty.call(e,O)&&(c[O]=e[O]);c.originalType=t,c.mdxType="string"==typeof t?t:n,r[1]=c;for(var j=2;j<l;j++)r[j]=a[j];return b.a.createElement.apply(null,r)}return b.a.createElement.apply(null,a)}u.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/df7ab5c6.8f17f2b9.js b/df7ab5c6.8f17f2b9.js
new file mode 100644
index 00000000000..024ea5390a3
--- /dev/null
+++ b/df7ab5c6.8f17f2b9.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[158],{282:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return a})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return p}));var r=n(1),o=n(9),i=(n(0),n(312)),a={id:"faq-extending",title:"FAQ: Extending"},c={id:"faq-extending",title:"FAQ: Extending",description:"## How do I use my own Java models?",source:"@site/../docs/faq-extending.md",permalink:"/docs/faq-extending",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-extending.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"faq-sidebar",previous:{title:"FAQ: General",permalink:"/docs/faq"},next:{title:"FAQ: Contributing",permalink:"/docs/faq-contributing"}},l=[{value:"How do I use my own Java models?",id:"how-do-i-use-my-own-java-models",children:[]},{value:"How do I disable certificate verification?",id:"how-do-i-disable-certificate-verification",children:[]},{value:"How do I skip files during code generation?",id:"how-do-i-skip-files-during-code-generation",children:[]},{value:"How can I customize the auto-generated code?",id:"how-can-i-customize-the-auto-generated-code",children:[]}],d={rightToc:l};function p(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(r.a)({},d,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h2",{id:"how-do-i-use-my-own-java-models"},"How do I use my own Java models?"),Object(i.b)("p",null,"See ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/customization#bringing-your-own-models"}),"Bringing your own Models"),"."),Object(i.b)("h2",{id:"how-do-i-disable-certificate-verification"},"How do I disable certificate verification?"),Object(i.b)("p",null,"Please add ",Object(i.b)("inlineCode",{parentName:"p"},"-Dio.swagger.v3.parser.util.RemoteUrl.trustAll=true")," when generating the code."),Object(i.b)("h2",{id:"how-do-i-skip-files-during-code-generation"},"How do I skip files during code generation?"),Object(i.b)("p",null,"OpenAPI Generator has a built-in ignore file processor."),Object(i.b)("p",null,"For example, to skip ",Object(i.b)("inlineCode",{parentName:"p"},"git_push.sh"),", one can create a file named ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," in the root of the output directory with the contents:"),Object(i.b)("pre",null,Object(i.b)("code",Object(r.a)({parentName:"pre"},{}),"# Prevent generator from creating these files:\ngit_push.sh\n")),Object(i.b)("p",null,"The ignore file works just like .gitignore, and it is auto-generated by default."),Object(i.b)("p",null,"If you need this functionality on initial generation, you can provide the option ",Object(i.b)("inlineCode",{parentName:"p"},"--ignore-file-override")," (CLI) or ",Object(i.b)("inlineCode",{parentName:"p"},"ignoreFileOverride")," (Maven and Gradle plugins) with a value targeting any existing file. The contents of that file will be evaluated relative to the output directory."),Object(i.b)("h2",{id:"how-can-i-customize-the-auto-generated-code"},"How can I customize the auto-generated code?"),Object(i.b)("p",null,"Variants:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},'"How can I add a header/footer to generated code?"'),Object(i.b)("li",{parentName:"ul"},'"How can I add my own logging to generated code?"'),Object(i.b)("li",{parentName:"ul"},'"How can I add my license to the top of files?"')),Object(i.b)("p",null,"OpenAPI Generator supports user-defined templates without need to recompile the artifact. We also support custom generators (templates and logic) if those generators are accessible on the classpath."),Object(i.b)("p",null,"See ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/templating#modifying-templates"}),"templating: Modifying Templates")," and ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," docs for more details."))}p.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return f}));var r=n(0),o=n.n(r);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n,r,o={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var d=o.a.createContext({}),p=function(e){var t=o.a.useContext(d),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},u=function(e){var t=p(e.components);return o.a.createElement(d.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},b=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,i=e.originalType,a=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),u=p(n),b=r,f=u["".concat(a,".").concat(b)]||u[b]||s[b]||i;return n?o.a.createElement(f,c({ref:t},d,{components:n})):o.a.createElement(f,c({ref:t},d))}));function f(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=n.length,a=new Array(i);a[0]=b;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:r,a[1]=c;for(var d=2;d<i;d++)a[d]=n[d];return o.a.createElement.apply(null,a)}return o.a.createElement.apply(null,n)}b.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/df7ab5c6.b6b994bf.js b/df7ab5c6.b6b994bf.js
deleted file mode 100644
index 02f8593fd48..00000000000
--- a/df7ab5c6.b6b994bf.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[158],{282:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return a})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return u}));var r=n(1),o=n(9),i=(n(0),n(312)),a={id:"faq-extending",title:"FAQ: Extending"},c={id:"faq-extending",title:"FAQ: Extending",description:"## How do I use my own Java models?",source:"@site/../docs/faq-extending.md",permalink:"/docs/faq-extending",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-extending.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"faq-sidebar",previous:{title:"FAQ: General",permalink:"/docs/faq"},next:{title:"FAQ: Contributing",permalink:"/docs/faq-contributing"}},l=[{value:"How do I use my own Java models?",id:"how-do-i-use-my-own-java-models",children:[]},{value:"How do I disable certificate verification?",id:"how-do-i-disable-certificate-verification",children:[]},{value:"How do I skip files during code generation?",id:"how-do-i-skip-files-during-code-generation",children:[]},{value:"How can I customize the auto-generated code?",id:"how-can-i-customize-the-auto-generated-code",children:[]}],d={rightToc:l};function u(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(r.a)({},d,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h2",{id:"how-do-i-use-my-own-java-models"},"How do I use my own Java models?"),Object(i.b)("p",null,"See ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/customization#bringing-your-own-models"}),"Bringing your own Models"),"."),Object(i.b)("h2",{id:"how-do-i-disable-certificate-verification"},"How do I disable certificate verification?"),Object(i.b)("p",null,"Please add ",Object(i.b)("inlineCode",{parentName:"p"},"-Dio.swagger.v3.parser.util.RemoteUrl.trustAll=true")," when generating the code."),Object(i.b)("h2",{id:"how-do-i-skip-files-during-code-generation"},"How do I skip files during code generation?"),Object(i.b)("p",null,"OpenAPI Generator has a built-in ignore file processor."),Object(i.b)("p",null,"For example, to skip ",Object(i.b)("inlineCode",{parentName:"p"},"git_push.sh"),", one can create a file named ",Object(i.b)("inlineCode",{parentName:"p"},".openapi-generator-ignore")," in the root of the output directory with the contents:"),Object(i.b)("pre",null,Object(i.b)("code",Object(r.a)({parentName:"pre"},{}),"# Prevent generator from creating these files:\ngit_push.sh\n")),Object(i.b)("p",null,"The ignore file works just like .gitignore, and it is auto-generated by default."),Object(i.b)("p",null,"If you need this functionality on initial generation, you can provide the option ",Object(i.b)("inlineCode",{parentName:"p"},"--ignore-file-override")," (CLI) or ",Object(i.b)("inlineCode",{parentName:"p"},"ignoreFileOverride")," (Maven and Gradle plugins) with a value targeting any existing file. The contents of that file will be evaluated relative to the output directory."),Object(i.b)("h2",{id:"how-can-i-customize-the-auto-generated-code"},"How can I customize the auto-generated code?"),Object(i.b)("p",null,"Variants:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},'"How can I add a header/footer to generated code?"'),Object(i.b)("li",{parentName:"ul"},'"How can I add my own logging to generated code?"'),Object(i.b)("li",{parentName:"ul"},'"How can I add my license to the top of files?"')),Object(i.b)("p",null,"OpenAPI Generator supports user-defined templates without need to recompile the artifact. We also support custom generators (templates and logic) if those generators are accessible on the classpath."),Object(i.b)("p",null,"See ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/templating#modifying-templates"}),"templating: Modifying Templates")," and ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"/docs/customization"}),"customization")," docs for more details."))}u.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return p})),n.d(t,"b",(function(){return f}));var r=n(0),o=n.n(r);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n,r,o={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var d=o.a.createContext({}),u=function(e){var t=o.a.useContext(d),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},p=function(e){var t=u(e.components);return o.a.createElement(d.Provider,{value:t},e.children)},s={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},b=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,i=e.originalType,a=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),p=u(n),b=r,f=p["".concat(a,".").concat(b)]||p[b]||s[b]||i;return n?o.a.createElement(f,c({ref:t},d,{components:n})):o.a.createElement(f,c({ref:t},d))}));function f(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=n.length,a=new Array(i);a[0]=b;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:r,a[1]=c;for(var d=2;d<i;d++)a[d]=n[d];return o.a.createElement.apply(null,a)}return o.a.createElement.apply(null,n)}b.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/docs/code-of-conduct/index.html b/docs/code-of-conduct/index.html
index c575339178a..765618740f7 100644
--- a/docs/code-of-conduct/index.html
+++ b/docs/code-of-conduct/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Code of Conduct</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="our-pledge"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#our-pledge" title="Direct link to heading">#</a>Our Pledge</h2><p>In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="our-standards"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#our-standards" title="Direct link to heading">#</a>Our Standards</h2><p>Examples of behavior that contributes to creating a positive environment include:</p><ul><li>Using welcoming and inclusive language</li><li>Being respectful of differing viewpoints and experiences</li><li>Gracefully accepting constructive criticism</li><li>Focusing on what is best for the community</li><li>Showing empathy towards other community members</li></ul><p>Examples of unacceptable behavior by participants include:</p><ul><li>The use of sexualized language or imagery and unwelcome sexual attention or advances</li><li>Trolling, insulting/derogatory comments, and personal or political attacks</li><li>Public or private harassment</li><li>Publishing others&#x27; private information, such as a physical or electronic address, without explicit permission</li><li>Other conduct which could reasonably be considered inappropriate in a professional setting</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="our-responsibilities"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#our-responsibilities" title="Direct link to heading">#</a>Our Responsibilities</h2><p>Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.</p><p>Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="scope"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#scope" title="Direct link to heading">#</a>Scope</h2><p>This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="enforcement"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#enforcement" title="Direct link to heading">#</a>Enforcement</h2><p>Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at team@openapitools.org. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.</p><p>Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project&#x27;s leadership.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="attribution"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#attribution" title="Direct link to heading">#</a>Attribution</h2><p>This Code of Conduct is adapted from the <a href="http://contributor-covenant.org">Contributor Covenant</a>, version 1.4, available at <a href="http://contributor-covenant.org/version/1/4/">http://contributor-covenant.org/version/1/4</a></p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/conduct.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/contributing"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Guidelines For Contributing</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/contribute-building"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Building the code »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#our-pledge" class="contents__link">Our Pledge</a></li><li><a href="#our-standards" class="contents__link">Our Standards</a></li><li><a href="#our-responsibilities" class="contents__link">Our Responsibilities</a></li><li><a href="#scope" class="contents__link">Scope</a></li><li><a href="#enforcement" class="contents__link">Enforcement</a></li><li><a href="#attribution" class="contents__link">Attribution</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Code of Conduct</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="our-pledge"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#our-pledge" title="Direct link to heading">#</a>Our Pledge</h2><p>In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="our-standards"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#our-standards" title="Direct link to heading">#</a>Our Standards</h2><p>Examples of behavior that contributes to creating a positive environment include:</p><ul><li>Using welcoming and inclusive language</li><li>Being respectful of differing viewpoints and experiences</li><li>Gracefully accepting constructive criticism</li><li>Focusing on what is best for the community</li><li>Showing empathy towards other community members</li></ul><p>Examples of unacceptable behavior by participants include:</p><ul><li>The use of sexualized language or imagery and unwelcome sexual attention or advances</li><li>Trolling, insulting/derogatory comments, and personal or political attacks</li><li>Public or private harassment</li><li>Publishing others&#x27; private information, such as a physical or electronic address, without explicit permission</li><li>Other conduct which could reasonably be considered inappropriate in a professional setting</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="our-responsibilities"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#our-responsibilities" title="Direct link to heading">#</a>Our Responsibilities</h2><p>Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.</p><p>Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="scope"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#scope" title="Direct link to heading">#</a>Scope</h2><p>This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="enforcement"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#enforcement" title="Direct link to heading">#</a>Enforcement</h2><p>Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at team@openapitools.org. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.</p><p>Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project&#x27;s leadership.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="attribution"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#attribution" title="Direct link to heading">#</a>Attribution</h2><p>This Code of Conduct is adapted from the <a href="http://contributor-covenant.org">Contributor Covenant</a>, version 1.4, available at <a href="http://contributor-covenant.org/version/1/4/">http://contributor-covenant.org/version/1/4</a></p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/conduct.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/contributing"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Guidelines For Contributing</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/contribute-building"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Building the code »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#our-pledge" class="contents__link">Our Pledge</a></li><li><a href="#our-standards" class="contents__link">Our Standards</a></li><li><a href="#our-responsibilities" class="contents__link">Our Responsibilities</a></li><li><a href="#scope" class="contents__link">Scope</a></li><li><a href="#enforcement" class="contents__link">Enforcement</a></li><li><a href="#attribution" class="contents__link">Attribution</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/f70cb32f.e3324f4c.js"></script>
+<script src="/f70cb32f.2f523636.js"></script>
 
 
 </body>
diff --git a/docs/configuration/index.html b/docs/configuration/index.html
index cbeb06f2980..136c3520b37 100644
--- a/docs/configuration/index.html
+++ b/docs/configuration/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Configuration Options</h1></header><div class="markdown"><p>Our tooling supports the following types of configuration:</p><ul><li><a href="/docs/globals">global properties</a><ul><li>properties with cross-cutting concerns which control generation, but  <em>don&#x27;t</em> belong to individual generators</li><li>Example: <code>debugSupportingFiles</code> prints the contents of template data bound to supporting files</li></ul></li><li>config options<ul><li>configuration specific to each individual <a href="/docs/generators/README">generator</a></li><li>these options are susceptible to validation within the defining generator; a config option of the same name across multiple generators may be validated differently in each</li><li>NOTE: The CLI accepts config options as &quot;additional properties&quot;</li></ul></li><li>additional properties<ul><li>these are the properties which will be passed to templates</li><li>generally used to pass user-defined properties to custom templates</li><li>many config options may also be passed as additional properties, however generators will read/modify/rewrite config options</li><li>users may pass custom additional properties and use these within templates (e.g. a custom <code>generatedBy</code> key with a value of <code>Jim Schubert</code> for inclusion in a custom CVS-like header)</li></ul></li><li>top-level properties specific to individual tools/plugins used to bootstrap our tooling</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="tool-specific-declarations"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#tool-specific-declarations" title="Direct link to heading">#</a>Tool-specific Declarations</h2><p>The READMEs for the <a href="https://openapi-generator.tech/docs/usage#generate">CLI</a>, <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin">Gradle Plugin</a>, <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin">Maven Plugin</a>, and <a href="https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md">SBT Plugin</a> may have top-level or tooling specific options which appear to duplicate &#x27;config options&#x27; or &#x27;global properties&#x27;. Each may also expose user-facing properties slightly differently from the other tools. This may occur due to:</p><ul><li>Conventions used by the underlying tooling</li><li>Limitations in underlying frameworks which define how properties must be declared</li><li>Continuation of support for &quot;legacy&quot; invocation patterns</li><li>Mistakes in documentation and/or contributions (please do <a href="https://github.com/OpenAPITools/openapi-generator/issues/new?assignees=&amp;labels=Issue%3A+Bug&amp;template=bug_report.md&amp;title=%5BBUG%5D+Issue+with+options">file a bug</a>)</li></ul><p>Take, for example, the CLI option of <code>--skip-validate-spec</code>. This flag sets the value to true with no option to set it to false (the default internally). The maven and gradle plugins allow for the top-level option <code>skipValidateSpec</code> to have a value of true or false. The SBT plugin, on the other hand, follows community convention and this property is <code>openApiSkipValidateSpec</code>.</p><p><em>How</em> you provide values to options also depends on the tool. OpenAPI Generator supports global properties for <a href="https://openapi-generator.tech/docs/customization/#selective-generation">selective generation</a> -- such as <code>apis</code> -- to have either a blank value or a comma-separated list of selected values. We would define this in CLI as <code>--global-property apis</code> or <code>--global-property apis=Equipment</code>. In the Gradle Plugin, these properties are set directly as strings:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openApiGenerate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    globalProperties </span><span class="token operator">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        apis: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;&quot;</span><span class="token plain">,</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        models: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;User:Pet&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>In the Maven plugin, we&#x27;re limited by XML syntax where <code>&lt;apis/&gt;</code> and <code>&lt;apis&gt;&lt;/apis&gt;</code> are treated the same as if the <code>apis</code> node was undefined; there&#x27;s no way to provide an empty string as a default. Instead, we have to extract the global property into its own properties which maintain the two states supported elsewhere (i.e. &quot;all apis&quot; or &quot;select apis&quot;). We have <code>generateApis</code> which accepts a boolean and <code>apisToGenerate</code> which accepts a comma-separated selection list.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="discovering-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#discovering-options" title="Direct link to heading">#</a>Discovering Options</h2><p>Refer to <a href="/docs/globals">global properties</a> for a list of available global properties and their usage.</p><p>Top-level tooling options are defined in <a href="https://openapi-generator.tech/docs/usage/#generate">CLI usage</a>. Many of these options directly map to camel case options in other tools, but do refer to <a href="https://openapi-generator.tech/docs/plugins">plugin documentation</a> for full details or plugin-specific differences.</p><p>Config options for generators are available in <a href="https://openapi-generator.tech/docs/generators">documentation online</a>. You may also use the CLI to query config options for a target generator using <code>openapi-generator config-help -g &lt;generator-name&gt;</code>. For example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">$ openapi-generator config-help -g mysql-schema</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">CONFIG OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    defaultDatabaseName</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Default database name </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> all MySQL queries </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: </span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    identifierNamingConvention</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Naming convention of MySQL identifiers</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">table names and </span><span class="token function" style="color:rgb(80, 250, 123)">column</span><span class="token plain"> names</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain">. This is not related to database name </span><span class="token function" style="color:rgb(80, 250, 123)">which</span><span class="token plain"> is defined by defaultDatabaseName option </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: original</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            original - Do not transform original names</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            snake_case - Use snake_case names</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    jsonDataTypeEnabled</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Use special JSON MySQL data </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">type</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> complex model properties. Requires MySQL version </span><span class="token number">5.7</span><span class="token plain">.8. Generates TEXT data </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">type</span><span class="token plain"> when disabled </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: </span><span class="token boolean">true</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    namedParametersEnabled</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Generates model prepared SQLs with named parameters, eg. :petName. Question mark placeholder used when option disabled. </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: </span><span class="token boolean">false</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This output provides the name of the configuration option. A set of acceptable values for any constrained values will print as an indented list (e.g. <code>identifierNamingConvention</code> above).</p><p>Suppose you want to apply snake case naming to mysql schema outputs. Your configuration might resemble the following examples.</p><p><strong>CLI</strong></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator -g mysql-schema -o out -i spec.yaml --additional-properties</span><span class="token operator">=</span><span class="token plain">identifierNamingConvention</span><span class="token operator">=</span><span class="token plain">snake_case</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>It may seem like a typo but there are two <code>=</code> signs in the above example.</p><p><strong>Maven Plugin</strong></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token operator">&lt;</span><span class="token plain">execution</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">id</span><span class="token operator">&gt;</span><span class="token plain">mysql-schema</span><span class="token operator">&lt;</span><span class="token plain">/id</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">phase</span><span class="token operator">&gt;</span><span class="token plain">generate-sources</span><span class="token operator">&lt;</span><span class="token plain">/phase</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">goals</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">goal</span><span class="token operator">&gt;</span><span class="token plain">generate</span><span class="token operator">&lt;</span><span class="token plain">/goal</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">/goals</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">configuration</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">inputSpec</span><span class="token operator">&gt;</span><span class="token plain">spec.yaml</span><span class="token operator">&lt;</span><span class="token plain">/inputSpec</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">generatorName</span><span class="token operator">&gt;</span><span class="token plain">mysql-schema</span><span class="token operator">&lt;</span><span class="token plain">/generatorName</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">configOptions</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token operator">&lt;</span><span class="token plain">identifierNamingConvention</span><span class="token operator">&gt;</span><span class="token plain">snake_case</span><span class="token operator">&lt;</span><span class="token plain">/identifierNamingConvention</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">/configOptions</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">output</span><span class="token operator">&gt;</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${project.build.directory}</span><span class="token plain">/generated-sources/mysql</span><span class="token operator">&lt;</span><span class="token plain">/output</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">/configuration</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token operator">&lt;</span><span class="token plain">/execution</span><span class="token operator">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p><strong>Gradle Plugin</strong></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openApiGenerate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    generatorName </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;mysql-schema&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    inputSpec </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">$rootDir</span><span class="token string" style="color:rgb(255, 121, 198)">/spec.yaml&quot;</span><span class="token plain">.toString</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    outputDir </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">$buildDir</span><span class="token string" style="color:rgb(255, 121, 198)">/mysql&quot;</span><span class="token plain">.toString</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    configOptions </span><span class="token operator">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            identifierNamingConvention: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;snake_case&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/configuration.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/globals"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Global Properties</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/file-post-processing"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">File post-processing »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#tool-specific-declarations" class="contents__link">Tool-specific Declarations</a></li><li><a href="#discovering-options" class="contents__link">Discovering Options</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Configuration Options</h1></header><div class="markdown"><p>Our tooling supports the following types of configuration:</p><ul><li><a href="/docs/globals">global properties</a><ul><li>properties with cross-cutting concerns which control generation, but  <em>don&#x27;t</em> belong to individual generators</li><li>Example: <code>debugSupportingFiles</code> prints the contents of template data bound to supporting files</li></ul></li><li>config options<ul><li>configuration specific to each individual <a href="/docs/generators/README">generator</a></li><li>these options are susceptible to validation within the defining generator; a config option of the same name across multiple generators may be validated differently in each</li><li>NOTE: The CLI accepts config options as &quot;additional properties&quot;</li></ul></li><li>additional properties<ul><li>these are the properties which will be passed to templates</li><li>generally used to pass user-defined properties to custom templates</li><li>many config options may also be passed as additional properties, however generators will read/modify/rewrite config options</li><li>users may pass custom additional properties and use these within templates (e.g. a custom <code>generatedBy</code> key with a value of <code>Jim Schubert</code> for inclusion in a custom CVS-like header)</li></ul></li><li>top-level properties specific to individual tools/plugins used to bootstrap our tooling</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="tool-specific-declarations"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#tool-specific-declarations" title="Direct link to heading">#</a>Tool-specific Declarations</h2><p>The READMEs for the <a href="https://openapi-generator.tech/docs/usage#generate">CLI</a>, <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin">Gradle Plugin</a>, <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin">Maven Plugin</a>, and <a href="https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md">SBT Plugin</a> may have top-level or tooling specific options which appear to duplicate &#x27;config options&#x27; or &#x27;global properties&#x27;. Each may also expose user-facing properties slightly differently from the other tools. This may occur due to:</p><ul><li>Conventions used by the underlying tooling</li><li>Limitations in underlying frameworks which define how properties must be declared</li><li>Continuation of support for &quot;legacy&quot; invocation patterns</li><li>Mistakes in documentation and/or contributions (please do <a href="https://github.com/OpenAPITools/openapi-generator/issues/new?assignees=&amp;labels=Issue%3A+Bug&amp;template=bug_report.md&amp;title=%5BBUG%5D+Issue+with+options">file a bug</a>)</li></ul><p>Take, for example, the CLI option of <code>--skip-validate-spec</code>. This flag sets the value to true with no option to set it to false (the default internally). The maven and gradle plugins allow for the top-level option <code>skipValidateSpec</code> to have a value of true or false. The SBT plugin, on the other hand, follows community convention and this property is <code>openApiSkipValidateSpec</code>.</p><p><em>How</em> you provide values to options also depends on the tool. OpenAPI Generator supports global properties for <a href="https://openapi-generator.tech/docs/customization/#selective-generation">selective generation</a> -- such as <code>apis</code> -- to have either a blank value or a comma-separated list of selected values. We would define this in CLI as <code>--global-property apis</code> or <code>--global-property apis=Equipment</code>. In the Gradle Plugin, these properties are set directly as strings:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openApiGenerate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    globalProperties </span><span class="token operator">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        apis: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;&quot;</span><span class="token plain">,</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        models: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;User:Pet&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>In the Maven plugin, we&#x27;re limited by XML syntax where <code>&lt;apis/&gt;</code> and <code>&lt;apis&gt;&lt;/apis&gt;</code> are treated the same as if the <code>apis</code> node was undefined; there&#x27;s no way to provide an empty string as a default. Instead, we have to extract the global property into its own properties which maintain the two states supported elsewhere (i.e. &quot;all apis&quot; or &quot;select apis&quot;). We have <code>generateApis</code> which accepts a boolean and <code>apisToGenerate</code> which accepts a comma-separated selection list.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="discovering-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#discovering-options" title="Direct link to heading">#</a>Discovering Options</h2><p>Refer to <a href="/docs/globals">global properties</a> for a list of available global properties and their usage.</p><p>Top-level tooling options are defined in <a href="https://openapi-generator.tech/docs/usage/#generate">CLI usage</a>. Many of these options directly map to camel case options in other tools, but do refer to <a href="https://openapi-generator.tech/docs/plugins">plugin documentation</a> for full details or plugin-specific differences.</p><p>Config options for generators are available in <a href="https://openapi-generator.tech/docs/generators">documentation online</a>. You may also use the CLI to query config options for a target generator using <code>openapi-generator config-help -g &lt;generator-name&gt;</code>. For example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">$ openapi-generator config-help -g mysql-schema</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">CONFIG OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    defaultDatabaseName</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Default database name </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> all MySQL queries </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: </span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    identifierNamingConvention</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Naming convention of MySQL identifiers</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">table names and </span><span class="token function" style="color:rgb(80, 250, 123)">column</span><span class="token plain"> names</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain">. This is not related to database name </span><span class="token function" style="color:rgb(80, 250, 123)">which</span><span class="token plain"> is defined by defaultDatabaseName option </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: original</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            original - Do not transform original names</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            snake_case - Use snake_case names</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    jsonDataTypeEnabled</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Use special JSON MySQL data </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">type</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> complex model properties. Requires MySQL version </span><span class="token number">5.7</span><span class="token plain">.8. Generates TEXT data </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">type</span><span class="token plain"> when disabled </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: </span><span class="token boolean">true</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    namedParametersEnabled</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Generates model prepared SQLs with named parameters, eg. :petName. Question mark placeholder used when option disabled. </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: </span><span class="token boolean">false</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This output provides the name of the configuration option. A set of acceptable values for any constrained values will print as an indented list (e.g. <code>identifierNamingConvention</code> above).</p><p>Suppose you want to apply snake case naming to mysql schema outputs. Your configuration might resemble the following examples.</p><p><strong>CLI</strong></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator -g mysql-schema -o out -i spec.yaml --additional-properties</span><span class="token operator">=</span><span class="token plain">identifierNamingConvention</span><span class="token operator">=</span><span class="token plain">snake_case</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>It may seem like a typo but there are two <code>=</code> signs in the above example.</p><p><strong>Maven Plugin</strong></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token operator">&lt;</span><span class="token plain">execution</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">id</span><span class="token operator">&gt;</span><span class="token plain">mysql-schema</span><span class="token operator">&lt;</span><span class="token plain">/id</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">phase</span><span class="token operator">&gt;</span><span class="token plain">generate-sources</span><span class="token operator">&lt;</span><span class="token plain">/phase</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">goals</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">goal</span><span class="token operator">&gt;</span><span class="token plain">generate</span><span class="token operator">&lt;</span><span class="token plain">/goal</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">/goals</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">configuration</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">inputSpec</span><span class="token operator">&gt;</span><span class="token plain">spec.yaml</span><span class="token operator">&lt;</span><span class="token plain">/inputSpec</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">generatorName</span><span class="token operator">&gt;</span><span class="token plain">mysql-schema</span><span class="token operator">&lt;</span><span class="token plain">/generatorName</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">configOptions</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token operator">&lt;</span><span class="token plain">identifierNamingConvention</span><span class="token operator">&gt;</span><span class="token plain">snake_case</span><span class="token operator">&lt;</span><span class="token plain">/identifierNamingConvention</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">/configOptions</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token operator">&lt;</span><span class="token plain">output</span><span class="token operator">&gt;</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${project.build.directory}</span><span class="token plain">/generated-sources/mysql</span><span class="token operator">&lt;</span><span class="token plain">/output</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token operator">&lt;</span><span class="token plain">/configuration</span><span class="token operator">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token operator">&lt;</span><span class="token plain">/execution</span><span class="token operator">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p><strong>Gradle Plugin</strong></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openApiGenerate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    generatorName </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;mysql-schema&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    inputSpec </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">$rootDir</span><span class="token string" style="color:rgb(255, 121, 198)">/spec.yaml&quot;</span><span class="token plain">.toString</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    outputDir </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">$buildDir</span><span class="token string" style="color:rgb(255, 121, 198)">/mysql&quot;</span><span class="token plain">.toString</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    configOptions </span><span class="token operator">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            identifierNamingConvention: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;snake_case&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/configuration.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/globals"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Global Properties</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/file-post-processing"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">File post-processing »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#tool-specific-declarations" class="contents__link">Tool-specific Declarations</a></li><li><a href="#discovering-options" class="contents__link">Discovering Options</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/2bbf879d.75ffa3a9.js"></script>
+<script src="/2bbf879d.eaee5317.js"></script>
 
 
 </body>
diff --git a/docs/contribute-building/index.html b/docs/contribute-building/index.html
index d76845eec73..21c25cfee08 100644
--- a/docs/contribute-building/index.html
+++ b/docs/contribute-building/index.html
@@ -28,12 +28,12 @@
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
 <nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Building the code</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="using-maven"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#using-maven" title="Direct link to heading">#</a>Using Maven</h2><p>To build from source, you need the following installed and available in your <code>$PATH:</code></p><ul><li><p><a href="https://java.oracle.com">Java 8</a></p></li><li><p><a href="https://maven.apache.org/">Apache maven 3.3.4 or greater</a></p></li></ul><p>After cloning the project, you can build it from source with this command:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean </span><span class="token function" style="color:rgb(80, 250, 123)">install</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>If you don&#x27;t have maven installed, you may directly use the included <a href="https://github.com/takari/maven-wrapper">maven wrapper</a>, and build with the command:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./mvnw clean </span><span class="token function" style="color:rgb(80, 250, 123)">install</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="using-docker"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#using-docker" title="Direct link to heading">#</a>Using Docker</h2><p>You can use <code>run-in-docker.sh</code> to do all development. This script maps your local repository to <code>/gen</code>
-in the docker container. It also maps <code>~/.m2/repository</code> to the appropriate container location.</p><p>To execute <code>mvn package</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh mvn package</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Build artifacts are now accessible in your working directory.</p><p>Once built, <code>run-in-docker.sh</code> will act as an executable for openapi-generator-cli. To generate code, you&#x27;ll need to output to a directory under <code>/gen</code> (e.g. <code>/gen/out</code>). For example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">help</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)"># Executes &#x27;help&#x27; command for openapi-generator-cli</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh list </span><span class="token comment" style="color:rgb(98, 114, 164)"># Executes &#x27;list&#x27; command for openapi-generator-cli</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh /gen/bin/generate-samples.sh /gen/bin/configs/go-petstore.yaml  </span><span class="token comment" style="color:rgb(98, 114, 164)"># Builds the Go client</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -g go -o /gen/out/go-petstore -p </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">packageName</span><span class="token operator">=</span><span class="token plain">petstore </span><span class="token comment" style="color:rgb(98, 114, 164)"># generates go client, outputs locally to ./out/go-petstore</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="docker-in-vagrant"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#docker-in-vagrant" title="Direct link to heading">#</a>Docker in Vagrant</h3><p>Prerequisite: install <a href="https://www.vagrantup.com/downloads.html">Vagrant</a> and <a href="https://www.virtualbox.org/wiki/Downloads">VirtualBox</a>.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">vagrant up</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">vagrant </span><span class="token function" style="color:rgb(80, 250, 123)">ssh</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> /vagrant</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh mvn package</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="troubleshooting"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#troubleshooting" title="Direct link to heading">#</a>Troubleshooting</h3><p>If an error like this occurs, just execute the <strong>mvn clean install -U</strong> command:</p><blockquote><p>org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test (default-test) on project openapi-generator: A type incompatibility occurred while executing org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test: java.lang.ExceptionInInitializerError cannot be cast to java.io.IOException</p></blockquote><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh mvn clean </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> -U</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>Failed to execute goal org.fortasoft:gradle-maven-plugin:1.0.8:invoke (default) on project openapi-generator-gradle-plugin-mvn-wrapper: org.gradle.tooling.BuildException: Could not execute build using Gradle distribution &#x27;<a href="https://services.gradle.org/distributions/gradle-4.7-bin.zip">https://services.gradle.org/distributions/gradle-4.7-bin.zip</a>&#x27;</p></blockquote><p>Right now: no solution for this one :|</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/building.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/code-of-conduct"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Code of Conduct</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/new-generator"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Create a New Generator »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#using-maven" class="contents__link">Using Maven</a></li><li><a href="#using-docker" class="contents__link">Using Docker</a><ul><li><a href="#docker-in-vagrant" class="contents__link">Docker in Vagrant</a></li><li><a href="#troubleshooting" class="contents__link">Troubleshooting</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+in the docker container. It also maps <code>~/.m2/repository</code> to the appropriate container location.</p><p>To execute <code>mvn package</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh mvn package</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Build artifacts are now accessible in your working directory.</p><p>Once built, <code>run-in-docker.sh</code> will act as an executable for openapi-generator-cli. To generate code, you&#x27;ll need to output to a directory under <code>/gen</code> (e.g. <code>/gen/out</code>). For example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">help</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)"># Executes &#x27;help&#x27; command for openapi-generator-cli</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh list </span><span class="token comment" style="color:rgb(98, 114, 164)"># Executes &#x27;list&#x27; command for openapi-generator-cli</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh /gen/bin/generate-samples.sh /gen/bin/configs/go-petstore.yaml  </span><span class="token comment" style="color:rgb(98, 114, 164)"># Builds the Go client</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -g go -o /gen/out/go-petstore -p </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">packageName</span><span class="token operator">=</span><span class="token plain">petstore </span><span class="token comment" style="color:rgb(98, 114, 164)"># generates go client, outputs locally to ./out/go-petstore</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="docker-in-vagrant"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#docker-in-vagrant" title="Direct link to heading">#</a>Docker in Vagrant</h3><p>Prerequisite: install <a href="https://www.vagrantup.com/downloads.html">Vagrant</a> and <a href="https://www.virtualbox.org/wiki/Downloads">VirtualBox</a>.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">vagrant up</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">vagrant </span><span class="token function" style="color:rgb(80, 250, 123)">ssh</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> /vagrant</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh mvn package</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="troubleshooting"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#troubleshooting" title="Direct link to heading">#</a>Troubleshooting</h3><p>If an error like this occurs, just execute the <strong>mvn clean install -U</strong> command:</p><blockquote><p>org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test (default-test) on project openapi-generator: A type incompatibility occurred while executing org.apache.maven.plugins:maven-surefire-plugin:2.19.1:test: java.lang.ExceptionInInitializerError cannot be cast to java.io.IOException</p></blockquote><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./run-in-docker.sh mvn clean </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> -U</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>Failed to execute goal org.fortasoft:gradle-maven-plugin:1.0.8:invoke (default) on project openapi-generator-gradle-plugin-mvn-wrapper: org.gradle.tooling.BuildException: Could not execute build using Gradle distribution &#x27;<a href="https://services.gradle.org/distributions/gradle-4.7-bin.zip">https://services.gradle.org/distributions/gradle-4.7-bin.zip</a>&#x27;</p></blockquote><p>Right now: no solution for this one :|</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/building.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/code-of-conduct"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Code of Conduct</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/new-generator"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Create a New Generator »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#using-maven" class="contents__link">Using Maven</a></li><li><a href="#using-docker" class="contents__link">Using Docker</a><ul><li><a href="#docker-in-vagrant" class="contents__link">Docker in Vagrant</a></li><li><a href="#troubleshooting" class="contents__link">Troubleshooting</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -49,7 +49,7 @@ in the docker container. It also maps <code>~/.m2/repository</code> to the appro
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/838bab07.e5a68e27.js"></script>
+<script src="/838bab07.4c814ca2.js"></script>
 
 
 </body>
diff --git a/docs/contributing/index.html b/docs/contributing/index.html
index 8a6c0efdd70..286c1853ff6 100644
--- a/docs/contributing/index.html
+++ b/docs/contributing/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Guidelines For Contributing</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="before-submitting-an-issue"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#before-submitting-an-issue" title="Direct link to heading">#</a>Before submitting an issue</h2><ul><li>If you&#x27;re not using the latest master to generate API clients or server stubs, please give it another try by pulling the latest master as the issue may have already been addressed. Ref: <a href="https://github.com/openapitools/openapi-generator#getting-started">Getting Started</a></li><li>Search the <a href="https://github.com/openapitools/openapi-generator/issues">open issue</a> and <a href="https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed">closed issue</a> to ensure no one else has reported something similar before.</li><li>File an <a href="https://github.com/openapitools/openapi-generator/issues/new">issue ticket</a> by providing all the required information. Failure to provide enough detail may result in slow response from the community.</li><li>Test with the latest master by building the JAR locally to see if the issue has already been addressed.</li><li>You can also make a suggestion or ask a question by opening an &quot;issue&quot;.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="before-submitting-a-pr"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#before-submitting-a-pr" title="Direct link to heading">#</a>Before submitting a PR</h2><ul><li>Search the <a href="https://github.com/openapitools/openapi-generator/issues">open issue</a> to ensure no one else has reported something similar and no one is actively working on similar proposed change.</li><li>If no one has suggested something similar, open an <a href="https://github.com/openapitools/openapi-generator/issues">&quot;issue&quot;</a> with your suggestion to gather feedback from the community.</li><li>If you&#x27;re adding a new option to a generator, please consider using the <code>-t</code> option with customized templates instead or start a discussion first by opening an issue as we want to avoid adding too many options to the generator.</li><li>It&#x27;s recommended to <strong>create a new git branch</strong> for the change so that the merge commit message looks nicer in the commit history.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-to-contribute"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-to-contribute" title="Direct link to heading">#</a>How to contribute</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="git"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#git" title="Direct link to heading">#</a>git</h3><p>If you&#x27;re new to git, you may find the following FAQs useful:</p><p><a href="https://github.com/openapitools/openapi-generator/wiki/FAQ#git">https://github.com/openapitools/openapi-generator/wiki/FAQ#git</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="branches"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#branches" title="Direct link to heading">#</a>Branches</h3><p>Please file the pull request against the correct branch, e.g. <code>master</code> for non-breaking changes. See the <a href="https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches">Git Branches</a> page for more information.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="code-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#code-generators" title="Direct link to heading">#</a>Code generators</h3><p>All the code generators can be found in <a href="https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages">modules/openapi-generator/src/main/java/org/openapitools/codegen/languages</a></p><p>If you want to add a new generator, follow the <a href="https://openapi-generator.tech/docs/new-generator">new-generator</a> guide. </p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#templates" title="Direct link to heading">#</a>Templates</h3><p>All the templates (<a href="https://mustache.github.io/">mustache</a>) can be found in <a href="https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources">modules/openapi-generator/src/main/resources</a>.</p><p>For a list of variables available in the template, please refer to this <a href="https://github.com/openapitools/openapi-generator/wiki/Mustache-Template-Variables">page</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="style-guide"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#style-guide" title="Direct link to heading">#</a>Style guide</h3><p>Code change should conform to the programming style guide of the respective languages:</p><ul><li>Ada: <a href="https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation">https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation</a></li><li>Android: <a href="https://source.android.com/source/code-style.html">https://source.android.com/source/code-style.html</a></li><li>Bash: <a href="https://github.com/bahamas10/bash-style-guide">https://github.com/bahamas10/bash-style-guide</a></li><li>C#: <a href="https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx">https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx</a></li><li>C++: <a href="https://google.github.io/styleguide/cppguide.html">https://google.github.io/styleguide/cppguide.html</a></li><li>C++ (Tizen): <a href="https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style">https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style</a></li><li>C++ (Unreal Engine 4): <a href="https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html">https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html</a></li><li>Clojure: <a href="https://github.com/bbatsov/clojure-style-guide">https://github.com/bbatsov/clojure-style-guide</a></li><li>Crystal: <a href="https://crystal-lang.org/reference/conventions/coding_style.html">https://crystal-lang.org/reference/conventions/coding_style.html</a></li><li>Dart: <a href="https://www.dartlang.org/guides/language/effective-dart/style">https://www.dartlang.org/guides/language/effective-dart/style</a></li><li>Elixir: <a href="https://github.com/christopheradams/elixir_style_guide">https://github.com/christopheradams/elixir_style_guide</a></li><li>Eiffel: <a href="https://www.eiffel.org/doc/eiffel/Coding%20Standards">https://www.eiffel.org/doc/eiffel/Coding%20Standards</a></li><li>Erlang: <a href="https://github.com/inaka/erlang_guidelines">https://github.com/inaka/erlang_guidelines</a></li><li>Haskell: <a href="https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md">https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md</a></li><li>Java: <a href="https://google.github.io/styleguide/javaguide.html">https://google.github.io/styleguide/javaguide.html</a></li><li>JavaScript: <a href="https://github.com/airbnb/javascript/">https://github.com/airbnb/javascript/</a></li><li>Kotlin: <a href="https://kotlinlang.org/docs/reference/coding-conventions.html">https://kotlinlang.org/docs/reference/coding-conventions.html</a></li><li>Groovy: <a href="http://groovy-lang.org/style-guide.html">http://groovy-lang.org/style-guide.html</a></li><li>Go: <a href="https://github.com/golang/go/wiki/CodeReviewComments">https://github.com/golang/go/wiki/CodeReviewComments</a></li><li>ObjC: <a href="https://github.com/NYTimes/objective-c-style-guide">https://github.com/NYTimes/objective-c-style-guide</a></li><li>Perl: <a href="http://perldoc.perl.org/perlstyle.html">http://perldoc.perl.org/perlstyle.html</a></li><li>PHP: <a href="https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md">https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md</a></li><li>PowerShell: <a href="https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx">https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx</a></li><li>Python: <a href="https://www.python.org/dev/peps/pep-0008/">https://www.python.org/dev/peps/pep-0008/</a></li><li>R: <a href="https://google.github.io/styleguide/Rguide.xml">https://google.github.io/styleguide/Rguide.xml</a></li><li>Ruby: <a href="https://github.com/bbatsov/ruby-style-guide">https://github.com/bbatsov/ruby-style-guide</a></li><li>Rust: <a href="https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md">https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md</a> (the default <a href="https://github.com/rust-lang-nursery/rustfmt">rustfmt</a> configuration)</li><li>Scala: <a href="http://docs.scala-lang.org/style/">http://docs.scala-lang.org/style/</a></li><li>Swift: <a href="https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/TheBasics.html">Apple Developer</a></li><li>TypeScript: <a href="https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines">https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines</a></li></ul><p>For other languages, feel free to suggest.</p><p>You may find the current code base not 100% conform to the coding style and we welcome contributions to fix those.</p><p>For <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#vendorExtensions">Vendor Extensions</a>, please follow the naming convention below:</p><ul><li>For general vendor extension, use lower case and hyphen. e.g. <code>x-is-unique</code>, <code>x-content-type</code></li><li>For language-specified vendor extension, put it in the form of <code>x-{lang}-{extension-name}</code>. e.g. <code>x-objc-operation-id</code>, <code>x-java-feign-retry-limit</code></li><li>For a list of existing vendor extensions in use, please refer to <a href="https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions">https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions</a>. If you&#x27;ve added new vendor extensions as part of your PR, please update the wiki page.</li></ul><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="testing"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#testing" title="Direct link to heading">#</a>Testing</h3><p>To add test cases (optional) covering the change in the code generator, please refer to <a href="https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/test/java/org/openapitools/codegen">modules/openapi-generator/src/test/java/org/openapitools/codegen</a></p><p>To test the templates, please perform the following:</p><ul><li>Update the Petstore sample by running the shell scripts under the <code>bin</code> folder. For example, run <code>./bin/generate-samples.sh ./bin/configs/python*</code> to update the Python-related samples under <a href="https://github.com/openapitools/openapi-generator/tree/master/samples"><code>samples</code></a>. For Windows, please install <a href="https://gitforwindows.org/">GIT bash</a>. (If you find that there are new files generated or unexpected changes as a result of the update, that&#x27;s not unusual as the test cases are added to the OpenAPI spec from time to time. If you&#x27;ve questions or concerns, please open a ticket to start a discussion)</li><li>During development, it can be helpful to quickly regenerate the samples without recompiling all of openapi-generator, e.g. when you have only updated the mustache templates. This can be done by passing the <code>-t</code> parameter: <code>-t modules/openapi-generator/src/main/resources/python</code>.</li><li>Run the tests in the sample folder using maven <code>mvn integration-test -f /path/to/pom.xml</code>, e.g. <code>mvn integration-test -f samples/client/petstore/python/pom.xml</code>. (some languages may not contain unit testing for Petstore and we&#x27;re looking for contribution from the community to implement those tests)</li><li>Finally, git commit the updated samples files: <code>git commit -a</code> (<code>git add -A</code> if added files with new test cases)</li><li>For new test cases, please add to the <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml">Fake Petstore spec</a></li></ul><p>To start the CI tests, you can:</p><ul><li>Run <code>mvn verify -Psamples</code>, assuming you have all the required tools installed to run tests for different languages.</li><li>Leverage <a href="http://travis-ci.org">http://travis-ci.org</a> to run the CI tests by adding your own openapi-generator repository.</li><li>Run some of the CI tests in your local workspace.</li></ul><p>See <a href="https://github.com/OpenAPITools/openapi-generator/wiki/Integration-Tests">OpenAPI Tools wiki</a> for more information about the integration tests.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="tips"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#tips" title="Direct link to heading">#</a>Tips</h3><ul><li>Smaller changes are easier to review</li><li>[Optional] For bug fixes, provide a OpenAPI Spec to repeat the issue so that the reviewer can use it to confirm the fix</li><li>Add test case(s) to cover the change</li><li>Document the fix in the code to make the code more readable</li><li>Make sure test cases passed after the change (one way is to leverage <a href="https://travis-ci.org/">https://travis-ci.org/</a> to run the CI tests)</li><li>File a PR with meaningful title, description and commit messages</li><li>Make sure the option &quot;Allow edits from maintainers&quot; in the PR is selected so that the maintainers can update your PRs with minor fixes, if needed.</li><li>Recommended git settings<ul><li><code>git config core.autocrlf input</code> to tell Git convert CRLF to LF on commit but not the other way around </li></ul></li><li>To close an issue (e.g. issue 1542) automatically after a PR is merged, use keywords &quot;fix&quot;, &quot;close&quot;, &quot;resolve&quot; in the PR description, e.g. <code>fix #1542</code>. (Ref: <a href="https://help.github.com/articles/closing-issues-using-keywords/">closing issues using keywords</a>)</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/contributing.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/integrations"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Workflow Integrations</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/code-of-conduct"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Code of Conduct »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#before-submitting-an-issue" class="contents__link">Before submitting an issue</a></li><li><a href="#before-submitting-a-pr" class="contents__link">Before submitting a PR</a></li><li><a href="#how-to-contribute" class="contents__link">How to contribute</a><ul><li><a href="#git" class="contents__link">git</a></li><li><a href="#branches" class="contents__link">Branches</a></li><li><a href="#code-generators" class="contents__link">Code generators</a></li><li><a href="#templates" class="contents__link">Templates</a></li><li><a href="#style-guide" class="contents__link">Style guide</a></li><li><a href="#testing" class="contents__link">Testing</a></li><li><a href="#tips" class="contents__link">Tips</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Guidelines For Contributing</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="before-submitting-an-issue"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#before-submitting-an-issue" title="Direct link to heading">#</a>Before submitting an issue</h2><ul><li>If you&#x27;re not using the latest master to generate API clients or server stubs, please give it another try by pulling the latest master as the issue may have already been addressed. Ref: <a href="https://github.com/openapitools/openapi-generator#getting-started">Getting Started</a></li><li>Search the <a href="https://github.com/openapitools/openapi-generator/issues">open issue</a> and <a href="https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed">closed issue</a> to ensure no one else has reported something similar before.</li><li>File an <a href="https://github.com/openapitools/openapi-generator/issues/new">issue ticket</a> by providing all the required information. Failure to provide enough detail may result in slow response from the community.</li><li>Test with the latest master by building the JAR locally to see if the issue has already been addressed.</li><li>You can also make a suggestion or ask a question by opening an &quot;issue&quot;.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="before-submitting-a-pr"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#before-submitting-a-pr" title="Direct link to heading">#</a>Before submitting a PR</h2><ul><li>Search the <a href="https://github.com/openapitools/openapi-generator/issues">open issue</a> to ensure no one else has reported something similar and no one is actively working on similar proposed change.</li><li>If no one has suggested something similar, open an <a href="https://github.com/openapitools/openapi-generator/issues">&quot;issue&quot;</a> with your suggestion to gather feedback from the community.</li><li>If you&#x27;re adding a new option to a generator, please consider using the <code>-t</code> option with customized templates instead or start a discussion first by opening an issue as we want to avoid adding too many options to the generator.</li><li>It&#x27;s recommended to <strong>create a new git branch</strong> for the change so that the merge commit message looks nicer in the commit history.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-to-contribute"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-to-contribute" title="Direct link to heading">#</a>How to contribute</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="git"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#git" title="Direct link to heading">#</a>git</h3><p>If you&#x27;re new to git, you may find the following FAQs useful:</p><p><a href="https://github.com/openapitools/openapi-generator/wiki/FAQ#git">https://github.com/openapitools/openapi-generator/wiki/FAQ#git</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="branches"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#branches" title="Direct link to heading">#</a>Branches</h3><p>Please file the pull request against the correct branch, e.g. <code>master</code> for non-breaking changes. See the <a href="https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches">Git Branches</a> page for more information.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="code-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#code-generators" title="Direct link to heading">#</a>Code generators</h3><p>All the code generators can be found in <a href="https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages">modules/openapi-generator/src/main/java/org/openapitools/codegen/languages</a></p><p>If you want to add a new generator, follow the <a href="https://openapi-generator.tech/docs/new-generator">new-generator</a> guide. </p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#templates" title="Direct link to heading">#</a>Templates</h3><p>All the templates (<a href="https://mustache.github.io/">mustache</a>) can be found in <a href="https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources">modules/openapi-generator/src/main/resources</a>.</p><p>For a list of variables available in the template, please refer to this <a href="https://github.com/openapitools/openapi-generator/wiki/Mustache-Template-Variables">page</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="style-guide"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#style-guide" title="Direct link to heading">#</a>Style guide</h3><p>Code change should conform to the programming style guide of the respective languages:</p><ul><li>Ada: <a href="https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation">https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation</a></li><li>Android: <a href="https://source.android.com/source/code-style.html">https://source.android.com/source/code-style.html</a></li><li>Bash: <a href="https://github.com/bahamas10/bash-style-guide">https://github.com/bahamas10/bash-style-guide</a></li><li>C#: <a href="https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx">https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx</a></li><li>C++: <a href="https://google.github.io/styleguide/cppguide.html">https://google.github.io/styleguide/cppguide.html</a></li><li>C++ (Tizen): <a href="https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style">https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style</a></li><li>C++ (Unreal Engine 4): <a href="https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html">https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html</a></li><li>Clojure: <a href="https://github.com/bbatsov/clojure-style-guide">https://github.com/bbatsov/clojure-style-guide</a></li><li>Crystal: <a href="https://crystal-lang.org/reference/conventions/coding_style.html">https://crystal-lang.org/reference/conventions/coding_style.html</a></li><li>Dart: <a href="https://www.dartlang.org/guides/language/effective-dart/style">https://www.dartlang.org/guides/language/effective-dart/style</a></li><li>Elixir: <a href="https://github.com/christopheradams/elixir_style_guide">https://github.com/christopheradams/elixir_style_guide</a></li><li>Eiffel: <a href="https://www.eiffel.org/doc/eiffel/Coding%20Standards">https://www.eiffel.org/doc/eiffel/Coding%20Standards</a></li><li>Erlang: <a href="https://github.com/inaka/erlang_guidelines">https://github.com/inaka/erlang_guidelines</a></li><li>Haskell: <a href="https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md">https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md</a></li><li>Java: <a href="https://google.github.io/styleguide/javaguide.html">https://google.github.io/styleguide/javaguide.html</a></li><li>JavaScript: <a href="https://github.com/airbnb/javascript/">https://github.com/airbnb/javascript/</a></li><li>Kotlin: <a href="https://kotlinlang.org/docs/reference/coding-conventions.html">https://kotlinlang.org/docs/reference/coding-conventions.html</a></li><li>Groovy: <a href="http://groovy-lang.org/style-guide.html">http://groovy-lang.org/style-guide.html</a></li><li>Go: <a href="https://github.com/golang/go/wiki/CodeReviewComments">https://github.com/golang/go/wiki/CodeReviewComments</a></li><li>ObjC: <a href="https://github.com/NYTimes/objective-c-style-guide">https://github.com/NYTimes/objective-c-style-guide</a></li><li>Perl: <a href="http://perldoc.perl.org/perlstyle.html">http://perldoc.perl.org/perlstyle.html</a></li><li>PHP: <a href="https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md">https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md</a></li><li>PowerShell: <a href="https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx">https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx</a></li><li>Python: <a href="https://www.python.org/dev/peps/pep-0008/">https://www.python.org/dev/peps/pep-0008/</a></li><li>R: <a href="https://google.github.io/styleguide/Rguide.xml">https://google.github.io/styleguide/Rguide.xml</a></li><li>Ruby: <a href="https://github.com/bbatsov/ruby-style-guide">https://github.com/bbatsov/ruby-style-guide</a></li><li>Rust: <a href="https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md">https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md</a> (the default <a href="https://github.com/rust-lang-nursery/rustfmt">rustfmt</a> configuration)</li><li>Scala: <a href="http://docs.scala-lang.org/style/">http://docs.scala-lang.org/style/</a></li><li>Swift: <a href="https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/TheBasics.html">Apple Developer</a></li><li>TypeScript: <a href="https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines">https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines</a></li></ul><p>For other languages, feel free to suggest.</p><p>You may find the current code base not 100% conform to the coding style and we welcome contributions to fix those.</p><p>For <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#vendorExtensions">Vendor Extensions</a>, please follow the naming convention below:</p><ul><li>For general vendor extension, use lower case and hyphen. e.g. <code>x-is-unique</code>, <code>x-content-type</code></li><li>For language-specified vendor extension, put it in the form of <code>x-{lang}-{extension-name}</code>. e.g. <code>x-objc-operation-id</code>, <code>x-java-feign-retry-limit</code></li><li>For a list of existing vendor extensions in use, please refer to <a href="https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions">https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions</a>. If you&#x27;ve added new vendor extensions as part of your PR, please update the wiki page.</li></ul><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="testing"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#testing" title="Direct link to heading">#</a>Testing</h3><p>To add test cases (optional) covering the change in the code generator, please refer to <a href="https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/test/java/org/openapitools/codegen">modules/openapi-generator/src/test/java/org/openapitools/codegen</a></p><p>To test the templates, please perform the following:</p><ul><li>Update the Petstore sample by running the shell scripts under the <code>bin</code> folder. For example, run <code>./bin/generate-samples.sh ./bin/configs/python*</code> to update the Python-related samples under <a href="https://github.com/openapitools/openapi-generator/tree/master/samples"><code>samples</code></a>. For Windows, please install <a href="https://gitforwindows.org/">GIT bash</a>. (If you find that there are new files generated or unexpected changes as a result of the update, that&#x27;s not unusual as the test cases are added to the OpenAPI spec from time to time. If you&#x27;ve questions or concerns, please open a ticket to start a discussion)</li><li>During development, it can be helpful to quickly regenerate the samples without recompiling all of openapi-generator, e.g. when you have only updated the mustache templates. This can be done by passing the <code>-t</code> parameter: <code>-t modules/openapi-generator/src/main/resources/python</code>.</li><li>Run the tests in the sample folder using maven <code>mvn integration-test -f /path/to/pom.xml</code>, e.g. <code>mvn integration-test -f samples/client/petstore/python/pom.xml</code>. (some languages may not contain unit testing for Petstore and we&#x27;re looking for contribution from the community to implement those tests)</li><li>Finally, git commit the updated samples files: <code>git commit -a</code> (<code>git add -A</code> if added files with new test cases)</li><li>For new test cases, please add to the <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml">Fake Petstore spec</a></li></ul><p>To start the CI tests, you can:</p><ul><li>Run <code>mvn verify -Psamples</code>, assuming you have all the required tools installed to run tests for different languages.</li><li>Leverage <a href="http://travis-ci.org">http://travis-ci.org</a> to run the CI tests by adding your own openapi-generator repository.</li><li>Run some of the CI tests in your local workspace.</li></ul><p>See <a href="https://github.com/OpenAPITools/openapi-generator/wiki/Integration-Tests">OpenAPI Tools wiki</a> for more information about the integration tests.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="tips"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#tips" title="Direct link to heading">#</a>Tips</h3><ul><li>Smaller changes are easier to review</li><li>[Optional] For bug fixes, provide a OpenAPI Spec to repeat the issue so that the reviewer can use it to confirm the fix</li><li>Add test case(s) to cover the change</li><li>Document the fix in the code to make the code more readable</li><li>Make sure test cases passed after the change (one way is to leverage <a href="https://travis-ci.org/">https://travis-ci.org/</a> to run the CI tests)</li><li>File a PR with meaningful title, description and commit messages</li><li>Make sure the option &quot;Allow edits from maintainers&quot; in the PR is selected so that the maintainers can update your PRs with minor fixes, if needed.</li><li>Recommended git settings<ul><li><code>git config core.autocrlf input</code> to tell Git convert CRLF to LF on commit but not the other way around </li></ul></li><li>To close an issue (e.g. issue 1542) automatically after a PR is merged, use keywords &quot;fix&quot;, &quot;close&quot;, &quot;resolve&quot; in the PR description, e.g. <code>fix #1542</code>. (Ref: <a href="https://help.github.com/articles/closing-issues-using-keywords/">closing issues using keywords</a>)</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/contributing.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/integrations"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Workflow Integrations</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/code-of-conduct"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Code of Conduct »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#before-submitting-an-issue" class="contents__link">Before submitting an issue</a></li><li><a href="#before-submitting-a-pr" class="contents__link">Before submitting a PR</a></li><li><a href="#how-to-contribute" class="contents__link">How to contribute</a><ul><li><a href="#git" class="contents__link">git</a></li><li><a href="#branches" class="contents__link">Branches</a></li><li><a href="#code-generators" class="contents__link">Code generators</a></li><li><a href="#templates" class="contents__link">Templates</a></li><li><a href="#style-guide" class="contents__link">Style guide</a></li><li><a href="#testing" class="contents__link">Testing</a></li><li><a href="#tips" class="contents__link">Tips</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/ecfe08ed.facb9733.js"></script>
+<script src="/ecfe08ed.b9e52a69.js"></script>
 
 
 </body>
diff --git a/docs/core-team/index.html b/docs/core-team/index.html
index fdbdaff1d7f..198a2740913 100644
--- a/docs/core-team/index.html
+++ b/docs/core-team/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Core Team Members</h1></header><div class="markdown"><ul><li><a href="https://github.com/wing328">@wing328</a> (2015/07)</li><li><a href="https://github.com/jimschubert">@jimschubert</a> (2016/05)</li><li><a href="https://github.com/cbornet">@cbornet</a> (2016/05)</li><li><a href="https://github.com/jaz-ah">@jaz-ah</a> (2016/05)</li><li><a href="https://github.com/JFCote">@JFCote</a> (2018/03)</li><li><a href="https://github.com/jmini">@jmini</a> (2018/04)</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/core-team.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Core Team Members</h1></header><div class="markdown"><ul><li><a href="https://github.com/wing328">@wing328</a> (2015/07)</li><li><a href="https://github.com/jimschubert">@jimschubert</a> (2016/05)</li><li><a href="https://github.com/cbornet">@cbornet</a> (2016/05)</li><li><a href="https://github.com/jaz-ah">@jaz-ah</a> (2016/05)</li><li><a href="https://github.com/JFCote">@JFCote</a> (2018/03)</li><li><a href="https://github.com/jmini">@jmini</a> (2018/04)</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/core-team.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/ac8b7f2e.2ce29d45.js"></script>
+<script src="/ac8b7f2e.73beb1ba.js"></script>
 
 
 </body>
diff --git a/docs/customization/index.html b/docs/customization/index.html
index 97918eb0c29..652150da5ea 100644
--- a/docs/customization/index.html
+++ b/docs/customization/index.html
@@ -33,12 +33,12 @@ These options default to true and don&#x27;t limit the generation of the feature
 <strong>These options are applied via configuration file (e.g. config.json or config.yml) or by passing them with <code>-p {optionName}={optionValue}</code></strong>. (If <code>-p {optionName}</code> does not work, please open a <a href="https://github.com/openapitools/openapi-generator/issues/new">ticket</a> and we&#x27;ll look into it)</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g java</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Output</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">CONFIG OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modelPackage</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        package </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> generated models</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    apiPackage</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        package </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> generated api classes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">results omitted</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    library</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        library template </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">sub-template</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> to use:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        jersey1 - HTTP client: Jersey client </span><span class="token number">1.18</span><span class="token plain">. JSON processing: Jackson </span><span class="token number">2.4</span><span class="token plain">.2</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        jersey2 - HTTP client: Jersey client </span><span class="token number">2.6</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        feign - HTTP client: Netflix Feign </span><span class="token number">8.1</span><span class="token plain">.1.  JSON processing: Jackson </span><span class="token number">2.6</span><span class="token plain">.3</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        okhttp-gson </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">default</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> - HTTP client: OkHttp </span><span class="token number">2.4</span><span class="token plain">.0. JSON processing: Gson </span><span class="token number">2.3</span><span class="token plain">.1</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        retrofit - HTTP client: OkHttp </span><span class="token number">2.4</span><span class="token plain">.0. JSON processing: Gson </span><span class="token number">2.3</span><span class="token plain">.1 </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Retrofit </span><span class="token number">1.9</span><span class="token plain">.0</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        retrofit2 - HTTP client: OkHttp </span><span class="token number">2.5</span><span class="token plain">.0. JSON processing: Gson </span><span class="token number">2.4</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Retrofit </span><span class="token number">2.0</span><span class="token plain">.0-beta2</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        google-api-client - HTTP client: google-api-client </span><span class="token number">1.23</span><span class="token plain">.0. JSON processing: Jackson </span><span class="token number">2.8</span><span class="token plain">.9</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        rest-assured - HTTP client: rest-assured </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">:</span><span class="token plain"> </span><span class="token number">4.3</span><span class="token plain">.0. JSON processing: Gson </span><span class="token number">2.8</span><span class="token plain">.6. Only </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> Java8</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Your config file for Java can look like</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;groupId&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;com.my.company&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;artifactId&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;MyClient&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;artifactVersion&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.2.0&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;library&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;feign&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Or if you prefer yaml format it can look like</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">groupId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;com.my.company&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">artifactId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;MyClient&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">artifactVersion</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.2.0&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">library</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;feign&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>For all the unspecified options default values will be used.</p><p>Another way to override default options is to extend the config class for the specific language.
 To change, for example, the prefix for the Objective-C generated files, simply subclass the <code>ObjcClientCodegen.java</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">package</span><span class="token plain"> </span><span class="token namespace">com</span><span class="token namespace punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token namespace">mycompany</span><span class="token namespace punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token namespace">openapitools</span><span class="token namespace punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token namespace">codegen</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">import</span><span class="token plain"> </span><span class="token namespace">org</span><span class="token namespace punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token namespace">openapitools</span><span class="token namespace punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token namespace">codegen</span><span class="token namespace punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token namespace">languages</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">*</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">public</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">class</span><span class="token plain"> </span><span class="token class-name">MyObjcCodegen</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">extends</span><span class="token plain"> </span><span class="token class-name">ObjcClientCodegen</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">static</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        PREFIX </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;HELLO&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>and specify the <code>classname</code> when running the generator:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">-g com.mycompany.openapitools.codegen.MyObjcCodegen</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Your subclass will now be loaded and overrides the <code>PREFIX</code> value in the superclass.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="bringing-your-own-models"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#bringing-your-own-models" title="Direct link to heading">#</a>Bringing your own models</h2><p>Sometimes you don&#x27;t want a model generated.  In this case, you can simply specify an import mapping to tell
 the codegen what <em>not</em> to create.  When doing this, every location that references a specific model will
-refer back to your classes.  Note, this may not apply to all languages...</p><p>To specify an import mapping, use the <code>--import-mappings</code> argument and specify the model-to-import logic as such:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Pet</span><span class="token operator">=</span><span class="token plain">my.models.MyPet</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Or for multiple mappings:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Pet</span><span class="token operator">=</span><span class="token plain">my.models.MyPet,Order</span><span class="token operator">=</span><span class="token plain">my.models.MyOrder</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>or</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Pet</span><span class="token operator">=</span><span class="token plain">my.models.MyPet --import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Order</span><span class="token operator">=</span><span class="token plain">my.models.MyOrder</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/customization.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/templating"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Using Templates</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/debugging"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Debugging »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#user-defined-templates" class="contents__link">User-defined Templates</a></li><li><a href="#custom-generator-and-template" class="contents__link">Custom Generator (and Template)</a><ul><li><a href="#use-your-new-generator-with-the-cli" class="contents__link">Use your new generator with the CLI</a></li><li><a href="#use-your-new-generator-with-the-maven-plugin" class="contents__link">Use your new generator with the maven plugin</a></li></ul></li><li><a href="#selective-generation" class="contents__link">Selective generation</a></li><li><a href="#ignore-file-format" class="contents__link">Ignore file format</a></li><li><a href="#customizing-the-generator" class="contents__link">Customizing the generator</a></li><li><a href="#bringing-your-own-models" class="contents__link">Bringing your own models</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a aria-current="page" class="footer__link-item active" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+refer back to your classes.  Note, this may not apply to all languages...</p><p>To specify an import mapping, use the <code>--import-mappings</code> argument and specify the model-to-import logic as such:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Pet</span><span class="token operator">=</span><span class="token plain">my.models.MyPet</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Or for multiple mappings:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Pet</span><span class="token operator">=</span><span class="token plain">my.models.MyPet,Order</span><span class="token operator">=</span><span class="token plain">my.models.MyOrder</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>or</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Pet</span><span class="token operator">=</span><span class="token plain">my.models.MyPet --import-mappings </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">Order</span><span class="token operator">=</span><span class="token plain">my.models.MyOrder</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/customization.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/templating"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Using Templates</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/debugging"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Debugging »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#user-defined-templates" class="contents__link">User-defined Templates</a></li><li><a href="#custom-generator-and-template" class="contents__link">Custom Generator (and Template)</a><ul><li><a href="#use-your-new-generator-with-the-cli" class="contents__link">Use your new generator with the CLI</a></li><li><a href="#use-your-new-generator-with-the-maven-plugin" class="contents__link">Use your new generator with the maven plugin</a></li></ul></li><li><a href="#selective-generation" class="contents__link">Selective generation</a></li><li><a href="#ignore-file-format" class="contents__link">Ignore file format</a></li><li><a href="#customizing-the-generator" class="contents__link">Customizing the generator</a></li><li><a href="#bringing-your-own-models" class="contents__link">Bringing your own models</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a aria-current="page" class="footer__link-item active" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -54,7 +54,7 @@ refer back to your classes.  Note, this may not apply to all languages...</p><p>
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/b6a32428.1b40b8d9.js"></script>
+<script src="/b6a32428.7992dd6c.js"></script>
 
 
 </body>
diff --git a/docs/debugging/index.html b/docs/debugging/index.html
index 3303e79b359..c9e0c85d80d 100644
--- a/docs/debugging/index.html
+++ b/docs/debugging/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Debugging</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="generation"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#generation" title="Direct link to heading">#</a>Generation</h2><p>As a user there may be times when generated outputs don&#x27;t match your expectations it&#x27;s unclear why. The CLI supports a <code>--dry-run</code> option which may be used to inspect the anticipated file operations without making changes to the file system.</p><p>Suppose you generate using the <code>--minimal-update</code> option, and you notice on subsequent generations of a client that no files have changed. This is by design.</p><p>For example, if you generate the aspnetcore generator passing <code>--minimal-update --dry-run</code> to the sample generation script in the code repository:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;-Dlog.level=off&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You&#x27;ll see the output similar to the following:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">$ ./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># START SCRIPT: ./bin/generate-samples.sh</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">This script generates all configs under bin/configs by default.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">You may generate a targeted script or </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">set</span><span class="token plain"> of scripts using glob patterns.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">For example:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ./bin/generate-samples.sh bin/configs/java-*</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">You may generate a single config with additional options </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> you use -- to</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">separate the single config </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> from the generator arguments.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">For example:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ./bin/generate-samples.sh bin/configs/java-vertx.yaml -- --global-property </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">debugModels</span><span class="token operator">=</span><span class="token plain">true</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Generating with </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">dryRun</span><span class="token operator">=</span><span class="token plain">true</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - OpenAPI Generator: lua </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">client</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Generator </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;lua&#x27;</span><span class="token plain"> is considered beta.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Model inline_object </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">marked as unused due to form parameters</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> is generated due to the system property </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">skipFormModel</span><span class="token operator">=</span><span class="token plain">false </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">default</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Model inline_object_1 </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">marked as unused due to form parameters</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> is generated due to the system property </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">skipFormModel</span><span class="token operator">=</span><span class="token plain">false </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">default</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/json</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.DefaultCodegen - Multiple MediaTypes found, using only the first one</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/json</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> ERROR o.o.codegen.DefaultGenerator - </span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Dry Run Results:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">n /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">States:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - w Write</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - n Write </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> New/Updated</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - i Ignored</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - s Skipped Overwrite</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - k Skipped by user option</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">s</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - e Error evaluating </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">write</span><span class="token plain"> state</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> ERROR o.o.codegen.DefaultGenerator - </span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Dry Run Results:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">n /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">States:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - w Write</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - n Write </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> New/Updated</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - i Ignored</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - s Skipped Overwrite</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - k Skipped by user option</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">s</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - e Error evaluating </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">write</span><span class="token plain"> state</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The output lists the files which would be written in a normal run of the tool. Notice that we skip <code>.openapi-generator-ignore</code> because the file exists and we don&#x27;t want to blow away the user&#x27;s generation rules. Most of these files will overwrite output files only if the contents slated for write are different from those on the filesystem; this is denoted by an <code>n</code> preceding the filename. Some of the above lines begin with a <code>w</code>, meaning these files will <em>always</em> result in a write operation.</p><p>If you find an operation that you feel should result in a different state, please <a href="https://github.com/OpenAPITools/openapi-generator/issues/new/choose">open an issue</a> or <a href="https://github.com/OpenAPITools/openapi-generator/compare">submit a pull request</a> to change the behavior (we welcome all contributions).</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#templates" title="Direct link to heading">#</a>Templates</h2><p>Sometimes, you may have issues with variables in your templates. As discussed in the <a href="/docs/templating">templating</a> docs, we offer a variety of system properties for inspecting the models bound to templates.</p><dl><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugOpenAPI</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model of the OpenAPI Document, as seen by OpenAPI Generator</dd><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugModels</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model passed to model templates</dd><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugOperations</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model passed to operation (api) templates</dd><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugSupportingFiles</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model passed to supporting files</dd></dl><p>One or more of these properties can be passed alongside other command line options:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator generate -g go </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -o out </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -i petstore-minimal.yaml </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    --global-property debugModels,debugOperations</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Or you can add these to your <code>JAVA_OPTS</code> environment variable (this applies to every invocation of the tool):</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">${JAVA_OPTS}</span><span class="token string" style="color:rgb(255, 121, 198)"> --global-property debugModels,debugOperations&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>NOTE: Globally available system options like these will apply to all invocations of the generator (CLI and plugins)</p></blockquote><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="runtime"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#runtime" title="Direct link to heading">#</a>Runtime</h2><p>When you&#x27;re working with a custom generator, a new generator, or otherwise trying to understand the behavior of the toolset, you may need to attach a remote debugger in order to step through the code.</p><p>The steps are shown here for a specific version of the generator, but apply the same if you&#x27;re working off master or a feature branch.</p><ul><li>Determine the version of <code>openapi-generator</code> you&#x27;re using. For the CLI, this is:  <pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator version</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Navigate to the <code>openapi-generator</code> source directory (see <a href="/docs/contribute-building">building</a> docs for obtaining source code and brief introduction).</li><li>Checkout the branch/tag for the target version. Branches are not prefixed, but tags are prefixed with a <code>v</code>. For instance if you&#x27;re using version <code>3.3.0</code>, you will execute:<pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> checkout v3.3.0</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Open the project in your IDE.</li><li>Setup your IDE for remote debugging. You&#x27;ll want to define a port used for connecting the remote debugger. For this example, we&#x27;ll use <code>5005</code>. See external tutorials for <a href="https://www.jetbrains.com/help/idea/run-debug-configuration-remote-debug.html">IntelliJ</a> and <a href="https://www.ibm.com/developerworks/library/os-eclipse-javadebug/index.html">Eclipse</a></li><li>Export the debug configuration, specifying <code>suspend=y</code> so you have time to attach a remote debugger. These are passed as Java system properties, either on command line or as part of the <code>JAVA_OPTS</code> environment variable. This will look like:<pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">${JAVA_OPTS}</span><span class="token string" style="color:rgb(255, 121, 198)"> -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Execute the generator with your desired options. You should see the application output <em>only</em><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Listening </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> transport dt_socket at address: </span><span class="token number">5005</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Set breakpoints in code, and then attach your remote debugger from your IDE (see above). The generator will automatically unblock once the remote debugger is attached. You can now step through the code.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="logs"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#logs" title="Direct link to heading">#</a>Logs</h2><p>You can try to enable debugging log with <code>-Dlog.level=debug</code> option to the <code>JAVA_OPTS</code> environment variable to see more information:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">${JAVA_OPTS}</span><span class="token string" style="color:rgb(255, 121, 198)"> -Dlog.level=debug&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Set the option then DEBUG logs are printed out:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator generate -g go </span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> DEBUG o.o.codegen.DefaultCodegen - debugging fromProperty </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> files </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">:</span><span class="token plain"> class Schema </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    type: null</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    format: null</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$ref</span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">:</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">#/components/schemas/File</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/debugging.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/customization"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Customization</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/integrations"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Workflow Integrations »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#generation" class="contents__link">Generation</a></li><li><a href="#templates" class="contents__link">Templates</a></li><li><a href="#runtime" class="contents__link">Runtime</a></li><li><a href="#logs" class="contents__link">Logs</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Debugging</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="generation"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#generation" title="Direct link to heading">#</a>Generation</h2><p>As a user there may be times when generated outputs don&#x27;t match your expectations it&#x27;s unclear why. The CLI supports a <code>--dry-run</code> option which may be used to inspect the anticipated file operations without making changes to the file system.</p><p>Suppose you generate using the <code>--minimal-update</code> option, and you notice on subsequent generations of a client that no files have changed. This is by design.</p><p>For example, if you generate the aspnetcore generator passing <code>--minimal-update --dry-run</code> to the sample generation script in the code repository:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;-Dlog.level=off&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You&#x27;ll see the output similar to the following:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">$ ./bin/generate-samples.sh ./bin/configs/lua.yaml -- --minimal-update --dry-run</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># START SCRIPT: ./bin/generate-samples.sh</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">This script generates all configs under bin/configs by default.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">You may generate a targeted script or </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">set</span><span class="token plain"> of scripts using glob patterns.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">For example:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ./bin/generate-samples.sh bin/configs/java-*</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">You may generate a single config with additional options </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> you use -- to</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">separate the single config </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> from the generator arguments.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">For example:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ./bin/generate-samples.sh bin/configs/java-vertx.yaml -- --global-property </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">debugModels</span><span class="token operator">=</span><span class="token plain">true</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Generating with </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">dryRun</span><span class="token operator">=</span><span class="token plain">true</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - OpenAPI Generator: lua </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">client</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Generator </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;lua&#x27;</span><span class="token plain"> is considered beta.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Model inline_object </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">marked as unused due to form parameters</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> is generated due to the system property </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">skipFormModel</span><span class="token operator">=</span><span class="token plain">false </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">default</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.DefaultGenerator - Model inline_object_1 </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">marked as unused due to form parameters</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> is generated due to the system property </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">skipFormModel</span><span class="token operator">=</span><span class="token plain">false </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">default</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/json</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.DefaultCodegen - Multiple MediaTypes found, using only the first one</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/json</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> WARN  o.o.codegen.utils.ModelUtils - Multiple schemas found </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the OAS </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;content&#x27;</span><span class="token plain"> section, returning only the first one </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">application/xml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> ERROR o.o.codegen.DefaultGenerator - </span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Dry Run Results:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">n /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">States:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - w Write</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - n Write </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> New/Updated</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - i Ignored</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - s Skipped Overwrite</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - k Skipped by user option</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">s</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - e Error evaluating </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">write</span><span class="token plain"> state</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> ERROR o.o.codegen.DefaultGenerator - </span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Dry Run Results:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator-ignore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">n /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/.openapi-generator/VERSION</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/api_response_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/category_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_1_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/inline_object_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/order_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/pet_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/store_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/tag_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_api_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">k /Users/williamcheng/Code/openapi-generator/samples/client/petstore/lua/spec/user_spec.lua</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">States:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - w Write</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - n Write </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> New/Updated</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - i Ignored</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - s Skipped Overwrite</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - k Skipped by user option</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">s</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  - e Error evaluating </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">write</span><span class="token plain"> state</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The output lists the files which would be written in a normal run of the tool. Notice that we skip <code>.openapi-generator-ignore</code> because the file exists and we don&#x27;t want to blow away the user&#x27;s generation rules. Most of these files will overwrite output files only if the contents slated for write are different from those on the filesystem; this is denoted by an <code>n</code> preceding the filename. Some of the above lines begin with a <code>w</code>, meaning these files will <em>always</em> result in a write operation.</p><p>If you find an operation that you feel should result in a different state, please <a href="https://github.com/OpenAPITools/openapi-generator/issues/new/choose">open an issue</a> or <a href="https://github.com/OpenAPITools/openapi-generator/compare">submit a pull request</a> to change the behavior (we welcome all contributions).</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#templates" title="Direct link to heading">#</a>Templates</h2><p>Sometimes, you may have issues with variables in your templates. As discussed in the <a href="/docs/templating">templating</a> docs, we offer a variety of system properties for inspecting the models bound to templates.</p><dl><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugOpenAPI</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model of the OpenAPI Document, as seen by OpenAPI Generator</dd><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugModels</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model passed to model templates</dd><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugOperations</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model passed to operation (api) templates</dd><dt><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--global-property debugSupportingFiles</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></dt><dd>Prints out the JSON model passed to supporting files</dd></dl><p>One or more of these properties can be passed alongside other command line options:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator generate -g go </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -o out </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -i petstore-minimal.yaml </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    --global-property debugModels,debugOperations</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Or you can add these to your <code>JAVA_OPTS</code> environment variable (this applies to every invocation of the tool):</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">${JAVA_OPTS}</span><span class="token string" style="color:rgb(255, 121, 198)"> --global-property debugModels,debugOperations&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>NOTE: Globally available system options like these will apply to all invocations of the generator (CLI and plugins)</p></blockquote><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="runtime"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#runtime" title="Direct link to heading">#</a>Runtime</h2><p>When you&#x27;re working with a custom generator, a new generator, or otherwise trying to understand the behavior of the toolset, you may need to attach a remote debugger in order to step through the code.</p><p>The steps are shown here for a specific version of the generator, but apply the same if you&#x27;re working off master or a feature branch.</p><ul><li>Determine the version of <code>openapi-generator</code> you&#x27;re using. For the CLI, this is:  <pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator version</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Navigate to the <code>openapi-generator</code> source directory (see <a href="/docs/contribute-building">building</a> docs for obtaining source code and brief introduction).</li><li>Checkout the branch/tag for the target version. Branches are not prefixed, but tags are prefixed with a <code>v</code>. For instance if you&#x27;re using version <code>3.3.0</code>, you will execute:<pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> checkout v3.3.0</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Open the project in your IDE.</li><li>Setup your IDE for remote debugging. You&#x27;ll want to define a port used for connecting the remote debugger. For this example, we&#x27;ll use <code>5005</code>. See external tutorials for <a href="https://www.jetbrains.com/help/idea/run-debug-configuration-remote-debug.html">IntelliJ</a> and <a href="https://www.ibm.com/developerworks/library/os-eclipse-javadebug/index.html">Eclipse</a></li><li>Export the debug configuration, specifying <code>suspend=y</code> so you have time to attach a remote debugger. These are passed as Java system properties, either on command line or as part of the <code>JAVA_OPTS</code> environment variable. This will look like:<pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">${JAVA_OPTS}</span><span class="token string" style="color:rgb(255, 121, 198)"> -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Execute the generator with your desired options. You should see the application output <em>only</em><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Listening </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> transport dt_socket at address: </span><span class="token number">5005</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></li><li>Set breakpoints in code, and then attach your remote debugger from your IDE (see above). The generator will automatically unblock once the remote debugger is attached. You can now step through the code.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="logs"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#logs" title="Direct link to heading">#</a>Logs</h2><p>You can try to enable debugging log with <code>-Dlog.level=debug</code> option to the <code>JAVA_OPTS</code> environment variable to see more information:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_OPTS</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;</span><span class="token string variable" style="color:rgb(189, 147, 249);font-style:italic">${JAVA_OPTS}</span><span class="token string" style="color:rgb(255, 121, 198)"> -Dlog.level=debug&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Set the option then DEBUG logs are printed out:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator generate -g go </span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> DEBUG o.o.codegen.DefaultCodegen - debugging fromProperty </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> files </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">:</span><span class="token plain"> class Schema </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    type: null</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    format: null</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$ref</span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">:</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">#/components/schemas/File</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">..</span><span class="token plain">.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/debugging.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/customization"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Customization</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/integrations"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Workflow Integrations »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#generation" class="contents__link">Generation</a></li><li><a href="#templates" class="contents__link">Templates</a></li><li><a href="#runtime" class="contents__link">Runtime</a></li><li><a href="#logs" class="contents__link">Logs</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/03abeb31.8a0f7431.js"></script>
+<script src="/03abeb31.b27e9b33.js"></script>
 
 
 </body>
diff --git a/docs/faq-contributing/index.html b/docs/faq-contributing/index.html
index fdd2e9944f5..0a78be31960 100644
--- a/docs/faq-contributing/index.html
+++ b/docs/faq-contributing/index.html
@@ -33,12 +33,12 @@
 4) make changes
 5) git commit -a (you may need to use <code>git add filename</code> to add new files)
 6) git push origin fix_issue9999
-7) Visit <a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a> in your browser and click on the button to file a new PR based on fix_issue9999</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-contributing.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/faq-extending"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« FAQ: Extending</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/faq-generators"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">FAQ: Generators »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#automated-checks-on-my-pr-have-failed-do-you-know-whats-wrong" class="contents__link">Automated checks on my PR have failed. Do you know what's wrong?</a></li><li><a href="#the-public-petstore-server-returns-status-500-can-i-run-it-locally" class="contents__link">The public petstore server returns status 500, can I run it locally?</a></li><li><a href="#who-should-i-report-a-security-vulnerability-to" class="contents__link">Who should I report a security vulnerability to?</a></li><li><a href="#how-can-i-rebase-my-pr-on-the-latest-master" class="contents__link">How can I rebase my PR on the latest master?</a></li><li><a href="#how-can-i-update-commits-that-are-not-linked-to-my-github-account" class="contents__link">How can I update commits that are not linked to my GitHub account?</a></li><li><a href="#any-useful-git-tips-to-share" class="contents__link">Any useful git tips to share?</a></li><li><a href="#how-can-i-submit-a-pr-to-fix-bugs-or-make-enhancements" class="contents__link">How can I submit a PR to fix bugs or make enhancements?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+7) Visit <a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a> in your browser and click on the button to file a new PR based on fix_issue9999</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-contributing.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/faq-extending"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« FAQ: Extending</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/faq-generators"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">FAQ: Generators »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#automated-checks-on-my-pr-have-failed-do-you-know-whats-wrong" class="contents__link">Automated checks on my PR have failed. Do you know what's wrong?</a></li><li><a href="#the-public-petstore-server-returns-status-500-can-i-run-it-locally" class="contents__link">The public petstore server returns status 500, can I run it locally?</a></li><li><a href="#who-should-i-report-a-security-vulnerability-to" class="contents__link">Who should I report a security vulnerability to?</a></li><li><a href="#how-can-i-rebase-my-pr-on-the-latest-master" class="contents__link">How can I rebase my PR on the latest master?</a></li><li><a href="#how-can-i-update-commits-that-are-not-linked-to-my-github-account" class="contents__link">How can I update commits that are not linked to my GitHub account?</a></li><li><a href="#any-useful-git-tips-to-share" class="contents__link">Any useful git tips to share?</a></li><li><a href="#how-can-i-submit-a-pr-to-fix-bugs-or-make-enhancements" class="contents__link">How can I submit a PR to fix bugs or make enhancements?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -54,7 +54,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/5f7cf4b7.97dacab2.js"></script>
+<script src="/5f7cf4b7.3b4dc9f4.js"></script>
 
 
 </body>
diff --git a/docs/faq-extending/index.html b/docs/faq-extending/index.html
index 4d3da0a2246..941dcd5d96d 100644
--- a/docs/faq-extending/index.html
+++ b/docs/faq-extending/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">FAQ</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ: General</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/faq-extending">FAQ: Extending</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-contributing">FAQ: Contributing</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-generators">FAQ: Generators</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">FAQ: Extending</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-use-my-own-java-models"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-use-my-own-java-models" title="Direct link to heading">#</a>How do I use my own Java models?</h2><p>See <a href="/docs/customization#bringing-your-own-models">Bringing your own Models</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-disable-certificate-verification"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-disable-certificate-verification" title="Direct link to heading">#</a>How do I disable certificate verification?</h2><p>Please add <code>-Dio.swagger.v3.parser.util.RemoteUrl.trustAll=true</code> when generating the code.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-skip-files-during-code-generation"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-skip-files-during-code-generation" title="Direct link to heading">#</a>How do I skip files during code generation?</h2><p>OpenAPI Generator has a built-in ignore file processor.</p><p>For example, to skip <code>git_push.sh</code>, one can create a file named <code>.openapi-generator-ignore</code> in the root of the output directory with the contents:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># Prevent generator from creating these files:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">git_push.sh</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The ignore file works just like .gitignore, and it is auto-generated by default.</p><p>If you need this functionality on initial generation, you can provide the option <code>--ignore-file-override</code> (CLI) or <code>ignoreFileOverride</code> (Maven and Gradle plugins) with a value targeting any existing file. The contents of that file will be evaluated relative to the output directory.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-can-i-customize-the-auto-generated-code"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-can-i-customize-the-auto-generated-code" title="Direct link to heading">#</a>How can I customize the auto-generated code?</h2><p>Variants:</p><ul><li>&quot;How can I add a header/footer to generated code?&quot;</li><li>&quot;How can I add my own logging to generated code?&quot;</li><li>&quot;How can I add my license to the top of files?&quot;</li></ul><p>OpenAPI Generator supports user-defined templates without need to recompile the artifact. We also support custom generators (templates and logic) if those generators are accessible on the classpath.</p><p>See <a href="/docs/templating#modifying-templates">templating: Modifying Templates</a> and <a href="/docs/customization">customization</a> docs for more details.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-extending.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/faq"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« FAQ: General</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/faq-contributing"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">FAQ: Contributing »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#how-do-i-use-my-own-java-models" class="contents__link">How do I use my own Java models?</a></li><li><a href="#how-do-i-disable-certificate-verification" class="contents__link">How do I disable certificate verification?</a></li><li><a href="#how-do-i-skip-files-during-code-generation" class="contents__link">How do I skip files during code generation?</a></li><li><a href="#how-can-i-customize-the-auto-generated-code" class="contents__link">How can I customize the auto-generated code?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">FAQ</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ: General</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/faq-extending">FAQ: Extending</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-contributing">FAQ: Contributing</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-generators">FAQ: Generators</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">FAQ: Extending</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-use-my-own-java-models"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-use-my-own-java-models" title="Direct link to heading">#</a>How do I use my own Java models?</h2><p>See <a href="/docs/customization#bringing-your-own-models">Bringing your own Models</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-disable-certificate-verification"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-disable-certificate-verification" title="Direct link to heading">#</a>How do I disable certificate verification?</h2><p>Please add <code>-Dio.swagger.v3.parser.util.RemoteUrl.trustAll=true</code> when generating the code.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-skip-files-during-code-generation"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-skip-files-during-code-generation" title="Direct link to heading">#</a>How do I skip files during code generation?</h2><p>OpenAPI Generator has a built-in ignore file processor.</p><p>For example, to skip <code>git_push.sh</code>, one can create a file named <code>.openapi-generator-ignore</code> in the root of the output directory with the contents:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># Prevent generator from creating these files:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">git_push.sh</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The ignore file works just like .gitignore, and it is auto-generated by default.</p><p>If you need this functionality on initial generation, you can provide the option <code>--ignore-file-override</code> (CLI) or <code>ignoreFileOverride</code> (Maven and Gradle plugins) with a value targeting any existing file. The contents of that file will be evaluated relative to the output directory.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="how-can-i-customize-the-auto-generated-code"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-can-i-customize-the-auto-generated-code" title="Direct link to heading">#</a>How can I customize the auto-generated code?</h2><p>Variants:</p><ul><li>&quot;How can I add a header/footer to generated code?&quot;</li><li>&quot;How can I add my own logging to generated code?&quot;</li><li>&quot;How can I add my license to the top of files?&quot;</li></ul><p>OpenAPI Generator supports user-defined templates without need to recompile the artifact. We also support custom generators (templates and logic) if those generators are accessible on the classpath.</p><p>See <a href="/docs/templating#modifying-templates">templating: Modifying Templates</a> and <a href="/docs/customization">customization</a> docs for more details.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-extending.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/faq"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« FAQ: General</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/faq-contributing"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">FAQ: Contributing »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#how-do-i-use-my-own-java-models" class="contents__link">How do I use my own Java models?</a></li><li><a href="#how-do-i-disable-certificate-verification" class="contents__link">How do I disable certificate verification?</a></li><li><a href="#how-do-i-skip-files-during-code-generation" class="contents__link">How do I skip files during code generation?</a></li><li><a href="#how-can-i-customize-the-auto-generated-code" class="contents__link">How can I customize the auto-generated code?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/df7ab5c6.b6b994bf.js"></script>
+<script src="/df7ab5c6.8f17f2b9.js"></script>
 
 
 </body>
diff --git a/docs/faq-generators/index.html b/docs/faq-generators/index.html
index 825ac131efe..48a8fbea9f9 100644
--- a/docs/faq-generators/index.html
+++ b/docs/faq-generators/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">FAQ</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ: General</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-extending">FAQ: Extending</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-contributing">FAQ: Contributing</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/faq-generators">FAQ: Generators</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">FAQ: Generators</h1></header><div class="markdown"><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="what-are-some-server-generator-use-cases"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#what-are-some-server-generator-use-cases" title="Direct link to heading">#</a>What are some server generator use cases?</h3><p>We have around 40+ server generators, with more added regularly. Some of these include Spring in your choice of Java or Kotlin, the Finch and Scalatra frameworks using Scala, and C# generators for ASP.NET and Azure Functions (to name only a few).</p><p>Besides generating the server code as a starting point to implement the API backend, here are some use cases of the server generators:</p><ul><li><strong>prototyping</strong> - one can generate the server code and have a functional API backend very quickly to try different things or features.</li><li><strong>mocking</strong> - easily provide an API backend for mocking based on the examples field defined in the response object.</li><li><strong>migration</strong> - let&#x27;s say one wants to migrate an API backend from Ruby on Rails to Java Spring. The server generator can save a lot of time in implementing and verify each endpoint in the new API backend.</li><li><strong>evaluating</strong> - when you want to try a new language or framework, and a typical &quot;Hello, World&quot; is too trivial.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="java"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#java" title="Direct link to heading">#</a>Java</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that" title="Direct link to heading">#</a>The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?</h3><p>Yes, please refer to <a href="http://stackoverflow.com/a/6055903/677735">http://stackoverflow.com/a/6055903/677735</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-can-i-customize-the-feign-client-templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-can-i-customize-the-feign-client-templates" title="Direct link to heading">#</a>How can I customize the Feign client templates?</h3><p>You will need to provide customized files in <code>Java/libraries/feign</code> under the resources folder and pass the location via the <code>-t</code> option.</p><p>In your Gradle build script, please add the following (example):</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">config.templateDir </span><span class="token operator">=</span><span class="token plain"> &#x27;src/openapi-generator-templates/Java/libraries/feign</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="android"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#android" title="Direct link to heading">#</a>Android</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-can-i-generate-an-android-sdk"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-can-i-generate-an-android-sdk" title="Direct link to heading">#</a>How can I generate an Android SDK?</h3><p><strong>The Java SDK is also compatible with Android.</strong></p><p>[RECOMMENDED] To generate the Java SDK with <code>okhttp</code> and <code>gson</code> libraries, run the following:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean package</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -l java --library</span><span class="token operator">=</span><span class="token plain">okhttp-gson </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  --additional-properties </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">hideGenerationTimestamp</span><span class="token operator">=</span><span class="token plain">true </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -o /var/tmp/java/okhttp-gson/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You can also generate the Java SDK with other HTTP libraries by replacing <code>okhttp-gson</code> with <code>retrofit</code> for example. For a list of support libraries, please run</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -l java</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>To generate the Android SDK with <a href="https://github.com/mcxiaoke/android-volley"><code>volley</code></a>, please run</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean package</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -l android --library</span><span class="token operator">=</span><span class="token plain">volley </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -o /var/tmp/android/volley/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>We do <strong>not</strong> recommend using the default HTTP library (Apache HttpClient) with <code>android</code> as it&#x27;s not actively maintained.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="c-sharp"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-sharp" title="Direct link to heading">#</a>C-Sharp</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-fix-csc--warning-cs2002-in-xamarin"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-fix-csc--warning-cs2002-in-xamarin" title="Direct link to heading">#</a>How do I fix <code>CSC:  warning CS2002</code> in Xamarin?</h3><p>The full warning might look like this: <code>CSC:  warning CS2002: Source file &#x27;Api/FakeApi.cs&#x27; specified multiple times</code></p><p>The warning has no impact on the build process so you should be able to build the solution without issue. The warning should be addressed in the upcoming stable release of Xamarin. </p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="objective-c"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#objective-c" title="Direct link to heading">#</a>Objective-C</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-run-integration-test-with-petstore-objc-api-client"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-run-integration-test-with-petstore-objc-api-client" title="Direct link to heading">#</a>How do I run integration test with Petstore ObjC API client?</h3><p>Here are the steps:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator/samples/client/petstore/objc/default/OpenAPIClientTests</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn integration-test</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Besides <code>default</code> (folder) ObjC API client, there&#x27;s also <code>core-data</code> for another ObjC API client with <a href="https://en.wikipedia.org/wiki/Core_Data">Core Data support</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="swift"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#swift" title="Direct link to heading">#</a>Swift</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-run-integration-test-with-petstore-swift-api-client"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-run-integration-test-with-petstore-swift-api-client" title="Direct link to heading">#</a>How do I run integration test with Petstore Swift API client?</h3><p>Here are the steps:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator/samples/client/petstore/swift/default/OpenAPIClientTests</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn integration-test</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Besides <code>default</code> (folder), there&#x27;s another folder <code>promisekit</code> for Swift API client with <a href="https://github.com/mxcl/PromiseKit">PromiseKit support</a></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator/samples/client/petstore/swift/promisekit/OpenAPIClientTests</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn integration-test</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="is-swift-2x-generator-still-actively-maintained"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#is-swift-2x-generator-still-actively-maintained" title="Direct link to heading">#</a>Is Swift (2.x) generator still actively maintained?</h3><p>No, please use <code>swift3</code> or <code>swift4</code> generator instead as we want to focus on Swift 3.x, 4.x.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="typescript"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#typescript" title="Direct link to heading">#</a>TypeScript</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming" title="Direct link to heading">#</a>The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?</h3><p>Yes, please use the following option when generating TypeScript clients:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">modelPropertyNaming</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Naming convention </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> the property: </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;camelCase&#x27;</span><span class="token plain">, </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;PascalCase&#x27;</span><span class="token plain">, </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;snake_case&#x27;</span><span class="token plain"> and </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;original&#x27;</span><span class="token plain">, </span><span class="token function" style="color:rgb(80, 250, 123)">which</span><span class="token plain"> keeps the original name </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: camelCase</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-generators.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/faq-contributing"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« FAQ: Contributing</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#what-are-some-server-generator-use-cases" class="contents__link">What are some server generator use cases?</a></li><li><a href="#java" class="contents__link">Java</a><ul><li><a href="#the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that" class="contents__link">The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?</a></li><li><a href="#how-can-i-customize-the-feign-client-templates" class="contents__link">How can I customize the Feign client templates?</a></li></ul></li><li><a href="#android" class="contents__link">Android</a><ul><li><a href="#how-can-i-generate-an-android-sdk" class="contents__link">How can I generate an Android SDK?</a></li></ul></li><li><a href="#c-sharp" class="contents__link">C-Sharp</a><ul><li><a href="#how-do-i-fix-csc--warning-cs2002-in-xamarin" class="contents__link">How do I fix <code>CSC:  warning CS2002</code> in Xamarin?</a></li></ul></li><li><a href="#objective-c" class="contents__link">Objective-C</a><ul><li><a href="#how-do-i-run-integration-test-with-petstore-objc-api-client" class="contents__link">How do I run integration test with Petstore ObjC API client?</a></li></ul></li><li><a href="#swift" class="contents__link">Swift</a><ul><li><a href="#how-do-i-run-integration-test-with-petstore-swift-api-client" class="contents__link">How do I run integration test with Petstore Swift API client?</a></li><li><a href="#is-swift-2x-generator-still-actively-maintained" class="contents__link">Is Swift (2.x) generator still actively maintained?</a></li></ul></li><li><a href="#typescript" class="contents__link">TypeScript</a><ul><li><a href="#the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming" class="contents__link">The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">FAQ</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ: General</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-extending">FAQ: Extending</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-contributing">FAQ: Contributing</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/faq-generators">FAQ: Generators</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">FAQ: Generators</h1></header><div class="markdown"><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="what-are-some-server-generator-use-cases"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#what-are-some-server-generator-use-cases" title="Direct link to heading">#</a>What are some server generator use cases?</h3><p>We have around 40+ server generators, with more added regularly. Some of these include Spring in your choice of Java or Kotlin, the Finch and Scalatra frameworks using Scala, and C# generators for ASP.NET and Azure Functions (to name only a few).</p><p>Besides generating the server code as a starting point to implement the API backend, here are some use cases of the server generators:</p><ul><li><strong>prototyping</strong> - one can generate the server code and have a functional API backend very quickly to try different things or features.</li><li><strong>mocking</strong> - easily provide an API backend for mocking based on the examples field defined in the response object.</li><li><strong>migration</strong> - let&#x27;s say one wants to migrate an API backend from Ruby on Rails to Java Spring. The server generator can save a lot of time in implementing and verify each endpoint in the new API backend.</li><li><strong>evaluating</strong> - when you want to try a new language or framework, and a typical &quot;Hello, World&quot; is too trivial.</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="java"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#java" title="Direct link to heading">#</a>Java</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that" title="Direct link to heading">#</a>The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?</h3><p>Yes, please refer to <a href="http://stackoverflow.com/a/6055903/677735">http://stackoverflow.com/a/6055903/677735</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-can-i-customize-the-feign-client-templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-can-i-customize-the-feign-client-templates" title="Direct link to heading">#</a>How can I customize the Feign client templates?</h3><p>You will need to provide customized files in <code>Java/libraries/feign</code> under the resources folder and pass the location via the <code>-t</code> option.</p><p>In your Gradle build script, please add the following (example):</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">config.templateDir </span><span class="token operator">=</span><span class="token plain"> &#x27;src/openapi-generator-templates/Java/libraries/feign</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="android"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#android" title="Direct link to heading">#</a>Android</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-can-i-generate-an-android-sdk"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-can-i-generate-an-android-sdk" title="Direct link to heading">#</a>How can I generate an Android SDK?</h3><p><strong>The Java SDK is also compatible with Android.</strong></p><p>[RECOMMENDED] To generate the Java SDK with <code>okhttp</code> and <code>gson</code> libraries, run the following:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean package</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -l java --library</span><span class="token operator">=</span><span class="token plain">okhttp-gson </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  --additional-properties </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">hideGenerationTimestamp</span><span class="token operator">=</span><span class="token plain">true </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -o /var/tmp/java/okhttp-gson/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You can also generate the Java SDK with other HTTP libraries by replacing <code>okhttp-gson</code> with <code>retrofit</code> for example. For a list of support libraries, please run</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -l java</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>To generate the Android SDK with <a href="https://github.com/mcxiaoke/android-volley"><code>volley</code></a>, please run</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean package</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -l android --library</span><span class="token operator">=</span><span class="token plain">volley </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -o /var/tmp/android/volley/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>We do <strong>not</strong> recommend using the default HTTP library (Apache HttpClient) with <code>android</code> as it&#x27;s not actively maintained.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="c-sharp"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-sharp" title="Direct link to heading">#</a>C-Sharp</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-fix-csc--warning-cs2002-in-xamarin"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-fix-csc--warning-cs2002-in-xamarin" title="Direct link to heading">#</a>How do I fix <code>CSC:  warning CS2002</code> in Xamarin?</h3><p>The full warning might look like this: <code>CSC:  warning CS2002: Source file &#x27;Api/FakeApi.cs&#x27; specified multiple times</code></p><p>The warning has no impact on the build process so you should be able to build the solution without issue. The warning should be addressed in the upcoming stable release of Xamarin. </p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="objective-c"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#objective-c" title="Direct link to heading">#</a>Objective-C</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-run-integration-test-with-petstore-objc-api-client"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-run-integration-test-with-petstore-objc-api-client" title="Direct link to heading">#</a>How do I run integration test with Petstore ObjC API client?</h3><p>Here are the steps:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator/samples/client/petstore/objc/default/OpenAPIClientTests</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn integration-test</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Besides <code>default</code> (folder) ObjC API client, there&#x27;s also <code>core-data</code> for another ObjC API client with <a href="https://en.wikipedia.org/wiki/Core_Data">Core Data support</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="swift"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#swift" title="Direct link to heading">#</a>Swift</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="how-do-i-run-integration-test-with-petstore-swift-api-client"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#how-do-i-run-integration-test-with-petstore-swift-api-client" title="Direct link to heading">#</a>How do I run integration test with Petstore Swift API client?</h3><p>Here are the steps:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator/samples/client/petstore/swift/default/OpenAPIClientTests</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn integration-test</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Besides <code>default</code> (folder), there&#x27;s another folder <code>promisekit</code> for Swift API client with <a href="https://github.com/mxcl/PromiseKit">PromiseKit support</a></p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">git</span><span class="token plain"> clone https://github.com/openapitools/openapi-generator.git</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> openapi-generator/samples/client/petstore/swift/promisekit/OpenAPIClientTests</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn integration-test</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="is-swift-2x-generator-still-actively-maintained"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#is-swift-2x-generator-still-actively-maintained" title="Direct link to heading">#</a>Is Swift (2.x) generator still actively maintained?</h3><p>No, please use <code>swift3</code> or <code>swift4</code> generator instead as we want to focus on Swift 3.x, 4.x.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="typescript"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#typescript" title="Direct link to heading">#</a>TypeScript</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming" title="Direct link to heading">#</a>The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?</h3><p>Yes, please use the following option when generating TypeScript clients:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">modelPropertyNaming</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Naming convention </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> the property: </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;camelCase&#x27;</span><span class="token plain">, </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;PascalCase&#x27;</span><span class="token plain">, </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;snake_case&#x27;</span><span class="token plain"> and </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;original&#x27;</span><span class="token plain">, </span><span class="token function" style="color:rgb(80, 250, 123)">which</span><span class="token plain"> keeps the original name </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Default: camelCase</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq-generators.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/faq-contributing"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« FAQ: Contributing</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#what-are-some-server-generator-use-cases" class="contents__link">What are some server generator use cases?</a></li><li><a href="#java" class="contents__link">Java</a><ul><li><a href="#the-api-client-has-ssl-errors-due-to-an-invalid-certificate-is-there-a-way-to-bypass-that" class="contents__link">The API client has SSL errors due to an invalid certificate. Is there a way to bypass that?</a></li><li><a href="#how-can-i-customize-the-feign-client-templates" class="contents__link">How can I customize the Feign client templates?</a></li></ul></li><li><a href="#android" class="contents__link">Android</a><ul><li><a href="#how-can-i-generate-an-android-sdk" class="contents__link">How can I generate an Android SDK?</a></li></ul></li><li><a href="#c-sharp" class="contents__link">C-Sharp</a><ul><li><a href="#how-do-i-fix-csc--warning-cs2002-in-xamarin" class="contents__link">How do I fix <code>CSC:  warning CS2002</code> in Xamarin?</a></li></ul></li><li><a href="#objective-c" class="contents__link">Objective-C</a><ul><li><a href="#how-do-i-run-integration-test-with-petstore-objc-api-client" class="contents__link">How do I run integration test with Petstore ObjC API client?</a></li></ul></li><li><a href="#swift" class="contents__link">Swift</a><ul><li><a href="#how-do-i-run-integration-test-with-petstore-swift-api-client" class="contents__link">How do I run integration test with Petstore Swift API client?</a></li><li><a href="#is-swift-2x-generator-still-actively-maintained" class="contents__link">Is Swift (2.x) generator still actively maintained?</a></li></ul></li><li><a href="#typescript" class="contents__link">TypeScript</a><ul><li><a href="#the-json-response-fails-to-deserialize-due-to-change-in-variable-naming-snake_case-to-camelcase-is-there-any-way-to-keep-the-original-naming" class="contents__link">The JSON response fails to deserialize due to change in variable naming (snake_case to camelCase). Is there any way to keep the original naming?</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/6db4087d.0d3d744a.js"></script>
+<script src="/6db4087d.21fab80e.js"></script>
 
 
 </body>
diff --git a/docs/faq/index.html b/docs/faq/index.html
index caa65530179..56211771b6f 100644
--- a/docs/faq/index.html
+++ b/docs/faq/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">FAQ</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/faq">FAQ: General</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-extending">FAQ: Extending</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-contributing">FAQ: Contributing</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-generators">FAQ: Generators</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">FAQ: General</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="do-you-have-a-chat-room"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#do-you-have-a-chat-room" title="Direct link to heading">#</a>Do you have a chat room?</h2><p><a href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g"><img src="https://img.shields.io/badge/Slack-Join%20the%20chat%20room-orange" alt="Join the Slack chat room"></a></p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="what-is-the-governance-structure-of-the-openapi-generator-project"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#what-is-the-governance-structure-of-the-openapi-generator-project" title="Direct link to heading">#</a>What is the governance structure of the OpenAPI Generator project?</h2><p>OpenAPI generator (openapi-generator) is managed by the members of the <a href="/docs/core-team">core team</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="what-is-the-difference-between-swagger-codegen-and-openapi-generator"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#what-is-the-difference-between-swagger-codegen-and-openapi-generator" title="Direct link to heading">#</a>What is the difference between Swagger Codegen and OpenAPI Generator?</h2><p>Swagger Codegen is driven by SmartBear while OpenAPI Generator is driven by the community. More than 40 top contributors and template creators of Swagger Codegen have joined OpenAPI Generator as the founding team members. For more details, see the <a href="/docs/fork-qna">Fork Q&amp;A</a>.</p><p>Swagger is a trademark owned by SmartBear and the use of the term &quot;Swagger&quot; in this project is for demo (reference) purposes only.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/faq-extending"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">FAQ: Extending »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#do-you-have-a-chat-room" class="contents__link">Do you have a chat room?</a></li><li><a href="#what-is-the-governance-structure-of-the-openapi-generator-project" class="contents__link">What is the governance structure of the OpenAPI Generator project?</a></li><li><a href="#what-is-the-difference-between-swagger-codegen-and-openapi-generator" class="contents__link">What is the difference between Swagger Codegen and OpenAPI Generator?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">FAQ</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/faq">FAQ: General</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-extending">FAQ: Extending</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-contributing">FAQ: Contributing</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq-generators">FAQ: Generators</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">FAQ: General</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="do-you-have-a-chat-room"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#do-you-have-a-chat-room" title="Direct link to heading">#</a>Do you have a chat room?</h2><p><a href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g"><img src="https://img.shields.io/badge/Slack-Join%20the%20chat%20room-orange" alt="Join the Slack chat room"></a></p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="what-is-the-governance-structure-of-the-openapi-generator-project"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#what-is-the-governance-structure-of-the-openapi-generator-project" title="Direct link to heading">#</a>What is the governance structure of the OpenAPI Generator project?</h2><p>OpenAPI generator (openapi-generator) is managed by the members of the <a href="/docs/core-team">core team</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="what-is-the-difference-between-swagger-codegen-and-openapi-generator"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#what-is-the-difference-between-swagger-codegen-and-openapi-generator" title="Direct link to heading">#</a>What is the difference between Swagger Codegen and OpenAPI Generator?</h2><p>Swagger Codegen is driven by SmartBear while OpenAPI Generator is driven by the community. More than 40 top contributors and template creators of Swagger Codegen have joined OpenAPI Generator as the founding team members. For more details, see the <a href="/docs/fork-qna">Fork Q&amp;A</a>.</p><p>Swagger is a trademark owned by SmartBear and the use of the term &quot;Swagger&quot; in this project is for demo (reference) purposes only.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/faq.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/faq-extending"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">FAQ: Extending »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#do-you-have-a-chat-room" class="contents__link">Do you have a chat room?</a></li><li><a href="#what-is-the-governance-structure-of-the-openapi-generator-project" class="contents__link">What is the governance structure of the OpenAPI Generator project?</a></li><li><a href="#what-is-the-difference-between-swagger-codegen-and-openapi-generator" class="contents__link">What is the difference between Swagger Codegen and OpenAPI Generator?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/3d70cde6.b291aef1.js"></script>
+<script src="/3d70cde6.3e5453f3.js"></script>
 
 
 </body>
diff --git a/docs/file-post-processing/index.html b/docs/file-post-processing/index.html
index 975cfcb9568..094d0335122 100644
--- a/docs/file-post-processing/index.html
+++ b/docs/file-post-processing/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">File post-processing</h1></header><div class="markdown"><p>Each tool (CLI and plugins) supports enabling file post-processing at a high-level. Enabling this option allows for generators which support post-processing to call some external process for each generated file, passing the file path to that tool. The external tool must be defined in an environment variable supported by the generator.</p><p>Note that:</p><ul><li>this option is <code>--enable-post-process-file</code> in the CLI and <code>enablePostProcessFile</code> in plugins</li><li>we require <em>both</em> specifying the environment variable <em>and</em> enabling the option at the tooling level; this feature is opt-in for security </li><li>file processing occurs one at a time</li><li>the external tool may be a custom script which invokes multiple tools</li></ul><p>Also refer to the relevant documentation for <a href="/docs/usage">CLI</a>, <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md">Maven Plugin</a>, <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc">Gradle Plugin</a>, or <a href="https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md">SBT Plugin</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-environment-variables"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-environment-variables" title="Direct link to heading">#</a>Supported Environment Variables</h2><p>The following environment variables are supported by their respective generators:</p><ul><li><code>CPP_POST_PROCESS_FILE</code></li><li><code>CSHARP_POST_PROCESS_FILE</code></li><li><code>C_POST_PROCESS_FILE</code></li><li><code>DART_POST_PROCESS_FILE</code></li><li><code>FSHARP_POST_PROCESS_FILE</code></li><li><code>GO_POST_PROCESS_FILE</code></li><li><code>HASKELL_POST_PROCESS_FILE</code></li><li><code>JAVA_POST_PROCESS_FILE</code></li><li><code>JS_POST_PROCESS_FILE</code></li><li><code>KOTLIN_POST_PROCESS_FILE</code></li><li><code>OCAML_POST_PROCESS_FILE</code></li><li><code>PERL_POST_PROCESS_FILE</code></li><li><code>PHP_POST_PROCESS_FILE</code></li><li><code>POWERSHELL_POST_PROCESS_FILE</code></li><li><code>PYTHON_POST_PROCESS_FILE</code></li><li><code>RUBY_POST_PROCESS_FILE</code></li><li><code>RUST_POST_PROCESS_FILE</code></li><li><code>SCALA_POST_PROCESS_FILE</code></li><li><code>SWIFT_POST_PROCESS_FILE</code></li><li><code>TS_POST_PROCESS_FILE</code></li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="example"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#example" title="Direct link to heading">#</a>Example</h2><p>Let&#x27;s see how to pass Ruby generated files to Rubocop, a static code analysis/linter/formatter tool.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># First, export the required environment variable</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">RUBY_POST_PROCESS_FILE</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;/usr/local/bin/rubocop -a&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_DOC</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Invoke the generator with --enable-post-process-file</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator generate --enable-post-process-file -i </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$OPENAPI_DOC</span><span class="token plain"> -g ruby -o .out-ruby/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You will now see messages logged about which files have been processed:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/.rspec</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - Skipped /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator-ignore </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Skipped by supportingFiles options supplied by user.</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/VERSION</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/FILES</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/file-post-processing.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/configuration"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Configuration Options</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/templating"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Using Templates »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#supported-environment-variables" class="contents__link">Supported Environment Variables</a></li><li><a href="#example" class="contents__link">Example</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">File post-processing</h1></header><div class="markdown"><p>Each tool (CLI and plugins) supports enabling file post-processing at a high-level. Enabling this option allows for generators which support post-processing to call some external process for each generated file, passing the file path to that tool. The external tool must be defined in an environment variable supported by the generator.</p><p>Note that:</p><ul><li>this option is <code>--enable-post-process-file</code> in the CLI and <code>enablePostProcessFile</code> in plugins</li><li>we require <em>both</em> specifying the environment variable <em>and</em> enabling the option at the tooling level; this feature is opt-in for security </li><li>file processing occurs one at a time</li><li>the external tool may be a custom script which invokes multiple tools</li></ul><p>Also refer to the relevant documentation for <a href="/docs/usage">CLI</a>, <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md">Maven Plugin</a>, <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc">Gradle Plugin</a>, or <a href="https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md">SBT Plugin</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-environment-variables"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-environment-variables" title="Direct link to heading">#</a>Supported Environment Variables</h2><p>The following environment variables are supported by their respective generators:</p><ul><li><code>CPP_POST_PROCESS_FILE</code></li><li><code>CSHARP_POST_PROCESS_FILE</code></li><li><code>C_POST_PROCESS_FILE</code></li><li><code>DART_POST_PROCESS_FILE</code></li><li><code>FSHARP_POST_PROCESS_FILE</code></li><li><code>GO_POST_PROCESS_FILE</code></li><li><code>HASKELL_POST_PROCESS_FILE</code></li><li><code>JAVA_POST_PROCESS_FILE</code></li><li><code>JS_POST_PROCESS_FILE</code></li><li><code>KOTLIN_POST_PROCESS_FILE</code></li><li><code>OCAML_POST_PROCESS_FILE</code></li><li><code>PERL_POST_PROCESS_FILE</code></li><li><code>PHP_POST_PROCESS_FILE</code></li><li><code>POWERSHELL_POST_PROCESS_FILE</code></li><li><code>PYTHON_POST_PROCESS_FILE</code></li><li><code>RUBY_POST_PROCESS_FILE</code></li><li><code>RUST_POST_PROCESS_FILE</code></li><li><code>SCALA_POST_PROCESS_FILE</code></li><li><code>SWIFT_POST_PROCESS_FILE</code></li><li><code>TS_POST_PROCESS_FILE</code></li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="example"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#example" title="Direct link to heading">#</a>Example</h2><p>Let&#x27;s see how to pass Ruby generated files to Rubocop, a static code analysis/linter/formatter tool.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># First, export the required environment variable</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">RUBY_POST_PROCESS_FILE</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;/usr/local/bin/rubocop -a&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_DOC</span><span class="token operator">=</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Invoke the generator with --enable-post-process-file</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator generate --enable-post-process-file -i </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$OPENAPI_DOC</span><span class="token plain"> -g ruby -o .out-ruby/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You will now see messages logged about which files have been processed:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/.rspec</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.c.languages.AbstractRubyCodegen - Successfully executed: /usr/local/bin/rubocopy -a /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - Skipped /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator-ignore </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">Skipped by supportingFiles options supplied by user.</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/VERSION</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">main</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> INFO  o.o.codegen.TemplateManager - writing </span><span class="token function" style="color:rgb(80, 250, 123)">file</span><span class="token plain"> /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/FILES</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/file-post-processing.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/configuration"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Configuration Options</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/templating"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Using Templates »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#supported-environment-variables" class="contents__link">Supported Environment Variables</a></li><li><a href="#example" class="contents__link">Example</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/47462ed9.6f9c0f5b.js"></script>
+<script src="/47462ed9.77c23de4.js"></script>
 
 
 </body>
diff --git a/docs/fork-qna/index.html b/docs/fork-qna/index.html
index 6d246632f0c..2b73f45c421 100644
--- a/docs/fork-qna/index.html
+++ b/docs/fork-qna/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Swagger Codegen Fork: Q&amp;A</h1></header><div class="markdown"><p>This document aims to answer some questions about the fork for historical reference, where these questions don&#x27;t fit into other documents related to the project itself.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="why-was-it-decided-to-fork-swagger-codegen"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#why-was-it-decided-to-fork-swagger-codegen" title="Direct link to heading">#</a>Why was it decided to fork Swagger Codegen?</h2><p>There are several reasons:</p><ol><li>The founding members felt that Swagger Codegen 3.0.0 was diverging too much from the philosophy of Swagger Codegen 2.x.</li><li>The founding members were concerned that the maintenance overhead of two separate branches (2.x, 3.x) would result in issues similar to those felt in the Python community.</li><li>The founding members wanted a more rapid <a href="https://github.com/OpenAPITools/openapi-generator/releases/">release cycle</a> (weekly patch release, monthly minor release) so users do not need to wait for several months to get a stable release.</li><li>Having a community-driven version allows for innovation, reliability, and a <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/docs/roadmap.md">roadmap</a> owned by the community.</li></ol><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="are-there-any-changes-to-the-project-license"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#are-there-any-changes-to-the-project-license" title="Direct link to heading">#</a>Are there any changes to the project license?</h2><p>No, OpenAPI Generator is still using the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache license (version 2)</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator" title="Direct link to heading">#</a>I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?</h2><p>OpenAPI Generator is based on Swagger Codegen <code>2.4.0-SNAPSHOT</code> version so the migration should be relatively straightforward. Refer to the <a href="/docs/swagger-codegen-migration">migration guide</a> for more information. </p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="who-maintains-this-qa-page"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#who-maintains-this-qa-page" title="Direct link to heading">#</a>Who maintains this Q&amp;A page?</h2><p>This Q&amp;A page is maintained by the <a href="/docs/core-team">core team members</a>. It is not maintained by any single person, nor do these Q&amp;As represent the views of any individual or person.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/qna.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/swagger-codegen-migration"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Migrating from Swagger Codegen</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/release-summary"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Release Summary »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#why-was-it-decided-to-fork-swagger-codegen" class="contents__link">Why was it decided to fork Swagger Codegen?</a></li><li><a href="#are-there-any-changes-to-the-project-license" class="contents__link">Are there any changes to the project license?</a></li><li><a href="#i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator" class="contents__link">I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?</a></li><li><a href="#who-maintains-this-qa-page" class="contents__link">Who maintains this Q&A page?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Swagger Codegen Fork: Q&amp;A</h1></header><div class="markdown"><p>This document aims to answer some questions about the fork for historical reference, where these questions don&#x27;t fit into other documents related to the project itself.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="why-was-it-decided-to-fork-swagger-codegen"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#why-was-it-decided-to-fork-swagger-codegen" title="Direct link to heading">#</a>Why was it decided to fork Swagger Codegen?</h2><p>There are several reasons:</p><ol><li>The founding members felt that Swagger Codegen 3.0.0 was diverging too much from the philosophy of Swagger Codegen 2.x.</li><li>The founding members were concerned that the maintenance overhead of two separate branches (2.x, 3.x) would result in issues similar to those felt in the Python community.</li><li>The founding members wanted a more rapid <a href="https://github.com/OpenAPITools/openapi-generator/releases/">release cycle</a> (weekly patch release, monthly minor release) so users do not need to wait for several months to get a stable release.</li><li>Having a community-driven version allows for innovation, reliability, and a <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/docs/roadmap.md">roadmap</a> owned by the community.</li></ol><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="are-there-any-changes-to-the-project-license"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#are-there-any-changes-to-the-project-license" title="Direct link to heading">#</a>Are there any changes to the project license?</h2><p>No, OpenAPI Generator is still using the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache license (version 2)</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator" title="Direct link to heading">#</a>I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?</h2><p>OpenAPI Generator is based on Swagger Codegen <code>2.4.0-SNAPSHOT</code> version so the migration should be relatively straightforward. Refer to the <a href="/docs/swagger-codegen-migration">migration guide</a> for more information. </p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="who-maintains-this-qa-page"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#who-maintains-this-qa-page" title="Direct link to heading">#</a>Who maintains this Q&amp;A page?</h2><p>This Q&amp;A page is maintained by the <a href="/docs/core-team">core team members</a>. It is not maintained by any single person, nor do these Q&amp;As represent the views of any individual or person.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/qna.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/swagger-codegen-migration"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Migrating from Swagger Codegen</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/release-summary"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Release Summary »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#why-was-it-decided-to-fork-swagger-codegen" class="contents__link">Why was it decided to fork Swagger Codegen?</a></li><li><a href="#are-there-any-changes-to-the-project-license" class="contents__link">Are there any changes to the project license?</a></li><li><a href="#i-am-currently-using-swagger-codegen-2x-how-can-i-upgrade-the-generator-to-openapi-generator" class="contents__link">I am currently using Swagger Codegen 2.x. How can I upgrade the generator to OpenAPI Generator?</a></li><li><a href="#who-maintains-this-qa-page" class="contents__link">Who maintains this Q&A page?</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/773b7ddf.efe0e210.js"></script>
+<script src="/773b7ddf.956b3208.js"></script>
 
 
 </body>
diff --git a/docs/generators/README/index.html b/docs/generators/README/index.html
index f3078936adc..e6ff60bdb2c 100644
--- a/docs/generators/README/index.html
+++ b/docs/generators/README/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">README</h1></header><div class="markdown"><p>The following generators are available:</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="client-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-generators" title="Direct link to heading">#</a>CLIENT generators</h2><ul><li><a href="/docs/generators/ada">ada</a>  </li><li><a href="/docs/generators/android">android</a>  </li><li><a href="/docs/generators/apex">apex</a>  </li><li><a href="/docs/generators/bash">bash</a>  </li><li><a href="/docs/generators/c">c</a>  </li><li><a href="/docs/generators/clojure">clojure</a>  </li><li><a href="cpp-qt5-client.md">cpp-qt5-client</a>  </li><li><a href="/docs/generators/cpp-restsdk">cpp-restsdk</a>  </li><li><a href="/docs/generators/cpp-tizen">cpp-tizen</a>  </li><li><a href="/docs/generators/csharp">csharp</a>  </li><li><a href="/docs/generators/csharp-netcore">csharp-netcore</a>  </li><li><a href="/docs/generators/dart">dart</a>  </li><li><a href="dart-dio.md">dart-dio</a>  </li><li><a href="/docs/generators/eiffel">eiffel</a>  </li><li><a href="/docs/generators/elixir">elixir</a>  </li><li><a href="/docs/generators/elm">elm</a>  </li><li><a href="/docs/generators/erlang-client">erlang-client</a>  </li><li><a href="/docs/generators/erlang-proper">erlang-proper</a>  </li><li><a href="/docs/generators/go">go</a>  </li><li><a href="/docs/generators/go-experimental">go-experimental (experimental)</a>  </li><li><a href="/docs/generators/groovy">groovy</a>  </li><li><a href="/docs/generators/haskell-http-client">haskell-http-client</a>  </li><li><a href="/docs/generators/java">java</a>  </li><li><a href="/docs/generators/javascript">javascript</a>  </li><li><a href="/docs/generators/javascript-closure-angular">javascript-closure-angular</a>  </li><li><a href="/docs/generators/javascript-flowtyped">javascript-flowtyped</a>  </li><li><a href="/docs/generators/jaxrs-cxf-client">jaxrs-cxf-client</a>  </li><li><a href="/docs/generators/jmeter">jmeter</a>  </li><li><a href="/docs/generators/kotlin">kotlin</a>  </li><li><a href="/docs/generators/lua">lua</a>  </li><li><a href="/docs/generators/nim">nim (beta)</a>  </li><li><a href="/docs/generators/objc">objc</a>  </li><li><a href="/docs/generators/ocaml">ocaml</a>  </li><li><a href="/docs/generators/perl">perl</a>  </li><li><a href="/docs/generators/php">php</a>  </li><li><a href="/docs/generators/php-dt">php-dt</a>  </li><li><a href="/docs/generators/powershell">powershell</a>  </li><li><a href="/docs/generators/python">python</a></li><li><a href="/docs/generators/python-legacy">python-legacy</a></li><li><a href="/docs/generators/r">r</a>  </li><li><a href="/docs/generators/ruby">ruby</a>  </li><li><a href="/docs/generators/rust">rust</a>  </li><li><a href="/docs/generators/scala-akka">scala-akka</a>  </li><li><a href="/docs/generators/scala-gatling">scala-gatling</a>  </li><li><a href="/docs/generators/scalaz">scalaz</a>  </li><li><a href="swift4.md">swift4</a>  </li><li><a href="/docs/generators/swift5">swift5 (beta)</a>  </li><li><a href="/docs/generators/typescript-angular">typescript-angular</a>  </li><li><a href="typescript-angularjs.md">typescript-angularjs</a>  </li><li><a href="/docs/generators/typescript-aurelia">typescript-aurelia</a>  </li><li><a href="/docs/generators/typescript-axios">typescript-axios</a>  </li><li><a href="/docs/generators/typescript-fetch">typescript-fetch</a>  </li><li><a href="/docs/generators/typescript-inversify">typescript-inversify</a>  </li><li><a href="/docs/generators/typescript-jquery">typescript-jquery</a>  </li><li><a href="/docs/generators/typescript-node">typescript-node</a>  </li><li><a href="/docs/generators/typescript-redux-query">typescript-redux-query</a>  </li><li><a href="/docs/generators/typescript-rxjs">typescript-rxjs</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="server-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#server-generators" title="Direct link to heading">#</a>SERVER generators</h2><ul><li><a href="/docs/generators/ada-server">ada-server</a>  </li><li><a href="/docs/generators/aspnetcore">aspnetcore</a>  </li><li><a href="/docs/generators/cpp-pistache-server">cpp-pistache-server</a>  </li><li><a href="cpp-qt5-qhttpengine-server.md">cpp-qt5-qhttpengine-server</a>  </li><li><a href="/docs/generators/cpp-restbed-server">cpp-restbed-server</a>  </li><li><a href="/docs/generators/erlang-server">erlang-server</a>  </li><li><a href="/docs/generators/fsharp-functions">fsharp-functions (beta)</a>  </li><li><a href="/docs/generators/fsharp-giraffe-server">fsharp-giraffe-server (beta)</a>  </li><li><a href="/docs/generators/go-gin-server">go-gin-server</a>  </li><li><a href="/docs/generators/go-server">go-server</a>  </li><li><a href="/docs/generators/graphql-nodejs-express-server">graphql-nodejs-express-server</a>  </li><li><a href="/docs/generators/haskell">haskell</a>  </li><li><a href="/docs/generators/java-inflector">java-inflector</a>  </li><li><a href="/docs/generators/java-msf4j">java-msf4j</a>  </li><li><a href="/docs/generators/java-pkmst">java-pkmst</a>  </li><li><a href="/docs/generators/java-play-framework">java-play-framework</a>  </li><li><a href="/docs/generators/java-undertow-server">java-undertow-server</a>  </li><li><a href="/docs/generators/java-vertx">java-vertx</a>  </li><li><a href="/docs/generators/java-vertx-web">java-vertx-web (beta)</a>  </li><li><a href="/docs/generators/jaxrs-cxf">jaxrs-cxf</a>  </li><li><a href="/docs/generators/jaxrs-cxf-cdi">jaxrs-cxf-cdi</a>  </li><li><a href="/docs/generators/jaxrs-cxf-extended">jaxrs-cxf-extended</a>  </li><li><a href="/docs/generators/jaxrs-jersey">jaxrs-jersey</a>  </li><li><a href="/docs/generators/jaxrs-resteasy">jaxrs-resteasy</a>  </li><li><a href="/docs/generators/jaxrs-resteasy-eap">jaxrs-resteasy-eap</a>  </li><li><a href="/docs/generators/jaxrs-spec">jaxrs-spec</a>  </li><li><a href="/docs/generators/kotlin-server">kotlin-server</a>  </li><li><a href="/docs/generators/kotlin-spring">kotlin-spring</a>  </li><li><a href="/docs/generators/kotlin-vertx">kotlin-vertx (beta)</a>  </li><li><a href="/docs/generators/nodejs-express-server">nodejs-express-server (beta)</a>  </li><li><a href="/docs/generators/php-laravel">php-laravel</a>  </li><li><a href="/docs/generators/php-lumen">php-lumen</a>  </li><li><a href="/docs/generators/php-mezzio-ph">php-mezzio-ph</a>  </li><li><a href="/docs/generators/php-slim4">php-slim4</a>  </li><li><a href="/docs/generators/php-symfony">php-symfony</a>  </li><li><a href="/docs/generators/python-aiohttp">python-aiohttp</a>  </li><li><a href="/docs/generators/python-blueplanet">python-blueplanet</a>  </li><li><a href="/docs/generators/python-flask">python-flask</a>  </li><li><a href="/docs/generators/ruby-on-rails">ruby-on-rails</a>  </li><li><a href="/docs/generators/ruby-sinatra">ruby-sinatra</a>  </li><li><a href="/docs/generators/rust-server">rust-server</a>  </li><li><a href="/docs/generators/scala-finch">scala-finch</a>  </li><li><a href="/docs/generators/scala-lagom-server">scala-lagom-server</a>  </li><li><a href="/docs/generators/scala-play-server">scala-play-server</a>  </li><li><a href="/docs/generators/scalatra">scalatra</a>  </li><li><a href="/docs/generators/spring">spring</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-generators" title="Direct link to heading">#</a>DOCUMENTATION generators</h2><ul><li><a href="/docs/generators/asciidoc">asciidoc</a>  </li><li><a href="/docs/generators/cwiki">cwiki</a>  </li><li><a href="/docs/generators/dynamic-html">dynamic-html</a>  </li><li><a href="/docs/generators/html">html</a>  </li><li><a href="/docs/generators/html2">html2</a>  </li><li><a href="/docs/generators/markdown">markdown (beta)</a>  </li><li><a href="/docs/generators/openapi">openapi</a>  </li><li><a href="/docs/generators/openapi-yaml">openapi-yaml</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-generators" title="Direct link to heading">#</a>SCHEMA generators</h2><ul><li><a href="/docs/generators/avro-schema">avro-schema (beta)</a>  </li><li><a href="/docs/generators/mysql-schema">mysql-schema</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-generators" title="Direct link to heading">#</a>CONFIG generators</h2><ul><li><a href="/docs/generators/apache2">apache2</a>  </li><li><a href="/docs/generators/graphql-schema">graphql-schema</a>  </li><li><a href="/docs/generators/protobuf-schema">protobuf-schema (beta)</a>  </li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/README.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#client-generators" class="contents__link">CLIENT generators</a></li><li><a href="#server-generators" class="contents__link">SERVER generators</a></li><li><a href="#documentation-generators" class="contents__link">DOCUMENTATION generators</a></li><li><a href="#schema-generators" class="contents__link">SCHEMA generators</a></li><li><a href="#config-generators" class="contents__link">CONFIG generators</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">README</h1></header><div class="markdown"><p>The following generators are available:</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="client-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-generators" title="Direct link to heading">#</a>CLIENT generators</h2><ul><li><a href="/docs/generators/ada">ada</a>  </li><li><a href="/docs/generators/android">android</a>  </li><li><a href="/docs/generators/apex">apex</a>  </li><li><a href="/docs/generators/bash">bash</a>  </li><li><a href="/docs/generators/c">c</a>  </li><li><a href="/docs/generators/clojure">clojure</a>  </li><li><a href="cpp-qt5-client.md">cpp-qt5-client</a>  </li><li><a href="/docs/generators/cpp-restsdk">cpp-restsdk</a>  </li><li><a href="/docs/generators/cpp-tizen">cpp-tizen</a>  </li><li><a href="/docs/generators/csharp">csharp</a>  </li><li><a href="/docs/generators/csharp-netcore">csharp-netcore</a>  </li><li><a href="/docs/generators/dart">dart</a>  </li><li><a href="dart-dio.md">dart-dio</a>  </li><li><a href="/docs/generators/eiffel">eiffel</a>  </li><li><a href="/docs/generators/elixir">elixir</a>  </li><li><a href="/docs/generators/elm">elm</a>  </li><li><a href="/docs/generators/erlang-client">erlang-client</a>  </li><li><a href="/docs/generators/erlang-proper">erlang-proper</a>  </li><li><a href="/docs/generators/go">go</a>  </li><li><a href="/docs/generators/go-experimental">go-experimental (experimental)</a>  </li><li><a href="/docs/generators/groovy">groovy</a>  </li><li><a href="/docs/generators/haskell-http-client">haskell-http-client</a>  </li><li><a href="/docs/generators/java">java</a>  </li><li><a href="/docs/generators/javascript">javascript</a>  </li><li><a href="/docs/generators/javascript-closure-angular">javascript-closure-angular</a>  </li><li><a href="/docs/generators/javascript-flowtyped">javascript-flowtyped</a>  </li><li><a href="/docs/generators/jaxrs-cxf-client">jaxrs-cxf-client</a>  </li><li><a href="/docs/generators/jmeter">jmeter</a>  </li><li><a href="/docs/generators/kotlin">kotlin</a>  </li><li><a href="/docs/generators/lua">lua</a>  </li><li><a href="/docs/generators/nim">nim (beta)</a>  </li><li><a href="/docs/generators/objc">objc</a>  </li><li><a href="/docs/generators/ocaml">ocaml</a>  </li><li><a href="/docs/generators/perl">perl</a>  </li><li><a href="/docs/generators/php">php</a>  </li><li><a href="/docs/generators/php-dt">php-dt</a>  </li><li><a href="/docs/generators/powershell">powershell</a>  </li><li><a href="/docs/generators/python">python</a></li><li><a href="/docs/generators/python-legacy">python-legacy</a></li><li><a href="/docs/generators/r">r</a>  </li><li><a href="/docs/generators/ruby">ruby</a>  </li><li><a href="/docs/generators/rust">rust</a>  </li><li><a href="/docs/generators/scala-akka">scala-akka</a>  </li><li><a href="/docs/generators/scala-gatling">scala-gatling</a>  </li><li><a href="/docs/generators/scalaz">scalaz</a>  </li><li><a href="swift4.md">swift4</a>  </li><li><a href="/docs/generators/swift5">swift5 (beta)</a>  </li><li><a href="/docs/generators/typescript-angular">typescript-angular</a>  </li><li><a href="typescript-angularjs.md">typescript-angularjs</a>  </li><li><a href="/docs/generators/typescript-aurelia">typescript-aurelia</a>  </li><li><a href="/docs/generators/typescript-axios">typescript-axios</a>  </li><li><a href="/docs/generators/typescript-fetch">typescript-fetch</a>  </li><li><a href="/docs/generators/typescript-inversify">typescript-inversify</a>  </li><li><a href="/docs/generators/typescript-jquery">typescript-jquery</a>  </li><li><a href="/docs/generators/typescript-node">typescript-node</a>  </li><li><a href="/docs/generators/typescript-redux-query">typescript-redux-query</a>  </li><li><a href="/docs/generators/typescript-rxjs">typescript-rxjs</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="server-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#server-generators" title="Direct link to heading">#</a>SERVER generators</h2><ul><li><a href="/docs/generators/ada-server">ada-server</a>  </li><li><a href="/docs/generators/aspnetcore">aspnetcore</a>  </li><li><a href="/docs/generators/cpp-pistache-server">cpp-pistache-server</a>  </li><li><a href="cpp-qt5-qhttpengine-server.md">cpp-qt5-qhttpengine-server</a>  </li><li><a href="/docs/generators/cpp-restbed-server">cpp-restbed-server</a>  </li><li><a href="/docs/generators/erlang-server">erlang-server</a>  </li><li><a href="/docs/generators/fsharp-functions">fsharp-functions (beta)</a>  </li><li><a href="/docs/generators/fsharp-giraffe-server">fsharp-giraffe-server (beta)</a>  </li><li><a href="/docs/generators/go-gin-server">go-gin-server</a>  </li><li><a href="/docs/generators/go-server">go-server</a>  </li><li><a href="/docs/generators/graphql-nodejs-express-server">graphql-nodejs-express-server</a>  </li><li><a href="/docs/generators/haskell">haskell</a>  </li><li><a href="/docs/generators/java-inflector">java-inflector</a>  </li><li><a href="/docs/generators/java-msf4j">java-msf4j</a>  </li><li><a href="/docs/generators/java-pkmst">java-pkmst</a>  </li><li><a href="/docs/generators/java-play-framework">java-play-framework</a>  </li><li><a href="/docs/generators/java-undertow-server">java-undertow-server</a>  </li><li><a href="/docs/generators/java-vertx">java-vertx</a>  </li><li><a href="/docs/generators/java-vertx-web">java-vertx-web (beta)</a>  </li><li><a href="/docs/generators/jaxrs-cxf">jaxrs-cxf</a>  </li><li><a href="/docs/generators/jaxrs-cxf-cdi">jaxrs-cxf-cdi</a>  </li><li><a href="/docs/generators/jaxrs-cxf-extended">jaxrs-cxf-extended</a>  </li><li><a href="/docs/generators/jaxrs-jersey">jaxrs-jersey</a>  </li><li><a href="/docs/generators/jaxrs-resteasy">jaxrs-resteasy</a>  </li><li><a href="/docs/generators/jaxrs-resteasy-eap">jaxrs-resteasy-eap</a>  </li><li><a href="/docs/generators/jaxrs-spec">jaxrs-spec</a>  </li><li><a href="/docs/generators/kotlin-server">kotlin-server</a>  </li><li><a href="/docs/generators/kotlin-spring">kotlin-spring</a>  </li><li><a href="/docs/generators/kotlin-vertx">kotlin-vertx (beta)</a>  </li><li><a href="/docs/generators/nodejs-express-server">nodejs-express-server (beta)</a>  </li><li><a href="/docs/generators/php-laravel">php-laravel</a>  </li><li><a href="/docs/generators/php-lumen">php-lumen</a>  </li><li><a href="/docs/generators/php-mezzio-ph">php-mezzio-ph</a>  </li><li><a href="/docs/generators/php-slim4">php-slim4</a>  </li><li><a href="/docs/generators/php-symfony">php-symfony</a>  </li><li><a href="/docs/generators/python-aiohttp">python-aiohttp</a>  </li><li><a href="/docs/generators/python-blueplanet">python-blueplanet</a>  </li><li><a href="/docs/generators/python-flask">python-flask</a>  </li><li><a href="/docs/generators/ruby-on-rails">ruby-on-rails</a>  </li><li><a href="/docs/generators/ruby-sinatra">ruby-sinatra</a>  </li><li><a href="/docs/generators/rust-server">rust-server</a>  </li><li><a href="/docs/generators/scala-finch">scala-finch</a>  </li><li><a href="/docs/generators/scala-lagom-server">scala-lagom-server</a>  </li><li><a href="/docs/generators/scala-play-server">scala-play-server</a>  </li><li><a href="/docs/generators/scalatra">scalatra</a>  </li><li><a href="/docs/generators/spring">spring</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-generators" title="Direct link to heading">#</a>DOCUMENTATION generators</h2><ul><li><a href="/docs/generators/asciidoc">asciidoc</a>  </li><li><a href="/docs/generators/cwiki">cwiki</a>  </li><li><a href="/docs/generators/dynamic-html">dynamic-html</a>  </li><li><a href="/docs/generators/html">html</a>  </li><li><a href="/docs/generators/html2">html2</a>  </li><li><a href="/docs/generators/markdown">markdown (beta)</a>  </li><li><a href="/docs/generators/openapi">openapi</a>  </li><li><a href="/docs/generators/openapi-yaml">openapi-yaml</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-generators" title="Direct link to heading">#</a>SCHEMA generators</h2><ul><li><a href="/docs/generators/avro-schema">avro-schema (beta)</a>  </li><li><a href="/docs/generators/mysql-schema">mysql-schema</a>  </li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-generators"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-generators" title="Direct link to heading">#</a>CONFIG generators</h2><ul><li><a href="/docs/generators/apache2">apache2</a>  </li><li><a href="/docs/generators/graphql-schema">graphql-schema</a>  </li><li><a href="/docs/generators/protobuf-schema">protobuf-schema (beta)</a>  </li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/README.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#client-generators" class="contents__link">CLIENT generators</a></li><li><a href="#server-generators" class="contents__link">SERVER generators</a></li><li><a href="#documentation-generators" class="contents__link">DOCUMENTATION generators</a></li><li><a href="#schema-generators" class="contents__link">SCHEMA generators</a></li><li><a href="#config-generators" class="contents__link">CONFIG generators</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/7eeb204a.287f1ae6.js"></script>
+<script src="/7eeb204a.89e49b42.js"></script>
 
 
 </body>
diff --git a/docs/generators/ada-server/index.html b/docs/generators/ada-server/index.html
index 3faa06bba79..d6591b72f78 100644
--- a/docs/generators/ada-server/index.html
+++ b/docs/generators/ada-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/ada/index.html b/docs/generators/ada/index.html
index 4bc721c924e..2df3df78ace 100644
--- a/docs/generators/ada/index.html
+++ b/docs/generators/ada/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/android/index.html b/docs/generators/android/index.html
index 6e1b6cb2b37..43ef67297fb 100644
--- a/docs/generators/android/index.html
+++ b/docs/generators/android/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/apache2/index.html b/docs/generators/apache2/index.html
index ea6e2531363..2e2141f2d4f 100644
--- a/docs/generators/apache2/index.html
+++ b/docs/generators/apache2/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/apex/index.html b/docs/generators/apex/index.html
index 92752eb262a..33fc0b844fd 100644
--- a/docs/generators/apex/index.html
+++ b/docs/generators/apex/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/asciidoc/index.html b/docs/generators/asciidoc/index.html
index 1a72a692bed..6464d489117 100644
--- a/docs/generators/asciidoc/index.html
+++ b/docs/generators/asciidoc/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/aspnetcore/index.html b/docs/generators/aspnetcore/index.html
index 304a8c933e2..d7f7bcd17a1 100644
--- a/docs/generators/aspnetcore/index.html
+++ b/docs/generators/aspnetcore/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/avro-schema/index.html b/docs/generators/avro-schema/index.html
index 97e6f0037da..fc6566ba775 100644
--- a/docs/generators/avro-schema/index.html
+++ b/docs/generators/avro-schema/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/bash/index.html b/docs/generators/bash/index.html
index bbb98759755..ce8c38ee814 100644
--- a/docs/generators/bash/index.html
+++ b/docs/generators/bash/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/c/index.html b/docs/generators/c/index.html
index 00bb899dacb..0d732a90e6e 100644
--- a/docs/generators/c/index.html
+++ b/docs/generators/c/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/clojure/index.html b/docs/generators/clojure/index.html
index b998285af0b..8d9f9945f4e 100644
--- a/docs/generators/clojure/index.html
+++ b/docs/generators/clojure/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-pistache-server/index.html b/docs/generators/cpp-pistache-server/index.html
index 27fe53ea079..adf9297d461 100644
--- a/docs/generators/cpp-pistache-server/index.html
+++ b/docs/generators/cpp-pistache-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-qt-client/index.html b/docs/generators/cpp-qt-client/index.html
index 1e6ce20a168..aad00752f77 100644
--- a/docs/generators/cpp-qt-client/index.html
+++ b/docs/generators/cpp-qt-client/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-qt-qhttpengine-server/index.html b/docs/generators/cpp-qt-qhttpengine-server/index.html
index f66ea0e083f..468672e7fdd 100644
--- a/docs/generators/cpp-qt-qhttpengine-server/index.html
+++ b/docs/generators/cpp-qt-qhttpengine-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-restbed-server/index.html b/docs/generators/cpp-restbed-server/index.html
index c9b80b63b88..b9151a742bf 100644
--- a/docs/generators/cpp-restbed-server/index.html
+++ b/docs/generators/cpp-restbed-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-restsdk/index.html b/docs/generators/cpp-restsdk/index.html
index 078d76852be..9526b842e4a 100644
--- a/docs/generators/cpp-restsdk/index.html
+++ b/docs/generators/cpp-restsdk/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-tiny/index.html b/docs/generators/cpp-tiny/index.html
index 29ce5281ec2..3e608639ff7 100644
--- a/docs/generators/cpp-tiny/index.html
+++ b/docs/generators/cpp-tiny/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-tizen/index.html b/docs/generators/cpp-tizen/index.html
index 9e8dba20446..ff96bcb9549 100644
--- a/docs/generators/cpp-tizen/index.html
+++ b/docs/generators/cpp-tizen/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cpp-ue4/index.html b/docs/generators/cpp-ue4/index.html
index 918f61df97d..ee33e3a38da 100644
--- a/docs/generators/cpp-ue4/index.html
+++ b/docs/generators/cpp-ue4/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/crystal/index.html b/docs/generators/crystal/index.html
index dd43483411a..5d33979677b 100644
--- a/docs/generators/crystal/index.html
+++ b/docs/generators/crystal/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/csharp-dotnet2/index.html b/docs/generators/csharp-dotnet2/index.html
index ec298a485e1..3c9806438d1 100644
--- a/docs/generators/csharp-dotnet2/index.html
+++ b/docs/generators/csharp-dotnet2/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/csharp-netcore-functions/index.html b/docs/generators/csharp-netcore-functions/index.html
index a82a9672701..8bb1de083a8 100644
--- a/docs/generators/csharp-netcore-functions/index.html
+++ b/docs/generators/csharp-netcore-functions/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the csharp-netcore-functions Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>csharp-netcore-functions</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>STABLE</td><td></td></tr><tr><td>generator type</td><td>SERVER</td><td></td></tr><tr><td>generator language</td><td>C#</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Generates an ASP.NET Core Web API server.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>azureFunctionsVersion</td><td>Azure functions version: v4, v3</td><td><dl><dt><strong>v4</strong></dt><dd>Azure Functions v4</dd><dt><strong>v3</strong></dt><dd>Azure Functions v3</dd></dl></td><td>v4</td></tr><tr><td>buildTarget</td><td>Target to build an application or library</td><td><dl><dt><strong>program</strong></dt><dd>Generate code for a standalone server</dd><dt><strong>library</strong></dt><dd>Generate code for a server abstract class library</dd></dl></td><td>program</td></tr><tr><td>classModifier</td><td>Class Modifier for function classes: Empty string or abstract.</td><td></td><td></td></tr><tr><td>enumNameSuffix</td><td>Suffix that will be appended to all enum names.</td><td></td><td>Enum</td></tr><tr><td>enumValueSuffix</td><td>Suffix that will be appended to all enum values.</td><td></td><td>Enum</td></tr><tr><td>generateBody</td><td>Generates method body.</td><td></td><td>true</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>NoLicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://localhost">http://localhost</a></td></tr><tr><td>modelClassModifier</td><td>Model Class Modifier can be nothing or partial</td><td></td><td>partial</td></tr><tr><td>netCoreVersion</td><td>.NET Core version: 6.0, 5.0, 3.1, 3.0</td><td><dl><dt><strong>3.0</strong></dt><dd>.NET Core 3.0</dd><dt><strong>3.1</strong></dt><dd>.NET Core 3.1</dd><dt><strong>5.0</strong></dt><dd>.NET Core 5.0</dd><dt><strong>6.0</strong></dt><dd>.NET Core 6.0</dd></dl></td><td>3.1</td></tr><tr><td>newtonsoftVersion</td><td>Version for Newtonsoft.Json for .NET Core 3.0+</td><td></td><td>3.0.0</td></tr><tr><td>nullableReferenceTypes</td><td>Use nullable annotations in the project. Only supported on C# 8 / ASP.NET Core 3.1 or newer.</td><td></td><td>false</td></tr><tr><td>operationIsAsync</td><td>Set methods to async or sync (default).</td><td></td><td>false</td></tr><tr><td>operationModifier</td><td>Operation Modifier can be virtual or abstract</td><td><dl><dt><strong>virtual</strong></dt><dd>Keep method virtual</dd><dt><strong>abstract</strong></dt><dd>Make method abstract</dd></dl></td><td>virtual</td></tr><tr><td>operationResultTask</td><td>Set methods result to Task&lt;&gt;.</td><td></td><td>false</td></tr><tr><td>packageAuthors</td><td>Specifies Authors property in the .NET Core project file.</td><td></td><td>OpenAPI</td></tr><tr><td>packageCopyright</td><td>Specifies an AssemblyCopyright for the .NET Framework global assembly attributes stored in the AssemblyInfo file.</td><td></td><td>No Copyright</td></tr><tr><td>packageDescription</td><td>Specifies a AssemblyDescription for the .NET Framework global assembly attributes stored in the AssemblyInfo file.</td><td></td><td>A library generated from a OpenAPI doc</td></tr><tr><td>packageGuid</td><td>The GUID that will be associated with the C# project</td><td></td><td>null</td></tr><tr><td>packageName</td><td>C# package name (convention: Title.Case).</td><td></td><td>Org.OpenAPITools</td></tr><tr><td>packageTitle</td><td>Specifies an AssemblyTitle for the .NET Framework global assembly attributes stored in the AssemblyInfo file.</td><td></td><td>OpenAPI Library</td></tr><tr><td>packageVersion</td><td>C# package version.</td><td></td><td>1.0.0</td></tr><tr><td>returnICollection</td><td>Return ICollection&lt;T&gt; instead of the concrete type.</td><td></td><td>false</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src</td></tr><tr><td>useCollection</td><td>Deserialize array types to Collection&lt;T&gt; instead of List&lt;T&gt;.</td><td></td><td>false</td></tr><tr><td>useDateTimeOffset</td><td>Use DateTimeOffset to model date-time properties</td><td></td><td>false</td></tr><tr><td>useNewtonsoft</td><td>Uses the Newtonsoft JSON library.</td><td></td><td>true</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>List</td></tr><tr><td>list</td><td>List</td></tr><tr><td>map</td><td>Dictionary</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Collection</li><li>DateTime</li><li>DateTime?</li><li>DateTimeOffset</li><li>DateTimeOffset?</li><li>Decimal</li><li>Dictionary</li><li>Double</li><li>Float</li><li>Guid</li><li>Guid?</li><li>ICollection</li><li>Int32</li><li>Int64</li><li>List</li><li>Object</li><li>String</li><li>System.IO.Stream</li><li>bool</li><li>bool?</li><li>byte[]</li><li>decimal</li><li>decimal?</li><li>double</li><li>double?</li><li>float</li><li>float?</li><li>int</li><li>int?</li><li>long</li><li>long?</li><li>string</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>Client</li><li>Configuration</li><li>Version</li><li>abstract</li><li>as</li><li>async</li><li>await</li><li>base</li><li>bool</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>checked</li><li>class</li><li>client</li><li>const</li><li>continue</li><li>decimal</li><li>default</li><li>delegate</li><li>do</li><li>double</li><li>dynamic</li><li>else</li><li>enum</li><li>event</li><li>explicit</li><li>extern</li><li>false</li><li>finally</li><li>fixed</li><li>float</li><li>for</li><li>foreach</li><li>goto</li><li>if</li><li>implicit</li><li>in</li><li>int</li><li>interface</li><li>internal</li><li>is</li><li>localVarFileParams</li><li>localVarFormParams</li><li>localVarHeaderParams</li><li>localVarHttpContentType</li><li>localVarHttpContentTypes</li><li>localVarHttpHeaderAccept</li><li>localVarHttpHeaderAccepts</li><li>localVarPath</li><li>localVarPathParams</li><li>localVarPostBody</li><li>localVarQueryParams</li><li>localVarResponse</li><li>localVarStatusCode</li><li>lock</li><li>long</li><li>namespace</li><li>new</li><li>null</li><li>object</li><li>operator</li><li>out</li><li>override</li><li>parameter</li><li>params</li><li>private</li><li>protected</li><li>public</li><li>readonly</li><li>ref</li><li>return</li><li>sbyte</li><li>sealed</li><li>short</li><li>sizeof</li><li>stackalloc</li><li>static</li><li>string</li><li>struct</li><li>switch</li><li>this</li><li>throw</li><li>true</li><li>try</li><li>typeof</li><li>uint</li><li>ulong</li><li>unchecked</li><li>unsafe</li><li>ushort</li><li>using</li><li>var</li><li>virtual</li><li>void</li><li>volatile</li><li>while</li><li>yield</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✓</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/csharp-netcore-functions.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-17T16:36:09.000Z" class="docLastUpdatedAt_1sqk">2022-4-17</time> by <strong>Justin Black</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the csharp-netcore-functions Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>csharp-netcore-functions</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>STABLE</td><td></td></tr><tr><td>generator type</td><td>SERVER</td><td></td></tr><tr><td>generator language</td><td>C#</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Creates Azure function templates on top of the models/converters created by the C# codegens. This function is contained in a partial class. Default Get/Create/Patch/Post etc. methods are created with an underscore prefix. The assumption is that when the function is implemented, the partial class will be completed with another partial class. The implementing code should be located in a method of the same name, only without the underscore prefix. If no such method is found then the function will throw a Not Implemented exception. This setup allows the endpoints to be specified in the schema at build time, and separated from the implementing function.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>azureFunctionsVersion</td><td>Azure functions version: v4, v3</td><td><dl><dt><strong>v4</strong></dt><dd>Azure Functions v4</dd><dt><strong>v3</strong></dt><dd>Azure Functions v3</dd></dl></td><td>v4</td></tr><tr><td>buildTarget</td><td>Target to build an application or library</td><td><dl><dt><strong>program</strong></dt><dd>Generate code for a standalone server</dd><dt><strong>library</strong></dt><dd>Generate code for a server abstract class library</dd></dl></td><td>program</td></tr><tr><td>classModifier</td><td>Class Modifier for function classes: Empty string or abstract.</td><td></td><td></td></tr><tr><td>enumNameSuffix</td><td>Suffix that will be appended to all enum names.</td><td></td><td>Enum</td></tr><tr><td>enumValueSuffix</td><td>Suffix that will be appended to all enum values.</td><td></td><td>Enum</td></tr><tr><td>generateBody</td><td>Generates method body.</td><td></td><td>true</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>NoLicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://localhost">http://localhost</a></td></tr><tr><td>modelClassModifier</td><td>Model Class Modifier can be nothing or partial</td><td></td><td>partial</td></tr><tr><td>netCoreVersion</td><td>.NET Core version: 6.0, 5.0, 3.1, 3.0</td><td><dl><dt><strong>3.0</strong></dt><dd>.NET Core 3.0</dd><dt><strong>3.1</strong></dt><dd>.NET Core 3.1</dd><dt><strong>5.0</strong></dt><dd>.NET Core 5.0</dd><dt><strong>6.0</strong></dt><dd>.NET Core 6.0</dd></dl></td><td>3.1</td></tr><tr><td>newtonsoftVersion</td><td>Version for Newtonsoft.Json for .NET Core 3.0+</td><td></td><td>3.0.0</td></tr><tr><td>nullableReferenceTypes</td><td>Use nullable annotations in the project. Only supported on C# 8 / ASP.NET Core 3.1 or newer.</td><td></td><td>false</td></tr><tr><td>operationIsAsync</td><td>Set methods to async or sync (default).</td><td></td><td>false</td></tr><tr><td>operationModifier</td><td>Operation Modifier can be virtual or abstract</td><td><dl><dt><strong>virtual</strong></dt><dd>Keep method virtual</dd><dt><strong>abstract</strong></dt><dd>Make method abstract</dd></dl></td><td>virtual</td></tr><tr><td>operationResultTask</td><td>Set methods result to Task&lt;&gt;.</td><td></td><td>false</td></tr><tr><td>packageAuthors</td><td>Specifies Authors property in the .NET Core project file.</td><td></td><td>OpenAPI</td></tr><tr><td>packageCopyright</td><td>Specifies an AssemblyCopyright for the .NET Framework global assembly attributes stored in the AssemblyInfo file.</td><td></td><td>No Copyright</td></tr><tr><td>packageDescription</td><td>Specifies a AssemblyDescription for the .NET Framework global assembly attributes stored in the AssemblyInfo file.</td><td></td><td>A library generated from a OpenAPI doc</td></tr><tr><td>packageGuid</td><td>The GUID that will be associated with the C# project</td><td></td><td>null</td></tr><tr><td>packageName</td><td>C# package name (convention: Title.Case).</td><td></td><td>Org.OpenAPITools</td></tr><tr><td>packageTitle</td><td>Specifies an AssemblyTitle for the .NET Framework global assembly attributes stored in the AssemblyInfo file.</td><td></td><td>OpenAPI Library</td></tr><tr><td>packageVersion</td><td>C# package version.</td><td></td><td>1.0.0</td></tr><tr><td>returnICollection</td><td>Return ICollection&lt;T&gt; instead of the concrete type.</td><td></td><td>false</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src</td></tr><tr><td>useCollection</td><td>Deserialize array types to Collection&lt;T&gt; instead of List&lt;T&gt;.</td><td></td><td>false</td></tr><tr><td>useDateTimeOffset</td><td>Use DateTimeOffset to model date-time properties</td><td></td><td>false</td></tr><tr><td>useNewtonsoft</td><td>Uses the Newtonsoft JSON library.</td><td></td><td>true</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>List</td></tr><tr><td>list</td><td>List</td></tr><tr><td>map</td><td>Dictionary</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Collection</li><li>DateTime</li><li>DateTime?</li><li>DateTimeOffset</li><li>DateTimeOffset?</li><li>Decimal</li><li>Dictionary</li><li>Double</li><li>Float</li><li>Guid</li><li>Guid?</li><li>ICollection</li><li>Int32</li><li>Int64</li><li>List</li><li>Object</li><li>String</li><li>System.IO.Stream</li><li>bool</li><li>bool?</li><li>byte[]</li><li>decimal</li><li>decimal?</li><li>double</li><li>double?</li><li>float</li><li>float?</li><li>int</li><li>int?</li><li>long</li><li>long?</li><li>string</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>Client</li><li>Configuration</li><li>Version</li><li>abstract</li><li>as</li><li>async</li><li>await</li><li>base</li><li>bool</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>checked</li><li>class</li><li>client</li><li>const</li><li>continue</li><li>decimal</li><li>default</li><li>delegate</li><li>do</li><li>double</li><li>dynamic</li><li>else</li><li>enum</li><li>event</li><li>explicit</li><li>extern</li><li>false</li><li>finally</li><li>fixed</li><li>float</li><li>for</li><li>foreach</li><li>goto</li><li>if</li><li>implicit</li><li>in</li><li>int</li><li>interface</li><li>internal</li><li>is</li><li>localVarFileParams</li><li>localVarFormParams</li><li>localVarHeaderParams</li><li>localVarHttpContentType</li><li>localVarHttpContentTypes</li><li>localVarHttpHeaderAccept</li><li>localVarHttpHeaderAccepts</li><li>localVarPath</li><li>localVarPathParams</li><li>localVarPostBody</li><li>localVarQueryParams</li><li>localVarResponse</li><li>localVarStatusCode</li><li>lock</li><li>long</li><li>namespace</li><li>new</li><li>null</li><li>object</li><li>operator</li><li>out</li><li>override</li><li>parameter</li><li>params</li><li>private</li><li>protected</li><li>public</li><li>readonly</li><li>ref</li><li>return</li><li>sbyte</li><li>sealed</li><li>short</li><li>sizeof</li><li>stackalloc</li><li>static</li><li>string</li><li>struct</li><li>switch</li><li>this</li><li>throw</li><li>true</li><li>try</li><li>typeof</li><li>uint</li><li>ulong</li><li>unchecked</li><li>unsafe</li><li>ushort</li><li>using</li><li>var</li><li>virtual</li><li>void</li><li>volatile</li><li>while</li><li>yield</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✓</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/csharp-netcore-functions.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-20T17:40:23.000Z" class="docLastUpdatedAt_1sqk">2022-4-20</time> by <strong>William Cheng</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/a43f9649.d71af5de.js"></script>
+<script src="/a43f9649.742d4b78.js"></script>
 
 
 </body>
diff --git a/docs/generators/csharp-netcore/index.html b/docs/generators/csharp-netcore/index.html
index 69eeaff236c..6d69629e3b3 100644
--- a/docs/generators/csharp-netcore/index.html
+++ b/docs/generators/csharp-netcore/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/csharp/index.html b/docs/generators/csharp/index.html
index ec47d36e0fe..a7d955ca6f0 100644
--- a/docs/generators/csharp/index.html
+++ b/docs/generators/csharp/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/cwiki/index.html b/docs/generators/cwiki/index.html
index 87152708cdb..a10415aacdb 100644
--- a/docs/generators/cwiki/index.html
+++ b/docs/generators/cwiki/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/dart-dio-next/index.html b/docs/generators/dart-dio-next/index.html
index be99cc8843b..368fcfe848e 100644
--- a/docs/generators/dart-dio-next/index.html
+++ b/docs/generators/dart-dio-next/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/dart/index.html b/docs/generators/dart/index.html
index d004d21f4f1..0a5d2bf78da 100644
--- a/docs/generators/dart/index.html
+++ b/docs/generators/dart/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/dynamic-html/index.html b/docs/generators/dynamic-html/index.html
index 9ede52d3ed4..d78b9528d28 100644
--- a/docs/generators/dynamic-html/index.html
+++ b/docs/generators/dynamic-html/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/eiffel/index.html b/docs/generators/eiffel/index.html
index f1f84cce0a5..e1f75a8f6f7 100644
--- a/docs/generators/eiffel/index.html
+++ b/docs/generators/eiffel/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/elixir/index.html b/docs/generators/elixir/index.html
index a4c6b88650f..00a5c78ed44 100644
--- a/docs/generators/elixir/index.html
+++ b/docs/generators/elixir/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/elm/index.html b/docs/generators/elm/index.html
index 3fe0b364552..2b7d482bfc1 100644
--- a/docs/generators/elm/index.html
+++ b/docs/generators/elm/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/erlang-client/index.html b/docs/generators/erlang-client/index.html
index 8cb1a3bf5e6..00dac757a0d 100644
--- a/docs/generators/erlang-client/index.html
+++ b/docs/generators/erlang-client/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/erlang-proper/index.html b/docs/generators/erlang-proper/index.html
index 24a47a25a5b..f543ecb8523 100644
--- a/docs/generators/erlang-proper/index.html
+++ b/docs/generators/erlang-proper/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/erlang-server/index.html b/docs/generators/erlang-server/index.html
index 45344018ac6..1e276ee5151 100644
--- a/docs/generators/erlang-server/index.html
+++ b/docs/generators/erlang-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/fsharp-functions/index.html b/docs/generators/fsharp-functions/index.html
index 63a46d7233b..628b23c846a 100644
--- a/docs/generators/fsharp-functions/index.html
+++ b/docs/generators/fsharp-functions/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/fsharp-giraffe-server/index.html b/docs/generators/fsharp-giraffe-server/index.html
index 53dcec07dfb..10ae2327e22 100644
--- a/docs/generators/fsharp-giraffe-server/index.html
+++ b/docs/generators/fsharp-giraffe-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/go-echo-server/index.html b/docs/generators/go-echo-server/index.html
index 9476bd9a079..8e7a619e2df 100644
--- a/docs/generators/go-echo-server/index.html
+++ b/docs/generators/go-echo-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/go-experimental/index.html b/docs/generators/go-experimental/index.html
index e2093dab71c..f3f0bd5b284 100644
--- a/docs/generators/go-experimental/index.html
+++ b/docs/generators/go-experimental/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Config Options for go-experimental</h1></header><div class="markdown"><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>Specify the behavior when the &#x27;additionalProperties&#x27; keyword is not present in the OAS document. If false: the &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications. If true: when the &#x27;additionalProperties&#x27; keyword is not present in a schema, the value of &#x27;additionalProperties&#x27; is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents:  1) When the &#x27;additionalProperties&#x27; keyword is not present in a 2.0 schema, additional properties are NOT allowed.  2) Boolean values of the &#x27;additionalProperties&#x27; keyword are ignored. It&#x27;s as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>when the &#x27;additionalProperties&#x27; keyword is not present in a schema, the value of &#x27;additionalProperties&#x27; is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl></td><td>true</td></tr><tr><td>enumClassPrefix</td><td>Prefix enum with class name</td><td></td><td>false</td></tr><tr><td>generateInterfaces</td><td>Generate interfaces for api classes</td><td></td><td>false</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>true</td></tr><tr><td>isGoSubmodule</td><td>whether the generated Go module is a submodule</td><td></td><td>false</td></tr><tr><td>packageName</td><td>Go package name (convention: lowercase).</td><td></td><td>openapi</td></tr><tr><td>packageVersion</td><td>Go package version.</td><td></td><td>1.0.0</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>structPrefix</td><td>whether to prefix struct with the class name. e.g. DeletePetOpts =&gt; PetApiDeletePetOpts</td><td></td><td>false</td></tr><tr><td>useOneOfDiscriminatorLookup</td><td>Use the discriminator&#x27;s mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf&#x27;s schemas) will be skipped.</td><td></td><td>false</td></tr><tr><td>skipReadonlyPropertiesInInt</td><td>Skip default values to the readOnly properties in the model init function./ /false/</td><td></td><td></td></tr><tr><td>withAWSV4Signature</td><td>whether to include AWS v4 signature support</td><td></td><td>false</td></tr><tr><td>withGoCodegenComment</td><td>whether to include Go codegen comment to disable Go Lint and collapse by default in GitHub PRs and diffs</td><td></td><td>false</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>bool</li><li>byte</li><li>complex128</li><li>complex64</li><li>float32</li><li>float64</li><li>int</li><li>int32</li><li>int64</li><li>interface</li><li>map[string]interface</li><li>rune</li><li>string</li><li>uint</li><li>uint32</li><li>uint64</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>bool</li><li>break</li><li>byte</li><li>case</li><li>chan</li><li>complex128</li><li>complex64</li><li>const</li><li>continue</li><li>default</li><li>defer</li><li>else</li><li>error</li><li>fallthrough</li><li>float32</li><li>float64</li><li>for</li><li>func</li><li>go</li><li>goto</li><li>if</li><li>import</li><li>int</li><li>int16</li><li>int32</li><li>int64</li><li>int8</li><li>interface</li><li>map</li><li>nil</li><li>package</li><li>range</li><li>return</li><li>rune</li><li>select</li><li>string</li><li>struct</li><li>switch</li><li>type</li><li>uint</li><li>uint16</li><li>uint32</li><li>uint64</li><li>uint8</li><li>uintptr</li><li>var</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✓</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/go-experimental.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Config Options for go-experimental</h1></header><div class="markdown"><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>Specify the behavior when the &#x27;additionalProperties&#x27; keyword is not present in the OAS document. If false: the &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications. If true: when the &#x27;additionalProperties&#x27; keyword is not present in a schema, the value of &#x27;additionalProperties&#x27; is set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.This setting is currently ignored for OAS 2.0 documents:  1) When the &#x27;additionalProperties&#x27; keyword is not present in a 2.0 schema, additional properties are NOT allowed.  2) Boolean values of the &#x27;additionalProperties&#x27; keyword are ignored. It&#x27;s as if additional properties are NOT allowed.Note: the root cause are issues #1369 and #1371, which must be resolved in the swagger-parser project.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>when the &#x27;additionalProperties&#x27; keyword is not present in a schema, the value of &#x27;additionalProperties&#x27; is automatically set to false, i.e. no additional properties are allowed. Note: this mode is not compliant with the JSON schema specification. This is the original openapi-generator behavior.</dd></dl></td><td>true</td></tr><tr><td>enumClassPrefix</td><td>Prefix enum with class name</td><td></td><td>false</td></tr><tr><td>generateInterfaces</td><td>Generate interfaces for api classes</td><td></td><td>false</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>true</td></tr><tr><td>isGoSubmodule</td><td>whether the generated Go module is a submodule</td><td></td><td>false</td></tr><tr><td>packageName</td><td>Go package name (convention: lowercase).</td><td></td><td>openapi</td></tr><tr><td>packageVersion</td><td>Go package version.</td><td></td><td>1.0.0</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>structPrefix</td><td>whether to prefix struct with the class name. e.g. DeletePetOpts =&gt; PetApiDeletePetOpts</td><td></td><td>false</td></tr><tr><td>useOneOfDiscriminatorLookup</td><td>Use the discriminator&#x27;s mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf&#x27;s schemas) will be skipped.</td><td></td><td>false</td></tr><tr><td>skipReadonlyPropertiesInInt</td><td>Skip default values to the readOnly properties in the model init function./ /false/</td><td></td><td></td></tr><tr><td>withAWSV4Signature</td><td>whether to include AWS v4 signature support</td><td></td><td>false</td></tr><tr><td>withGoCodegenComment</td><td>whether to include Go codegen comment to disable Go Lint and collapse by default in GitHub PRs and diffs</td><td></td><td>false</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>bool</li><li>byte</li><li>complex128</li><li>complex64</li><li>float32</li><li>float64</li><li>int</li><li>int32</li><li>int64</li><li>interface</li><li>map[string]interface</li><li>rune</li><li>string</li><li>uint</li><li>uint32</li><li>uint64</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>bool</li><li>break</li><li>byte</li><li>case</li><li>chan</li><li>complex128</li><li>complex64</li><li>const</li><li>continue</li><li>default</li><li>defer</li><li>else</li><li>error</li><li>fallthrough</li><li>float32</li><li>float64</li><li>for</li><li>func</li><li>go</li><li>goto</li><li>if</li><li>import</li><li>int</li><li>int16</li><li>int32</li><li>int64</li><li>int8</li><li>interface</li><li>map</li><li>nil</li><li>package</li><li>range</li><li>return</li><li>rune</li><li>select</li><li>string</li><li>struct</li><li>switch</li><li>type</li><li>uint</li><li>uint16</li><li>uint32</li><li>uint64</li><li>uint8</li><li>uintptr</li><li>var</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✓</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/go-experimental.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/da5134d7.6d299e19.js"></script>
+<script src="/da5134d7.e68f5ed7.js"></script>
 
 
 </body>
diff --git a/docs/generators/go-gin-server/index.html b/docs/generators/go-gin-server/index.html
index f2200911cba..11c957600e0 100644
--- a/docs/generators/go-gin-server/index.html
+++ b/docs/generators/go-gin-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/go-server/index.html b/docs/generators/go-server/index.html
index a1006a0fe1e..4e2a172bff9 100644
--- a/docs/generators/go-server/index.html
+++ b/docs/generators/go-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/go/index.html b/docs/generators/go/index.html
index dc1f2ab7c17..2bde6be80fe 100644
--- a/docs/generators/go/index.html
+++ b/docs/generators/go/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/graphql-nodejs-express-server/index.html b/docs/generators/graphql-nodejs-express-server/index.html
index ded8155f84f..c6df43fbede 100644
--- a/docs/generators/graphql-nodejs-express-server/index.html
+++ b/docs/generators/graphql-nodejs-express-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/graphql-schema/index.html b/docs/generators/graphql-schema/index.html
index 2608c0b25de..271e68f0795 100644
--- a/docs/generators/graphql-schema/index.html
+++ b/docs/generators/graphql-schema/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/groovy/index.html b/docs/generators/groovy/index.html
index cab9da49b01..e1787e17328 100644
--- a/docs/generators/groovy/index.html
+++ b/docs/generators/groovy/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/haskell-http-client/index.html b/docs/generators/haskell-http-client/index.html
index c99ebf0ee00..882d7692d42 100644
--- a/docs/generators/haskell-http-client/index.html
+++ b/docs/generators/haskell-http-client/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/haskell-yesod/index.html b/docs/generators/haskell-yesod/index.html
index 1097616325a..f9a098a2334 100644
--- a/docs/generators/haskell-yesod/index.html
+++ b/docs/generators/haskell-yesod/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/haskell/index.html b/docs/generators/haskell/index.html
index bdf0df76533..eb02301b2b0 100644
--- a/docs/generators/haskell/index.html
+++ b/docs/generators/haskell/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/html/index.html b/docs/generators/html/index.html
index e031f8d941d..21b4e078e14 100644
--- a/docs/generators/html/index.html
+++ b/docs/generators/html/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/html2/index.html b/docs/generators/html2/index.html
index b214ef8a0e2..ecc8226d707 100644
--- a/docs/generators/html2/index.html
+++ b/docs/generators/html2/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/index.html b/docs/generators/index.html
index 85c61627373..c9fff108327 100644
--- a/docs/generators/index.html
+++ b/docs/generators/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-camel/index.html b/docs/generators/java-camel/index.html
index 371d1320e21..4347e6d75e6 100644
--- a/docs/generators/java-camel/index.html
+++ b/docs/generators/java-camel/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-inflector/index.html b/docs/generators/java-inflector/index.html
index 68e04b9aa8e..88b644e7dc5 100644
--- a/docs/generators/java-inflector/index.html
+++ b/docs/generators/java-inflector/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-micronaut-client/index.html b/docs/generators/java-micronaut-client/index.html
index 22d2e97dc4d..9ac43f69304 100644
--- a/docs/generators/java-micronaut-client/index.html
+++ b/docs/generators/java-micronaut-client/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the java-micronaut-client Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>java-micronaut-client</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>BETA</td><td></td></tr><tr><td>generator type</td><td>CLIENT</td><td></td></tr><tr><td>generator language</td><td>Java</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Generates a Java Micronaut Client.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>additionalEnumTypeAnnotations</td><td>Additional annotations for enum type(class level annotations)</td><td></td><td>null</td></tr><tr><td>additionalModelTypeAnnotations</td><td>Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)</td><td></td><td>null</td></tr><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>apiPackage</td><td>package for generated api classes</td><td></td><td>org.openapitools.api</td></tr><tr><td>artifactDescription</td><td>artifact description in generated pom.xml</td><td></td><td>OpenAPI Java</td></tr><tr><td>artifactId</td><td>artifactId in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>openapi-micronaut</td></tr><tr><td>artifactUrl</td><td>artifact URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>artifactVersion</td><td>artifact version in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>1.0.0</td></tr><tr><td>bigDecimalAsString</td><td>Treat BigDecimal values as Strings to avoid precision loss.</td><td></td><td>false</td></tr><tr><td>booleanGetterPrefix</td><td>Set booleanGetterPrefix</td><td></td><td>get</td></tr><tr><td>build</td><td>Specify for which build tool to generate files</td><td><dl><dt><strong>gradle</strong></dt><dd>Gradle configuration is generated for the project</dd><dt><strong>all</strong></dt><dd>Both Gradle and Maven configurations are generated</dd><dt><strong>maven</strong></dt><dd>Maven configuration is generated for the project</dd></dl></td><td>all</td></tr><tr><td>configureAuth</td><td>Configure all the authorization methods as specified in the file</td><td></td><td>false</td></tr><tr><td>dateFormat</td><td>Specify the format pattern of date as a string</td><td></td><td>null</td></tr><tr><td>dateLibrary</td><td>Option. Date library to use</td><td><dl><dt><strong>java8-localdatetime</strong></dt><dd>Java 8 using LocalDateTime (for legacy app only)</dd><dt><strong>java8</strong></dt><dd>Java 8 native JSR310 (preferred for jdk 1.8+)</dd></dl></td><td>java8</td></tr><tr><td>datetimeFormat</td><td>Specify the format pattern of date-time as a string</td><td></td><td>null</td></tr><tr><td>developerEmail</td><td>developer email in generated pom.xml</td><td></td><td>team@openapitools.org</td></tr><tr><td>developerName</td><td>developer name in generated pom.xml</td><td></td><td>OpenAPI-Generator Contributors</td></tr><tr><td>developerOrganization</td><td>developer organization in generated pom.xml</td><td></td><td>OpenAPITools.org</td></tr><tr><td>developerOrganizationUrl</td><td>developer organization URL in generated pom.xml</td><td></td><td><a href="http://openapitools.org">http://openapitools.org</a></td></tr><tr><td>disableHtmlEscaping</td><td>Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)</td><td></td><td>false</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>discriminatorCaseSensitive</td><td>Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client</td><td></td><td>true</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>enumUnknownDefaultCase</td><td>If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.</td><td><dl><dt><strong>false</strong></dt><dd>No changes to the enum&#x27;s are made, this is the default option.</dd><dt><strong>true</strong></dt><dd>With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.</dd></dl></td><td>false</td></tr><tr><td>fullJavaUtil</td><td>whether to use fully qualified name for classes under java.util. This option only works for Java API client</td><td></td><td>false</td></tr><tr><td>groupId</td><td>groupId in generated pom.xml</td><td></td><td>org.openapitools</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>false</td></tr><tr><td>ignoreAnyOfInEnum</td><td>Ignore anyOf keyword in enum</td><td></td><td>false</td></tr><tr><td>implicitHeaders</td><td>Skip header parameters in the generated API methods using @ApiImplicitParams annotation.</td><td></td><td>false</td></tr><tr><td>implicitHeadersRegex</td><td>Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true</td><td></td><td>null</td></tr><tr><td>invokerPackage</td><td>root package for generated code</td><td></td><td>org.openapitools</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>Unlicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://unlicense.org">http://unlicense.org</a></td></tr><tr><td>micronautVersion</td><td>Micronaut version, only &gt;=3.0.0 versions are supported</td><td></td><td>3.3.1</td></tr><tr><td>modelPackage</td><td>package for generated models</td><td></td><td>org.openapitools.model</td></tr><tr><td>openApiNullable</td><td>Enable OpenAPI Jackson Nullable library</td><td></td><td>true</td></tr><tr><td>parentArtifactId</td><td>parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentGroupId</td><td>parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentVersion</td><td>parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>requiredPropertiesInConstructor</td><td>Allow only to create models with all the required properties provided in constructor</td><td></td><td>true</td></tr><tr><td>scmConnection</td><td>SCM connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmDeveloperConnection</td><td>SCM developer connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmUrl</td><td>SCM URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>serializableModel</td><td>boolean - toggle &quot;implements Serializable&quot; for generated models</td><td></td><td>false</td></tr><tr><td>snapshotVersion</td><td>Uses a SNAPSHOT version.</td><td><dl><dt><strong>true</strong></dt><dd>Use a SnapShot Version</dd><dt><strong>false</strong></dt><dd>Use a Release Version</dd></dl></td><td>null</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src/main/java</td></tr><tr><td>test</td><td>Specify which test tool to generate files for</td><td><dl><dt><strong>junit</strong></dt><dd>Use JUnit as test tool</dd><dt><strong>spock</strong></dt><dd>Use Spock as test tool</dd></dl></td><td>junit</td></tr><tr><td>testOutput</td><td>Set output folder for models and APIs tests</td><td></td><td>${project.build.directory}/generated-test-sources/openapi</td></tr><tr><td>title</td><td>Client service name</td><td></td><td>null</td></tr><tr><td>useBeanValidation</td><td>Use BeanValidation API annotations</td><td></td><td>true</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-vendor-extensions"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-vendor-extensions" title="Direct link to heading">#</a>SUPPORTED VENDOR EXTENSIONS</h2><table><thead><tr><th>Extension name</th><th>Description</th><th>Applicable for</th><th>Default value</th></tr></thead><tbody><tr><td>x-discriminator-value</td><td>Used with model inheritance to specify value for discriminator that identifies current model</td><td>MODEL</td><td></td></tr><tr><td>x-implements</td><td>Ability to specify interfaces that model must implements</td><td>MODEL</td><td>empty array</td></tr><tr><td>x-setter-extra-annotation</td><td>Custom annotation that can be specified over java setter for specific field</td><td>FIELD</td><td>When field is array &amp; uniqueItems, then this extension is used to add <code>@JsonDeserialize(as = LinkedHashSet.class)</code> over setter, otherwise no value</td></tr><tr><td>x-tags</td><td>Specify multiple swagger tags for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-accepts</td><td>Specify custom value for &#x27;Accept&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-content-type</td><td>Specify custom value for &#x27;Content-Type&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-class-extra-annotation</td><td>List of custom annotations to be added to model</td><td>MODEL</td><td>null</td></tr><tr><td>x-field-extra-annotation</td><td>List of custom annotations to be added to property</td><td>FIELD</td><td>null</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody><tr><td>Array</td><td>java.util.List</td></tr><tr><td>ArrayList</td><td>java.util.ArrayList</td></tr><tr><td>BigDecimal</td><td>java.math.BigDecimal</td></tr><tr><td>Date</td><td>java.util.Date</td></tr><tr><td>DateTime</td><td>org.joda.time.*</td></tr><tr><td>File</td><td>java.io.File</td></tr><tr><td>HashMap</td><td>java.util.HashMap</td></tr><tr><td>LinkedHashSet</td><td>java.util.LinkedHashSet</td></tr><tr><td>List</td><td>java.util.*</td></tr><tr><td>LocalDate</td><td>org.joda.time.*</td></tr><tr><td>LocalDateTime</td><td>org.joda.time.*</td></tr><tr><td>LocalTime</td><td>org.joda.time.*</td></tr><tr><td>Map</td><td>java.util.Map</td></tr><tr><td>Set</td><td>java.util.*</td></tr><tr><td>Timestamp</td><td>java.sql.Timestamp</td></tr><tr><td>URI</td><td>java.net.URI</td></tr><tr><td>UUID</td><td>java.util.UUID</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>ArrayList</td></tr><tr><td>map</td><td>HashMap</td></tr><tr><td>set</td><td>LinkedHashSet</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Double</li><li>Float</li><li>Integer</li><li>Long</li><li>Object</li><li>String</li><li>boolean</li><li>byte[]</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>abstract</li><li>apiclient</li><li>apiexception</li><li>apiresponse</li><li>application</li><li>assert</li><li>authorization</li><li>body</li><li>boolean</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>class</li><li>client</li><li>configuration</li><li>const</li><li>continue</li><li>cookie</li><li>default</li><li>do</li><li>double</li><li>else</li><li>enum</li><li>extends</li><li>file</li><li>final</li><li>finally</li><li>float</li><li>for</li><li>format</li><li>goto</li><li>header</li><li>if</li><li>implements</li><li>import</li><li>instanceof</li><li>int</li><li>interface</li><li>list</li><li>localreturntype</li><li>localvaraccept</li><li>localvaraccepts</li><li>localvarauthnames</li><li>localvarcollectionqueryparams</li><li>localvarcontenttype</li><li>localvarcontenttypes</li><li>localvarcookieparams</li><li>localvarformparams</li><li>localvarheaderparams</li><li>localvarpath</li><li>localvarpostbody</li><li>localvarqueryparams</li><li>long</li><li>native</li><li>new</li><li>null</li><li>object</li><li>package</li><li>pathvariable</li><li>private</li><li>protected</li><li>public</li><li>queryparam</li><li>queryvalue</li><li>return</li><li>short</li><li>static</li><li>strictfp</li><li>stringutil</li><li>super</li><li>switch</li><li>synchronized</li><li>this</li><li>throw</li><li>throws</li><li>transient</li><li>try</li><li>void</li><li>volatile</li><li>while</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✓</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✓</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-client.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-17T16:36:09.000Z" class="docLastUpdatedAt_1sqk">2022-4-17</time> by <strong>Justin Black</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#supported-vendor-extensions" class="contents__link">SUPPORTED VENDOR EXTENSIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the java-micronaut-client Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>java-micronaut-client</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>BETA</td><td></td></tr><tr><td>generator type</td><td>CLIENT</td><td></td></tr><tr><td>generator language</td><td>Java</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Generates a Java Micronaut Client.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>additionalEnumTypeAnnotations</td><td>Additional annotations for enum type(class level annotations)</td><td></td><td>null</td></tr><tr><td>additionalModelTypeAnnotations</td><td>Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)</td><td></td><td>null</td></tr><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>apiPackage</td><td>package for generated api classes</td><td></td><td>org.openapitools.api</td></tr><tr><td>artifactDescription</td><td>artifact description in generated pom.xml</td><td></td><td>OpenAPI Java</td></tr><tr><td>artifactId</td><td>artifactId in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>openapi-micronaut</td></tr><tr><td>artifactUrl</td><td>artifact URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>artifactVersion</td><td>artifact version in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>1.0.0</td></tr><tr><td>bigDecimalAsString</td><td>Treat BigDecimal values as Strings to avoid precision loss.</td><td></td><td>false</td></tr><tr><td>booleanGetterPrefix</td><td>Set booleanGetterPrefix</td><td></td><td>get</td></tr><tr><td>build</td><td>Specify for which build tool to generate files</td><td><dl><dt><strong>gradle</strong></dt><dd>Gradle configuration is generated for the project</dd><dt><strong>all</strong></dt><dd>Both Gradle and Maven configurations are generated</dd><dt><strong>maven</strong></dt><dd>Maven configuration is generated for the project</dd></dl></td><td>all</td></tr><tr><td>configureAuth</td><td>Configure all the authorization methods as specified in the file</td><td></td><td>false</td></tr><tr><td>dateFormat</td><td>Specify the format pattern of date as a string</td><td></td><td>null</td></tr><tr><td>dateLibrary</td><td>Option. Date library to use</td><td><dl><dt><strong>java8-localdatetime</strong></dt><dd>Java 8 using LocalDateTime (for legacy app only)</dd><dt><strong>java8</strong></dt><dd>Java 8 native JSR310 (preferred for jdk 1.8+)</dd></dl></td><td>java8</td></tr><tr><td>datetimeFormat</td><td>Specify the format pattern of date-time as a string</td><td></td><td>null</td></tr><tr><td>developerEmail</td><td>developer email in generated pom.xml</td><td></td><td>team@openapitools.org</td></tr><tr><td>developerName</td><td>developer name in generated pom.xml</td><td></td><td>OpenAPI-Generator Contributors</td></tr><tr><td>developerOrganization</td><td>developer organization in generated pom.xml</td><td></td><td>OpenAPITools.org</td></tr><tr><td>developerOrganizationUrl</td><td>developer organization URL in generated pom.xml</td><td></td><td><a href="http://openapitools.org">http://openapitools.org</a></td></tr><tr><td>disableHtmlEscaping</td><td>Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)</td><td></td><td>false</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>discriminatorCaseSensitive</td><td>Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client</td><td></td><td>true</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>enumUnknownDefaultCase</td><td>If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.</td><td><dl><dt><strong>false</strong></dt><dd>No changes to the enum&#x27;s are made, this is the default option.</dd><dt><strong>true</strong></dt><dd>With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.</dd></dl></td><td>false</td></tr><tr><td>fullJavaUtil</td><td>whether to use fully qualified name for classes under java.util. This option only works for Java API client</td><td></td><td>false</td></tr><tr><td>groupId</td><td>groupId in generated pom.xml</td><td></td><td>org.openapitools</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>false</td></tr><tr><td>ignoreAnyOfInEnum</td><td>Ignore anyOf keyword in enum</td><td></td><td>false</td></tr><tr><td>implicitHeaders</td><td>Skip header parameters in the generated API methods using @ApiImplicitParams annotation.</td><td></td><td>false</td></tr><tr><td>implicitHeadersRegex</td><td>Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true</td><td></td><td>null</td></tr><tr><td>invokerPackage</td><td>root package for generated code</td><td></td><td>org.openapitools</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>Unlicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://unlicense.org">http://unlicense.org</a></td></tr><tr><td>micronautVersion</td><td>Micronaut version, only &gt;=3.0.0 versions are supported</td><td></td><td>3.3.1</td></tr><tr><td>modelPackage</td><td>package for generated models</td><td></td><td>org.openapitools.model</td></tr><tr><td>openApiNullable</td><td>Enable OpenAPI Jackson Nullable library</td><td></td><td>true</td></tr><tr><td>parentArtifactId</td><td>parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentGroupId</td><td>parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentVersion</td><td>parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>requiredPropertiesInConstructor</td><td>Allow only to create models with all the required properties provided in constructor</td><td></td><td>true</td></tr><tr><td>scmConnection</td><td>SCM connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmDeveloperConnection</td><td>SCM developer connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmUrl</td><td>SCM URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>serializableModel</td><td>boolean - toggle &quot;implements Serializable&quot; for generated models</td><td></td><td>false</td></tr><tr><td>snapshotVersion</td><td>Uses a SNAPSHOT version.</td><td><dl><dt><strong>true</strong></dt><dd>Use a SnapShot Version</dd><dt><strong>false</strong></dt><dd>Use a Release Version</dd></dl></td><td>null</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src/main/java</td></tr><tr><td>test</td><td>Specify which test tool to generate files for</td><td><dl><dt><strong>junit</strong></dt><dd>Use JUnit as test tool</dd><dt><strong>spock</strong></dt><dd>Use Spock as test tool</dd></dl></td><td>junit</td></tr><tr><td>testOutput</td><td>Set output folder for models and APIs tests</td><td></td><td>${project.build.directory}/generated-test-sources/openapi</td></tr><tr><td>title</td><td>Client service name</td><td></td><td>null</td></tr><tr><td>useBeanValidation</td><td>Use BeanValidation API annotations</td><td></td><td>true</td></tr><tr><td>useOptional</td><td>Use Optional container for optional parameters</td><td></td><td>false</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-vendor-extensions"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-vendor-extensions" title="Direct link to heading">#</a>SUPPORTED VENDOR EXTENSIONS</h2><table><thead><tr><th>Extension name</th><th>Description</th><th>Applicable for</th><th>Default value</th></tr></thead><tbody><tr><td>x-discriminator-value</td><td>Used with model inheritance to specify value for discriminator that identifies current model</td><td>MODEL</td><td></td></tr><tr><td>x-implements</td><td>Ability to specify interfaces that model must implements</td><td>MODEL</td><td>empty array</td></tr><tr><td>x-setter-extra-annotation</td><td>Custom annotation that can be specified over java setter for specific field</td><td>FIELD</td><td>When field is array &amp; uniqueItems, then this extension is used to add <code>@JsonDeserialize(as = LinkedHashSet.class)</code> over setter, otherwise no value</td></tr><tr><td>x-tags</td><td>Specify multiple swagger tags for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-accepts</td><td>Specify custom value for &#x27;Accept&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-content-type</td><td>Specify custom value for &#x27;Content-Type&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-class-extra-annotation</td><td>List of custom annotations to be added to model</td><td>MODEL</td><td>null</td></tr><tr><td>x-field-extra-annotation</td><td>List of custom annotations to be added to property</td><td>FIELD</td><td>null</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody><tr><td>Array</td><td>java.util.List</td></tr><tr><td>ArrayList</td><td>java.util.ArrayList</td></tr><tr><td>BigDecimal</td><td>java.math.BigDecimal</td></tr><tr><td>Date</td><td>java.util.Date</td></tr><tr><td>DateTime</td><td>org.joda.time.*</td></tr><tr><td>File</td><td>java.io.File</td></tr><tr><td>HashMap</td><td>java.util.HashMap</td></tr><tr><td>LinkedHashSet</td><td>java.util.LinkedHashSet</td></tr><tr><td>List</td><td>java.util.*</td></tr><tr><td>LocalDate</td><td>org.joda.time.*</td></tr><tr><td>LocalDateTime</td><td>org.joda.time.*</td></tr><tr><td>LocalTime</td><td>org.joda.time.*</td></tr><tr><td>Map</td><td>java.util.Map</td></tr><tr><td>Set</td><td>java.util.*</td></tr><tr><td>Timestamp</td><td>java.sql.Timestamp</td></tr><tr><td>URI</td><td>java.net.URI</td></tr><tr><td>UUID</td><td>java.util.UUID</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>ArrayList</td></tr><tr><td>map</td><td>HashMap</td></tr><tr><td>set</td><td>LinkedHashSet</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Double</li><li>Float</li><li>Integer</li><li>Long</li><li>Object</li><li>String</li><li>boolean</li><li>byte[]</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>abstract</li><li>apiclient</li><li>apiexception</li><li>apiresponse</li><li>application</li><li>assert</li><li>authorization</li><li>body</li><li>boolean</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>class</li><li>client</li><li>configuration</li><li>const</li><li>continue</li><li>cookie</li><li>default</li><li>do</li><li>double</li><li>else</li><li>enum</li><li>extends</li><li>file</li><li>final</li><li>finally</li><li>float</li><li>for</li><li>format</li><li>goto</li><li>header</li><li>if</li><li>implements</li><li>import</li><li>instanceof</li><li>int</li><li>interface</li><li>list</li><li>localreturntype</li><li>localvaraccept</li><li>localvaraccepts</li><li>localvarauthnames</li><li>localvarcollectionqueryparams</li><li>localvarcontenttype</li><li>localvarcontenttypes</li><li>localvarcookieparams</li><li>localvarformparams</li><li>localvarheaderparams</li><li>localvarpath</li><li>localvarpostbody</li><li>localvarqueryparams</li><li>long</li><li>native</li><li>new</li><li>null</li><li>object</li><li>package</li><li>pathvariable</li><li>private</li><li>protected</li><li>public</li><li>queryparam</li><li>queryvalue</li><li>return</li><li>short</li><li>static</li><li>strictfp</li><li>stringutil</li><li>super</li><li>switch</li><li>synchronized</li><li>this</li><li>throw</li><li>throws</li><li>transient</li><li>try</li><li>void</li><li>volatile</li><li>while</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✓</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✓</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-client.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-21T02:53:56.000Z" class="docLastUpdatedAt_1sqk">2022-4-21</time> by <strong>Auke Schrijnen</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#supported-vendor-extensions" class="contents__link">SUPPORTED VENDOR EXTENSIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/9d9ec3e3.51da6e88.js"></script>
+<script src="/9d9ec3e3.93741e5c.js"></script>
 
 
 </body>
diff --git a/docs/generators/java-micronaut-server/index.html b/docs/generators/java-micronaut-server/index.html
index b3a08fe5087..b6123716967 100644
--- a/docs/generators/java-micronaut-server/index.html
+++ b/docs/generators/java-micronaut-server/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the java-micronaut-server Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>java-micronaut-server</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>BETA</td><td></td></tr><tr><td>generator type</td><td>SERVER</td><td></td></tr><tr><td>generator language</td><td>Java</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Generates a Java Micronaut Server.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>additionalEnumTypeAnnotations</td><td>Additional annotations for enum type(class level annotations)</td><td></td><td>null</td></tr><tr><td>additionalModelTypeAnnotations</td><td>Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)</td><td></td><td>null</td></tr><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>artifactDescription</td><td>artifact description in generated pom.xml</td><td></td><td>OpenAPI Java</td></tr><tr><td>artifactId</td><td>artifactId in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>openapi-micronaut</td></tr><tr><td>artifactUrl</td><td>artifact URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>artifactVersion</td><td>artifact version in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>1.0.0</td></tr><tr><td>bigDecimalAsString</td><td>Treat BigDecimal values as Strings to avoid precision loss.</td><td></td><td>false</td></tr><tr><td>booleanGetterPrefix</td><td>Set booleanGetterPrefix</td><td></td><td>get</td></tr><tr><td>build</td><td>Specify for which build tool to generate files</td><td><dl><dt><strong>gradle</strong></dt><dd>Gradle configuration is generated for the project</dd><dt><strong>all</strong></dt><dd>Both Gradle and Maven configurations are generated</dd><dt><strong>maven</strong></dt><dd>Maven configuration is generated for the project</dd></dl></td><td>all</td></tr><tr><td>controllerPackage</td><td>The package in which controllers will be generated</td><td></td><td>org.openapitools.api</td></tr><tr><td>dateFormat</td><td>Specify the format pattern of date as a string</td><td></td><td>null</td></tr><tr><td>dateLibrary</td><td>Option. Date library to use</td><td><dl><dt><strong>java8-localdatetime</strong></dt><dd>Java 8 using LocalDateTime (for legacy app only)</dd><dt><strong>java8</strong></dt><dd>Java 8 native JSR310 (preferred for jdk 1.8+)</dd></dl></td><td>java8</td></tr><tr><td>datetimeFormat</td><td>Specify the format pattern of date-time as a string</td><td></td><td>null</td></tr><tr><td>developerEmail</td><td>developer email in generated pom.xml</td><td></td><td>team@openapitools.org</td></tr><tr><td>developerName</td><td>developer name in generated pom.xml</td><td></td><td>OpenAPI-Generator Contributors</td></tr><tr><td>developerOrganization</td><td>developer organization in generated pom.xml</td><td></td><td>OpenAPITools.org</td></tr><tr><td>developerOrganizationUrl</td><td>developer organization URL in generated pom.xml</td><td></td><td><a href="http://openapitools.org">http://openapitools.org</a></td></tr><tr><td>disableHtmlEscaping</td><td>Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)</td><td></td><td>false</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>discriminatorCaseSensitive</td><td>Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client</td><td></td><td>true</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>enumUnknownDefaultCase</td><td>If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.</td><td><dl><dt><strong>false</strong></dt><dd>No changes to the enum&#x27;s are made, this is the default option.</dd><dt><strong>true</strong></dt><dd>With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.</dd></dl></td><td>false</td></tr><tr><td>fullJavaUtil</td><td>whether to use fully qualified name for classes under java.util. This option only works for Java API client</td><td></td><td>false</td></tr><tr><td>generateControllerAsAbstract</td><td>Generate an abstract class for controller to be extended. (apiPackage is then used for the abstract class, and controllerPackage is used for implementation that extends it.)</td><td></td><td>false</td></tr><tr><td>generateControllerFromExamples</td><td>Generate the implementation of controller and tests from parameter and return examples that will verify that the api works as desired (for testing)</td><td></td><td>false</td></tr><tr><td>groupId</td><td>groupId in generated pom.xml</td><td></td><td>org.openapitools</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>false</td></tr><tr><td>ignoreAnyOfInEnum</td><td>Ignore anyOf keyword in enum</td><td></td><td>false</td></tr><tr><td>implicitHeaders</td><td>Skip header parameters in the generated API methods using @ApiImplicitParams annotation.</td><td></td><td>false</td></tr><tr><td>implicitHeadersRegex</td><td>Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true</td><td></td><td>null</td></tr><tr><td>invokerPackage</td><td>root package for generated code</td><td></td><td>org.openapitools</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>Unlicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://unlicense.org">http://unlicense.org</a></td></tr><tr><td>micronautVersion</td><td>Micronaut version, only &gt;=3.0.0 versions are supported</td><td></td><td>3.3.1</td></tr><tr><td>modelPackage</td><td>package for generated models</td><td></td><td>org.openapitools.model</td></tr><tr><td>openApiNullable</td><td>Enable OpenAPI Jackson Nullable library</td><td></td><td>true</td></tr><tr><td>parentArtifactId</td><td>parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentGroupId</td><td>parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentVersion</td><td>parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>requiredPropertiesInConstructor</td><td>Allow only to create models with all the required properties provided in constructor</td><td></td><td>true</td></tr><tr><td>scmConnection</td><td>SCM connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmDeveloperConnection</td><td>SCM developer connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmUrl</td><td>SCM URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>serializableModel</td><td>boolean - toggle &quot;implements Serializable&quot; for generated models</td><td></td><td>false</td></tr><tr><td>snapshotVersion</td><td>Uses a SNAPSHOT version.</td><td><dl><dt><strong>true</strong></dt><dd>Use a SnapShot Version</dd><dt><strong>false</strong></dt><dd>Use a Release Version</dd></dl></td><td>null</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src/main/java</td></tr><tr><td>test</td><td>Specify which test tool to generate files for</td><td><dl><dt><strong>junit</strong></dt><dd>Use JUnit as test tool</dd><dt><strong>spock</strong></dt><dd>Use Spock as test tool</dd></dl></td><td>junit</td></tr><tr><td>testOutput</td><td>Set output folder for models and APIs tests</td><td></td><td>${project.build.directory}/generated-test-sources/openapi</td></tr><tr><td>title</td><td>Client service name</td><td></td><td>null</td></tr><tr><td>useAuth</td><td>Whether to import authorization and to annotate controller methods accordingly</td><td></td><td>true</td></tr><tr><td>useBeanValidation</td><td>Use BeanValidation API annotations</td><td></td><td>true</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-vendor-extensions"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-vendor-extensions" title="Direct link to heading">#</a>SUPPORTED VENDOR EXTENSIONS</h2><table><thead><tr><th>Extension name</th><th>Description</th><th>Applicable for</th><th>Default value</th></tr></thead><tbody><tr><td>x-discriminator-value</td><td>Used with model inheritance to specify value for discriminator that identifies current model</td><td>MODEL</td><td></td></tr><tr><td>x-implements</td><td>Ability to specify interfaces that model must implements</td><td>MODEL</td><td>empty array</td></tr><tr><td>x-setter-extra-annotation</td><td>Custom annotation that can be specified over java setter for specific field</td><td>FIELD</td><td>When field is array &amp; uniqueItems, then this extension is used to add <code>@JsonDeserialize(as = LinkedHashSet.class)</code> over setter, otherwise no value</td></tr><tr><td>x-tags</td><td>Specify multiple swagger tags for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-accepts</td><td>Specify custom value for &#x27;Accept&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-content-type</td><td>Specify custom value for &#x27;Content-Type&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-class-extra-annotation</td><td>List of custom annotations to be added to model</td><td>MODEL</td><td>null</td></tr><tr><td>x-field-extra-annotation</td><td>List of custom annotations to be added to property</td><td>FIELD</td><td>null</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody><tr><td>Array</td><td>java.util.List</td></tr><tr><td>ArrayList</td><td>java.util.ArrayList</td></tr><tr><td>BigDecimal</td><td>java.math.BigDecimal</td></tr><tr><td>CompletedFileUpload</td><td>io.micronaut.http.multipart.CompletedFileUpload</td></tr><tr><td>Date</td><td>java.util.Date</td></tr><tr><td>DateTime</td><td>org.joda.time.*</td></tr><tr><td>File</td><td>java.io.File</td></tr><tr><td>HashMap</td><td>java.util.HashMap</td></tr><tr><td>LinkedHashSet</td><td>java.util.LinkedHashSet</td></tr><tr><td>List</td><td>java.util.*</td></tr><tr><td>LocalDate</td><td>org.joda.time.*</td></tr><tr><td>LocalDateTime</td><td>org.joda.time.*</td></tr><tr><td>LocalTime</td><td>org.joda.time.*</td></tr><tr><td>Map</td><td>java.util.Map</td></tr><tr><td>Set</td><td>java.util.*</td></tr><tr><td>Timestamp</td><td>java.sql.Timestamp</td></tr><tr><td>URI</td><td>java.net.URI</td></tr><tr><td>UUID</td><td>java.util.UUID</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>ArrayList</td></tr><tr><td>map</td><td>HashMap</td></tr><tr><td>set</td><td>LinkedHashSet</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Double</li><li>Float</li><li>Integer</li><li>Long</li><li>Object</li><li>String</li><li>boolean</li><li>byte[]</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>abstract</li><li>apiclient</li><li>apiexception</li><li>apiresponse</li><li>application</li><li>assert</li><li>authorization</li><li>body</li><li>boolean</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>class</li><li>client</li><li>configuration</li><li>const</li><li>continue</li><li>cookie</li><li>default</li><li>do</li><li>double</li><li>else</li><li>enum</li><li>extends</li><li>file</li><li>final</li><li>finally</li><li>float</li><li>for</li><li>format</li><li>goto</li><li>header</li><li>if</li><li>implements</li><li>import</li><li>instanceof</li><li>int</li><li>interface</li><li>list</li><li>localreturntype</li><li>localvaraccept</li><li>localvaraccepts</li><li>localvarauthnames</li><li>localvarcollectionqueryparams</li><li>localvarcontenttype</li><li>localvarcontenttypes</li><li>localvarcookieparams</li><li>localvarformparams</li><li>localvarheaderparams</li><li>localvarpath</li><li>localvarpostbody</li><li>localvarqueryparams</li><li>long</li><li>native</li><li>new</li><li>null</li><li>object</li><li>package</li><li>pathvariable</li><li>private</li><li>protected</li><li>public</li><li>queryparam</li><li>queryvalue</li><li>return</li><li>short</li><li>static</li><li>strictfp</li><li>stringutil</li><li>super</li><li>switch</li><li>synchronized</li><li>this</li><li>throw</li><li>throws</li><li>transient</li><li>try</li><li>void</li><li>volatile</li><li>while</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✓</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✓</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-server.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-17T16:36:09.000Z" class="docLastUpdatedAt_1sqk">2022-4-17</time> by <strong>Justin Black</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#supported-vendor-extensions" class="contents__link">SUPPORTED VENDOR EXTENSIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the java-micronaut-server Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>java-micronaut-server</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>BETA</td><td></td></tr><tr><td>generator type</td><td>SERVER</td><td></td></tr><tr><td>generator language</td><td>Java</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Generates a Java Micronaut Server.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>additionalEnumTypeAnnotations</td><td>Additional annotations for enum type(class level annotations)</td><td></td><td>null</td></tr><tr><td>additionalModelTypeAnnotations</td><td>Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)</td><td></td><td>null</td></tr><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>artifactDescription</td><td>artifact description in generated pom.xml</td><td></td><td>OpenAPI Java</td></tr><tr><td>artifactId</td><td>artifactId in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>openapi-micronaut</td></tr><tr><td>artifactUrl</td><td>artifact URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>artifactVersion</td><td>artifact version in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>1.0.0</td></tr><tr><td>bigDecimalAsString</td><td>Treat BigDecimal values as Strings to avoid precision loss.</td><td></td><td>false</td></tr><tr><td>booleanGetterPrefix</td><td>Set booleanGetterPrefix</td><td></td><td>get</td></tr><tr><td>build</td><td>Specify for which build tool to generate files</td><td><dl><dt><strong>gradle</strong></dt><dd>Gradle configuration is generated for the project</dd><dt><strong>all</strong></dt><dd>Both Gradle and Maven configurations are generated</dd><dt><strong>maven</strong></dt><dd>Maven configuration is generated for the project</dd></dl></td><td>all</td></tr><tr><td>controllerPackage</td><td>The package in which controllers will be generated</td><td></td><td>org.openapitools.api</td></tr><tr><td>dateFormat</td><td>Specify the format pattern of date as a string</td><td></td><td>null</td></tr><tr><td>dateLibrary</td><td>Option. Date library to use</td><td><dl><dt><strong>java8-localdatetime</strong></dt><dd>Java 8 using LocalDateTime (for legacy app only)</dd><dt><strong>java8</strong></dt><dd>Java 8 native JSR310 (preferred for jdk 1.8+)</dd></dl></td><td>java8</td></tr><tr><td>datetimeFormat</td><td>Specify the format pattern of date-time as a string</td><td></td><td>null</td></tr><tr><td>developerEmail</td><td>developer email in generated pom.xml</td><td></td><td>team@openapitools.org</td></tr><tr><td>developerName</td><td>developer name in generated pom.xml</td><td></td><td>OpenAPI-Generator Contributors</td></tr><tr><td>developerOrganization</td><td>developer organization in generated pom.xml</td><td></td><td>OpenAPITools.org</td></tr><tr><td>developerOrganizationUrl</td><td>developer organization URL in generated pom.xml</td><td></td><td><a href="http://openapitools.org">http://openapitools.org</a></td></tr><tr><td>disableHtmlEscaping</td><td>Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)</td><td></td><td>false</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>discriminatorCaseSensitive</td><td>Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client</td><td></td><td>true</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>enumUnknownDefaultCase</td><td>If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.</td><td><dl><dt><strong>false</strong></dt><dd>No changes to the enum&#x27;s are made, this is the default option.</dd><dt><strong>true</strong></dt><dd>With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.</dd></dl></td><td>false</td></tr><tr><td>fullJavaUtil</td><td>whether to use fully qualified name for classes under java.util. This option only works for Java API client</td><td></td><td>false</td></tr><tr><td>generateControllerAsAbstract</td><td>Generate an abstract class for controller to be extended. (apiPackage is then used for the abstract class, and controllerPackage is used for implementation that extends it.)</td><td></td><td>false</td></tr><tr><td>generateControllerFromExamples</td><td>Generate the implementation of controller and tests from parameter and return examples that will verify that the api works as desired (for testing)</td><td></td><td>false</td></tr><tr><td>groupId</td><td>groupId in generated pom.xml</td><td></td><td>org.openapitools</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>false</td></tr><tr><td>ignoreAnyOfInEnum</td><td>Ignore anyOf keyword in enum</td><td></td><td>false</td></tr><tr><td>implicitHeaders</td><td>Skip header parameters in the generated API methods using @ApiImplicitParams annotation.</td><td></td><td>false</td></tr><tr><td>implicitHeadersRegex</td><td>Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true</td><td></td><td>null</td></tr><tr><td>invokerPackage</td><td>root package for generated code</td><td></td><td>org.openapitools</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>Unlicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://unlicense.org">http://unlicense.org</a></td></tr><tr><td>micronautVersion</td><td>Micronaut version, only &gt;=3.0.0 versions are supported</td><td></td><td>3.3.1</td></tr><tr><td>modelPackage</td><td>package for generated models</td><td></td><td>org.openapitools.model</td></tr><tr><td>openApiNullable</td><td>Enable OpenAPI Jackson Nullable library</td><td></td><td>true</td></tr><tr><td>parentArtifactId</td><td>parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentGroupId</td><td>parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentVersion</td><td>parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>requiredPropertiesInConstructor</td><td>Allow only to create models with all the required properties provided in constructor</td><td></td><td>true</td></tr><tr><td>scmConnection</td><td>SCM connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmDeveloperConnection</td><td>SCM developer connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmUrl</td><td>SCM URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>serializableModel</td><td>boolean - toggle &quot;implements Serializable&quot; for generated models</td><td></td><td>false</td></tr><tr><td>snapshotVersion</td><td>Uses a SNAPSHOT version.</td><td><dl><dt><strong>true</strong></dt><dd>Use a SnapShot Version</dd><dt><strong>false</strong></dt><dd>Use a Release Version</dd></dl></td><td>null</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src/main/java</td></tr><tr><td>test</td><td>Specify which test tool to generate files for</td><td><dl><dt><strong>junit</strong></dt><dd>Use JUnit as test tool</dd><dt><strong>spock</strong></dt><dd>Use Spock as test tool</dd></dl></td><td>junit</td></tr><tr><td>testOutput</td><td>Set output folder for models and APIs tests</td><td></td><td>${project.build.directory}/generated-test-sources/openapi</td></tr><tr><td>title</td><td>Client service name</td><td></td><td>null</td></tr><tr><td>useAuth</td><td>Whether to import authorization and to annotate controller methods accordingly</td><td></td><td>true</td></tr><tr><td>useBeanValidation</td><td>Use BeanValidation API annotations</td><td></td><td>true</td></tr><tr><td>useOptional</td><td>Use Optional container for optional parameters</td><td></td><td>false</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-vendor-extensions"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-vendor-extensions" title="Direct link to heading">#</a>SUPPORTED VENDOR EXTENSIONS</h2><table><thead><tr><th>Extension name</th><th>Description</th><th>Applicable for</th><th>Default value</th></tr></thead><tbody><tr><td>x-discriminator-value</td><td>Used with model inheritance to specify value for discriminator that identifies current model</td><td>MODEL</td><td></td></tr><tr><td>x-implements</td><td>Ability to specify interfaces that model must implements</td><td>MODEL</td><td>empty array</td></tr><tr><td>x-setter-extra-annotation</td><td>Custom annotation that can be specified over java setter for specific field</td><td>FIELD</td><td>When field is array &amp; uniqueItems, then this extension is used to add <code>@JsonDeserialize(as = LinkedHashSet.class)</code> over setter, otherwise no value</td></tr><tr><td>x-tags</td><td>Specify multiple swagger tags for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-accepts</td><td>Specify custom value for &#x27;Accept&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-content-type</td><td>Specify custom value for &#x27;Content-Type&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-class-extra-annotation</td><td>List of custom annotations to be added to model</td><td>MODEL</td><td>null</td></tr><tr><td>x-field-extra-annotation</td><td>List of custom annotations to be added to property</td><td>FIELD</td><td>null</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody><tr><td>Array</td><td>java.util.List</td></tr><tr><td>ArrayList</td><td>java.util.ArrayList</td></tr><tr><td>BigDecimal</td><td>java.math.BigDecimal</td></tr><tr><td>CompletedFileUpload</td><td>io.micronaut.http.multipart.CompletedFileUpload</td></tr><tr><td>Date</td><td>java.util.Date</td></tr><tr><td>DateTime</td><td>org.joda.time.*</td></tr><tr><td>File</td><td>java.io.File</td></tr><tr><td>HashMap</td><td>java.util.HashMap</td></tr><tr><td>LinkedHashSet</td><td>java.util.LinkedHashSet</td></tr><tr><td>List</td><td>java.util.*</td></tr><tr><td>LocalDate</td><td>org.joda.time.*</td></tr><tr><td>LocalDateTime</td><td>org.joda.time.*</td></tr><tr><td>LocalTime</td><td>org.joda.time.*</td></tr><tr><td>Map</td><td>java.util.Map</td></tr><tr><td>Set</td><td>java.util.*</td></tr><tr><td>Timestamp</td><td>java.sql.Timestamp</td></tr><tr><td>URI</td><td>java.net.URI</td></tr><tr><td>UUID</td><td>java.util.UUID</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>ArrayList</td></tr><tr><td>map</td><td>HashMap</td></tr><tr><td>set</td><td>LinkedHashSet</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Double</li><li>Float</li><li>Integer</li><li>Long</li><li>Object</li><li>String</li><li>boolean</li><li>byte[]</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>abstract</li><li>apiclient</li><li>apiexception</li><li>apiresponse</li><li>application</li><li>assert</li><li>authorization</li><li>body</li><li>boolean</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>class</li><li>client</li><li>configuration</li><li>const</li><li>continue</li><li>cookie</li><li>default</li><li>do</li><li>double</li><li>else</li><li>enum</li><li>extends</li><li>file</li><li>final</li><li>finally</li><li>float</li><li>for</li><li>format</li><li>goto</li><li>header</li><li>if</li><li>implements</li><li>import</li><li>instanceof</li><li>int</li><li>interface</li><li>list</li><li>localreturntype</li><li>localvaraccept</li><li>localvaraccepts</li><li>localvarauthnames</li><li>localvarcollectionqueryparams</li><li>localvarcontenttype</li><li>localvarcontenttypes</li><li>localvarcookieparams</li><li>localvarformparams</li><li>localvarheaderparams</li><li>localvarpath</li><li>localvarpostbody</li><li>localvarqueryparams</li><li>long</li><li>native</li><li>new</li><li>null</li><li>object</li><li>package</li><li>pathvariable</li><li>private</li><li>protected</li><li>public</li><li>queryparam</li><li>queryvalue</li><li>return</li><li>short</li><li>static</li><li>strictfp</li><li>stringutil</li><li>super</li><li>switch</li><li>synchronized</li><li>this</li><li>throw</li><li>throws</li><li>transient</li><li>try</li><li>void</li><li>volatile</li><li>while</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✓</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✓</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java-micronaut-server.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-21T02:53:56.000Z" class="docLastUpdatedAt_1sqk">2022-4-21</time> by <strong>Auke Schrijnen</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#supported-vendor-extensions" class="contents__link">SUPPORTED VENDOR EXTENSIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/96fb2cf3.e7049fd7.js"></script>
+<script src="/96fb2cf3.40226c94.js"></script>
 
 
 </body>
diff --git a/docs/generators/java-msf4j/index.html b/docs/generators/java-msf4j/index.html
index eda95d7168e..83e0996240b 100644
--- a/docs/generators/java-msf4j/index.html
+++ b/docs/generators/java-msf4j/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-pkmst/index.html b/docs/generators/java-pkmst/index.html
index 89b829f64da..fa6e80fae2f 100644
--- a/docs/generators/java-pkmst/index.html
+++ b/docs/generators/java-pkmst/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-play-framework/index.html b/docs/generators/java-play-framework/index.html
index 3ed1b681c36..3d3ad2c71be 100644
--- a/docs/generators/java-play-framework/index.html
+++ b/docs/generators/java-play-framework/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-undertow-server/index.html b/docs/generators/java-undertow-server/index.html
index d1b6f5ff5d8..da22b727bb3 100644
--- a/docs/generators/java-undertow-server/index.html
+++ b/docs/generators/java-undertow-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-vertx-web/index.html b/docs/generators/java-vertx-web/index.html
index 77cb075f253..884574e366f 100644
--- a/docs/generators/java-vertx-web/index.html
+++ b/docs/generators/java-vertx-web/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java-vertx/index.html b/docs/generators/java-vertx/index.html
index 016a36475e0..fca50846172 100644
--- a/docs/generators/java-vertx/index.html
+++ b/docs/generators/java-vertx/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/java/index.html b/docs/generators/java/index.html
index 77f497f545e..835a1840670 100644
--- a/docs/generators/java/index.html
+++ b/docs/generators/java/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the java Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>java</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>STABLE</td><td></td></tr><tr><td>generator type</td><td>CLIENT</td><td></td></tr><tr><td>generator language</td><td>Java</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Generates a Java client library (HTTP lib: Jersey (1.x, 2.x), Retrofit (2.x), OpenFeign (10.x) and more.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>additionalEnumTypeAnnotations</td><td>Additional annotations for enum type(class level annotations)</td><td></td><td>null</td></tr><tr><td>additionalModelTypeAnnotations</td><td>Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)</td><td></td><td>null</td></tr><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>apiPackage</td><td>package for generated api classes</td><td></td><td>org.openapitools.client.api</td></tr><tr><td>artifactDescription</td><td>artifact description in generated pom.xml</td><td></td><td>OpenAPI Java</td></tr><tr><td>artifactId</td><td>artifactId in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>openapi-java-client</td></tr><tr><td>artifactUrl</td><td>artifact URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>artifactVersion</td><td>artifact version in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>1.0.0</td></tr><tr><td>asyncNative</td><td>If true, async handlers will be used, instead of the sync version</td><td></td><td>false</td></tr><tr><td>bigDecimalAsString</td><td>Treat BigDecimal values as Strings to avoid precision loss.</td><td></td><td>false</td></tr><tr><td>booleanGetterPrefix</td><td>Set booleanGetterPrefix</td><td></td><td>get</td></tr><tr><td>caseInsensitiveResponseHeaders</td><td>Make API response&#x27;s headers case-insensitive. Available on okhttp-gson, jersey2 libraries</td><td></td><td>false</td></tr><tr><td>configKey</td><td>Config key in @RegisterRestClient. Default to none. Only <code>microprofile</code> supports this option.</td><td></td><td>null</td></tr><tr><td>dateLibrary</td><td>Option. Date library to use</td><td><dl><dt><strong>joda</strong></dt><dd>Joda (for legacy app only)</dd><dt><strong>legacy</strong></dt><dd>Legacy java.util.Date</dd><dt><strong>java8-localdatetime</strong></dt><dd>Java 8 using LocalDateTime (for legacy app only)</dd><dt><strong>java8</strong></dt><dd>Java 8 native JSR310 (preferred for jdk 1.8+)</dd></dl></td><td>java8</td></tr><tr><td>developerEmail</td><td>developer email in generated pom.xml</td><td></td><td>team@openapitools.org</td></tr><tr><td>developerName</td><td>developer name in generated pom.xml</td><td></td><td>OpenAPI-Generator Contributors</td></tr><tr><td>developerOrganization</td><td>developer organization in generated pom.xml</td><td></td><td>OpenAPITools.org</td></tr><tr><td>developerOrganizationUrl</td><td>developer organization URL in generated pom.xml</td><td></td><td><a href="http://openapitools.org">http://openapitools.org</a></td></tr><tr><td>disableHtmlEscaping</td><td>Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)</td><td></td><td>false</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>discriminatorCaseSensitive</td><td>Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client</td><td></td><td>true</td></tr><tr><td>dynamicOperations</td><td>Generate operations dynamically at runtime from an OAS</td><td></td><td>false</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>enumUnknownDefaultCase</td><td>If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.</td><td><dl><dt><strong>false</strong></dt><dd>No changes to the enum&#x27;s are made, this is the default option.</dd><dt><strong>true</strong></dt><dd>With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.</dd></dl></td><td>false</td></tr><tr><td>errorObjectType</td><td>Error Object type. (This option is for okhttp-gson-next-gen only)</td><td></td><td>null</td></tr><tr><td>fullJavaUtil</td><td>whether to use fully qualified name for classes under java.util. This option only works for Java API client</td><td></td><td>false</td></tr><tr><td>gradleProperties</td><td>Append additional Gradle properties to the gradle.properties file</td><td></td><td>null</td></tr><tr><td>groupId</td><td>groupId in generated pom.xml</td><td></td><td>org.openapitools</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>false</td></tr><tr><td>ignoreAnyOfInEnum</td><td>Ignore anyOf keyword in enum</td><td></td><td>false</td></tr><tr><td>implicitHeaders</td><td>Skip header parameters in the generated API methods using @ApiImplicitParams annotation.</td><td></td><td>false</td></tr><tr><td>implicitHeadersRegex</td><td>Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true</td><td></td><td>null</td></tr><tr><td>invokerPackage</td><td>root package for generated code</td><td></td><td>org.openapitools.client</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>library</td><td>library template (sub-template) to use</td><td><dl><dt><strong>jersey1</strong></dt><dd>HTTP client: Jersey client 1.19.x. JSON processing: Jackson 2.9.x. Enable gzip request encoding using &#x27;-DuseGzipFeature=true&#x27;. IMPORTANT NOTE: jersey 1.x is no longer actively maintained so please upgrade to &#x27;jersey3&#x27; or other HTTP libraries instead.</dd><dt><strong>jersey2</strong></dt><dd>HTTP client: Jersey client 2.25.1. JSON processing: Jackson 2.9.x</dd><dt><strong>jersey3</strong></dt><dd>HTTP client: Jersey client 3.x. JSON processing: Jackson 2.x</dd><dt><strong>feign</strong></dt><dd>HTTP client: OpenFeign 10.x. JSON processing: Jackson 2.9.x.</dd><dt><strong>okhttp-gson</strong></dt><dd>[DEFAULT] HTTP client: OkHttp 3.x. JSON processing: Gson 2.8.x. Enable Parcelable models on Android using &#x27;-DparcelableModel=true&#x27;. Enable gzip request encoding using &#x27;-DuseGzipFeature=true&#x27;.</dd><dt><strong>retrofit2</strong></dt><dd>HTTP client: OkHttp 3.x. JSON processing: Gson 2.x (Retrofit 2.3.0). Enable the RxJava adapter using &#x27;-DuseRxJava[2/3]=true&#x27;. (RxJava 1.x or 2.x or 3.x)</dd><dt><strong>resttemplate</strong></dt><dd>HTTP client: Spring RestTemplate 4.x. JSON processing: Jackson 2.9.x</dd><dt><strong>webclient</strong></dt><dd>HTTP client: Spring WebClient 5.x. JSON processing: Jackson 2.9.x</dd><dt><strong>resteasy</strong></dt><dd>HTTP client: Resteasy client 3.x. JSON processing: Jackson 2.9.x</dd><dt><strong>vertx</strong></dt><dd>HTTP client: VertX client 3.x. JSON processing: Jackson 2.9.x</dd><dt><strong>google-api-client</strong></dt><dd>HTTP client: Google API client 1.x. JSON processing: Jackson 2.9.x</dd><dt><strong>rest-assured</strong></dt><dd>HTTP client: rest-assured : 4.x. JSON processing: Gson 2.x or Jackson 2.10.x. Only for Java 8</dd><dt><strong>native</strong></dt><dd>HTTP client: Java native HttpClient. JSON processing: Jackson 2.9.x. Only for Java11+</dd><dt><strong>microprofile</strong></dt><dd>HTTP client: Microprofile client 1.x. JSON processing: JSON-B</dd><dt><strong>apache-httpclient</strong></dt><dd>HTTP client: Apache httpclient 4.x</dd></dl></td><td>okhttp-gson</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>Unlicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://unlicense.org">http://unlicense.org</a></td></tr><tr><td>microprofileFramework</td><td>Framework for microprofile. Possible values &quot;kumuluzee&quot;</td><td></td><td>null</td></tr><tr><td>modelPackage</td><td>package for generated models</td><td></td><td>org.openapitools.client.model</td></tr><tr><td>openApiNullable</td><td>Enable OpenAPI Jackson Nullable library</td><td></td><td>true</td></tr><tr><td>parcelableModel</td><td>Whether to generate models for Android that implement Parcelable with the okhttp-gson library.</td><td></td><td>false</td></tr><tr><td>parentArtifactId</td><td>parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentGroupId</td><td>parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentVersion</td><td>parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>performBeanValidation</td><td>Perform BeanValidation</td><td></td><td>false</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>scmConnection</td><td>SCM connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmDeveloperConnection</td><td>SCM developer connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmUrl</td><td>SCM URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>serializableModel</td><td>boolean - toggle &quot;implements Serializable&quot; for generated models</td><td></td><td>false</td></tr><tr><td>serializationLibrary</td><td>Serialization library, default depends on value of the option library</td><td><dl><dt><strong>jsonb</strong></dt><dd>Use JSON-B as serialization library</dd><dt><strong>jackson</strong></dt><dd>Use Jackson as serialization library</dd><dt><strong>gson</strong></dt><dd>Use Gson as serialization library</dd></dl></td><td>null</td></tr><tr><td>snapshotVersion</td><td>Uses a SNAPSHOT version.</td><td><dl><dt><strong>true</strong></dt><dd>Use a SnapShot Version</dd><dt><strong>false</strong></dt><dd>Use a Release Version</dd></dl></td><td>null</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src/main/java</td></tr><tr><td>supportStreaming</td><td>Support streaming endpoint (beta)</td><td></td><td>false</td></tr><tr><td>testOutput</td><td>Set output folder for models and APIs tests</td><td></td><td>${project.build.directory}/generated-test-sources/openapi</td></tr><tr><td>useAbstractionForFiles</td><td>Use alternative types instead of java.io.File to allow passing bytes without a file on disk. Available on resttemplate, webclient, libraries</td><td></td><td>false</td></tr><tr><td>useBeanValidation</td><td>Use BeanValidation API annotations</td><td></td><td>false</td></tr><tr><td>useGzipFeature</td><td>Send gzip-encoded requests</td><td></td><td>false</td></tr><tr><td>useOneOfDiscriminatorLookup</td><td>Use the discriminator&#x27;s mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf&#x27;s schemas) will be skipped. Only jersey2, jersey3, native, okhttp-gson support this option.</td><td></td><td>false</td></tr><tr><td>usePlayWS</td><td>Use Play! Async HTTP client (Play WS API)</td><td></td><td>false</td></tr><tr><td>useReflectionEqualsHashCode</td><td>Use org.apache.commons.lang3.builder for equals and hashCode in the models. WARNING: This will fail under a security manager, unless the appropriate permissions are set up correctly and also there&#x27;s potential performance impact.</td><td></td><td>false</td></tr><tr><td>useRuntimeException</td><td>Use RuntimeException instead of Exception</td><td></td><td>false</td></tr><tr><td>useRxJava2</td><td>Whether to use the RxJava2 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated.</td><td></td><td>false</td></tr><tr><td>useRxJava3</td><td>Whether to use the RxJava3 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated.</td><td></td><td>false</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-vendor-extensions"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-vendor-extensions" title="Direct link to heading">#</a>SUPPORTED VENDOR EXTENSIONS</h2><table><thead><tr><th>Extension name</th><th>Description</th><th>Applicable for</th><th>Default value</th></tr></thead><tbody><tr><td>x-discriminator-value</td><td>Used with model inheritance to specify value for discriminator that identifies current model</td><td>MODEL</td><td></td></tr><tr><td>x-implements</td><td>Ability to specify interfaces that model must implements</td><td>MODEL</td><td>empty array</td></tr><tr><td>x-setter-extra-annotation</td><td>Custom annotation that can be specified over java setter for specific field</td><td>FIELD</td><td>When field is array &amp; uniqueItems, then this extension is used to add <code>@JsonDeserialize(as = LinkedHashSet.class)</code> over setter, otherwise no value</td></tr><tr><td>x-tags</td><td>Specify multiple swagger tags for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-accepts</td><td>Specify custom value for &#x27;Accept&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-content-type</td><td>Specify custom value for &#x27;Content-Type&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-class-extra-annotation</td><td>List of custom annotations to be added to model</td><td>MODEL</td><td>null</td></tr><tr><td>x-field-extra-annotation</td><td>List of custom annotations to be added to property</td><td>FIELD</td><td>null</td></tr><tr><td>x-webclient-blocking</td><td>Specifies if method for specific operation should be blocking or non-blocking(ex: return <code>Mono&lt;T&gt;/Flux&lt;T&gt;</code> or <code>return T/List&lt;T&gt;/Set&lt;T&gt;</code> &amp; execute <code>.block()</code> inside generated method)</td><td>OPERATION</td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody><tr><td>Array</td><td>java.util.List</td></tr><tr><td>ArrayList</td><td>java.util.ArrayList</td></tr><tr><td>BigDecimal</td><td>java.math.BigDecimal</td></tr><tr><td>Date</td><td>java.util.Date</td></tr><tr><td>DateTime</td><td>org.joda.time.*</td></tr><tr><td>File</td><td>java.io.File</td></tr><tr><td>HashMap</td><td>java.util.HashMap</td></tr><tr><td>LinkedHashSet</td><td>java.util.LinkedHashSet</td></tr><tr><td>List</td><td>java.util.*</td></tr><tr><td>LocalDate</td><td>org.joda.time.*</td></tr><tr><td>LocalDateTime</td><td>org.joda.time.*</td></tr><tr><td>LocalTime</td><td>org.joda.time.*</td></tr><tr><td>Map</td><td>java.util.Map</td></tr><tr><td>Set</td><td>java.util.*</td></tr><tr><td>Timestamp</td><td>java.sql.Timestamp</td></tr><tr><td>URI</td><td>java.net.URI</td></tr><tr><td>UUID</td><td>java.util.UUID</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>ArrayList</td></tr><tr><td>map</td><td>HashMap</td></tr><tr><td>set</td><td>LinkedHashSet</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Double</li><li>Float</li><li>Integer</li><li>Long</li><li>Object</li><li>String</li><li>boolean</li><li>byte[]</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>abstract</li><li>apiclient</li><li>apiexception</li><li>apiresponse</li><li>assert</li><li>boolean</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>class</li><li>configuration</li><li>const</li><li>continue</li><li>default</li><li>do</li><li>double</li><li>else</li><li>enum</li><li>extends</li><li>file</li><li>final</li><li>finally</li><li>float</li><li>for</li><li>goto</li><li>if</li><li>implements</li><li>import</li><li>instanceof</li><li>int</li><li>interface</li><li>list</li><li>localreturntype</li><li>localvaraccept</li><li>localvaraccepts</li><li>localvarauthnames</li><li>localvarcollectionqueryparams</li><li>localvarcontenttype</li><li>localvarcontenttypes</li><li>localvarcookieparams</li><li>localvarformparams</li><li>localvarheaderparams</li><li>localvarpath</li><li>localvarpostbody</li><li>localvarqueryparams</li><li>long</li><li>native</li><li>new</li><li>null</li><li>object</li><li>package</li><li>private</li><li>protected</li><li>public</li><li>return</li><li>short</li><li>static</li><li>strictfp</li><li>stringutil</li><li>super</li><li>switch</li><li>synchronized</li><li>this</li><li>throw</li><li>throws</li><li>transient</li><li>try</li><li>void</li><li>volatile</li><li>while</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✓</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-17T16:36:09.000Z" class="docLastUpdatedAt_1sqk">2022-4-17</time> by <strong>Justin Black</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#supported-vendor-extensions" class="contents__link">SUPPORTED VENDOR EXTENSIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Documentation for the java Generator</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata" title="Direct link to heading">#</a>METADATA</h2><table><thead><tr><th>Property</th><th>Value</th><th>Notes</th></tr></thead><tbody><tr><td>generator name</td><td>java</td><td>pass this to the generate command after -g</td></tr><tr><td>generator stability</td><td>STABLE</td><td></td></tr><tr><td>generator type</td><td>CLIENT</td><td></td></tr><tr><td>generator language</td><td>Java</td><td></td></tr><tr><td>generator default templating engine</td><td>mustache</td><td></td></tr><tr><td>helpTxt</td><td>Generates a Java client library (HTTP lib: Jersey (1.x, 2.x), Retrofit (2.x), OpenFeign (10.x) and more.</td><td></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-options"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-options" title="Direct link to heading">#</a>CONFIG OPTIONS</h2><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>additionalEnumTypeAnnotations</td><td>Additional annotations for enum type(class level annotations)</td><td></td><td>null</td></tr><tr><td>additionalModelTypeAnnotations</td><td>Additional annotations for model type(class level annotations). List separated by semicolon(;) or new line (Linux or Windows)</td><td></td><td>null</td></tr><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>apiPackage</td><td>package for generated api classes</td><td></td><td>org.openapitools.client.api</td></tr><tr><td>artifactDescription</td><td>artifact description in generated pom.xml</td><td></td><td>OpenAPI Java</td></tr><tr><td>artifactId</td><td>artifactId in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>openapi-java-client</td></tr><tr><td>artifactUrl</td><td>artifact URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>artifactVersion</td><td>artifact version in generated pom.xml. This also becomes part of the generated library&#x27;s filename</td><td></td><td>1.0.0</td></tr><tr><td>asyncNative</td><td>If true, async handlers will be used, instead of the sync version</td><td></td><td>false</td></tr><tr><td>bigDecimalAsString</td><td>Treat BigDecimal values as Strings to avoid precision loss.</td><td></td><td>false</td></tr><tr><td>booleanGetterPrefix</td><td>Set booleanGetterPrefix</td><td></td><td>get</td></tr><tr><td>caseInsensitiveResponseHeaders</td><td>Make API response&#x27;s headers case-insensitive. Available on okhttp-gson, jersey2 libraries</td><td></td><td>false</td></tr><tr><td>configKey</td><td>Config key in @RegisterRestClient. Default to none. Only <code>microprofile</code> supports this option.</td><td></td><td>null</td></tr><tr><td>dateLibrary</td><td>Option. Date library to use</td><td><dl><dt><strong>joda</strong></dt><dd>Joda (for legacy app only)</dd><dt><strong>legacy</strong></dt><dd>Legacy java.util.Date</dd><dt><strong>java8-localdatetime</strong></dt><dd>Java 8 using LocalDateTime (for legacy app only)</dd><dt><strong>java8</strong></dt><dd>Java 8 native JSR310 (preferred for jdk 1.8+)</dd></dl></td><td>java8</td></tr><tr><td>developerEmail</td><td>developer email in generated pom.xml</td><td></td><td>team@openapitools.org</td></tr><tr><td>developerName</td><td>developer name in generated pom.xml</td><td></td><td>OpenAPI-Generator Contributors</td></tr><tr><td>developerOrganization</td><td>developer organization in generated pom.xml</td><td></td><td>OpenAPITools.org</td></tr><tr><td>developerOrganizationUrl</td><td>developer organization URL in generated pom.xml</td><td></td><td><a href="http://openapitools.org">http://openapitools.org</a></td></tr><tr><td>disableHtmlEscaping</td><td>Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)</td><td></td><td>false</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>discriminatorCaseSensitive</td><td>Whether the discriminator value lookup should be case-sensitive or not. This option only works for Java API client</td><td></td><td>true</td></tr><tr><td>dynamicOperations</td><td>Generate operations dynamically at runtime from an OAS</td><td></td><td>false</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>enumUnknownDefaultCase</td><td>If the server adds new enum cases, that are unknown by an old spec/client, the client will fail to parse the network response.With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the server sends an enum case that is not known by the client/spec, they can safely fallback to this case.</td><td><dl><dt><strong>false</strong></dt><dd>No changes to the enum&#x27;s are made, this is the default option.</dd><dt><strong>true</strong></dt><dd>With this option enabled, each enum will have a new case, &#x27;unknown_default_open_api&#x27;, so that when the enum case sent by the server is not known by the client/spec, can safely be decoded to this case.</dd></dl></td><td>false</td></tr><tr><td>errorObjectType</td><td>Error Object type. (This option is for okhttp-gson-next-gen only)</td><td></td><td>null</td></tr><tr><td>fullJavaUtil</td><td>whether to use fully qualified name for classes under java.util. This option only works for Java API client</td><td></td><td>false</td></tr><tr><td>gradleProperties</td><td>Append additional Gradle properties to the gradle.properties file</td><td></td><td>null</td></tr><tr><td>groupId</td><td>groupId in generated pom.xml</td><td></td><td>org.openapitools</td></tr><tr><td>hideGenerationTimestamp</td><td>Hides the generation timestamp when files are generated.</td><td></td><td>false</td></tr><tr><td>ignoreAnyOfInEnum</td><td>Ignore anyOf keyword in enum</td><td></td><td>false</td></tr><tr><td>implicitHeaders</td><td>Skip header parameters in the generated API methods using @ApiImplicitParams annotation.</td><td></td><td>false</td></tr><tr><td>implicitHeadersRegex</td><td>Skip header parameters that matches given regex in the generated API methods using @ApiImplicitParams annotation. Note: this parameter is ignored when implicitHeaders=true</td><td></td><td>null</td></tr><tr><td>invokerPackage</td><td>root package for generated code</td><td></td><td>org.openapitools.client</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>library</td><td>library template (sub-template) to use</td><td><dl><dt><strong>jersey1</strong></dt><dd>HTTP client: Jersey client 1.19.x. JSON processing: Jackson 2.9.x. Enable gzip request encoding using &#x27;-DuseGzipFeature=true&#x27;. IMPORTANT NOTE: jersey 1.x is no longer actively maintained so please upgrade to &#x27;jersey3&#x27; or other HTTP libraries instead.</dd><dt><strong>jersey2</strong></dt><dd>HTTP client: Jersey client 2.25.1. JSON processing: Jackson 2.9.x</dd><dt><strong>jersey3</strong></dt><dd>HTTP client: Jersey client 3.x. JSON processing: Jackson 2.x</dd><dt><strong>feign</strong></dt><dd>HTTP client: OpenFeign 10.x. JSON processing: Jackson 2.9.x.</dd><dt><strong>okhttp-gson</strong></dt><dd>[DEFAULT] HTTP client: OkHttp 3.x. JSON processing: Gson 2.8.x. Enable Parcelable models on Android using &#x27;-DparcelableModel=true&#x27;. Enable gzip request encoding using &#x27;-DuseGzipFeature=true&#x27;.</dd><dt><strong>retrofit2</strong></dt><dd>HTTP client: OkHttp 3.x. JSON processing: Gson 2.x (Retrofit 2.3.0). Enable the RxJava adapter using &#x27;-DuseRxJava[2/3]=true&#x27;. (RxJava 1.x or 2.x or 3.x)</dd><dt><strong>resttemplate</strong></dt><dd>HTTP client: Spring RestTemplate 4.x. JSON processing: Jackson 2.9.x</dd><dt><strong>webclient</strong></dt><dd>HTTP client: Spring WebClient 5.x. JSON processing: Jackson 2.9.x</dd><dt><strong>resteasy</strong></dt><dd>HTTP client: Resteasy client 3.x. JSON processing: Jackson 2.9.x</dd><dt><strong>vertx</strong></dt><dd>HTTP client: VertX client 3.x. JSON processing: Jackson 2.9.x</dd><dt><strong>google-api-client</strong></dt><dd>HTTP client: Google API client 1.x. JSON processing: Jackson 2.9.x</dd><dt><strong>rest-assured</strong></dt><dd>HTTP client: rest-assured : 4.x. JSON processing: Gson 2.x or Jackson 2.10.x. Only for Java 8</dd><dt><strong>native</strong></dt><dd>HTTP client: Java native HttpClient. JSON processing: Jackson 2.9.x. Only for Java11+</dd><dt><strong>microprofile</strong></dt><dd>HTTP client: Microprofile client 1.x. JSON processing: JSON-B</dd><dt><strong>apache-httpclient</strong></dt><dd>HTTP client: Apache httpclient 4.x</dd></dl></td><td>okhttp-gson</td></tr><tr><td>licenseName</td><td>The name of the license</td><td></td><td>Unlicense</td></tr><tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td><a href="http://unlicense.org">http://unlicense.org</a></td></tr><tr><td>microprofileFramework</td><td>Framework for microprofile. Possible values &quot;kumuluzee&quot;</td><td></td><td>null</td></tr><tr><td>microprofileRestClientVersion</td><td>Version of MicroProfile Rest Client API.</td><td></td><td>null</td></tr><tr><td>modelPackage</td><td>package for generated models</td><td></td><td>org.openapitools.client.model</td></tr><tr><td>openApiNullable</td><td>Enable OpenAPI Jackson Nullable library</td><td></td><td>true</td></tr><tr><td>parcelableModel</td><td>Whether to generate models for Android that implement Parcelable with the okhttp-gson library.</td><td></td><td>false</td></tr><tr><td>parentArtifactId</td><td>parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentGroupId</td><td>parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>parentVersion</td><td>parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr><tr><td>performBeanValidation</td><td>Perform BeanValidation</td><td></td><td>false</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>scmConnection</td><td>SCM connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmDeveloperConnection</td><td>SCM developer connection in generated pom.xml</td><td></td><td>scm:git:git@github.com:openapitools/openapi-generator.git</td></tr><tr><td>scmUrl</td><td>SCM URL in generated pom.xml</td><td></td><td><a href="https://github.com/openapitools/openapi-generator">https://github.com/openapitools/openapi-generator</a></td></tr><tr><td>serializableModel</td><td>boolean - toggle &quot;implements Serializable&quot; for generated models</td><td></td><td>false</td></tr><tr><td>serializationLibrary</td><td>Serialization library, default depends on value of the option library</td><td><dl><dt><strong>jsonb</strong></dt><dd>Use JSON-B as serialization library</dd><dt><strong>jackson</strong></dt><dd>Use Jackson as serialization library</dd><dt><strong>gson</strong></dt><dd>Use Gson as serialization library</dd></dl></td><td>null</td></tr><tr><td>snapshotVersion</td><td>Uses a SNAPSHOT version.</td><td><dl><dt><strong>true</strong></dt><dd>Use a SnapShot Version</dd><dt><strong>false</strong></dt><dd>Use a Release Version</dd></dl></td><td>null</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>src/main/java</td></tr><tr><td>supportStreaming</td><td>Support streaming endpoint (beta)</td><td></td><td>false</td></tr><tr><td>testOutput</td><td>Set output folder for models and APIs tests</td><td></td><td>${project.build.directory}/generated-test-sources/openapi</td></tr><tr><td>useAbstractionForFiles</td><td>Use alternative types instead of java.io.File to allow passing bytes without a file on disk. Available on resttemplate, webclient, libraries</td><td></td><td>false</td></tr><tr><td>useBeanValidation</td><td>Use BeanValidation API annotations</td><td></td><td>false</td></tr><tr><td>useGzipFeature</td><td>Send gzip-encoded requests</td><td></td><td>false</td></tr><tr><td>useOneOfDiscriminatorLookup</td><td>Use the discriminator&#x27;s mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and only one match in oneOf&#x27;s schemas) will be skipped. Only jersey2, jersey3, native, okhttp-gson support this option.</td><td></td><td>false</td></tr><tr><td>usePlayWS</td><td>Use Play! Async HTTP client (Play WS API)</td><td></td><td>false</td></tr><tr><td>useReflectionEqualsHashCode</td><td>Use org.apache.commons.lang3.builder for equals and hashCode in the models. WARNING: This will fail under a security manager, unless the appropriate permissions are set up correctly and also there&#x27;s potential performance impact.</td><td></td><td>false</td></tr><tr><td>useRuntimeException</td><td>Use RuntimeException instead of Exception</td><td></td><td>false</td></tr><tr><td>useRxJava2</td><td>Whether to use the RxJava2 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated.</td><td></td><td>false</td></tr><tr><td>useRxJava3</td><td>Whether to use the RxJava3 adapter with the retrofit2 library. IMPORTANT: This option has been deprecated.</td><td></td><td>false</td></tr><tr><td>withXml</td><td>whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)</td><td></td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="supported-vendor-extensions"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#supported-vendor-extensions" title="Direct link to heading">#</a>SUPPORTED VENDOR EXTENSIONS</h2><table><thead><tr><th>Extension name</th><th>Description</th><th>Applicable for</th><th>Default value</th></tr></thead><tbody><tr><td>x-discriminator-value</td><td>Used with model inheritance to specify value for discriminator that identifies current model</td><td>MODEL</td><td></td></tr><tr><td>x-implements</td><td>Ability to specify interfaces that model must implements</td><td>MODEL</td><td>empty array</td></tr><tr><td>x-setter-extra-annotation</td><td>Custom annotation that can be specified over java setter for specific field</td><td>FIELD</td><td>When field is array &amp; uniqueItems, then this extension is used to add <code>@JsonDeserialize(as = LinkedHashSet.class)</code> over setter, otherwise no value</td></tr><tr><td>x-tags</td><td>Specify multiple swagger tags for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-accepts</td><td>Specify custom value for &#x27;Accept&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-content-type</td><td>Specify custom value for &#x27;Content-Type&#x27; header for operation</td><td>OPERATION</td><td>null</td></tr><tr><td>x-class-extra-annotation</td><td>List of custom annotations to be added to model</td><td>MODEL</td><td>null</td></tr><tr><td>x-field-extra-annotation</td><td>List of custom annotations to be added to property</td><td>FIELD</td><td>null</td></tr><tr><td>x-webclient-blocking</td><td>Specifies if method for specific operation should be blocking or non-blocking(ex: return <code>Mono&lt;T&gt;/Flux&lt;T&gt;</code> or <code>return T/List&lt;T&gt;/Set&lt;T&gt;</code> &amp; execute <code>.block()</code> inside generated method)</td><td>OPERATION</td><td>false</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody><tr><td>Array</td><td>java.util.List</td></tr><tr><td>ArrayList</td><td>java.util.ArrayList</td></tr><tr><td>BigDecimal</td><td>java.math.BigDecimal</td></tr><tr><td>Date</td><td>java.util.Date</td></tr><tr><td>DateTime</td><td>org.joda.time.*</td></tr><tr><td>File</td><td>java.io.File</td></tr><tr><td>HashMap</td><td>java.util.HashMap</td></tr><tr><td>LinkedHashSet</td><td>java.util.LinkedHashSet</td></tr><tr><td>List</td><td>java.util.*</td></tr><tr><td>LocalDate</td><td>org.joda.time.*</td></tr><tr><td>LocalDateTime</td><td>org.joda.time.*</td></tr><tr><td>LocalTime</td><td>org.joda.time.*</td></tr><tr><td>Map</td><td>java.util.Map</td></tr><tr><td>Set</td><td>java.util.*</td></tr><tr><td>Timestamp</td><td>java.sql.Timestamp</td></tr><tr><td>URI</td><td>java.net.URI</td></tr><tr><td>UUID</td><td>java.util.UUID</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody><tr><td>array</td><td>ArrayList</td></tr><tr><td>map</td><td>HashMap</td></tr><tr><td>set</td><td>LinkedHashSet</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>Boolean</li><li>Double</li><li>Float</li><li>Integer</li><li>Long</li><li>Object</li><li>String</li><li>boolean</li><li>byte[]</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>abstract</li><li>apiclient</li><li>apiexception</li><li>apiresponse</li><li>assert</li><li>boolean</li><li>break</li><li>byte</li><li>case</li><li>catch</li><li>char</li><li>class</li><li>configuration</li><li>const</li><li>continue</li><li>default</li><li>do</li><li>double</li><li>else</li><li>enum</li><li>extends</li><li>file</li><li>final</li><li>finally</li><li>float</li><li>for</li><li>goto</li><li>if</li><li>implements</li><li>import</li><li>instanceof</li><li>int</li><li>interface</li><li>list</li><li>localreturntype</li><li>localvaraccept</li><li>localvaraccepts</li><li>localvarauthnames</li><li>localvarcollectionqueryparams</li><li>localvarcontenttype</li><li>localvarcontenttypes</li><li>localvarcookieparams</li><li>localvarformparams</li><li>localvarheaderparams</li><li>localvarpath</li><li>localvarpostbody</li><li>localvarqueryparams</li><li>long</li><li>native</li><li>new</li><li>null</li><li>object</li><li>package</li><li>private</li><li>protected</li><li>public</li><li>return</li><li>short</li><li>static</li><li>strictfp</li><li>stringutil</li><li>super</li><li>switch</li><li>synchronized</li><li>this</li><li>throw</li><li>throws</li><li>transient</li><li>try</li><li>void</li><li>volatile</li><li>while</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Uuid</td><td>✗</td><td></td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Null</td><td>✗</td><td>OAS3</td></tr><tr><td>AnyType</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Object</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✓</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✓</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✓</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✓</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr><tr><td>allOf</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>anyOf</td><td>✗</td><td>OAS3</td></tr><tr><td>oneOf</td><td>✗</td><td>OAS3</td></tr><tr><td>not</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✗</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/java.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-20T06:29:43.000Z" class="docLastUpdatedAt_1sqk">2022-4-20</time> by <strong>Andrii Serkes</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#metadata" class="contents__link">METADATA</a></li><li><a href="#config-options" class="contents__link">CONFIG OPTIONS</a></li><li><a href="#supported-vendor-extensions" class="contents__link">SUPPORTED VENDOR EXTENSIONS</a></li><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/0358ea4a.319c66aa.js"></script>
+<script src="/0358ea4a.eb6d82ad.js"></script>
 
 
 </body>
diff --git a/docs/generators/javascript-apollo/index.html b/docs/generators/javascript-apollo/index.html
index 4864ce57cf8..0450479c112 100644
--- a/docs/generators/javascript-apollo/index.html
+++ b/docs/generators/javascript-apollo/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/javascript-closure-angular/index.html b/docs/generators/javascript-closure-angular/index.html
index 8acac05f83b..1f31b14c7f3 100644
--- a/docs/generators/javascript-closure-angular/index.html
+++ b/docs/generators/javascript-closure-angular/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/javascript-flowtyped/index.html b/docs/generators/javascript-flowtyped/index.html
index 66267b75130..1ade97283dd 100644
--- a/docs/generators/javascript-flowtyped/index.html
+++ b/docs/generators/javascript-flowtyped/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/javascript/index.html b/docs/generators/javascript/index.html
index 5f9d4270ac1..353775e85c7 100644
--- a/docs/generators/javascript/index.html
+++ b/docs/generators/javascript/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-cxf-cdi/index.html b/docs/generators/jaxrs-cxf-cdi/index.html
index 7129f898d8c..8b4d87f4d37 100644
--- a/docs/generators/jaxrs-cxf-cdi/index.html
+++ b/docs/generators/jaxrs-cxf-cdi/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-cxf-client/index.html b/docs/generators/jaxrs-cxf-client/index.html
index b9a2230d7c6..62a88dda4ae 100644
--- a/docs/generators/jaxrs-cxf-client/index.html
+++ b/docs/generators/jaxrs-cxf-client/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-cxf-extended/index.html b/docs/generators/jaxrs-cxf-extended/index.html
index 052a3084a41..e709aa5f13a 100644
--- a/docs/generators/jaxrs-cxf-extended/index.html
+++ b/docs/generators/jaxrs-cxf-extended/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-cxf/index.html b/docs/generators/jaxrs-cxf/index.html
index fcafea0694e..9faadaffcb5 100644
--- a/docs/generators/jaxrs-cxf/index.html
+++ b/docs/generators/jaxrs-cxf/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-jersey/index.html b/docs/generators/jaxrs-jersey/index.html
index faed16951f9..13eddda0592 100644
--- a/docs/generators/jaxrs-jersey/index.html
+++ b/docs/generators/jaxrs-jersey/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-resteasy-eap/index.html b/docs/generators/jaxrs-resteasy-eap/index.html
index 6040171d77c..3db57ac2ca9 100644
--- a/docs/generators/jaxrs-resteasy-eap/index.html
+++ b/docs/generators/jaxrs-resteasy-eap/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-resteasy/index.html b/docs/generators/jaxrs-resteasy/index.html
index 19355361b2a..ce4eac7a384 100644
--- a/docs/generators/jaxrs-resteasy/index.html
+++ b/docs/generators/jaxrs-resteasy/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jaxrs-spec/index.html b/docs/generators/jaxrs-spec/index.html
index 9d6ec55dabd..10a922154a7 100644
--- a/docs/generators/jaxrs-spec/index.html
+++ b/docs/generators/jaxrs-spec/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/jmeter/index.html b/docs/generators/jmeter/index.html
index 561e2800315..cb2ef7b269f 100644
--- a/docs/generators/jmeter/index.html
+++ b/docs/generators/jmeter/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/k6/index.html b/docs/generators/k6/index.html
index 40018d456c9..3f7897fed81 100644
--- a/docs/generators/k6/index.html
+++ b/docs/generators/k6/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/kotlin-server/index.html b/docs/generators/kotlin-server/index.html
index 0aad4fd330a..7e9e1e921f7 100644
--- a/docs/generators/kotlin-server/index.html
+++ b/docs/generators/kotlin-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/kotlin-spring/index.html b/docs/generators/kotlin-spring/index.html
index 9c71281a7cf..4e1fe0b7bb5 100644
--- a/docs/generators/kotlin-spring/index.html
+++ b/docs/generators/kotlin-spring/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/kotlin-vertx/index.html b/docs/generators/kotlin-vertx/index.html
index 86225dc6e83..913e7a56862 100644
--- a/docs/generators/kotlin-vertx/index.html
+++ b/docs/generators/kotlin-vertx/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/kotlin/index.html b/docs/generators/kotlin/index.html
index cceb7d6e888..3e17e656408 100644
--- a/docs/generators/kotlin/index.html
+++ b/docs/generators/kotlin/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/ktorm-schema/index.html b/docs/generators/ktorm-schema/index.html
index 0bc7d8bfa62..866f3fa86e5 100644
--- a/docs/generators/ktorm-schema/index.html
+++ b/docs/generators/ktorm-schema/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/lua/index.html b/docs/generators/lua/index.html
index 591b5427e15..7f478015520 100644
--- a/docs/generators/lua/index.html
+++ b/docs/generators/lua/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/markdown/index.html b/docs/generators/markdown/index.html
index 226d2977730..64a0efa0864 100644
--- a/docs/generators/markdown/index.html
+++ b/docs/generators/markdown/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/mysql-schema/index.html b/docs/generators/mysql-schema/index.html
index d08a4cba08a..2a72cd68e1b 100644
--- a/docs/generators/mysql-schema/index.html
+++ b/docs/generators/mysql-schema/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/nim/index.html b/docs/generators/nim/index.html
index 390ca81dec8..bee14be17bf 100644
--- a/docs/generators/nim/index.html
+++ b/docs/generators/nim/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/nodejs-express-server/index.html b/docs/generators/nodejs-express-server/index.html
index d659a748776..eb0dd822918 100644
--- a/docs/generators/nodejs-express-server/index.html
+++ b/docs/generators/nodejs-express-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/objc/index.html b/docs/generators/objc/index.html
index 4cd940a5dfd..eba06f6cdb0 100644
--- a/docs/generators/objc/index.html
+++ b/docs/generators/objc/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/ocaml/index.html b/docs/generators/ocaml/index.html
index 085cd162f2a..dfb90193004 100644
--- a/docs/generators/ocaml/index.html
+++ b/docs/generators/ocaml/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/openapi-yaml/index.html b/docs/generators/openapi-yaml/index.html
index 930d62c1ffa..92b4686b7f7 100644
--- a/docs/generators/openapi-yaml/index.html
+++ b/docs/generators/openapi-yaml/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/openapi/index.html b/docs/generators/openapi/index.html
index c7bc1a9802b..9a755980d32 100644
--- a/docs/generators/openapi/index.html
+++ b/docs/generators/openapi/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/perl/index.html b/docs/generators/perl/index.html
index bdd639acc5c..761b4be95ce 100644
--- a/docs/generators/perl/index.html
+++ b/docs/generators/perl/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php-dt/index.html b/docs/generators/php-dt/index.html
index c097a6b940d..0ef0d75cba1 100644
--- a/docs/generators/php-dt/index.html
+++ b/docs/generators/php-dt/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php-laravel/index.html b/docs/generators/php-laravel/index.html
index a267d02d8d4..c73bc2b9294 100644
--- a/docs/generators/php-laravel/index.html
+++ b/docs/generators/php-laravel/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php-lumen/index.html b/docs/generators/php-lumen/index.html
index f9fe5d9370a..7dbbeb4b1eb 100644
--- a/docs/generators/php-lumen/index.html
+++ b/docs/generators/php-lumen/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php-mezzio-ph/index.html b/docs/generators/php-mezzio-ph/index.html
index 10c3ca5f588..b41f337d895 100644
--- a/docs/generators/php-mezzio-ph/index.html
+++ b/docs/generators/php-mezzio-ph/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php-slim-deprecated/index.html b/docs/generators/php-slim-deprecated/index.html
index 5eaf1679131..05b1e66999f 100644
--- a/docs/generators/php-slim-deprecated/index.html
+++ b/docs/generators/php-slim-deprecated/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php-slim4/index.html b/docs/generators/php-slim4/index.html
index aab422670bb..e72abb0bfc8 100644
--- a/docs/generators/php-slim4/index.html
+++ b/docs/generators/php-slim4/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php-symfony/index.html b/docs/generators/php-symfony/index.html
index ad8bf83f6c9..dc7af359b9d 100644
--- a/docs/generators/php-symfony/index.html
+++ b/docs/generators/php-symfony/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/php/index.html b/docs/generators/php/index.html
index 74b28c86e81..72e11ee7594 100644
--- a/docs/generators/php/index.html
+++ b/docs/generators/php/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/plantuml/index.html b/docs/generators/plantuml/index.html
index 01028248238..0b1ffa6d32e 100644
--- a/docs/generators/plantuml/index.html
+++ b/docs/generators/plantuml/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/powershell/index.html b/docs/generators/powershell/index.html
index 78e590fb9df..1bbf0fbaa23 100644
--- a/docs/generators/powershell/index.html
+++ b/docs/generators/powershell/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/protobuf-schema/index.html b/docs/generators/protobuf-schema/index.html
index 03d3cb69028..1fee5129f89 100644
--- a/docs/generators/protobuf-schema/index.html
+++ b/docs/generators/protobuf-schema/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/python-aiohttp/index.html b/docs/generators/python-aiohttp/index.html
index 3361829e67f..1f4ce0ac820 100644
--- a/docs/generators/python-aiohttp/index.html
+++ b/docs/generators/python-aiohttp/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/python-blueplanet/index.html b/docs/generators/python-blueplanet/index.html
index 7163305ccf8..b9506c1b011 100644
--- a/docs/generators/python-blueplanet/index.html
+++ b/docs/generators/python-blueplanet/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/python-experimental/index.html b/docs/generators/python-experimental/index.html
index 50df1335cca..daed7875803 100644
--- a/docs/generators/python-experimental/index.html
+++ b/docs/generators/python-experimental/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/python-fastapi/index.html b/docs/generators/python-fastapi/index.html
index 6e0e1156001..852e69b818a 100644
--- a/docs/generators/python-fastapi/index.html
+++ b/docs/generators/python-fastapi/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/python-flask/index.html b/docs/generators/python-flask/index.html
index e699ebb6bd8..0702b90fffc 100644
--- a/docs/generators/python-flask/index.html
+++ b/docs/generators/python-flask/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/python-legacy/index.html b/docs/generators/python-legacy/index.html
index 976f948d6e6..c183fbdad34 100644
--- a/docs/generators/python-legacy/index.html
+++ b/docs/generators/python-legacy/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/python/index.html b/docs/generators/python/index.html
index aabea73438f..878fc49bd38 100644
--- a/docs/generators/python/index.html
+++ b/docs/generators/python/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/r/index.html b/docs/generators/r/index.html
index a633ddad709..7b37eaa17c9 100644
--- a/docs/generators/r/index.html
+++ b/docs/generators/r/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/ruby-on-rails/index.html b/docs/generators/ruby-on-rails/index.html
index c6ef106a61b..618822223d8 100644
--- a/docs/generators/ruby-on-rails/index.html
+++ b/docs/generators/ruby-on-rails/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/ruby-sinatra/index.html b/docs/generators/ruby-sinatra/index.html
index ac954dbe1b2..ba59c4ccd6f 100644
--- a/docs/generators/ruby-sinatra/index.html
+++ b/docs/generators/ruby-sinatra/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/ruby/index.html b/docs/generators/ruby/index.html
index bf51fd09a49..4680f29f40a 100644
--- a/docs/generators/ruby/index.html
+++ b/docs/generators/ruby/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/rust-server/index.html b/docs/generators/rust-server/index.html
index 421f55818d2..db6d2a310fa 100644
--- a/docs/generators/rust-server/index.html
+++ b/docs/generators/rust-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/rust/index.html b/docs/generators/rust/index.html
index b8c4838d43b..667f5f21ef8 100644
--- a/docs/generators/rust/index.html
+++ b/docs/generators/rust/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-akka-http-server/index.html b/docs/generators/scala-akka-http-server/index.html
index 260ff1c3f28..747c5eb53f5 100644
--- a/docs/generators/scala-akka-http-server/index.html
+++ b/docs/generators/scala-akka-http-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-akka/index.html b/docs/generators/scala-akka/index.html
index 44864ce7e65..54acb51e39f 100644
--- a/docs/generators/scala-akka/index.html
+++ b/docs/generators/scala-akka/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-finch/index.html b/docs/generators/scala-finch/index.html
index a5442c58b4e..c376c9f2e3d 100644
--- a/docs/generators/scala-finch/index.html
+++ b/docs/generators/scala-finch/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-gatling/index.html b/docs/generators/scala-gatling/index.html
index 770effb9c68..af18f0ccf8e 100644
--- a/docs/generators/scala-gatling/index.html
+++ b/docs/generators/scala-gatling/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-httpclient-deprecated/index.html b/docs/generators/scala-httpclient-deprecated/index.html
index 84a4bfc6bea..a07a5cf4f07 100644
--- a/docs/generators/scala-httpclient-deprecated/index.html
+++ b/docs/generators/scala-httpclient-deprecated/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-lagom-server/index.html b/docs/generators/scala-lagom-server/index.html
index 1f006e445e1..7db2c119416 100644
--- a/docs/generators/scala-lagom-server/index.html
+++ b/docs/generators/scala-lagom-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-play-server/index.html b/docs/generators/scala-play-server/index.html
index a2bd8dbf994..b988a621f05 100644
--- a/docs/generators/scala-play-server/index.html
+++ b/docs/generators/scala-play-server/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scala-sttp/index.html b/docs/generators/scala-sttp/index.html
index 40cb47c9316..d32be98752c 100644
--- a/docs/generators/scala-sttp/index.html
+++ b/docs/generators/scala-sttp/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scalatra/index.html b/docs/generators/scalatra/index.html
index b014a9ad7af..8b55961d989 100644
--- a/docs/generators/scalatra/index.html
+++ b/docs/generators/scalatra/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/scalaz/index.html b/docs/generators/scalaz/index.html
index fa3f823fe9c..4575a2c44f7 100644
--- a/docs/generators/scalaz/index.html
+++ b/docs/generators/scalaz/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/spring/index.html b/docs/generators/spring/index.html
index 12155402072..6a3779abe09 100644
--- a/docs/generators/spring/index.html
+++ b/docs/generators/spring/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/swift5/index.html b/docs/generators/swift5/index.html
index ddd5d0f2a09..5e7d5d4b2ca 100644
--- a/docs/generators/swift5/index.html
+++ b/docs/generators/swift5/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/tiny-cpp/index.html b/docs/generators/tiny-cpp/index.html
index de1eaad616f..c0fa950b547 100644
--- a/docs/generators/tiny-cpp/index.html
+++ b/docs/generators/tiny-cpp/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Config Options for tiny-cpp</h1></header><div class="markdown"><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>controller</td><td>name of microcontroller (e.g esp32 or esp8266)</td><td></td><td>esp32</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>reservedWordPrefix</td><td>Prefix to prepend to reserved words in order to avoid conflicts</td><td></td><td>r_</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>variableNameFirstCharacterUppercase</td><td>Make first character of variable name uppercase (eg. value -&gt; Value)</td><td></td><td>true</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>bool</li><li>double</li><li>float</li><li>int</li><li>long</li><li>std::string</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>alignas</li><li>alignof</li><li>and</li><li>and_eq</li><li>asm</li><li>auto</li><li>bitand</li><li>bitor</li><li>bool</li><li>break</li><li>case</li><li>catch</li><li>char</li><li>char16_t</li><li>char32_t</li><li>class</li><li>compl</li><li>concept</li><li>const</li><li>const_cast</li><li>constexpr</li><li>continue</li><li>decltype</li><li>default</li><li>delete</li><li>do</li><li>double</li><li>dynamic_cast</li><li>else</li><li>enum</li><li>explicit</li><li>export</li><li>extern</li><li>false</li><li>float</li><li>for</li><li>friend</li><li>goto</li><li>if</li><li>inline</li><li>int</li><li>linux</li><li>long</li><li>mutable</li><li>namespace</li><li>new</li><li>noexcept</li><li>not</li><li>not_eq</li><li>nullptr</li><li>operator</li><li>or</li><li>or_eq</li><li>private</li><li>protected</li><li>public</li><li>register</li><li>reinterpret_cast</li><li>requires</li><li>return</li><li>short</li><li>signed</li><li>sizeof</li><li>static</li><li>static_assert</li><li>static_cast</li><li>struct</li><li>switch</li><li>template</li><li>this</li><li>thread_local</li><li>throw</li><li>true</li><li>try</li><li>typedef</li><li>typeid</li><li>typename</li><li>union</li><li>unsigned</li><li>using</li><li>virtual</li><li>void</li><li>volatile</li><li>wchar_t</li><li>while</li><li>xor</li><li>xor_eq</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✗</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✗</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✓</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✓</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/tiny-cpp.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Config Options for tiny-cpp</h1></header><div class="markdown"><p>These options may be applied as additional-properties (cli) or configOptions (plugins). Refer to <a href="https://openapi-generator.tech/docs/configuration">configuration docs</a> for more details.</p><table><thead><tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr></thead><tbody><tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr><tr><td>controller</td><td>name of microcontroller (e.g esp32 or esp8266)</td><td></td><td>esp32</td></tr><tr><td>disallowAdditionalPropertiesIfNotPresent</td><td>If false, the &#x27;additionalProperties&#x27; implementation (set to true by default) is compliant with the OAS and JSON schema specifications. If true (default), keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</td><td><dl><dt><strong>false</strong></dt><dd>The &#x27;additionalProperties&#x27; implementation is compliant with the OAS and JSON schema specifications.</dd><dt><strong>true</strong></dt><dd>Keep the old (incorrect) behaviour that &#x27;additionalProperties&#x27; is set to false by default.</dd></dl></td><td>true</td></tr><tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr><tr><td>legacyDiscriminatorBehavior</td><td>Set to false for generators with better support for discriminators. (Python, Java, Go, PowerShell, C#have this enabled by default).</td><td><dl><dt><strong>true</strong></dt><dd>The mapping in the discriminator includes descendent schemas that allOf inherit from self and the discriminator mapping schemas in the OAS document.</dd><dt><strong>false</strong></dt><dd>The mapping in the discriminator includes any descendent schemas that allOf inherit from self, any oneOf schemas, any anyOf schemas, any x-discriminator-values, and the discriminator mapping schemas in the OAS document AND Codegen validates that oneOf and anyOf schemas contain the required discriminator and throws an error if the discriminator is missing.</dd></dl></td><td>true</td></tr><tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr><tr><td>reservedWordPrefix</td><td>Prefix to prepend to reserved words in order to avoid conflicts</td><td></td><td>r_</td></tr><tr><td>sortModelPropertiesByRequiredFlag</td><td>Sort model properties to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr><tr><td>variableNameFirstCharacterUppercase</td><td>Make first character of variable name uppercase (eg. value -&gt; Value)</td><td></td><td>true</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="import-mapping"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#import-mapping" title="Direct link to heading">#</a>IMPORT MAPPING</h2><table><thead><tr><th>Type/Alias</th><th>Imports</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="instantiation-types"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#instantiation-types" title="Direct link to heading">#</a>INSTANTIATION TYPES</h2><table><thead><tr><th>Type/Alias</th><th>Instantiated By</th></tr></thead><tbody></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="language-primitives"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#language-primitives" title="Direct link to heading">#</a>LANGUAGE PRIMITIVES</h2><ul class="column-ul"><li>bool</li><li>double</li><li>float</li><li>int</li><li>long</li><li>std::string</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="reserved-words"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#reserved-words" title="Direct link to heading">#</a>RESERVED WORDS</h2><ul class="column-ul"><li>alignas</li><li>alignof</li><li>and</li><li>and_eq</li><li>asm</li><li>auto</li><li>bitand</li><li>bitor</li><li>bool</li><li>break</li><li>case</li><li>catch</li><li>char</li><li>char16_t</li><li>char32_t</li><li>class</li><li>compl</li><li>concept</li><li>const</li><li>const_cast</li><li>constexpr</li><li>continue</li><li>decltype</li><li>default</li><li>delete</li><li>do</li><li>double</li><li>dynamic_cast</li><li>else</li><li>enum</li><li>explicit</li><li>export</li><li>extern</li><li>false</li><li>float</li><li>for</li><li>friend</li><li>goto</li><li>if</li><li>inline</li><li>int</li><li>linux</li><li>long</li><li>mutable</li><li>namespace</li><li>new</li><li>noexcept</li><li>not</li><li>not_eq</li><li>nullptr</li><li>operator</li><li>or</li><li>or_eq</li><li>private</li><li>protected</li><li>public</li><li>register</li><li>reinterpret_cast</li><li>requires</li><li>return</li><li>short</li><li>signed</li><li>sizeof</li><li>static</li><li>static_assert</li><li>static_cast</li><li>struct</li><li>switch</li><li>template</li><li>this</li><li>thread_local</li><li>throw</li><li>true</li><li>try</li><li>typedef</li><li>typeid</li><li>typename</li><li>union</li><li>unsigned</li><li>using</li><li>virtual</li><li>void</li><li>volatile</li><li>wchar_t</li><li>while</li><li>xor</li><li>xor_eq</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="feature-set"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#feature-set" title="Direct link to heading">#</a>FEATURE SET</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="client-modification-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#client-modification-feature" title="Direct link to heading">#</a>Client Modification Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasePath</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Authorizations</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>UserAgent</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MockServer</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="data-type-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#data-type-feature" title="Direct link to heading">#</a>Data Type Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Int32</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Int64</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Float</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Double</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Decimal</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>String</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Byte</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Binary</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Boolean</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Date</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>DateTime</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>File</td><td>✓</td><td>OAS2</td></tr><tr><td>Array</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Maps</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>CollectionFormat</td><td>✓</td><td>OAS2</td></tr><tr><td>CollectionFormatMulti</td><td>✓</td><td>OAS2</td></tr><tr><td>Enum</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>ArrayOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfPrimitives</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfModel</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>ArrayOfCollectionOfEnum</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>MapOfEnum</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfModel</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfPrimitives</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfModel</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>MapOfCollectionOfEnum</td><td>✗</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation-feature" title="Direct link to heading">#</a>Documentation Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Readme</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Model</td><td>✓</td><td>ToolingExtension</td></tr><tr><td>Api</td><td>✓</td><td>ToolingExtension</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="global-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#global-feature" title="Direct link to heading">#</a>Global Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Host</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>BasePath</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Info</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Schemes</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PartialSchemes</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Consumes</td><td>✓</td><td>OAS2</td></tr><tr><td>Produces</td><td>✓</td><td>OAS2</td></tr><tr><td>ExternalDocumentation</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Examples</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XMLStructureDefinitions</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>MultiServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterizedServer</td><td>✗</td><td>OAS3</td></tr><tr><td>ParameterStyling</td><td>✗</td><td>OAS3</td></tr><tr><td>Callbacks</td><td>✗</td><td>OAS3</td></tr><tr><td>LinkObjects</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="parameter-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#parameter-feature" title="Direct link to heading">#</a>Parameter Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Path</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Query</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Header</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Body</td><td>✓</td><td>OAS2</td></tr><tr><td>FormUnencoded</td><td>✗</td><td>OAS2</td></tr><tr><td>FormMultipart</td><td>✗</td><td>OAS2</td></tr><tr><td>Cookie</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="schema-support-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#schema-support-feature" title="Direct link to heading">#</a>Schema Support Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>Simple</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Composite</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>Polymorphism</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>Union</td><td>✗</td><td>OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="security-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#security-feature" title="Direct link to heading">#</a>Security Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>BasicAuth</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>ApiKey</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OpenIDConnect</td><td>✗</td><td>OAS3</td></tr><tr><td>BearerToken</td><td>✓</td><td>OAS3</td></tr><tr><td>OAuth2_Implicit</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_Password</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_ClientCredentials</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>OAuth2_AuthorizationCode</td><td>✓</td><td>OAS2,OAS3</td></tr></tbody></table><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="wire-format-feature"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#wire-format-feature" title="Direct link to heading">#</a>Wire Format Feature</h3><table><thead><tr><th>Name</th><th>Supported</th><th>Defined By</th></tr></thead><tbody><tr><td>JSON</td><td>✓</td><td>OAS2,OAS3</td></tr><tr><td>XML</td><td>✗</td><td>OAS2,OAS3</td></tr><tr><td>PROTOBUF</td><td>✗</td><td>ToolingExtension</td></tr><tr><td>Custom</td><td>✗</td><td>OAS2,OAS3</td></tr></tbody></table></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/generators/tiny-cpp.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#import-mapping" class="contents__link">IMPORT MAPPING</a></li><li><a href="#instantiation-types" class="contents__link">INSTANTIATION TYPES</a></li><li><a href="#language-primitives" class="contents__link">LANGUAGE PRIMITIVES</a></li><li><a href="#reserved-words" class="contents__link">RESERVED WORDS</a></li><li><a href="#feature-set" class="contents__link">FEATURE SET</a><ul><li><a href="#client-modification-feature" class="contents__link">Client Modification Feature</a></li><li><a href="#data-type-feature" class="contents__link">Data Type Feature</a></li><li><a href="#documentation-feature" class="contents__link">Documentation Feature</a></li><li><a href="#global-feature" class="contents__link">Global Feature</a></li><li><a href="#parameter-feature" class="contents__link">Parameter Feature</a></li><li><a href="#schema-support-feature" class="contents__link">Schema Support Feature</a></li><li><a href="#security-feature" class="contents__link">Security Feature</a></li><li><a href="#wire-format-feature" class="contents__link">Wire Format Feature</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/bdaab79f.1ff1951f.js"></script>
+<script src="/bdaab79f.01df211b.js"></script>
 
 
 </body>
diff --git a/docs/generators/typescript-angular/index.html b/docs/generators/typescript-angular/index.html
index f6c942ff548..8bb4be51a04 100644
--- a/docs/generators/typescript-angular/index.html
+++ b/docs/generators/typescript-angular/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-aurelia/index.html b/docs/generators/typescript-aurelia/index.html
index 1b0b7eed6ac..803b71c5f2e 100644
--- a/docs/generators/typescript-aurelia/index.html
+++ b/docs/generators/typescript-aurelia/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-axios/index.html b/docs/generators/typescript-axios/index.html
index eb8db588bca..776cbbc073e 100644
--- a/docs/generators/typescript-axios/index.html
+++ b/docs/generators/typescript-axios/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-fetch/index.html b/docs/generators/typescript-fetch/index.html
index 1fa1ef1b001..ab60faf3b58 100644
--- a/docs/generators/typescript-fetch/index.html
+++ b/docs/generators/typescript-fetch/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-inversify/index.html b/docs/generators/typescript-inversify/index.html
index 864e016d9f7..dcf7c6cec2d 100644
--- a/docs/generators/typescript-inversify/index.html
+++ b/docs/generators/typescript-inversify/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-jquery/index.html b/docs/generators/typescript-jquery/index.html
index 9f8efe2b8aa..de4bb5e1809 100644
--- a/docs/generators/typescript-jquery/index.html
+++ b/docs/generators/typescript-jquery/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-nestjs/index.html b/docs/generators/typescript-nestjs/index.html
index 9c953479d70..2169f570743 100644
--- a/docs/generators/typescript-nestjs/index.html
+++ b/docs/generators/typescript-nestjs/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-node/index.html b/docs/generators/typescript-node/index.html
index c7b574679ec..00d11f478bc 100644
--- a/docs/generators/typescript-node/index.html
+++ b/docs/generators/typescript-node/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-redux-query/index.html b/docs/generators/typescript-redux-query/index.html
index 1ee8a9e4ec5..12431440063 100644
--- a/docs/generators/typescript-redux-query/index.html
+++ b/docs/generators/typescript-redux-query/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript-rxjs/index.html b/docs/generators/typescript-rxjs/index.html
index 207a33df9ac..19abd0be41f 100644
--- a/docs/generators/typescript-rxjs/index.html
+++ b/docs/generators/typescript-rxjs/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/typescript/index.html b/docs/generators/typescript/index.html
index 7da23e9671c..afff169ed39 100644
--- a/docs/generators/typescript/index.html
+++ b/docs/generators/typescript/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/generators/wsdl-schema/index.html b/docs/generators/wsdl-schema/index.html
index c7940ad610c..b828a3b3ac9 100644
--- a/docs/generators/wsdl-schema/index.html
+++ b/docs/generators/wsdl-schema/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/docs/globals/index.html b/docs/globals/index.html
index 6f97b6ba3e6..74c90a732c1 100644
--- a/docs/globals/index.html
+++ b/docs/globals/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Global Properties</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="available-global-properties"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#available-global-properties" title="Direct link to heading">#</a>Available Global Properties</h2><table><thead><tr><th>Property</th><th>Description</th><th>Acceptable value</th></tr></thead><tbody><tr><td>debugOpenAPI</td><td>Dumps JSON formatted and fully parsed OpenAPI document during generation</td><td>none</td></tr><tr><td>debugModels</td><td>Dumps JSON formatted template-bound model information during generation</td><td>none</td></tr><tr><td>debugOperations</td><td>Dumps JSON formatted template-bound operation information during generation</td><td>none</td></tr><tr><td>debugSupportingFiles</td><td>Dumps JSON formatted Supporting File information during generation</td><td>none</td></tr><tr><td>verbose</td><td>Defines the verbosity</td><td><code>true</code> or <code>false</code></td></tr><tr><td>generateAliasAsModel</td><td>Defines whether primitive types defined at the model/schema level will be wrapped in a model</td><td><code>true</code> or <code>false</code></td></tr><tr><td>org.openapitools.codegen.utils.oncelogger.enabled</td><td>Enable/disable the &quot;OnceLogger&quot; which reduces noise for select repeated logs</td><td><code>true</code> or <code>false</code></td></tr><tr><td>supportingFiles</td><td>Allows the user to define which supporting files will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td>no value, or a comma-separated string of file names</td></tr><tr><td>models</td><td>Allows the user to define which models will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td>no value, or a comma-separated string of model names</td></tr><tr><td>apis</td><td>Allows the user to define which apis will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td>no value, or a comma-separated string of api names</td></tr><tr><td>apiDocs</td><td>Allows the user to define if api docs will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>modelDocs</td><td>Allows the user to define if model docs will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>apiTests</td><td>Allows the user to define if api tests will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>modelTests</td><td>Allows the user to define if model tests will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>withXml</td><td>Allows the user to control support of XML generated constructs, where supported</td><td>none</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="note-on-global-property-declaration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#note-on-global-property-declaration" title="Direct link to heading">#</a>Note on Global Property declaration</h2><p>There are <em>two ways</em> to provide selective generation properties or &quot;global properties&quot;. First, these can be passed as Java System Properties. Second, these can be passed via the global property tooling option (<code>--global-property</code> in CLI and <code>globalProperty</code> in Maven and Gradle configurations). This differentiation is new in version 5.0 with the removal of the <code>-D</code> CLI option and the renaming of <code>systemProperties</code>. If you&#x27;re upgrading to OpenAPI Generator 5.0+</p><p>While the examples seen in <a href="/docs/customization">Customization</a> use the Java System Property syntax, keep in mind that the following are equivalent:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -Dmodels {jar} generate {opts}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>and</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java {jar} generate {opts} --global-property=models</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Why the two differing ways to provide the same properties? We previously accepted a <code>-D</code> tooling option which resembled Java System Property declaration. In older versions of OpenAPI Generator, the option modified the SystemProperties collection directly and was truly a &quot;system property&quot;. This option changed during the 4.x release in an effort to make OpenAPI Generator thread-safe and isolate its configuration via thread locals. We no longer mutate System Properties. In the 4.x release and earlier, specifying the tooling <code>-D</code> option with system properties intended for other tools like swagger-parser rather than passing them as true Java System Properties would lead to unexpected behavior for the user; if our tool set the system property <em>after</em> invoking certain code, it would seem to the user like Java System Properties weren&#x27;t working! </p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/global-properties.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/usage"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Usage</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/configuration"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Configuration Options »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#available-global-properties" class="contents__link">Available Global Properties</a></li><li><a href="#note-on-global-property-declaration" class="contents__link">Note on Global Property declaration</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Global Properties</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="available-global-properties"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#available-global-properties" title="Direct link to heading">#</a>Available Global Properties</h2><table><thead><tr><th>Property</th><th>Description</th><th>Acceptable value</th></tr></thead><tbody><tr><td>debugOpenAPI</td><td>Dumps JSON formatted and fully parsed OpenAPI document during generation</td><td>none</td></tr><tr><td>debugModels</td><td>Dumps JSON formatted template-bound model information during generation</td><td>none</td></tr><tr><td>debugOperations</td><td>Dumps JSON formatted template-bound operation information during generation</td><td>none</td></tr><tr><td>debugSupportingFiles</td><td>Dumps JSON formatted Supporting File information during generation</td><td>none</td></tr><tr><td>verbose</td><td>Defines the verbosity</td><td><code>true</code> or <code>false</code></td></tr><tr><td>generateAliasAsModel</td><td>Defines whether primitive types defined at the model/schema level will be wrapped in a model</td><td><code>true</code> or <code>false</code></td></tr><tr><td>org.openapitools.codegen.utils.oncelogger.enabled</td><td>Enable/disable the &quot;OnceLogger&quot; which reduces noise for select repeated logs</td><td><code>true</code> or <code>false</code></td></tr><tr><td>supportingFiles</td><td>Allows the user to define which supporting files will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td>no value, or a comma-separated string of file names</td></tr><tr><td>models</td><td>Allows the user to define which models will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td>no value, or a comma-separated string of model names</td></tr><tr><td>apis</td><td>Allows the user to define which apis will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td>no value, or a comma-separated string of api names</td></tr><tr><td>apiDocs</td><td>Allows the user to define if api docs will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>modelDocs</td><td>Allows the user to define if model docs will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>apiTests</td><td>Allows the user to define if api tests will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>modelTests</td><td>Allows the user to define if model tests will be generated. Prefer using the more robust <code>.openapi-generator-ignore</code>.</td><td><code>true</code> or <code>false</code></td></tr><tr><td>withXml</td><td>Allows the user to control support of XML generated constructs, where supported</td><td>none</td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="note-on-global-property-declaration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#note-on-global-property-declaration" title="Direct link to heading">#</a>Note on Global Property declaration</h2><p>There are <em>two ways</em> to provide selective generation properties or &quot;global properties&quot;. First, these can be passed as Java System Properties. Second, these can be passed via the global property tooling option (<code>--global-property</code> in CLI and <code>globalProperty</code> in Maven and Gradle configurations). This differentiation is new in version 5.0 with the removal of the <code>-D</code> CLI option and the renaming of <code>systemProperties</code>. If you&#x27;re upgrading to OpenAPI Generator 5.0+</p><p>While the examples seen in <a href="/docs/customization">Customization</a> use the Java System Property syntax, keep in mind that the following are equivalent:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -Dmodels {jar} generate {opts}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>and</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java {jar} generate {opts} --global-property=models</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Why the two differing ways to provide the same properties? We previously accepted a <code>-D</code> tooling option which resembled Java System Property declaration. In older versions of OpenAPI Generator, the option modified the SystemProperties collection directly and was truly a &quot;system property&quot;. This option changed during the 4.x release in an effort to make OpenAPI Generator thread-safe and isolate its configuration via thread locals. We no longer mutate System Properties. In the 4.x release and earlier, specifying the tooling <code>-D</code> option with system properties intended for other tools like swagger-parser rather than passing them as true Java System Properties would lead to unexpected behavior for the user; if our tool set the system property <em>after</em> invoking certain code, it would seem to the user like Java System Properties weren&#x27;t working! </p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/global-properties.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/usage"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Usage</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/configuration"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Configuration Options »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#available-global-properties" class="contents__link">Available Global Properties</a></li><li><a href="#note-on-global-property-declaration" class="contents__link">Note on Global Property declaration</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/a5c65c7b.1aff2bac.js"></script>
+<script src="/a5c65c7b.e83132ce.js"></script>
 
 
 </body>
diff --git a/docs/installation/index.html b/docs/installation/index.html
index 7722462bfbe..64d554f17a6 100644
--- a/docs/installation/index.html
+++ b/docs/installation/index.html
@@ -31,12 +31,12 @@
 Installing OpenAPI Generator&#x27;s CLI tool allows users to generate all available generators from the command line.</p><p>Some of the following are cross-platform options and some are not, these are called out where possible.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="npm"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#npm" title="Direct link to heading">#</a>npm</h2><blockquote><p><strong>Platform(s)</strong>: Linux, macOS, Windows</p></blockquote><p>The <a href="https://github.com/openapitools/openapi-generator-cli">npm package wrapper</a> is cross-platform wrapper around the .jar artifact. It works by providing a CLI wrapper atop the JAR&#x27;s command line options. This gives a simple interface layer which normalizes usage of the command line across operating systems, removing some differences in how options or switches are passed to the tool (depending on OS).
 <strong>Install</strong> the latest version of the tool globally, exposing the CLI on the command line:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">npm</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> @openapitools/openapi-generator-cli -g</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>To install a specific version of the tool, pass the version during installation:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version-manager </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">set</span><span class="token plain"> </span><span class="token number">5.3</span><span class="token plain">.0</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>To install the tool as a dev dependency in your current project:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">npm</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> @openapitools/openapi-generator-cli -D</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Then, <strong>generate</strong> a ruby client from a valid <a href="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml">petstore.yaml</a> doc:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">npx @openapitools/openapi-generator-cli generate -i petstore.yaml -g ruby -o /tmp/test/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p><code>npx</code> will execute a globally available <code>openapi-generator</code>, and if not found it will fall back to project-local commands. The result is that the above command will work regardless of which installation method you&#x27;ve chosen.</p></blockquote><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="homebrew"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#homebrew" title="Direct link to heading">#</a>Homebrew</h2><blockquote><p><strong>Platform(s)</strong>: macOS</p></blockquote><p><strong>Install</strong> via <a href="https://brew.sh/">homebrew</a>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">brew </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> openapi-generator</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Then, <strong>generate</strong> a ruby client from a valid <a href="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml">petstore.yaml</a> doc:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator generate -i petstore.yaml -g ruby -o /tmp/test/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="scoop"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#scoop" title="Direct link to heading">#</a>Scoop</h2><blockquote><p><strong>Platform(s)</strong>: Windows</p></blockquote><p><strong>Install</strong> via <a href="https://scoop.sh/">scoop</a>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">scoop </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> openapi-generator-cli</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>If you don&#x27;t have java installed, you can also install it via <a href="https://github.com/ScoopInstaller/Java/">scoop java bucket</a>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">scoop bucket </span><span class="token function" style="color:rgb(80, 250, 123)">add</span><span class="token plain"> java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">scoop </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> openjdk</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Then, <strong>generate</strong> a ruby client from a valid <a href="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml">petstore.yaml</a> doc:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli generate -i petstore.yaml -g ruby</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="docker"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#docker" title="Direct link to heading">#</a>Docker</h2><blockquote><p><strong>Platform(s)</strong>: Linux, macOS, Windows</p></blockquote><p>The OpenAPI Generator Docker image acts as a standalone executable. It can be used as an alternative to installing via homebrew, or for developers who are unable to install Java or upgrade the installed version.</p><p>To generate code from a valid <a href="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml">petstore.yaml</a> doc with this image, you&#x27;ll need to mount a local location as a volume.
 You&#x27;ll then need to output the generated code to this mapped volume. Everything else works the same as if you ran the command on your host machine.</p><p>Here&#x27;s an example generating a Go client:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">docker run --rm </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -v </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${</span><span class="token variable environment constant" style="color:rgb(189, 147, 249);font-style:italic">PWD</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">}</span><span class="token plain">:/local openapitools/openapi-generator-cli generate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -i /local/petstore.yaml </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -g go </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -o /local/out/go</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="jar"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#jar" title="Direct link to heading">#</a>JAR</h2><blockquote><p><strong>Platform(s)</strong>: Linux, macOS, Windows</p></blockquote><p>If you&#x27;re looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):</p><p>JAR location: <code>https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar</code></p><p>For <strong>Mac/Linux</strong> users:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">wget</span><span class="token plain"> https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar -O openapi-generator-cli.jar</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>For <strong>Windows</strong> users, you will need to install <a href="http://gnuwin32.sourceforge.net/packages/wget.htm">wget</a> or you can use Invoke-WebRequest in PowerShell (3.0+), e.g.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-powershell codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Invoke-WebRequest -OutFile openapi-generator-cli.jar https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.3.0/openapi-generator-cli-5.3.0.jar</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>After downloading the JAR, run <code>java -jar openapi-generator-cli.jar help</code> to show the usage.</p><p>For Mac users, please make sure Java 8 is installed (Tips: run <code>java -version</code> to check the version), and export <code>JAVA_HOME</code> in order to use the supported Java version:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">JAVA_HOME</span><span class="token operator">=</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">`</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">/usr/libexec/java_home -v </span><span class="token variable number" style="color:rgb(189, 147, 249);font-style:italic">1.8</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">`</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable environment constant" style="color:rgb(189, 147, 249);font-style:italic">PATH</span><span class="token operator">=</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${JAVA_HOME}</span><span class="token plain">/bin:</span><span class="token environment constant" style="color:rgb(189, 147, 249)">$PATH</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="bash-launcher-script"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#bash-launcher-script" title="Direct link to heading">#</a>Bash Launcher Script</h2><blockquote><p><strong>Platform(s)</strong>: Linux, macOS, Windows (variable)</p></blockquote><p>One downside to manual JAR downloads is that you don&#x27;t keep up-to-date with the latest released version. We have a Bash launcher script at <a href="https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh">bin/utils/openapi-generator-cli.sh</a> which solves this problem.</p><p>To install the launcher script, copy the contents of the script to a location on your path and make the script executable.</p><p>An example of setting this up (NOTE: Always evaluate scripts curled from external systems before executing them).</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">mkdir</span><span class="token plain"> -p ~/bin/openapitools</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">curl</span><span class="token plain"> https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh </span><span class="token operator">&gt;</span><span class="token plain"> ~/bin/openapitools/openapi-generator-cli</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">chmod</span><span class="token plain"> u+x ~/bin/openapitools/openapi-generator-cli</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable environment constant" style="color:rgb(189, 147, 249);font-style:italic">PATH</span><span class="token operator">=</span><span class="token environment constant" style="color:rgb(189, 147, 249)">$PATH</span><span class="token plain">:~/bin/openapitools/</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Now, <code>openapi-generator-cli</code> is &quot;installed&quot;. On invocation, it will query the GitHub repository for the most recently released version. If this matches the last downloaded jar,
-it will execute as normal. If a newer version is found, the script will download the latest release and execute it.</p><p>If you need to invoke an older version of the generator, you can define the variable <code>OPENAPI_GENERATOR_VERSION</code> either ad hoc or globally. You can export this variable if you&#x27;d like to persist a specific release version.</p><p>Examples:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># Execute latest released openapi-generator-cli</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute version 3.1.0 for the current invocation, regardless of the latest released version</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_GENERATOR_VERSION</span><span class="token operator">=</span><span class="token number">3.1</span><span class="token plain">.0 openapi-generator-cli version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute version 3.1.0-SNAPSHOT for the current invocation</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_GENERATOR_VERSION</span><span class="token operator">=</span><span class="token number">3.1</span><span class="token plain">.0-SNAPSHOT openapi-generator-cli version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute version 3.0.2 for every invocation in the current shell session</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_GENERATOR_VERSION</span><span class="token operator">=</span><span class="token number">3.0</span><span class="token plain">.2</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version </span><span class="token comment" style="color:rgb(98, 114, 164)"># is 3.0.2</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version </span><span class="token comment" style="color:rgb(98, 114, 164)"># is also 3.0.2</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># To &quot;install&quot; a specific version, set the variable in .bashrc/.bash_profile</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">echo</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;export OPENAPI_GENERATOR_VERSION=3.0.2&quot;</span><span class="token plain"> </span><span class="token operator">&gt;&gt;</span><span class="token plain"> ~/.bashrc</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">source</span><span class="token plain"> ~/.bashrc</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version </span><span class="token comment" style="color:rgb(98, 114, 164)"># is always 3.0.2, unless any of the above overrides are done ad hoc</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/installation.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/plugins"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Plugins »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#npm" class="contents__link">npm</a></li><li><a href="#homebrew" class="contents__link">Homebrew</a></li><li><a href="#scoop" class="contents__link">Scoop</a></li><li><a href="#docker" class="contents__link">Docker</a></li><li><a href="#jar" class="contents__link">JAR</a></li><li><a href="#bash-launcher-script" class="contents__link">Bash Launcher Script</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a aria-current="page" class="footer__link-item active" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+it will execute as normal. If a newer version is found, the script will download the latest release and execute it.</p><p>If you need to invoke an older version of the generator, you can define the variable <code>OPENAPI_GENERATOR_VERSION</code> either ad hoc or globally. You can export this variable if you&#x27;d like to persist a specific release version.</p><p>Examples:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># Execute latest released openapi-generator-cli</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute version 3.1.0 for the current invocation, regardless of the latest released version</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_GENERATOR_VERSION</span><span class="token operator">=</span><span class="token number">3.1</span><span class="token plain">.0 openapi-generator-cli version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute version 3.1.0-SNAPSHOT for the current invocation</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_GENERATOR_VERSION</span><span class="token operator">=</span><span class="token number">3.1</span><span class="token plain">.0-SNAPSHOT openapi-generator-cli version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute version 3.0.2 for every invocation in the current shell session</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">export</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">OPENAPI_GENERATOR_VERSION</span><span class="token operator">=</span><span class="token number">3.0</span><span class="token plain">.2</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version </span><span class="token comment" style="color:rgb(98, 114, 164)"># is 3.0.2</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version </span><span class="token comment" style="color:rgb(98, 114, 164)"># is also 3.0.2</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># To &quot;install&quot; a specific version, set the variable in .bashrc/.bash_profile</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">echo</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;export OPENAPI_GENERATOR_VERSION=3.0.2&quot;</span><span class="token plain"> </span><span class="token operator">&gt;&gt;</span><span class="token plain"> ~/.bashrc</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">source</span><span class="token plain"> ~/.bashrc</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli version </span><span class="token comment" style="color:rgb(98, 114, 164)"># is always 3.0.2, unless any of the above overrides are done ad hoc</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/installation.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/plugins"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Plugins »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#npm" class="contents__link">npm</a></li><li><a href="#homebrew" class="contents__link">Homebrew</a></li><li><a href="#scoop" class="contents__link">Scoop</a></li><li><a href="#docker" class="contents__link">Docker</a></li><li><a href="#jar" class="contents__link">JAR</a></li><li><a href="#bash-launcher-script" class="contents__link">Bash Launcher Script</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a aria-current="page" class="footer__link-item active" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -52,7 +52,7 @@ it will execute as normal. If a newer version is found, the script will download
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/726258db.7a6414e5.js"></script>
+<script src="/726258db.c102ce0a.js"></script>
 
 
 </body>
diff --git a/docs/integrations/index.html b/docs/integrations/index.html
index 03cdd229f21..70f7d3b25b4 100644
--- a/docs/integrations/index.html
+++ b/docs/integrations/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Workflow Integrations</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="workflow-integration-gradle-maven-github-cicd"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#workflow-integration-gradle-maven-github-cicd" title="Direct link to heading">#</a>Workflow Integration (Gradle, Maven, GitHub, CI/CD)</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="gradle-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#gradle-integration" title="Direct link to heading">#</a>Gradle Integration</h3><p>See the <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc">openapi-generator-gradle-plugin README</a> for details related to configuring and using the Gradle Plugin.</p><p>Supported tasks include:</p><ul><li>Listing generators</li><li>Validation of Open API 2.0 and 3.0 Specs</li><li>Generating &quot;Meta&quot; generators</li><li>Generating all generators supported by OpenAPI Generator</li></ul><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="maven-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#maven-integration" title="Direct link to heading">#</a>Maven Integration</h3><p>See the <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md">openapi-generator-maven-plugin README</a> for details related to configuring and using the Maven Plugin.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="sbt-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#sbt-integration" title="Direct link to heading">#</a>sbt Integration</h3><p>Please refer to <a href="https://github.com/OpenAPITools/sbt-openapi-generator">https://github.com/OpenAPITools/sbt-openapi-generator</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="bazel-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#bazel-integration" title="Direct link to heading">#</a>Bazel Integration</h3><p>Please refer to <a href="https://github.com/OpenAPITools/openapi-generator-bazel">https://github.com/OpenAPITools/openapi-generator-bazel</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="cake-addin"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#cake-addin" title="Direct link to heading">#</a>Cake Addin</h3><p>3rd-party Cake Addin provided by <a href="https://github.com/lukoerfer">Lukas Körfer</a>: <a href="https://github.com/lukoerfer/cake-openapi-generator">https://github.com/lukoerfer/cake-openapi-generator</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="github-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#github-integration" title="Direct link to heading">#</a>GitHub Integration</h3><p>To push the auto-generated SDK to GitHub, we provide <code>git_push.sh</code> to streamline the process. For example:</p><p> 1) Create a new repository in GitHub (Ref: <a href="https://help.github.com/articles/creating-a-new-repository/">https://help.github.com/articles/creating-a-new-repository/</a>)</p><p> 2) Generate the SDK</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar openapi-generator-cli.jar generate \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> -i modules/openapi-generator/src/test/resources/3_0/petstore.json -g perl \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> --git-user-id &quot;wing328&quot; \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> --git-repo-id &quot;petstore-perl&quot; \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> --release-note &quot;GitHub integration demo&quot; \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> -o /var/tmp/perl/petstore</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p> 3) Push the SDK to GitHub</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">cd /var/tmp/perl/petstore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">/bin/sh ./git_push.sh</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="cicd"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#cicd" title="Direct link to heading">#</a>CI/CD</h3><p>Some generators also generate CI/CD configuration files (.travis.yml) so that the output will be ready to be tested by the CI (e.g. Travis)</p><p>If you&#x27;re looking for the configuration files of a particular CI that is not yet supported, please open an <a href="https://github.com/openapitools/openapi-generator/issues/new">issue</a> to let us know.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/integration.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/debugging"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Debugging</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/contributing"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Guidelines For Contributing »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#workflow-integration-gradle-maven-github-cicd" class="contents__link">Workflow Integration (Gradle, Maven, GitHub, CI/CD)</a><ul><li><a href="#gradle-integration" class="contents__link">Gradle Integration</a></li><li><a href="#maven-integration" class="contents__link">Maven Integration</a></li><li><a href="#sbt-integration" class="contents__link">sbt Integration</a></li><li><a href="#bazel-integration" class="contents__link">Bazel Integration</a></li><li><a href="#cake-addin" class="contents__link">Cake Addin</a></li><li><a href="#github-integration" class="contents__link">GitHub Integration</a></li><li><a href="#cicd" class="contents__link">CI/CD</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a aria-current="page" class="footer__link-item active" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Workflow Integrations</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="workflow-integration-gradle-maven-github-cicd"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#workflow-integration-gradle-maven-github-cicd" title="Direct link to heading">#</a>Workflow Integration (Gradle, Maven, GitHub, CI/CD)</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="gradle-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#gradle-integration" title="Direct link to heading">#</a>Gradle Integration</h3><p>See the <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc">openapi-generator-gradle-plugin README</a> for details related to configuring and using the Gradle Plugin.</p><p>Supported tasks include:</p><ul><li>Listing generators</li><li>Validation of Open API 2.0 and 3.0 Specs</li><li>Generating &quot;Meta&quot; generators</li><li>Generating all generators supported by OpenAPI Generator</li></ul><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="maven-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#maven-integration" title="Direct link to heading">#</a>Maven Integration</h3><p>See the <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md">openapi-generator-maven-plugin README</a> for details related to configuring and using the Maven Plugin.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="sbt-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#sbt-integration" title="Direct link to heading">#</a>sbt Integration</h3><p>Please refer to <a href="https://github.com/OpenAPITools/sbt-openapi-generator">https://github.com/OpenAPITools/sbt-openapi-generator</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="bazel-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#bazel-integration" title="Direct link to heading">#</a>Bazel Integration</h3><p>Please refer to <a href="https://github.com/OpenAPITools/openapi-generator-bazel">https://github.com/OpenAPITools/openapi-generator-bazel</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="cake-addin"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#cake-addin" title="Direct link to heading">#</a>Cake Addin</h3><p>3rd-party Cake Addin provided by <a href="https://github.com/lukoerfer">Lukas Körfer</a>: <a href="https://github.com/lukoerfer/cake-openapi-generator">https://github.com/lukoerfer/cake-openapi-generator</a></p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="github-integration"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#github-integration" title="Direct link to heading">#</a>GitHub Integration</h3><p>To push the auto-generated SDK to GitHub, we provide <code>git_push.sh</code> to streamline the process. For example:</p><p> 1) Create a new repository in GitHub (Ref: <a href="https://help.github.com/articles/creating-a-new-repository/">https://help.github.com/articles/creating-a-new-repository/</a>)</p><p> 2) Generate the SDK</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">java -jar openapi-generator-cli.jar generate \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> -i modules/openapi-generator/src/test/resources/3_0/petstore.json -g perl \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> --git-user-id &quot;wing328&quot; \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> --git-repo-id &quot;petstore-perl&quot; \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> --release-note &quot;GitHub integration demo&quot; \</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> -o /var/tmp/perl/petstore</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p> 3) Push the SDK to GitHub</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-sh codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">cd /var/tmp/perl/petstore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">/bin/sh ./git_push.sh</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="cicd"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#cicd" title="Direct link to heading">#</a>CI/CD</h3><p>Some generators also generate CI/CD configuration files (.travis.yml) so that the output will be ready to be tested by the CI (e.g. Travis)</p><p>If you&#x27;re looking for the configuration files of a particular CI that is not yet supported, please open an <a href="https://github.com/openapitools/openapi-generator/issues/new">issue</a> to let us know.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/integration.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/debugging"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Debugging</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/contributing"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Guidelines For Contributing »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#workflow-integration-gradle-maven-github-cicd" class="contents__link">Workflow Integration (Gradle, Maven, GitHub, CI/CD)</a><ul><li><a href="#gradle-integration" class="contents__link">Gradle Integration</a></li><li><a href="#maven-integration" class="contents__link">Maven Integration</a></li><li><a href="#sbt-integration" class="contents__link">sbt Integration</a></li><li><a href="#bazel-integration" class="contents__link">Bazel Integration</a></li><li><a href="#cake-addin" class="contents__link">Cake Addin</a></li><li><a href="#github-integration" class="contents__link">GitHub Integration</a></li><li><a href="#cicd" class="contents__link">CI/CD</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a aria-current="page" class="footer__link-item active" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/d9b8b8b3.e0b8f5ee.js"></script>
+<script src="/d9b8b8b3.bc7f414b.js"></script>
 
 
 </body>
diff --git a/docs/new-generator/index.html b/docs/new-generator/index.html
index b607e9b89e0..255f7c66daa 100644
--- a/docs/new-generator/index.html
+++ b/docs/new-generator/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Create a New Generator</h1></header><div class="markdown"><p>Creating a new generator which will become a part of the officially supported generators in OpenAPI Generator is pretty simple. We&#x27;ve created a helper script to bootstrap the operation. Let&#x27;s look at the files necessary to create a new generator, then an example of bootstrapping a generator using the <code>new.sh</code> script in the root of the repository.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="required-files"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#required-files" title="Direct link to heading">#</a>Required Files</h2><p>The minimum set of files required to create a new generator are:</p><ul><li>A &quot;Codegen&quot; file<ul><li>exists under <code>modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/</code></li><li>defines language options</li><li>defines framework options</li><li>determines OpenAPI feature set</li><li>extends the generation workflow</li></ul></li><li>SPI registration<ul><li>Above class must be referenced in <code>modules/openapi-generator/src/main/resources/META-INF/services/org.openapitools.codegen.CodegenConfig</code></li><li>Tells the generator that this class exists</li><li>Allows for classpath extension (addition) of generators</li></ul></li><li>A minimal template<ul><li>Should include a README explaining usage</li><li>Must include an <code>api.mustache</code></li><li>Exists under <code>modules/openapi-generator/src/main/resources/</code> (plus <code>embeddedTemplate</code> dir value, see below)</li></ul></li><li>Config file under <code>./bin/configs</code><ul><li>Gives users a &quot;real life&quot; example of generated output</li><li>Samples are used by CI to verify generators and test for regressions in some cases</li></ul></li></ul><p>Now, let&#x27;s generate an example generator and then walk through the pieces. At the end, we&#x27;ll touch on some known sticking points for new generator authors and provide some suggestions.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="newsh"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#newsh" title="Direct link to heading">#</a>new.sh</h2><p>The <code>new.sh</code> script in the root of the project is meant to simplify this process. Run <code>./new.sh --help</code>.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Stubs out files for new generators</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Usage:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./new.sh [options]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Options:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -n  Required. Specify generator name, should be kebab-cased.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -c  Create a client generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -s  Create a server generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -d  Create a documentation generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -H  Create a schema generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -f  Create a config generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -t  When specified, creates test file(s) for the generator.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -h  Display help.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Examples:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  Create a server generator for ktor:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  ./new.sh -n kotlin -s</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Creates:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/KotlinServerCodegen.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/kotlin-server/README.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/kotlin-server/model.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/kotlin-server/api.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    bin/configs/kotlin-server-petstore-new.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  Create a generic C# server generator:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  ./new.sh -n csharp -s -t</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Creates:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CsharpServerCodegen.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/csharp-server/README.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/csharp-server/model.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/csharp-server/api.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    bin/configs/csharp-server-petstore-new.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenTest.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenModelTest.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenOptionsTest.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/options/CsharpServerCodegenOptionsProvider.java</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This script allows us to define a client, server, schema, or documentation generator. We&#x27;ll focus on the simplest generator (documentation). The other generator types may require heavy extension of the &quot;Config&quot; base class, and these docs could very quickly become outdated. When creating a new generator, please review existing generators as a guideline for implementation.</p><p>Create a new Markdown generator, specifying CommonMark as the name to avoid conflicting with the built-in Markdown generator.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./new.sh -n common-mark -d</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You should see output similar to the following:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CommonMarkDocumentationCodegen.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/resources/common-mark-documentation/README.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/resources/common-mark-documentation/model.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/resources/common-mark-documentation/api.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating bin/configs/common-mark-documentation-petstore-new.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Finished.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="review-generated-config"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#review-generated-config" title="Direct link to heading">#</a>Review Generated Config</h3><p>Beginning with the &quot;Codegen&quot; file (<code>CommonMarkDocumentationCodegen.java</code>), the constructor was created:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">public</span><span class="token plain"> </span><span class="token class-name">CommonMarkDocumentationCodegen</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">super</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        outputFolder </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;generated-code&quot;</span><span class="token plain"> </span><span class="token operator">+</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        modelTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;model.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        apiTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;api.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        embeddedTemplateDir </span><span class="token operator">=</span><span class="token plain"> templateDir </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark-documentation&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        apiPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Apis&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        modelPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Models&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        supportingFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">add</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">new</span><span class="token plain"> </span><span class="token class-name">SupportingFile</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.md&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token comment" style="color:rgb(98, 114, 164)">// TODO: Fill this out.</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>These options are some defaults which may require updating. Let&#x27;s look line-by-line at the config.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">outputFolder </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;generated-code&quot;</span><span class="token plain"> </span><span class="token operator">+</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This is the default output location. This will be <code>generated-code/common-mark</code> on non-Windows machines and <code>generated-code\common-mark</code> on Windows. You may change this to any value you&#x27;d like, but a user will almost always provide an output directory.</p><blockquote><p>When joining paths, always use <code>File.seperator</code></p></blockquote><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">modelTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;model.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The <code>model.mustache</code> file is registered as the template for model generation. The <code>new.sh</code> script doesn&#x27;t have a way to know your intended file extension, so we default to a <code>.zz</code> extension. This <em>must</em> be changed (unless your generator&#x27;s target extension is <code>.zz</code>). For this example, you&#x27;d change <code>.zz</code> to <code>.md</code> or <code>.markdown</code>, depending on your preference.</p><p>This model template registration will use <code>model.mustache</code> to generate a new file for every model defined in your API&#x27;s specification document.</p><p>The path is considered relative to <code>embeddedTemplateDir</code>, <code>templateDir</code>, or a library subdirectory (refer to the Java client generator implementation for a prime example).</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">apiTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;api.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This is the template used for generating API related files. Similar to the above model template, you&#x27;ll want to change <code>.zz</code> to <code>.md</code> or <code>.markdown</code>.</p><p>The path is considered relative to <code>embeddedTemplateDir</code>, <code>templateDir</code>, or a library subdirectory (refer to the Java client generator implementation for a prime example).</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">embeddedTemplateDir </span><span class="token operator">=</span><span class="token plain"> templateDir </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark-documentation&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This line sets the embedded and template directories to <code>common-mark-documentation</code>. The <code>embeddedTemplateDir</code> refers to the directory which will exist under <code>modules/openapi-generator/src/main/resources</code> and will be published with every release in which your new generator is present.</p><p>The <code>templateDir</code> variable refers to the &quot;current&quot; template directory setting, as defined by the user. That is, the user may invoke with <code>-t</code> or <code>--template-directory</code> (or plugin option variants), and override this directory.</p><p>Both of these variables exist because the generator will fallback to files under <code>embeddedTemplateDir</code> if they are not defined in the user&#x27;s custom template directory.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">apiPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Apis&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This sets the &quot;package&quot; location for anything considered an API document. You might want to change this setting if, for instance, your language doesn&#x27;t support uppercase letters in the path. We don&#x27;t need to worry about that here.</p><p>Every templated output from <code>api.mustache</code> (registered via <code>apiTemplateFiles</code> above) will end up in the directory defined by <code>apiPackage</code> here.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">modelPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Models&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Similarly, this sets the package for <code>Models</code>.</p><p>Every templated output from <code>model.mustache</code> (registered via <code>modelTemplateFiles</code> above) will end up in the directory defined by <code>modelPackage</code> here.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">supportingFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">add</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">new</span><span class="token plain"> </span><span class="token class-name">SupportingFile</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.md&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>A &quot;supporting file&quot; is an extra file which isn&#x27;t created once for every operation or model defined in your specification document. It is a single file which may or may not be templated (determined by the extension of the filename).</p><p>A supporting file only passes through the Mustache template processor if the filename ends in <code>.mustache</code>.</p><p>The path is considered relative to <code>embeddedTemplateDir</code>, <code>templateDir</code>, or a library subdirectory (refer to the Java client generator implementation for a prime example).</p><blockquote><p>If you want your readme to be generic (not templated), just rename the file to README.md and change <code>README.mustache</code> to <code>README.md</code> above.</p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="create-templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#create-templates" title="Direct link to heading">#</a>Create templates</h3><p>The <code>new.sh</code> created our three required files. Let&#x27;s start filling out each of these files.</p><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="readmemustache"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#readmemustache" title="Direct link to heading">#</a>README.mustache</h4><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain"># Documentation for {{appName}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#generateApiDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;documentation-for-api-endpoints&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Documentation for API Endpoints</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">All URIs are relative to *{{{basePath}}}*</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Class | Method | HTTP request | Description</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------ | ------------- | ------------- | -------------</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**](Apis/{{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{{summary}}}{{/summary}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/generateApiDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#generateModelDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;documentation-for-models&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Documentation for Models</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#models}}{{#model}} - [{{{modelPackage}}}.{{{classname}}}](Models/{{modelDocPath}}{{{classname}}}.md)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/model}}{{/models}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">No model defined in this package</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/generateModelDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;documentation-for-authorization&quot;&gt;&lt;/a&gt;{{! TODO: optional documentation for authorization? }}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Documentation for Authorization</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">All endpoints do not require authorization.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#last}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Authentication schemes defined for the API:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/last}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;{{name}}&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### {{name}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#isApiKey}}- **Type**: API key</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **API key parameter name**: {{keyParamName}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/isApiKey}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#isBasic}}- **Type**: HTTP basic authentication</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/isBasic}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#isOAuth}}- **Type**: OAuth</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Flow**: {{flow}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Authorization URL**: {{authorizationUrl}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Scopes**: {{^scopes}}N/A{{/scopes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#scopes}}  - {{scope}}: {{description}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/scopes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/isOAuth}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/authMethods}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Let&#x27;s not focus too much on the contents of this file.  You may refer to <a href="/docs/templating">templating</a> for more details on the variables bound to these files and to <a href="/docs/debugging">debugging</a> how to debug the structures. Of note here is that we&#x27;re generating structures in markdown as defined by the objects constructed by our new &quot;Config&quot; class.</p><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="apimustache"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#apimustache" title="Direct link to heading">#</a>api.mustache</h4><p>The API documentation might look like this:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain"># {{classname}}{{#description}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{description}}{{/description}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">All URIs are relative to *{{basePath}}*</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Method | HTTP request | Description</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------- | ------------- | -------------</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operations}}{{#operation}}[**{{operationId}}**]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{summary}}{{/summary}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operation}}{{/operations}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operations}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operation}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;{{operationId}}&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"># **{{operationId}}**</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&gt; {{#returnType}}{{returnType}} {{/returnType}}{{operationId}}({{#allParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/allParams}})</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{summary}}{{#notes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{notes}}{{/notes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### Parameters</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^allParams}}This endpoint does not need any parameter.{{/allParams}}{{#allParams}}{{#-last}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Name | Type | Description  | Notes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------- | ------------- | ------------- | -------------{{/-last}}{{/allParams}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#allParams}} **{{paramName}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}{{#isFile}}**{{dataType}}**{{/isFile}}{{^isFile}}{{#generateModelDocs}}[**{{dataType}}**]({{baseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{dataType}}**{{/generateModelDocs}}{{/isFile}}{{/isPrimitiveType}}| {{description}} |{{^required}} [optional]{{/required}}{{#defaultValue}} [default to {{defaultValue}}]{{/defaultValue}}{{#allowableValues}} [enum: {{#values}}{{{.}}}{{^-last}}, {{/-last}}{{/values}}]{{/allowableValues}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/allParams}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### Return type</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#returnType}}{{#returnTypeIsPrimitive}}**{{returnType}}**{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}{{#generateModelDocs}}[**{{returnType}}**]({{returnBaseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{returnType}}**{{/generateModelDocs}}{{/returnTypeIsPrimitive}}{{/returnType}}{{^returnType}}null (empty response body){{/returnType}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### Authorization</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^authMethods}}No authorization required{{/authMethods}}{{#authMethods}}[{{name}}](../README.md#{{name}}){{^-last}}, {{/-last}}{{/authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### HTTP request headers</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> - **Content-Type**: {{#consumes}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/consumes}}{{^consumes}}Not defined{{/consumes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> - **Accept**: {{#produces}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/produces}}{{^produces}}Not defined{{/produces}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operation}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operations}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="modelmustache"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#modelmustache" title="Direct link to heading">#</a>model.mustache</h4><p>The models file could resemble the following.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#models}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#model}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"># {{{packageName}}}.{{modelPackage}}.{{{classname}}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Properties</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Name | Type | Description | Notes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------ | ------------- | ------------- | -------------</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#parent}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#parentVars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/parentVars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/parent}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/vars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/model}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/models}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="build-it"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#build-it" title="Direct link to heading">#</a>Build it</h3><p>To compile quickly to test this out, you can run <code>mvn clean package -DskipTests</code>.</p><blockquote><p>When implementing a more robust generator, you&#x27;ll want to run all tests as well: <code>mvn clean package</code></p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="compile-sample"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#compile-sample" title="Direct link to heading">#</a>Compile Sample</h3><p>The <code>new.sh</code> script created the generation config file <code>bin/configs/common-mark-documentation-petstore-new.yaml</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">generatorName: common-mark</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">outputDir: samples/documentation/petstore/common/mark</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">templateDir: modules/openapi-generator/src/main/resources/common-mark</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  hideGenerationTimestamp: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;true&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This configuration file is passed to the generator&#x27;s CLI tool during continuous integration builds, and many outputs are compiled and tested as a regression test on every build. Contributors are also asked to run <code>./bin/utils/ensure-up-to-date</code> before opening a pull request to regenerate all samples defined under <code>./bin/configs</code>. This allows maintainers to quickly verify whether changes impact other generators.</p><p>Configuration based examples allow us to test the same samples in each tooling option (CLI, Gradle Plugin, Maven Plugin, etc.). </p><p>You can compile your generator by running:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./bin/generate-samples.sh bin/configs/common-mark-documentation-petstore-new.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This configuration file can be used to demonstrate the default options for generation. A common option in most of these configs is to define the template directory as the generator&#x27;s directory under <code>resources</code>. This allows template maintainers to modify and test out template changes which don&#x27;t require recompilation of the entire project. You&#x27;d still need to recompile the project in full if you add or modify behaviors to the generator (such as adding a <code>CliOption</code>).</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="verify-output"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#verify-output" title="Direct link to heading">#</a>Verify output</h3><p>Creating a new generator will be an iterative task. Once you&#x27;ve generated the sample, you&#x27;ll want to try it out. For compiled client/server outputs, this would mean running the code or creating a small sample project to consume your artifact just to make sure it works.</p><p>For markdown, you can open in Visual Studio Code or any other editor with a markdown preview. Not all editors support relative links to other markdown documents. To test the output in this guide, install <code>markserv</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">npm</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> --global markserv</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Now, you can serve the output directory directly and test your links:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">markserv samples/documentation/petstore/common/markdown</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>That&#x27;s it! You&#x27;ve created your first generator!</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/new-generator.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/contribute-building"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Building the code</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/roadmap"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Roadmap »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#required-files" class="contents__link">Required Files</a></li><li><a href="#newsh" class="contents__link">new.sh</a><ul><li><a href="#review-generated-config" class="contents__link">Review Generated Config</a></li><li><a href="#create-templates" class="contents__link">Create templates</a></li><li><a href="#build-it" class="contents__link">Build it</a></li><li><a href="#compile-sample" class="contents__link">Compile Sample</a></li><li><a href="#verify-output" class="contents__link">Verify output</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Create a New Generator</h1></header><div class="markdown"><p>Creating a new generator which will become a part of the officially supported generators in OpenAPI Generator is pretty simple. We&#x27;ve created a helper script to bootstrap the operation. Let&#x27;s look at the files necessary to create a new generator, then an example of bootstrapping a generator using the <code>new.sh</code> script in the root of the repository.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="required-files"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#required-files" title="Direct link to heading">#</a>Required Files</h2><p>The minimum set of files required to create a new generator are:</p><ul><li>A &quot;Codegen&quot; file<ul><li>exists under <code>modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/</code></li><li>defines language options</li><li>defines framework options</li><li>determines OpenAPI feature set</li><li>extends the generation workflow</li></ul></li><li>SPI registration<ul><li>Above class must be referenced in <code>modules/openapi-generator/src/main/resources/META-INF/services/org.openapitools.codegen.CodegenConfig</code></li><li>Tells the generator that this class exists</li><li>Allows for classpath extension (addition) of generators</li></ul></li><li>A minimal template<ul><li>Should include a README explaining usage</li><li>Must include an <code>api.mustache</code></li><li>Exists under <code>modules/openapi-generator/src/main/resources/</code> (plus <code>embeddedTemplate</code> dir value, see below)</li></ul></li><li>Config file under <code>./bin/configs</code><ul><li>Gives users a &quot;real life&quot; example of generated output</li><li>Samples are used by CI to verify generators and test for regressions in some cases</li></ul></li></ul><p>Now, let&#x27;s generate an example generator and then walk through the pieces. At the end, we&#x27;ll touch on some known sticking points for new generator authors and provide some suggestions.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="newsh"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#newsh" title="Direct link to heading">#</a>new.sh</h2><p>The <code>new.sh</code> script in the root of the project is meant to simplify this process. Run <code>./new.sh --help</code>.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Stubs out files for new generators</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Usage:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">./new.sh [options]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Options:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -n  Required. Specify generator name, should be kebab-cased.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -c  Create a client generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -s  Create a server generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -d  Create a documentation generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -H  Create a schema generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -f  Create a config generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -t  When specified, creates test file(s) for the generator.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -h  Display help.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Examples:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  Create a server generator for ktor:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  ./new.sh -n kotlin -s</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Creates:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/KotlinServerCodegen.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/kotlin-server/README.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/kotlin-server/model.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/kotlin-server/api.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    bin/configs/kotlin-server-petstore-new.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  Create a generic C# server generator:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  ./new.sh -n csharp -s -t</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Creates:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CsharpServerCodegen.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/csharp-server/README.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/csharp-server/model.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/main/resources/csharp-server/api.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    bin/configs/csharp-server-petstore-new.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenTest.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenModelTest.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/csharp/CsharpServerCodegenOptionsTest.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modules/openapi-generator/src/test/java/org/openapitools/codegen/options/CsharpServerCodegenOptionsProvider.java</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This script allows us to define a client, server, schema, or documentation generator. We&#x27;ll focus on the simplest generator (documentation). The other generator types may require heavy extension of the &quot;Config&quot; base class, and these docs could very quickly become outdated. When creating a new generator, please review existing generators as a guideline for implementation.</p><p>Create a new Markdown generator, specifying CommonMark as the name to avoid conflicting with the built-in Markdown generator.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./new.sh -n common-mark -d</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>You should see output similar to the following:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/CommonMarkDocumentationCodegen.java</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/resources/common-mark-documentation/README.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/resources/common-mark-documentation/model.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating modules/openapi-generator/src/main/resources/common-mark-documentation/api.mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Creating bin/configs/common-mark-documentation-petstore-new.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Finished.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="review-generated-config"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#review-generated-config" title="Direct link to heading">#</a>Review Generated Config</h3><p>Beginning with the &quot;Codegen&quot; file (<code>CommonMarkDocumentationCodegen.java</code>), the constructor was created:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">public</span><span class="token plain"> </span><span class="token class-name">CommonMarkDocumentationCodegen</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">super</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        outputFolder </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;generated-code&quot;</span><span class="token plain"> </span><span class="token operator">+</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        modelTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;model.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        apiTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;api.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        embeddedTemplateDir </span><span class="token operator">=</span><span class="token plain"> templateDir </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark-documentation&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        apiPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Apis&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        modelPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Models&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        supportingFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">add</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">new</span><span class="token plain"> </span><span class="token class-name">SupportingFile</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.md&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token comment" style="color:rgb(98, 114, 164)">// TODO: Fill this out.</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>These options are some defaults which may require updating. Let&#x27;s look line-by-line at the config.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">outputFolder </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;generated-code&quot;</span><span class="token plain"> </span><span class="token operator">+</span><span class="token plain"> </span><span class="token class-name">File</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">separator </span><span class="token operator">+</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This is the default output location. This will be <code>generated-code/common-mark</code> on non-Windows machines and <code>generated-code\common-mark</code> on Windows. You may change this to any value you&#x27;d like, but a user will almost always provide an output directory.</p><blockquote><p>When joining paths, always use <code>File.seperator</code></p></blockquote><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">modelTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;model.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The <code>model.mustache</code> file is registered as the template for model generation. The <code>new.sh</code> script doesn&#x27;t have a way to know your intended file extension, so we default to a <code>.zz</code> extension. This <em>must</em> be changed (unless your generator&#x27;s target extension is <code>.zz</code>). For this example, you&#x27;d change <code>.zz</code> to <code>.md</code> or <code>.markdown</code>, depending on your preference.</p><p>This model template registration will use <code>model.mustache</code> to generate a new file for every model defined in your API&#x27;s specification document.</p><p>The path is considered relative to <code>embeddedTemplateDir</code>, <code>templateDir</code>, or a library subdirectory (refer to the Java client generator implementation for a prime example).</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">apiTemplateFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">put</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;api.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;.zz&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This is the template used for generating API related files. Similar to the above model template, you&#x27;ll want to change <code>.zz</code> to <code>.md</code> or <code>.markdown</code>.</p><p>The path is considered relative to <code>embeddedTemplateDir</code>, <code>templateDir</code>, or a library subdirectory (refer to the Java client generator implementation for a prime example).</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">embeddedTemplateDir </span><span class="token operator">=</span><span class="token plain"> templateDir </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;common-mark-documentation&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This line sets the embedded and template directories to <code>common-mark-documentation</code>. The <code>embeddedTemplateDir</code> refers to the directory which will exist under <code>modules/openapi-generator/src/main/resources</code> and will be published with every release in which your new generator is present.</p><p>The <code>templateDir</code> variable refers to the &quot;current&quot; template directory setting, as defined by the user. That is, the user may invoke with <code>-t</code> or <code>--template-directory</code> (or plugin option variants), and override this directory.</p><p>Both of these variables exist because the generator will fallback to files under <code>embeddedTemplateDir</code> if they are not defined in the user&#x27;s custom template directory.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">apiPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Apis&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This sets the &quot;package&quot; location for anything considered an API document. You might want to change this setting if, for instance, your language doesn&#x27;t support uppercase letters in the path. We don&#x27;t need to worry about that here.</p><p>Every templated output from <code>api.mustache</code> (registered via <code>apiTemplateFiles</code> above) will end up in the directory defined by <code>apiPackage</code> here.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">modelPackage </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Models&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Similarly, this sets the package for <code>Models</code>.</p><p>Every templated output from <code>model.mustache</code> (registered via <code>modelTemplateFiles</code> above) will end up in the directory defined by <code>modelPackage</code> here.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-java codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">supportingFiles</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">add</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">new</span><span class="token plain"> </span><span class="token class-name">SupportingFile</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.mustache&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;README.md&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>A &quot;supporting file&quot; is an extra file which isn&#x27;t created once for every operation or model defined in your specification document. It is a single file which may or may not be templated (determined by the extension of the filename).</p><p>A supporting file only passes through the Mustache template processor if the filename ends in <code>.mustache</code>.</p><p>The path is considered relative to <code>embeddedTemplateDir</code>, <code>templateDir</code>, or a library subdirectory (refer to the Java client generator implementation for a prime example).</p><blockquote><p>If you want your readme to be generic (not templated), just rename the file to README.md and change <code>README.mustache</code> to <code>README.md</code> above.</p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="create-templates"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#create-templates" title="Direct link to heading">#</a>Create templates</h3><p>The <code>new.sh</code> created our three required files. Let&#x27;s start filling out each of these files.</p><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="readmemustache"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#readmemustache" title="Direct link to heading">#</a>README.mustache</h4><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain"># Documentation for {{appName}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#generateApiDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;documentation-for-api-endpoints&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Documentation for API Endpoints</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">All URIs are relative to *{{{basePath}}}*</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Class | Method | HTTP request | Description</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------ | ------------- | ------------- | -------------</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**](Apis/{{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{{summary}}}{{/summary}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/generateApiDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#generateModelDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;documentation-for-models&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Documentation for Models</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#models}}{{#model}} - [{{{modelPackage}}}.{{{classname}}}](Models/{{modelDocPath}}{{{classname}}}.md)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/model}}{{/models}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">No model defined in this package</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/modelPackage}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/generateModelDocs}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;documentation-for-authorization&quot;&gt;&lt;/a&gt;{{! TODO: optional documentation for authorization? }}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Documentation for Authorization</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">All endpoints do not require authorization.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#last}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Authentication schemes defined for the API:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/last}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;{{name}}&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### {{name}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#isApiKey}}- **Type**: API key</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **API key parameter name**: {{keyParamName}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/isApiKey}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#isBasic}}- **Type**: HTTP basic authentication</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/isBasic}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#isOAuth}}- **Type**: OAuth</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Flow**: {{flow}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Authorization URL**: {{authorizationUrl}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">- **Scopes**: {{^scopes}}N/A{{/scopes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#scopes}}  - {{scope}}: {{description}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/scopes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/isOAuth}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/authMethods}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Let&#x27;s not focus too much on the contents of this file.  You may refer to <a href="/docs/templating">templating</a> for more details on the variables bound to these files and to <a href="/docs/debugging">debugging</a> how to debug the structures. Of note here is that we&#x27;re generating structures in markdown as defined by the objects constructed by our new &quot;Config&quot; class.</p><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="apimustache"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#apimustache" title="Direct link to heading">#</a>api.mustache</h4><p>The API documentation might look like this:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain"># {{classname}}{{#description}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{description}}{{/description}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">All URIs are relative to *{{basePath}}*</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Method | HTTP request | Description</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------- | ------------- | -------------</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operations}}{{#operation}}[**{{operationId}}**]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{summary}}{{/summary}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operation}}{{/operations}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operations}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operation}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&lt;a name=&quot;{{operationId}}&quot;&gt;&lt;/a&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"># **{{operationId}}**</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">&gt; {{#returnType}}{{returnType}} {{/returnType}}{{operationId}}({{#allParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/allParams}})</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{summary}}{{#notes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{notes}}{{/notes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### Parameters</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^allParams}}This endpoint does not need any parameter.{{/allParams}}{{#allParams}}{{#-last}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Name | Type | Description  | Notes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------- | ------------- | ------------- | -------------{{/-last}}{{/allParams}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#allParams}} **{{paramName}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}{{#isFile}}**{{dataType}}**{{/isFile}}{{^isFile}}{{#generateModelDocs}}[**{{dataType}}**]({{baseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{dataType}}**{{/generateModelDocs}}{{/isFile}}{{/isPrimitiveType}}| {{description}} |{{^required}} [optional]{{/required}}{{#defaultValue}} [default to {{defaultValue}}]{{/defaultValue}}{{#allowableValues}} [enum: {{#values}}{{{.}}}{{^-last}}, {{/-last}}{{/values}}]{{/allowableValues}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/allParams}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### Return type</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#returnType}}{{#returnTypeIsPrimitive}}**{{returnType}}**{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}{{#generateModelDocs}}[**{{returnType}}**]({{returnBaseType}}.md){{/generateModelDocs}}{{^generateModelDocs}}**{{returnType}}**{{/generateModelDocs}}{{/returnTypeIsPrimitive}}{{/returnType}}{{^returnType}}null (empty response body){{/returnType}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### Authorization</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{^authMethods}}No authorization required{{/authMethods}}{{#authMethods}}[{{name}}](../README.md#{{name}}){{^-last}}, {{/-last}}{{/authMethods}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">### HTTP request headers</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> - **Content-Type**: {{#consumes}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/consumes}}{{^consumes}}Not defined{{/consumes}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"> - **Accept**: {{#produces}}{{{mediaType}}}{{^-last}}, {{/-last}}{{/produces}}{{^produces}}Not defined{{/produces}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operation}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/operations}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="modelmustache"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#modelmustache" title="Direct link to heading">#</a>model.mustache</h4><p>The models file could resemble the following.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#models}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#model}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"># {{{packageName}}}.{{modelPackage}}.{{{classname}}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">## Properties</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Name | Type | Description | Notes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">------------ | ------------- | ------------- | -------------</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#parent}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#parentVars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/parentVars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/parent}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#vars}}**{{name}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}} | {{description}} | {{^required}}[optional] {{/required}}{{#readOnly}}[readonly] {{/readOnly}}{{#defaultValue}}[default to {{{.}}}]{{/defaultValue}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/vars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/model}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{/models}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="build-it"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#build-it" title="Direct link to heading">#</a>Build it</h3><p>To compile quickly to test this out, you can run <code>mvn clean package -DskipTests</code>.</p><blockquote><p>When implementing a more robust generator, you&#x27;ll want to run all tests as well: <code>mvn clean package</code></p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="compile-sample"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#compile-sample" title="Direct link to heading">#</a>Compile Sample</h3><p>The <code>new.sh</code> script created the generation config file <code>bin/configs/common-mark-documentation-petstore-new.yaml</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">generatorName: common-mark</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">outputDir: samples/documentation/petstore/common/mark</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">templateDir: modules/openapi-generator/src/main/resources/common-mark</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  hideGenerationTimestamp: </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;true&quot;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This configuration file is passed to the generator&#x27;s CLI tool during continuous integration builds, and many outputs are compiled and tested as a regression test on every build. Contributors are also asked to run <code>./bin/utils/ensure-up-to-date</code> before opening a pull request to regenerate all samples defined under <code>./bin/configs</code>. This allows maintainers to quickly verify whether changes impact other generators.</p><p>Configuration based examples allow us to test the same samples in each tooling option (CLI, Gradle Plugin, Maven Plugin, etc.). </p><p>You can compile your generator by running:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">./bin/generate-samples.sh bin/configs/common-mark-documentation-petstore-new.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This configuration file can be used to demonstrate the default options for generation. A common option in most of these configs is to define the template directory as the generator&#x27;s directory under <code>resources</code>. This allows template maintainers to modify and test out template changes which don&#x27;t require recompilation of the entire project. You&#x27;d still need to recompile the project in full if you add or modify behaviors to the generator (such as adding a <code>CliOption</code>).</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="verify-output"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#verify-output" title="Direct link to heading">#</a>Verify output</h3><p>Creating a new generator will be an iterative task. Once you&#x27;ve generated the sample, you&#x27;ll want to try it out. For compiled client/server outputs, this would mean running the code or creating a small sample project to consume your artifact just to make sure it works.</p><p>For markdown, you can open in Visual Studio Code or any other editor with a markdown preview. Not all editors support relative links to other markdown documents. To test the output in this guide, install <code>markserv</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">npm</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"> --global markserv</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Now, you can serve the output directory directly and test your links:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">markserv samples/documentation/petstore/common/markdown</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>That&#x27;s it! You&#x27;ve created your first generator!</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/new-generator.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/contribute-building"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Building the code</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/roadmap"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Roadmap »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#required-files" class="contents__link">Required Files</a></li><li><a href="#newsh" class="contents__link">new.sh</a><ul><li><a href="#review-generated-config" class="contents__link">Review Generated Config</a></li><li><a href="#create-templates" class="contents__link">Create templates</a></li><li><a href="#build-it" class="contents__link">Build it</a></li><li><a href="#compile-sample" class="contents__link">Compile Sample</a></li><li><a href="#verify-output" class="contents__link">Verify output</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/10211c0a.240a2561.js"></script>
+<script src="/10211c0a.d66e8115.js"></script>
 
 
 </body>
diff --git a/docs/online/index.html b/docs/online/index.html
index 4e54a385e38..c95fa5b13aa 100644
--- a/docs/online/index.html
+++ b/docs/online/index.html
@@ -28,12 +28,12 @@
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
 <nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Online</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="hosted"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#hosted" title="Direct link to heading">#</a>Hosted</h2><p>We offer online services, publicly and free of charge:</p><ul><li>latest stable version: <a href="http://api.openapi-generator.tech">http://api.openapi-generator.tech</a></li><li>latest master: <a href="http://api-latest-master.openapi-generator.tech">http://api-latest-master.openapi-generator.tech</a> (updated with latest master every hour)</li></ul><blockquote><p><strong>Hosting Sponsor</strong><br>
-<a href="https://www.linode.com/"><img src="https://www.linode.com/media/images/logos/standard/light/linode-logo_standard_light_small.png" alt="Linode Logo"></a></p></blockquote><p>These services are beta and do not have any guarantee on service level</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="docker-image"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#docker-image" title="Direct link to heading">#</a>Docker Image</h2><p>The openapi-generator-online Docker image can act as a self-hosted web application and API for generating code. This container can be incorporated into a CI pipeline, and requires at least two HTTP requests and some docker orchestration to access generated code.</p><p>Example usage:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># Start container at port 8888 and save the container id</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">CID</span><span class="token operator">=</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$(</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">docker run -d -p </span><span class="token variable number" style="color:rgb(189, 147, 249);font-style:italic">8888</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">:8080 openapitools/openapi-generator-online</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># allow for startup</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">sleep</span><span class="token plain"> </span><span class="token number">10</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Get the IP of the running container (optional)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">GEN_IP</span><span class="token operator">=</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$(</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">docker inspect --format </span><span class="token variable string" style="color:rgb(255, 121, 198);font-style:italic">&#x27;{{.NetworkSettings.IPAddress}}&#x27;</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">  $</span><span class="token variable punctuation" style="color:rgb(248, 248, 242);font-style:italic">{</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">CID</span><span class="token variable punctuation" style="color:rgb(248, 248, 242);font-style:italic">}</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute an HTTP request to generate a Ruby client</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">curl</span><span class="token plain"> -X POST --header </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;Content-Type: application/json&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  --header </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;Accept: application/json&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -d </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;{&quot;openAPIUrl&quot;: &quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;}&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;http://localhost:8888/api/gen/clients/ruby&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Example output:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># {&quot;code&quot;:&quot;c2d483.3.4672-40e9-91df-b9ffd18d22b8&quot;,&quot;link&quot;:&quot;http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8&quot;}</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Download the generated zip file  (using &quot;code&quot; provided from your output) </span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">wget</span><span class="token plain"> http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Unzip the file</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">unzip</span><span class="token plain"> c2d483.3.4672-40e9-91df-b9ffd18d22b8</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Shutdown the openapi generator image</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">docker stop </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${CID}</span><span class="token plain"> </span><span class="token operator">&amp;&amp;</span><span class="token plain"> docker </span><span class="token function" style="color:rgb(80, 250, 123)">rm</span><span class="token plain"> </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${CID}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="localself-hosting"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#localself-hosting" title="Direct link to heading">#</a>Local/Self-hosting</h2><p>If you prefer to run the service locally, here are the steps:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> modules/openapi-generator-online</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn spring-boot:run</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>The online openapi-generator can be run via <a href="#docker-image">Docker</a> as well.</p></blockquote><p>For example, to generate Ruby API client, simply send the following HTTP request using curl:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">curl</span><span class="token plain"> -X POST -H </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;content-type:application/json&quot;</span><span class="token plain"> -d </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;{&quot;openAPIUrl&quot;:&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;}&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    http://localhost:8080/api/gen/clients/ruby</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Then you will receive a JSON response with the URL to download the zipped code.</p><p>To customize the SDK, you can <code>POST</code> to <code>http://localhost:8080/gen/clients/{generator}</code> with the following HTTP body:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;options&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;openAPIUrl&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Here, the <code>options</code> for a language can be obtained by submitting a <code>GET</code> request to <code>http://locahost:8080/api/gen/clients/{generator}</code>:</p><p>For example, <code>curl http://localhost:8080/api/gen/clients/python</code> returns</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token property">&quot;packageName&quot;</span><span class="token operator">:</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;opt&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;packageName&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;description&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;python package name (convention: snake_case).&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;type&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;string&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;default&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;openapi_client&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;packageVersion&quot;</span><span class="token operator">:</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;opt&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;packageVersion&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;description&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;python package version.&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;type&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;string&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;default&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.0.0&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;sortParamsByRequiredFlag&quot;</span><span class="token operator">:</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;opt&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;sortParamsByRequiredFlag&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;description&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Sort method arguments to place required parameters before optional parameters.&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;type&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;boolean&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;default&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;true&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>To set package name to <code>pet_store</code>, the HTTP body of the request is as follows:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;options&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;packageName&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;pet_store&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;openAPIUrl&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>and here is the curl command:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">curl</span><span class="token plain"> -H </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Content-type: application/json&quot;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -X POST </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -d </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;{&quot;options&quot;: {&quot;packageName&quot;: &quot;pet_store&quot;},&quot;openAPIUrl&quot;: &quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;}&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    http://localhost:8080/api/gen/clients/python</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Instead of using <code>openAPIUrl</code> with an URL to the OpenAPI spec, one can include the spec in the JSON payload with <code>spec</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;options&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;spec&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;swagger&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;2.0&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;info&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token property">&quot;version&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.0.0&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token property">&quot;title&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Test API&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ...</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/online.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/plugins"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Plugins</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/usage"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Usage »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#hosted" class="contents__link">Hosted</a></li><li><a href="#docker-image" class="contents__link">Docker Image</a></li><li><a href="#localself-hosting" class="contents__link">Local/Self-hosting</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<a href="https://www.linode.com/"><img src="https://www.linode.com/media/images/logos/standard/light/linode-logo_standard_light_small.png" alt="Linode Logo"></a></p></blockquote><p>These services are beta and do not have any guarantee on service level</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="docker-image"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#docker-image" title="Direct link to heading">#</a>Docker Image</h2><p>The openapi-generator-online Docker image can act as a self-hosted web application and API for generating code. This container can be incorporated into a CI pipeline, and requires at least two HTTP requests and some docker orchestration to access generated code.</p><p>Example usage:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># Start container at port 8888 and save the container id</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">CID</span><span class="token operator">=</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$(</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">docker run -d -p </span><span class="token variable number" style="color:rgb(189, 147, 249);font-style:italic">8888</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">:8080 openapitools/openapi-generator-online</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># allow for startup</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">sleep</span><span class="token plain"> </span><span class="token number">10</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Get the IP of the running container (optional)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token assign-left variable" style="color:rgb(189, 147, 249);font-style:italic">GEN_IP</span><span class="token operator">=</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">$(</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">docker inspect --format </span><span class="token variable string" style="color:rgb(255, 121, 198);font-style:italic">&#x27;{{.NetworkSettings.IPAddress}}&#x27;</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">  $</span><span class="token variable punctuation" style="color:rgb(248, 248, 242);font-style:italic">{</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">CID</span><span class="token variable punctuation" style="color:rgb(248, 248, 242);font-style:italic">}</span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">)</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Execute an HTTP request to generate a Ruby client</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">curl</span><span class="token plain"> -X POST --header </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;Content-Type: application/json&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  --header </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;Accept: application/json&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  -d </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;{&quot;openAPIUrl&quot;: &quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;}&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;http://localhost:8888/api/gen/clients/ruby&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Example output:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># {&quot;code&quot;:&quot;c2d483.3.4672-40e9-91df-b9ffd18d22b8&quot;,&quot;link&quot;:&quot;http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8&quot;}</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Download the generated zip file  (using &quot;code&quot; provided from your output) </span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">wget</span><span class="token plain"> http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Unzip the file</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">unzip</span><span class="token plain"> c2d483.3.4672-40e9-91df-b9ffd18d22b8</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Shutdown the openapi generator image</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">docker stop </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${CID}</span><span class="token plain"> </span><span class="token operator">&amp;&amp;</span><span class="token plain"> docker </span><span class="token function" style="color:rgb(80, 250, 123)">rm</span><span class="token plain"> </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${CID}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="localself-hosting"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#localself-hosting" title="Direct link to heading">#</a>Local/Self-hosting</h2><p>If you prefer to run the service locally, here are the steps:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean </span><span class="token function" style="color:rgb(80, 250, 123)">install</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">cd</span><span class="token plain"> modules/openapi-generator-online</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn spring-boot:run</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>The online openapi-generator can be run via <a href="#docker-image">Docker</a> as well.</p></blockquote><p>For example, to generate Ruby API client, simply send the following HTTP request using curl:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">curl</span><span class="token plain"> -X POST -H </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;content-type:application/json&quot;</span><span class="token plain"> -d </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;{&quot;openAPIUrl&quot;:&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;}&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    http://localhost:8080/api/gen/clients/ruby</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Then you will receive a JSON response with the URL to download the zipped code.</p><p>To customize the SDK, you can <code>POST</code> to <code>http://localhost:8080/gen/clients/{generator}</code> with the following HTTP body:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;options&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;openAPIUrl&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Here, the <code>options</code> for a language can be obtained by submitting a <code>GET</code> request to <code>http://locahost:8080/api/gen/clients/{generator}</code>:</p><p>For example, <code>curl http://localhost:8080/api/gen/clients/python</code> returns</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token property">&quot;packageName&quot;</span><span class="token operator">:</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;opt&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;packageName&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;description&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;python package name (convention: snake_case).&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;type&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;string&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;default&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;openapi_client&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;packageVersion&quot;</span><span class="token operator">:</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;opt&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;packageVersion&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;description&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;python package version.&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;type&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;string&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;default&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.0.0&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;sortParamsByRequiredFlag&quot;</span><span class="token operator">:</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;opt&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;sortParamsByRequiredFlag&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;description&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Sort method arguments to place required parameters before optional parameters.&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;type&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;boolean&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;default&quot;</span><span class="token operator">:</span><span class="token string" style="color:rgb(255, 121, 198)">&quot;true&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>To set package name to <code>pet_store</code>, the HTTP body of the request is as follows:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;options&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;packageName&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;pet_store&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;openAPIUrl&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>and here is the curl command:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">curl</span><span class="token plain"> -H </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Content-type: application/json&quot;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -X POST </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -d </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;{&quot;options&quot;: {&quot;packageName&quot;: &quot;pet_store&quot;},&quot;openAPIUrl&quot;: &quot;https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml&quot;}&#x27;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    http://localhost:8080/api/gen/clients/python</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Instead of using <code>openAPIUrl</code> with an URL to the OpenAPI spec, one can include the spec in the JSON payload with <code>spec</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;options&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;spec&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;swagger&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;2.0&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token property">&quot;info&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token property">&quot;version&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.0.0&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token property">&quot;title&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;Test API&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ...</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/online.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/plugins"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Plugins</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/usage"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Usage »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#hosted" class="contents__link">Hosted</a></li><li><a href="#docker-image" class="contents__link">Docker Image</a></li><li><a href="#localself-hosting" class="contents__link">Local/Self-hosting</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -49,7 +49,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/0cae4475.982252e5.js"></script>
+<script src="/0cae4475.608d273a.js"></script>
 
 
 </body>
diff --git a/docs/plugins/index.html b/docs/plugins/index.html
index c7e37c5f5a9..d0ee3145b1b 100644
--- a/docs/plugins/index.html
+++ b/docs/plugins/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Plugins</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="maven"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#maven" title="Direct link to heading">#</a>Maven</h2><p>A Maven plugin to support the OpenAPI generator project</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="example"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#example" title="Direct link to heading">#</a>Example</h3><p>Add to your <code>build-&gt;plugins</code> section (default phase is <code>generate-sources</code> phase)</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-xml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">plugin</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">org.openapitools</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">openapi-generator-maven-plugin</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token comment" style="color:rgb(98, 114, 164)">&lt;!-- RELEASE_VERSION --&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">version</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">5.1.0</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">version</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token comment" style="color:rgb(98, 114, 164)">&lt;!-- /RELEASE_VERSION --&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">executions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">execution</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">goals</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">goal</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">generate</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">goal</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">goals</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">configuration</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">inputSpec</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">${project.basedir}/src/main/resources/api.yaml</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">inputSpec</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">generatorName</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">java</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">generatorName</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">configOptions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                   </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">sourceFolder</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">src/gen/java/main</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">sourceFolder</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">configOptions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">configuration</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">execution</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">executions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">plugin</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Followed by:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean compile</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>For full details of all options, see the <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin">plugin README</a>.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="dependencies"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#dependencies" title="Direct link to heading">#</a>Dependencies</h3><p>The generated models use commonly used Swagger v2 annotations like <code>@ApiModelProperty</code>. A user may add Swagger v3 annotations:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-xml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">io.swagger.core.v3</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">swagger-annotations</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>But this will not work. This dependency is not binary compatible with Swagger v2 annotations. The resulting code will fail to compile.</p><p>As alternative instead use the following dependency:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-xml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">io.swagger.parser.v3</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">swagger-parser</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="gradle"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#gradle" title="Direct link to heading">#</a>Gradle</h2><p>This gradle plugin offers a declarative DSL via extensions (these are Gradle project extensions). These map almost fully 1:1 with the options you’d pass to the CLI or Maven plugin. The plugin maps the extensions to a task of the same name to provide a clean API. If you’re interested in the extension/task mapping concept from a high-level, you can check out <a href="https://docs.gradle.org/current/userguide/custom_plugins.html#sec:mapping_extension_properties_to_task_properties">Gradle’s docs</a>.</p><p>To include in your project, add the following to <code>build.gradle</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-groovy codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">buildscript {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  repositories {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    mavenLocal()</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    maven { url &quot;https://repo1.maven.org/maven2&quot; }</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  }</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  dependencies {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    classpath &quot;org.openapitools:openapi-generator-gradle-plugin:5.0.0&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  }</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">apply plugin: &#x27;org.openapi.generator&#x27;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This gives access to the following tasks:</p><table><thead><tr><th>Task</th><th>Description</th></tr></thead><tbody><tr><td>openApiGenerate</td><td>Generate code via Open API Tools Generator for Open API 2.0 or 3.x specification documents.</td></tr><tr><td>openApiGenerators</td><td>Lists generators available via Open API Generators.</td></tr><tr><td>openApiMeta</td><td>Generates a new generator to be consumed via Open API Generator.</td></tr><tr><td>openApiValidate</td><td>Validates an Open API 2.0 or 3.x specification document.</td></tr></tbody></table><blockquote><p>The plugin implements the above tasks as project extensions of the same name. If you’d like to declare these tasks as dependencies to other tasks (using <code>dependsOn</code>), you’ll need a task reference. e.g.:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-groovy codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">compileJava.dependsOn tasks.openApiGenerate</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></blockquote><p>For full details of all options, see the <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin">plugin README</a>.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="example-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#example-1" title="Direct link to heading">#</a>Example</h3><p>An example task for generating a kotlin client:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-groovy codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openApiGenerate {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    generatorName = &quot;kotlin&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    inputSpec = &quot;$rootDir/specs/petstore-v3.0.yaml&quot;.toString()</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    outputDir = &quot;$buildDir/generated&quot;.toString()</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    apiPackage = &quot;org.openapi.example.api&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    invokerPackage = &quot;org.openapi.example.invoker&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modelPackage = &quot;org.openapi.example.model&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    configOptions = [</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        dateLibrary: &quot;java8&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/plugins.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/installation"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« CLI Installation</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/online"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Online »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#maven" class="contents__link">Maven</a><ul><li><a href="#example" class="contents__link">Example</a></li><li><a href="#dependencies" class="contents__link">Dependencies</a></li></ul></li><li><a href="#gradle" class="contents__link">Gradle</a><ul><li><a href="#example-1" class="contents__link">Example</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Plugins</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="maven"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#maven" title="Direct link to heading">#</a>Maven</h2><p>A Maven plugin to support the OpenAPI generator project</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="example"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#example" title="Direct link to heading">#</a>Example</h3><p>Add to your <code>build-&gt;plugins</code> section (default phase is <code>generate-sources</code> phase)</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-xml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">plugin</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">org.openapitools</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">openapi-generator-maven-plugin</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token comment" style="color:rgb(98, 114, 164)">&lt;!-- RELEASE_VERSION --&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">version</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">5.1.0</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">version</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token comment" style="color:rgb(98, 114, 164)">&lt;!-- /RELEASE_VERSION --&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">executions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">execution</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">goals</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">goal</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">generate</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">goal</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">goals</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">configuration</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">inputSpec</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">${project.basedir}/src/main/resources/api.yaml</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">inputSpec</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">generatorName</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">java</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">generatorName</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">configOptions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                   </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">sourceFolder</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">src/gen/java/main</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">sourceFolder</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">configOptions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">configuration</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">execution</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">executions</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">plugin</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Followed by:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">mvn clean compile</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>For full details of all options, see the <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin">plugin README</a>.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="dependencies"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#dependencies" title="Direct link to heading">#</a>Dependencies</h3><p>The generated models use commonly used Swagger v2 annotations like <code>@ApiModelProperty</code>. A user may add Swagger v3 annotations:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-xml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">io.swagger.core.v3</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">swagger-annotations</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>But this will not work. This dependency is not binary compatible with Swagger v2 annotations. The resulting code will fail to compile.</p><p>As alternative instead use the following dependency:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-xml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">io.swagger.parser.v3</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">groupId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain">swagger-parser</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">artifactId</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&lt;/</span><span class="token tag" style="color:rgb(255, 121, 198)">dependency</span><span class="token tag punctuation" style="color:rgb(248, 248, 242)">&gt;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="gradle"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#gradle" title="Direct link to heading">#</a>Gradle</h2><p>This gradle plugin offers a declarative DSL via extensions (these are Gradle project extensions). These map almost fully 1:1 with the options you’d pass to the CLI or Maven plugin. The plugin maps the extensions to a task of the same name to provide a clean API. If you’re interested in the extension/task mapping concept from a high-level, you can check out <a href="https://docs.gradle.org/current/userguide/custom_plugins.html#sec:mapping_extension_properties_to_task_properties">Gradle’s docs</a>.</p><p>To include in your project, add the following to <code>build.gradle</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-groovy codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">buildscript {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  repositories {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    mavenLocal()</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    maven { url &quot;https://repo1.maven.org/maven2&quot; }</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  }</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  dependencies {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    classpath &quot;org.openapitools:openapi-generator-gradle-plugin:5.0.0&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  }</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">apply plugin: &#x27;org.openapi.generator&#x27;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This gives access to the following tasks:</p><table><thead><tr><th>Task</th><th>Description</th></tr></thead><tbody><tr><td>openApiGenerate</td><td>Generate code via Open API Tools Generator for Open API 2.0 or 3.x specification documents.</td></tr><tr><td>openApiGenerators</td><td>Lists generators available via Open API Generators.</td></tr><tr><td>openApiMeta</td><td>Generates a new generator to be consumed via Open API Generator.</td></tr><tr><td>openApiValidate</td><td>Validates an Open API 2.0 or 3.x specification document.</td></tr></tbody></table><blockquote><p>The plugin implements the above tasks as project extensions of the same name. If you’d like to declare these tasks as dependencies to other tasks (using <code>dependsOn</code>), you’ll need a task reference. e.g.:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-groovy codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">compileJava.dependsOn tasks.openApiGenerate</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></blockquote><p>For full details of all options, see the <a href="https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin">plugin README</a>.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="example-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#example-1" title="Direct link to heading">#</a>Example</h3><p>An example task for generating a kotlin client:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-groovy codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openApiGenerate {</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    generatorName = &quot;kotlin&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    inputSpec = &quot;$rootDir/specs/petstore-v3.0.yaml&quot;.toString()</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    outputDir = &quot;$buildDir/generated&quot;.toString()</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    apiPackage = &quot;org.openapi.example.api&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    invokerPackage = &quot;org.openapi.example.invoker&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    modelPackage = &quot;org.openapi.example.model&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    configOptions = [</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        dateLibrary: &quot;java8&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/plugins.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/installation"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« CLI Installation</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/online"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Online »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#maven" class="contents__link">Maven</a><ul><li><a href="#example" class="contents__link">Example</a></li><li><a href="#dependencies" class="contents__link">Dependencies</a></li></ul></li><li><a href="#gradle" class="contents__link">Gradle</a><ul><li><a href="#example-1" class="contents__link">Example</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/e360e27f.5bb331e6.js"></script>
+<script src="/e360e27f.12407e7d.js"></script>
 
 
 </body>
diff --git a/docs/release-3-0-0/index.html b/docs/release-3-0-0/index.html
index 26c081bb221..16ce80945f0 100644
--- a/docs/release-3-0-0/index.html
+++ b/docs/release-3-0-0/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Release Notes: 3.0.0</h1></header><div class="markdown"><ul><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="docker"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#docker" title="Direct link to heading">#</a>Docker</h2></li><li><p>7dfd94002 Docker: use correct MAVEN_CONFIG (#182)</p></li><li><p>b5a0d173d Revise the usage of OpenAPI Generator online (docker image) (#73)</p></li><li><p>e58dc2c77 Fix COPY in Dockerfile (#64)</p></li><li><p>9d7feaaeb Fix online generator (docker push) (#58)</p></li><li><p>9247cd01e Changes for Docker</p></li><li><p>64037ee59 update docker-related files to ues jdk8</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="plug-ins"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#plug-ins" title="Direct link to heading">#</a>Plug-ins</h2></li><li><p>b6b8c0db8 [gradle-plugin] Initial implementation (#162)  </p></li><li><p>0a28aad73 [MAVEN PLUGIN] Checking for null configOptions before looking for property</p></li><li><p>9c79297d6 [MAVEN PLUGIN] Use latest version in dependencies snippet</p></li><li><p>9e1bbe0c1 Add maven wrapper</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="api-clients"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#api-clients" title="Direct link to heading">#</a>API Clients</h2></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="ada"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#ada" title="Direct link to heading">#</a>Ada</h3></li><li><p>edf6be8c0 [Ada] bug fix by defining x-is-model-type when property is local to the YML file</p></li><li><p>9ba74f484 [Ada] Fix GNAT project and server skeleton to avoid sending a response when an error is returned</p></li><li><p>ea27924f5 [Ada] changed default project/package name, to solve circular dependencies</p></li><li><p>6b9d38d40 remove trailing spaces in ada template</p></li><li><p>0de7f972f Fix the Ada server skeleton to check the authsMethods in the Shared_Instance generic package</p></li><li><p>4bd8fc6e8 Fix 7511: [Ada] Client call is not correct with multiple parameters and application/x-www-urlencoded</p></li><li><p>3035bc629 [Ada] Hotfix/ada model sort</p></li><li><p>43f0e8692 Ada code generator corrected: &quot;=&gt;&quot; instead of &quot;-&gt;&quot;.  </p></li><li><p>7d2b49085 [Ada] wrong order for generated structures in models.ads files</p></li><li><p>2b2b85eec [Ada] wrong JSON in POST operations</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c" title="Direct link to heading">#</a>C#</h3></li><li><p>0e34bcf4e [csharp] ctor params should always be camelCase</p></li><li><p>872471996 [csharp] Support arrays of arrays for properties and models</p></li><li><p>1c4e6b7d4 [csharp] Fix ToJson to work with composition and polymorphism</p></li><li><p>ed7af73f6 [csharp] Reference this.Configuration in client API template</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-1" title="Direct link to heading">#</a>C++</h3></li><li><p>e796e4c36 [C++] Add linux as a reserve keyword</p></li><li><p>36f69a034 remove trailing spaces in qt5 c++ templates</p></li><li><p>f192613f1 fix string type in c++ generator</p></li><li><p>409015461 fix file type in qt5cpp</p></li><li><p>a4bcb3bc7 fix datetime and map type for qt5cpp</p></li><li><p>23b31aba8 [qt5cpp] Fix crash when API return a map container</p></li><li><p>3b031ed2b [qt5cpp] delete callback data allocated before signal emission</p></li><li><p>1bb1e44d1 [qt5cpp] Remove qt5 pro.user file</p></li><li><p>194722015 Qt5cpp plug memleaks part2</p></li><li><p>12f3661d6 Qt5cpp plug memleaks</p></li><li><p>ea4b94842 [qt5cpp] Add nullptr guard to prevent crash when empty model is being serialized</p></li><li><p>0bf430a80 Qt5cpp Add support for nested containers</p></li><li><p>0b3ec6b1f fix NPE with cpp qt5, add logic to avoid NPE with composed schema</p></li><li><p>7c734445b fix file parameter in header file (cpprest)</p></li><li><p>070b5c00b fix object type declaration in cpprest</p></li><li><p>bad1885b4 [cpprest] add parameterToString for number type with unspecified format (double)</p></li><li><p>73bd24db7 [cpprest] Add support for nested vectors</p></li><li><p>ee2eb74f7 [qt] update Qt client</p></li><li><p>d82499944 Adding qt project generation fix</p></li><li><p>9bd94b4db [qt] Fix warning message</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="clojure"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#clojure" title="Direct link to heading">#</a>Clojure</h3></li><li><p>d7e374504 [Clojure] Add util method to set the api-context globally (#93)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="dart"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#dart" title="Direct link to heading">#</a>Dart</h3></li><li><p>f1638a659 [Dart] Allow setting an accessToken for OAuth</p></li><li><p>a5e26a44f [Dart] - Rework Dart client generator to be flutter-compatible</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="elixir"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#elixir" title="Direct link to heading">#</a>Elixir</h3></li><li><p>f9b2839a3 [Elixir] Check date value before calling to_iso8601</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="elm"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#elm" title="Direct link to heading">#</a>Elm</h3></li><li><p>5a87fe695 [elm] Fix operations with empty responses (#171)</p></li><li><p>a5cf27b60 Fix Petstore example for Elm (#96)</p></li><li><p>c522927d5 Fix Elm generator for polymorphism (#78)</p></li><li><p>7d9fb9f51 Add CI test for Elm in travis (#40)</p></li><li><p>769a65c95 [Elm] Add support for array schemas</p></li><li><p>56a0268e3 [elm] missing &#x27;-&gt;&#x27; in Main elm template</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="erlang"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#erlang" title="Direct link to heading">#</a>Erlang</h3></li><li><p>c73118524 [erlang-client] Erlang request utils</p></li><li><p>049eef9c5 Test erlang client, server petstore</p></li><li><p>bcc7b788e fix erlang client compilation error</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="go"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#go" title="Direct link to heading">#</a>Go</h3></li><li><p>acb63fd5e Fix go readme, remove resty install</p></li><li><p>5d8362d85 Update go client, fix double body read</p></li><li><p>47614bb76 Properly capitalize exported go types</p></li><li><p>ee561fcd6 Add withXml option for Go language</p></li><li><p>0f6696089 [Go] Use consistent indentation in readme  </p></li><li><p>72abb20f2 [Go] Fix operation files clobbering model files. [2.4.0]</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="haskell"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#haskell" title="Direct link to heading">#</a>Haskell</h3></li><li><p>34db79b9b [haskell-http-client] update dependency versions + readme (#81)</p></li><li><p>e45b3784f Fix NPE with Haskell client generator with OAS3 spec</p></li><li><p>d3401396f [haskell-http-client] remove duplicates in produces/consumes; fix pathParam paramName issue</p></li><li><p>4bc99b9da minor fixes to haskell http client generator</p></li><li><p>2d0bafb6b [haskell-http-client] default InlineMimeTypes=true</p></li><li><p>9fba9c325 [haskell-http-client] add config options: cabalPackage, cabalVersion, baseModule, requestType, configType</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="kotlin"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#kotlin" title="Direct link to heading">#</a>Kotlin</h3></li><li><p>a3322fbf7 [kotlin] Add OkHttpClient.Builder to ApiClient.</p></li><li><p>3c5fb1d80 [kotlin] Add json annotation to each enum value.</p></li><li><p>39fa375e3 [kotlin] Fix NPE for POST/PUT/PATCH with empty request models.</p></li><li><p>c599906f1 Kotlin: Correct data_class.mustache to use proper property for inner enum data type</p></li><li><p>c69925b53 [Kotlin] Fix issues with threetenbp  </p></li><li><p>a811a48c3 minor fix to kotlin client generator due to merge conflict</p></li><li><p>914275fe7 [kotlin] support selection of datelibrary</p></li><li><p>a61d23265 Fixed incorrect renaming of header and query param to camel cases for Kotlin Client template</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="lua"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#lua" title="Direct link to heading">#</a>Lua</h3></li><li><p>dbe78e23e [Lua] Improve auto-generated test files</p></li><li><p>6c79052ac Add auto-generated Lua spec files for APIs, models</p></li><li><p>38a2c1dde [Lua] Fix Rockpec</p></li><li><p>a2410b210 Add auto-generated rockspec file to Lua API client</p></li><li><p>df10c725a Add lua test script, minor fix to Lua API files</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="java"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#java" title="Direct link to heading">#</a>Java</h3></li><li><p>2e69e6c03 build.gradle should not have commas</p></li><li><p>1a4e5a4e5 Java client: Add constants for libraries (#163)</p></li><li><p>7db0201a8 Fix NPEs in Java generator (#154)</p></li><li><p>4d7ff8cfb JavaDoc fixes for Java/RESTEasy client (#151)</p></li><li><p>072ce070b resteasy: fix outer enum case (#139)</p></li><li><p>ccd002966 [Java] rest-assured: fix javadoc in templates</p></li><li><p>e7410d4c8 Allow $ in java var name</p></li><li><p>03490e923 Fix Java binary mapping</p></li><li><p>70b4b55fa Fix performance linting problem with maps in Java ApiClient template</p></li><li><p>cddcda0fe [Java][Jersey2] Make generated client code thread safe</p></li><li><p>298ca8d35 use correct jackson date library when using Java 8</p></li><li><p>53eeb0c04 [Java] fix connection leak on retrofit OAuth token renewal</p></li><li><p>61c25e711 [Java] Fixes for retrofit</p></li><li><p>f02332755 [JAVA] 4709: codegen with parcelableMode fails to build if using arrays in swagger.</p></li><li><p>4eeb974cb [Java][google-api-client] Fix bug with empty POST request not sending content-type</p></li><li><p>d4543a99e [Java][retrofit2] file upload sets filename as baseName instead of a dynamic filename</p></li><li><p>62a930223 [JAVA][Rest-assured] reqSpec() method has been added into api.mustache for requests custom…</p></li><li><p>fec0363f7 [Java] Add back byte array enhancement</p></li><li><p>59ff4c198 [Java][library: vertx] Add default value and required parameter support to vertx server temp…</p></li><li><p>3bd2da9a8 [Java] Fix build warnings</p></li><li><p>429b96ae7 [JAVA] equals and hashCode for models with byte[] and binary strings</p></li><li><p>495971c2c [Java] use html entities in javadoc of generated code (#106)</p></li><li><p>82ee8656f [java] Enum in array of array (#66)</p></li><li><p>bf7e4e7df Java gson: add @SerializedName value as constant  (#22)</p></li><li><p>30c1448d7 Fix build.gradle for Java RESTEasy client</p></li><li><p>642c0566d [Java] Use Rx2 Completable for Void Retrofit2 responses</p></li><li><p>72221b1cf Adding @Deprecated to retrofit2 client interfaces.</p></li><li><p>47111b324 [Java] fix gson deserialize format byte</p></li><li><p>9e06f7063 [Java] Fix assignment of new object instance to variable</p></li><li><p>006f084b5 [Java] Allow to set values with setApiPackage(..) and setModelPackage(..)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="javascriptnodejs"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#javascriptnodejs" title="Direct link to heading">#</a>JavaScript/NodeJS</h3></li><li><p>d80e29585 Fix JS test using baseName in default value (#5)</p></li><li><p>fe15f4690 fix toDefaultValueWithParam in JS</p></li><li><p>90859575e Fixing variable name typo (instane -&gt; instance)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="objective-c"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#objective-c" title="Direct link to heading">#</a>Objective-C</h3></li><li><p>9fb2c29a4 7644 objc deprecated afnetworking datataskwithrequest</p></li><li><p>5d1874028 add class as a keyword in objc generator</p></li><li><p>1b8df5c20 Update ObjcClientCodegen.java</p></li><li><p>246ed5754 restore objc reserved word: property</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="php"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#php" title="Direct link to heading">#</a>PHP</h3></li><li><p>3beeb4e77 [PHP] Not-required properties now shows as nullable (#129)</p></li><li><p>37df59d6f [PHP] Adjust the names (script, sample folder, generator) to lang option (#159)</p></li><li><p>4a5d16b23 [PHP] Fix string length validation</p></li><li><p>d58835e57 [PHP] Improve: Make validation strict</p></li><li><p>cf8d8d56f [PHP] Fix code example from README. Variable name was missing when using Basic auth.</p></li><li><p>0adbf7e51 [PHP] Improve: update sample tests automatically</p></li><li><p>32cf2f16f [PHP] Non required enum property</p></li><li><p>3bcf0ff76 [PHP] Add path &amp; file separator (/) to return the correct path when deserializing a file</p></li><li><p>14e1e1980 [PHP] Improve validation on empty arrays</p></li><li><p>809e1f4c9 [PHP] Cleanup tests</p></li><li><p>76907cacd [PHP] declare property headerSelector</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="python"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#python" title="Direct link to heading">#</a>Python</h3></li><li><p>7184f1ec6 [python] asyncio supports _preload_content; remove unused imports (#107)</p></li><li><p>d74d2ba03 fix: python clients</p></li><li><p>8e0a0ebd6 Fix python / tornado body handling</p></li><li><p>b39c35c76 Fix inconsistency between model name and file name in python client</p></li><li><p>dfbef4374 Fixed unicode error and supported allow_nonstandard_methods in tornado based python client</p></li><li><p>f6e0e297e [python-asyncio] tests and fixes</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="r"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#r" title="Direct link to heading">#</a>R</h3></li><li><p>61e58d649 Add R namespace file</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="ruby"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#ruby" title="Direct link to heading">#</a>Ruby</h3></li><li><p>a08164592 fix ruby parameters in documentation, fix requiredParams, optionalParams</p></li><li><p>8e34f9a98 update to newer version of ruby</p></li><li><p>aa6b217bb [Ruby] Add auto-generated rubocop config file</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="rust"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#rust" title="Direct link to heading">#</a>Rust</h3></li><li><p>b44357394 [Rust] Implement minimal auth support</p></li><li><p>0b845a57e [Rust] Changes hard coded body to dynamic parameter name -  </p></li><li><p>a3c97753f [Rust] Handles UUID as string</p></li><li><p>027df610b [Rust] Handle error response statuses</p></li><li><p>66be7a791 [Rust] Add user agent handling for rust template (master)  </p></li><li><p>3029b7b0f [Rust] Format example with rustfmt</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="scala"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#scala" title="Direct link to heading">#</a>Scala</h3></li><li><p>197b4481e normalize akka-scala and Java README</p></li><li><p>612cfb7af [Akka-scala] Clean unused dependencies such swagger-core</p></li><li><p>86697fedb [Scala][Gatling] correct body params filename</p></li><li><p>832919b84 [Scala][Akka] Remove unused dep when model package is empty</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="swift"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#swift" title="Direct link to heading">#</a>Swift</h3></li><li><p>40d5d0990 [Swift4] accept empty content with default client</p></li><li><p>3b7230b17 [Swift 4] Fix APIHelper to accept array parameter</p></li><li><p>e22faf4cd [Swift] Add public initializer for modelObject.</p></li><li><p>b184fb1d9 [Swift3] escape URL parameters</p></li><li><p>52f606b8d Fix Swift3 test cases and add pom.xml, travis config for iOS test</p></li><li><p>a3d0f1d4b Swift4: make generated models structs instead of classes</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="typescript"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#typescript" title="Direct link to heading">#</a>TypeScript</h3></li><li><p>f615d823f update ts node dependencies</p></li><li><p>9ac9bc0dc [TypeScript] enhance ts import</p></li><li><p>009dcf009 Mark <code>not required</code> swagger properties as optional typescript properties</p></li><li><p>bdd2c2a4e Misc typescript Angular code generation improvements</p></li><li><p>260375c9e Fix typescript-node generation of array type models</p></li><li><p>d1933b5fc Fix a problem in the generation of typescript-jquery when we have enum in a query param</p></li><li><p>20305139b [Feature][TypeScript] request param enum as literal unions</p></li><li><p>524f162e6 Use supportsES6 flag in ts compilation for language typescript-angular</p></li><li><p>9b8602311 [TypeScript] Make OpenAPI Generator serialize subclasses properly (#102)</p></li><li><p>4bc5ffe86 [typescript-angular] add provided in support (#120)</p></li><li><p>ef832e715 [Feature][TS Angular] improve docs angular import</p></li><li><p>fc7e08346 [TS][Fetch] Add interfaces option</p></li><li><p>157e6b7fa [angular] Add option to generate tagged unions</p></li><li><p>7faaa091c Fix generated module imports in Aurelia APIs</p></li><li><p>b5f0b24ba [TS] fix object declaration in model</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="api-servers"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#api-servers" title="Direct link to heading">#</a>API Servers</h2></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c-2"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-2" title="Direct link to heading">#</a>C++</h3></li><li><p>6fef0a7ff fix string issue with restbed generator</p></li><li><p>a339422bd move get type declaration method to c++ restbed</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c-3"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-3" title="Direct link to heading">#</a>C#</h3></li><li><p>d9d653016 [aspnetcore] Make the use of Swashbuckle optional (#110)</p></li><li><p>9a8183ab0 [aspnetcore] Fix openapi.json location rename (#56)</p></li><li><p>12abfb968 [aspnetcore] Update Dockerfile</p></li><li><p>866817587 [aspnetcore] Fix string enum generation</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="java-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#java-1" title="Direct link to heading">#</a>Java</h3></li><li><p>bd50d368e [JAVA - jaxrs-resteasy-eap] Add import to models (#179)</p></li><li><p>7efda597c Fix issue with useBeanValidation option in Java server generators (#160)</p></li><li><p>71b5de3ed Do not set contextPath for spring-boot (#104)</p></li><li><p>b73ab0260 jaxrs-cxf-cdi: fix outer enum (#131)</p></li><li><p>4d7fc046f [JaxRS] Add &quot;validation-api&quot; dependency in jetty (#30)</p></li><li><p>ce930e7a6 [Jaxrs-cxf] Add bean-level cascaded beanvalidation for pojos (@Valid)</p></li><li><p>386b9f432 Modify &quot;postProcessOperations&quot; for &quot;jaxrs-cxf-client&quot;  </p></li><li><p>5d92717dc update jaxrs to listen at port 10080</p></li><li><p>7c2031675 update artifact id for jaxrs datelib j8</p></li><li><p>88c5112f2 Adds support for returning response in jaxrs-spec interfaces</p></li><li><p>6bf84d5fa [JAXRS-SPEC] Fix lowercase enums sent as uppercase</p></li><li><p>3a1922bc9 Fix version for &quot;spring-boot-maven-plugin&quot; (#85)</p></li><li><p>161948657 Add reactive option for Spring Boot (webflux)</p></li><li><p>ff1178ad7 [Java][Spring] fix missing optional query params</p></li><li><p>2103fadab Fix package declaration for play-framework</p></li><li><p>2c6380c84 fix inner item (list, map) for play framework</p></li><li><p>e33b350c8 Fix an issue in Play Framework generator where a CSV is empty and transferred to the controllerImp with an empty item.</p></li><li><p>99fc27246 [JAX-RS][Spec] Removes throws Exception.</p></li><li><p>fe2a44339 Fixes issue  (SpringCodeGen dateLibrary &quot;java8-localdatetime&quot; option is ignored).</p></li><li><p>d890d733f [JaxRS][Java] issue with implFolder on windows, and required fields generation for containers (#88)</p></li><li><p>c91ce17ae Feature/javaPlayWithAsynchronousControllers</p></li><li><p>f00a1ef52 [JAVA] Correct consumes/produces attributes for Spring Controllers</p></li><li><p>d14318cf2 [JAVA][Spring] Optional params with delegate</p></li><li><p>3f81378d7 [java resteasy] fix string comparison (#134)</p></li><li><p>5ea3d3bb1 [JAX-RS][SPEC] Bug fix that prevents generating interfaces when interfaceOnly is false.</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="kotlin-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#kotlin-1" title="Direct link to heading">#</a>Kotlin</h3></li><li><p>7cad47dd3 [kotlin-server] --library=ktor (barebones implementation)</p></li><li><p>752b36e66 [Kotlin] Sanitize enumeration name to add underscore when it starts with digits (#77)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="nodejs"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#nodejs" title="Direct link to heading">#</a>NodeJS</h3></li><li><p>6d88d073c [NodeJS] make serverPort configurable via CLI option</p></li><li><p>e7f4fb3c4 Fix nodejs-server path issue in windows platform</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="php-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#php-1" title="Direct link to heading">#</a>PHP</h3></li><li><p>d30fcbabb Fixes for php-ze-ph generator</p></li><li><p>60e3339aa [Feature][PHP] Update for ze-ph generator</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="python-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#python-1" title="Direct link to heading">#</a>Python</h3></li><li><p>62b93fc5c [Python][Flask] Handles UUID format -  </p></li><li><p>9999eac52 fix python flask parameter naming</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="scala-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#scala-1" title="Direct link to heading">#</a>Scala</h3></li><li><p>d5c355a59 [Scalatra] Updated the version of Scalatra to the latest (2.6.2)</p></li><li><p>52322c47c [finch] Allow finch server to compile for CI checks (#7)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="ruby-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#ruby-1" title="Direct link to heading">#</a>Ruby</h3></li><li><p>dcad9ae80 [Rails5] make version of the generated Rails stub server to strict Rails 5.0</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="rust-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#rust-1" title="Direct link to heading">#</a>Rust</h3></li><li><p>37faaf926 [rust-server] API version constant and composite version support</p></li><li><p>6c7813e79 [rust-server] asynchronous support via hyper v0.11</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation" title="Direct link to heading">#</a>Documentation</h2></li><li><p>25a6a9d44 html: fix typo in class name  </p></li></ul><ul><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="miscellaneous"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#miscellaneous" title="Direct link to heading">#</a>Miscellaneous</h2></li><li>f04213285 Cli error message improvements (#172)</li><li>0ece706a4 Remove CodegenConfig.fromModel(String, Schema) method (#90)</li><li>64f2bea37 Fix getReferenced...() methods in ModelUtils (#157)</li><li>16ff5174e Update swagger-parser to 2.0.1 (#123)</li><li>76b7307a6 DefaultGenerator: ignore only form param schemas (#74)</li><li>a3aabd390 Create a default implementation of delegate if none could be autowired (#92)</li><li>ca89af808 Switch to Java 8</li><li>27426f7b5 Cli generator name option, replaces &#x27;language&#x27; options in CLI and Maven Plugin (#57)</li><li>a1ff50241 Rename datatype to dataType in CodegenProperty (#69)</li><li>3b9a2a7c3 CaseFormatLambda has been added, params for Rest-assured client has been refactored (#91)</li><li>488910362 Set parameters allowableValues dynamically (#65)</li><li>2821f18b9 Meta: set version for &quot;build-helper-maven-plugin&quot; (#89)</li><li>82d9e935e Add CORS configuration to openapi-generator-online (#71)</li><li>e3814f51d Improvements to online codegen (#55)</li><li>6b8079808 Consider minLength, maxLength and pattern in referenced schema (#45)</li><li>7c5dfbfa0 Minor improvements to OpenAPI Generator Online (#54)</li><li>8dd46a3fb Move online gen from jersey to spring boot (#44)</li><li>803821e21 Fix an issue with example generator when array is too large (#46)</li><li>673f2bc46 Add CodegenProperty.nameInSnakeCase  (#42)</li><li>67ebe17dd Fix isPrimitiveType flag for array of form parameters (#38)</li><li>10ac4024d Code clean-up: remove field declaration hiding existing fields (#35)</li><li>ab9c4b5a6 Code clean-up: Add own private static final LOGGER in each class (#26)</li><li>41b0ff351 Code clean-up: remove DefaultCodegen#getSimpleRef(String) (#19)</li><li>13f084e7b Fix dataTypeWithEnum for array of form parameters</li><li>fd3b883e8 [DefaultCodegen] Fill CodegenOperation::produces with unique media types</li><li>db9a899a0 update getSchemaType variable, remove unused import</li><li>d74b4cdf8 fix map type and collection format for form parameter (array)</li><li>d99f46cff Revise how to obtain the example value</li><li>b1eac05b2 Fix form datatype (array of string)</li><li>3c666a6d4 Fix array of form parameters</li><li>1492df6ce Override server port for Jetty configuration</li><li>622a75b2c Fix data type shadowing</li><li>861d11d01 use vendor extension in operation to set the body parameter name</li><li>80c8b92cb add postProcessParameter for body, form parameter</li><li>7fe555a51 Set collectionFormat default only for array</li><li>16589de97 default collection format to csv according to the spec</li><li>edbe4902a Consider &#x27;$ref&#x27; for consumes and produces in CodegenOperation</li><li>e24238a35 Improve getter name handling for boolean properties</li><li>6e2ca294b update discriminator to discriminatorName</li><li>74075c087 Primitive datatype in Schema components</li><li>d8abd4a14 support map in body parameter</li><li>186594115 Update swagger-core to 2.0.1</li><li>2034f61e5 Add HideGenerationTimestamp getter and setter in the CodegenConfig interface</li><li>d0e2d7684 Getter and Setter for hideGenerationTimestamp</li><li>adbde2fb6 replace fromOperation with postProcessOperations</li><li>9d1ae0dd2 fix bigdecimal in default codegen</li><li>ffa0e115d fix default value and type declaration</li><li>0e744adb8 Apply collection format to SIMPLE enum style</li><li>36ed29852 Tweak tests according to the parameter order changes</li><li>17b082793 Move &#x27;enum_query_double&#x27; to parameters section</li><li>28fcf48f4 Add a method returns discriminator name</li><li>7daa2ec5d Fix broken discriminator</li><li>faa901640 Replace with the helper function: <code>getTypeDeclaration</code></li><li>c8650d0e3 Make optional properties in models optional parameters</li><li>40c30dd2f Fix inputSpec for multi module builds</li><li>5326152cc add option to reorder form/body parameter</li><li>d1850091a Improve JMeter Template</li><li>fedfb0cda Factorize addOption/addSwitch method</li><li>e73eeb4fd fix for stripping prefix on single enums</li><li>13e3db59e Add operationIdOriginal to store the original operationId</li><li>0b2d80569 Expose getter/setter for serverPort to facilitate testing</li><li>8e270f465 add vendorExtensions field in CodegenSecurity class</li><li>1ee85de94 Added Intelli J ignore</li><li>7b8e409cf Added gitignore generation function</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/3.0.0-release-note.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/release-summary"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Release Summary</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/generators"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Generators List »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Release Notes: 3.0.0</h1></header><div class="markdown"><ul><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="docker"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#docker" title="Direct link to heading">#</a>Docker</h2></li><li><p>7dfd94002 Docker: use correct MAVEN_CONFIG (#182)</p></li><li><p>b5a0d173d Revise the usage of OpenAPI Generator online (docker image) (#73)</p></li><li><p>e58dc2c77 Fix COPY in Dockerfile (#64)</p></li><li><p>9d7feaaeb Fix online generator (docker push) (#58)</p></li><li><p>9247cd01e Changes for Docker</p></li><li><p>64037ee59 update docker-related files to ues jdk8</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="plug-ins"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#plug-ins" title="Direct link to heading">#</a>Plug-ins</h2></li><li><p>b6b8c0db8 [gradle-plugin] Initial implementation (#162)  </p></li><li><p>0a28aad73 [MAVEN PLUGIN] Checking for null configOptions before looking for property</p></li><li><p>9c79297d6 [MAVEN PLUGIN] Use latest version in dependencies snippet</p></li><li><p>9e1bbe0c1 Add maven wrapper</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="api-clients"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#api-clients" title="Direct link to heading">#</a>API Clients</h2></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="ada"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#ada" title="Direct link to heading">#</a>Ada</h3></li><li><p>edf6be8c0 [Ada] bug fix by defining x-is-model-type when property is local to the YML file</p></li><li><p>9ba74f484 [Ada] Fix GNAT project and server skeleton to avoid sending a response when an error is returned</p></li><li><p>ea27924f5 [Ada] changed default project/package name, to solve circular dependencies</p></li><li><p>6b9d38d40 remove trailing spaces in ada template</p></li><li><p>0de7f972f Fix the Ada server skeleton to check the authsMethods in the Shared_Instance generic package</p></li><li><p>4bd8fc6e8 Fix 7511: [Ada] Client call is not correct with multiple parameters and application/x-www-urlencoded</p></li><li><p>3035bc629 [Ada] Hotfix/ada model sort</p></li><li><p>43f0e8692 Ada code generator corrected: &quot;=&gt;&quot; instead of &quot;-&gt;&quot;.  </p></li><li><p>7d2b49085 [Ada] wrong order for generated structures in models.ads files</p></li><li><p>2b2b85eec [Ada] wrong JSON in POST operations</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c" title="Direct link to heading">#</a>C#</h3></li><li><p>0e34bcf4e [csharp] ctor params should always be camelCase</p></li><li><p>872471996 [csharp] Support arrays of arrays for properties and models</p></li><li><p>1c4e6b7d4 [csharp] Fix ToJson to work with composition and polymorphism</p></li><li><p>ed7af73f6 [csharp] Reference this.Configuration in client API template</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-1" title="Direct link to heading">#</a>C++</h3></li><li><p>e796e4c36 [C++] Add linux as a reserve keyword</p></li><li><p>36f69a034 remove trailing spaces in qt5 c++ templates</p></li><li><p>f192613f1 fix string type in c++ generator</p></li><li><p>409015461 fix file type in qt5cpp</p></li><li><p>a4bcb3bc7 fix datetime and map type for qt5cpp</p></li><li><p>23b31aba8 [qt5cpp] Fix crash when API return a map container</p></li><li><p>3b031ed2b [qt5cpp] delete callback data allocated before signal emission</p></li><li><p>1bb1e44d1 [qt5cpp] Remove qt5 pro.user file</p></li><li><p>194722015 Qt5cpp plug memleaks part2</p></li><li><p>12f3661d6 Qt5cpp plug memleaks</p></li><li><p>ea4b94842 [qt5cpp] Add nullptr guard to prevent crash when empty model is being serialized</p></li><li><p>0bf430a80 Qt5cpp Add support for nested containers</p></li><li><p>0b3ec6b1f fix NPE with cpp qt5, add logic to avoid NPE with composed schema</p></li><li><p>7c734445b fix file parameter in header file (cpprest)</p></li><li><p>070b5c00b fix object type declaration in cpprest</p></li><li><p>bad1885b4 [cpprest] add parameterToString for number type with unspecified format (double)</p></li><li><p>73bd24db7 [cpprest] Add support for nested vectors</p></li><li><p>ee2eb74f7 [qt] update Qt client</p></li><li><p>d82499944 Adding qt project generation fix</p></li><li><p>9bd94b4db [qt] Fix warning message</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="clojure"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#clojure" title="Direct link to heading">#</a>Clojure</h3></li><li><p>d7e374504 [Clojure] Add util method to set the api-context globally (#93)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="dart"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#dart" title="Direct link to heading">#</a>Dart</h3></li><li><p>f1638a659 [Dart] Allow setting an accessToken for OAuth</p></li><li><p>a5e26a44f [Dart] - Rework Dart client generator to be flutter-compatible</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="elixir"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#elixir" title="Direct link to heading">#</a>Elixir</h3></li><li><p>f9b2839a3 [Elixir] Check date value before calling to_iso8601</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="elm"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#elm" title="Direct link to heading">#</a>Elm</h3></li><li><p>5a87fe695 [elm] Fix operations with empty responses (#171)</p></li><li><p>a5cf27b60 Fix Petstore example for Elm (#96)</p></li><li><p>c522927d5 Fix Elm generator for polymorphism (#78)</p></li><li><p>7d9fb9f51 Add CI test for Elm in travis (#40)</p></li><li><p>769a65c95 [Elm] Add support for array schemas</p></li><li><p>56a0268e3 [elm] missing &#x27;-&gt;&#x27; in Main elm template</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="erlang"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#erlang" title="Direct link to heading">#</a>Erlang</h3></li><li><p>c73118524 [erlang-client] Erlang request utils</p></li><li><p>049eef9c5 Test erlang client, server petstore</p></li><li><p>bcc7b788e fix erlang client compilation error</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="go"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#go" title="Direct link to heading">#</a>Go</h3></li><li><p>acb63fd5e Fix go readme, remove resty install</p></li><li><p>5d8362d85 Update go client, fix double body read</p></li><li><p>47614bb76 Properly capitalize exported go types</p></li><li><p>ee561fcd6 Add withXml option for Go language</p></li><li><p>0f6696089 [Go] Use consistent indentation in readme  </p></li><li><p>72abb20f2 [Go] Fix operation files clobbering model files. [2.4.0]</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="haskell"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#haskell" title="Direct link to heading">#</a>Haskell</h3></li><li><p>34db79b9b [haskell-http-client] update dependency versions + readme (#81)</p></li><li><p>e45b3784f Fix NPE with Haskell client generator with OAS3 spec</p></li><li><p>d3401396f [haskell-http-client] remove duplicates in produces/consumes; fix pathParam paramName issue</p></li><li><p>4bc99b9da minor fixes to haskell http client generator</p></li><li><p>2d0bafb6b [haskell-http-client] default InlineMimeTypes=true</p></li><li><p>9fba9c325 [haskell-http-client] add config options: cabalPackage, cabalVersion, baseModule, requestType, configType</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="kotlin"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#kotlin" title="Direct link to heading">#</a>Kotlin</h3></li><li><p>a3322fbf7 [kotlin] Add OkHttpClient.Builder to ApiClient.</p></li><li><p>3c5fb1d80 [kotlin] Add json annotation to each enum value.</p></li><li><p>39fa375e3 [kotlin] Fix NPE for POST/PUT/PATCH with empty request models.</p></li><li><p>c599906f1 Kotlin: Correct data_class.mustache to use proper property for inner enum data type</p></li><li><p>c69925b53 [Kotlin] Fix issues with threetenbp  </p></li><li><p>a811a48c3 minor fix to kotlin client generator due to merge conflict</p></li><li><p>914275fe7 [kotlin] support selection of datelibrary</p></li><li><p>a61d23265 Fixed incorrect renaming of header and query param to camel cases for Kotlin Client template</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="lua"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#lua" title="Direct link to heading">#</a>Lua</h3></li><li><p>dbe78e23e [Lua] Improve auto-generated test files</p></li><li><p>6c79052ac Add auto-generated Lua spec files for APIs, models</p></li><li><p>38a2c1dde [Lua] Fix Rockpec</p></li><li><p>a2410b210 Add auto-generated rockspec file to Lua API client</p></li><li><p>df10c725a Add lua test script, minor fix to Lua API files</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="java"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#java" title="Direct link to heading">#</a>Java</h3></li><li><p>2e69e6c03 build.gradle should not have commas</p></li><li><p>1a4e5a4e5 Java client: Add constants for libraries (#163)</p></li><li><p>7db0201a8 Fix NPEs in Java generator (#154)</p></li><li><p>4d7ff8cfb JavaDoc fixes for Java/RESTEasy client (#151)</p></li><li><p>072ce070b resteasy: fix outer enum case (#139)</p></li><li><p>ccd002966 [Java] rest-assured: fix javadoc in templates</p></li><li><p>e7410d4c8 Allow $ in java var name</p></li><li><p>03490e923 Fix Java binary mapping</p></li><li><p>70b4b55fa Fix performance linting problem with maps in Java ApiClient template</p></li><li><p>cddcda0fe [Java][Jersey2] Make generated client code thread safe</p></li><li><p>298ca8d35 use correct jackson date library when using Java 8</p></li><li><p>53eeb0c04 [Java] fix connection leak on retrofit OAuth token renewal</p></li><li><p>61c25e711 [Java] Fixes for retrofit</p></li><li><p>f02332755 [JAVA] 4709: codegen with parcelableMode fails to build if using arrays in swagger.</p></li><li><p>4eeb974cb [Java][google-api-client] Fix bug with empty POST request not sending content-type</p></li><li><p>d4543a99e [Java][retrofit2] file upload sets filename as baseName instead of a dynamic filename</p></li><li><p>62a930223 [JAVA][Rest-assured] reqSpec() method has been added into api.mustache for requests custom…</p></li><li><p>fec0363f7 [Java] Add back byte array enhancement</p></li><li><p>59ff4c198 [Java][library: vertx] Add default value and required parameter support to vertx server temp…</p></li><li><p>3bd2da9a8 [Java] Fix build warnings</p></li><li><p>429b96ae7 [JAVA] equals and hashCode for models with byte[] and binary strings</p></li><li><p>495971c2c [Java] use html entities in javadoc of generated code (#106)</p></li><li><p>82ee8656f [java] Enum in array of array (#66)</p></li><li><p>bf7e4e7df Java gson: add @SerializedName value as constant  (#22)</p></li><li><p>30c1448d7 Fix build.gradle for Java RESTEasy client</p></li><li><p>642c0566d [Java] Use Rx2 Completable for Void Retrofit2 responses</p></li><li><p>72221b1cf Adding @Deprecated to retrofit2 client interfaces.</p></li><li><p>47111b324 [Java] fix gson deserialize format byte</p></li><li><p>9e06f7063 [Java] Fix assignment of new object instance to variable</p></li><li><p>006f084b5 [Java] Allow to set values with setApiPackage(..) and setModelPackage(..)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="javascriptnodejs"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#javascriptnodejs" title="Direct link to heading">#</a>JavaScript/NodeJS</h3></li><li><p>d80e29585 Fix JS test using baseName in default value (#5)</p></li><li><p>fe15f4690 fix toDefaultValueWithParam in JS</p></li><li><p>90859575e Fixing variable name typo (instane -&gt; instance)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="objective-c"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#objective-c" title="Direct link to heading">#</a>Objective-C</h3></li><li><p>9fb2c29a4 7644 objc deprecated afnetworking datataskwithrequest</p></li><li><p>5d1874028 add class as a keyword in objc generator</p></li><li><p>1b8df5c20 Update ObjcClientCodegen.java</p></li><li><p>246ed5754 restore objc reserved word: property</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="php"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#php" title="Direct link to heading">#</a>PHP</h3></li><li><p>3beeb4e77 [PHP] Not-required properties now shows as nullable (#129)</p></li><li><p>37df59d6f [PHP] Adjust the names (script, sample folder, generator) to lang option (#159)</p></li><li><p>4a5d16b23 [PHP] Fix string length validation</p></li><li><p>d58835e57 [PHP] Improve: Make validation strict</p></li><li><p>cf8d8d56f [PHP] Fix code example from README. Variable name was missing when using Basic auth.</p></li><li><p>0adbf7e51 [PHP] Improve: update sample tests automatically</p></li><li><p>32cf2f16f [PHP] Non required enum property</p></li><li><p>3bcf0ff76 [PHP] Add path &amp; file separator (/) to return the correct path when deserializing a file</p></li><li><p>14e1e1980 [PHP] Improve validation on empty arrays</p></li><li><p>809e1f4c9 [PHP] Cleanup tests</p></li><li><p>76907cacd [PHP] declare property headerSelector</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="python"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#python" title="Direct link to heading">#</a>Python</h3></li><li><p>7184f1ec6 [python] asyncio supports _preload_content; remove unused imports (#107)</p></li><li><p>d74d2ba03 fix: python clients</p></li><li><p>8e0a0ebd6 Fix python / tornado body handling</p></li><li><p>b39c35c76 Fix inconsistency between model name and file name in python client</p></li><li><p>dfbef4374 Fixed unicode error and supported allow_nonstandard_methods in tornado based python client</p></li><li><p>f6e0e297e [python-asyncio] tests and fixes</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="r"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#r" title="Direct link to heading">#</a>R</h3></li><li><p>61e58d649 Add R namespace file</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="ruby"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#ruby" title="Direct link to heading">#</a>Ruby</h3></li><li><p>a08164592 fix ruby parameters in documentation, fix requiredParams, optionalParams</p></li><li><p>8e34f9a98 update to newer version of ruby</p></li><li><p>aa6b217bb [Ruby] Add auto-generated rubocop config file</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="rust"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#rust" title="Direct link to heading">#</a>Rust</h3></li><li><p>b44357394 [Rust] Implement minimal auth support</p></li><li><p>0b845a57e [Rust] Changes hard coded body to dynamic parameter name -  </p></li><li><p>a3c97753f [Rust] Handles UUID as string</p></li><li><p>027df610b [Rust] Handle error response statuses</p></li><li><p>66be7a791 [Rust] Add user agent handling for rust template (master)  </p></li><li><p>3029b7b0f [Rust] Format example with rustfmt</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="scala"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#scala" title="Direct link to heading">#</a>Scala</h3></li><li><p>197b4481e normalize akka-scala and Java README</p></li><li><p>612cfb7af [Akka-scala] Clean unused dependencies such swagger-core</p></li><li><p>86697fedb [Scala][Gatling] correct body params filename</p></li><li><p>832919b84 [Scala][Akka] Remove unused dep when model package is empty</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="swift"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#swift" title="Direct link to heading">#</a>Swift</h3></li><li><p>40d5d0990 [Swift4] accept empty content with default client</p></li><li><p>3b7230b17 [Swift 4] Fix APIHelper to accept array parameter</p></li><li><p>e22faf4cd [Swift] Add public initializer for modelObject.</p></li><li><p>b184fb1d9 [Swift3] escape URL parameters</p></li><li><p>52f606b8d Fix Swift3 test cases and add pom.xml, travis config for iOS test</p></li><li><p>a3d0f1d4b Swift4: make generated models structs instead of classes</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="typescript"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#typescript" title="Direct link to heading">#</a>TypeScript</h3></li><li><p>f615d823f update ts node dependencies</p></li><li><p>9ac9bc0dc [TypeScript] enhance ts import</p></li><li><p>009dcf009 Mark <code>not required</code> swagger properties as optional typescript properties</p></li><li><p>bdd2c2a4e Misc typescript Angular code generation improvements</p></li><li><p>260375c9e Fix typescript-node generation of array type models</p></li><li><p>d1933b5fc Fix a problem in the generation of typescript-jquery when we have enum in a query param</p></li><li><p>20305139b [Feature][TypeScript] request param enum as literal unions</p></li><li><p>524f162e6 Use supportsES6 flag in ts compilation for language typescript-angular</p></li><li><p>9b8602311 [TypeScript] Make OpenAPI Generator serialize subclasses properly (#102)</p></li><li><p>4bc5ffe86 [typescript-angular] add provided in support (#120)</p></li><li><p>ef832e715 [Feature][TS Angular] improve docs angular import</p></li><li><p>fc7e08346 [TS][Fetch] Add interfaces option</p></li><li><p>157e6b7fa [angular] Add option to generate tagged unions</p></li><li><p>7faaa091c Fix generated module imports in Aurelia APIs</p></li><li><p>b5f0b24ba [TS] fix object declaration in model</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="api-servers"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#api-servers" title="Direct link to heading">#</a>API Servers</h2></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c-2"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-2" title="Direct link to heading">#</a>C++</h3></li><li><p>6fef0a7ff fix string issue with restbed generator</p></li><li><p>a339422bd move get type declaration method to c++ restbed</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="c-3"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#c-3" title="Direct link to heading">#</a>C#</h3></li><li><p>d9d653016 [aspnetcore] Make the use of Swashbuckle optional (#110)</p></li><li><p>9a8183ab0 [aspnetcore] Fix openapi.json location rename (#56)</p></li><li><p>12abfb968 [aspnetcore] Update Dockerfile</p></li><li><p>866817587 [aspnetcore] Fix string enum generation</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="java-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#java-1" title="Direct link to heading">#</a>Java</h3></li><li><p>bd50d368e [JAVA - jaxrs-resteasy-eap] Add import to models (#179)</p></li><li><p>7efda597c Fix issue with useBeanValidation option in Java server generators (#160)</p></li><li><p>71b5de3ed Do not set contextPath for spring-boot (#104)</p></li><li><p>b73ab0260 jaxrs-cxf-cdi: fix outer enum (#131)</p></li><li><p>4d7fc046f [JaxRS] Add &quot;validation-api&quot; dependency in jetty (#30)</p></li><li><p>ce930e7a6 [Jaxrs-cxf] Add bean-level cascaded beanvalidation for pojos (@Valid)</p></li><li><p>386b9f432 Modify &quot;postProcessOperations&quot; for &quot;jaxrs-cxf-client&quot;  </p></li><li><p>5d92717dc update jaxrs to listen at port 10080</p></li><li><p>7c2031675 update artifact id for jaxrs datelib j8</p></li><li><p>88c5112f2 Adds support for returning response in jaxrs-spec interfaces</p></li><li><p>6bf84d5fa [JAXRS-SPEC] Fix lowercase enums sent as uppercase</p></li><li><p>3a1922bc9 Fix version for &quot;spring-boot-maven-plugin&quot; (#85)</p></li><li><p>161948657 Add reactive option for Spring Boot (webflux)</p></li><li><p>ff1178ad7 [Java][Spring] fix missing optional query params</p></li><li><p>2103fadab Fix package declaration for play-framework</p></li><li><p>2c6380c84 fix inner item (list, map) for play framework</p></li><li><p>e33b350c8 Fix an issue in Play Framework generator where a CSV is empty and transferred to the controllerImp with an empty item.</p></li><li><p>99fc27246 [JAX-RS][Spec] Removes throws Exception.</p></li><li><p>fe2a44339 Fixes issue  (SpringCodeGen dateLibrary &quot;java8-localdatetime&quot; option is ignored).</p></li><li><p>d890d733f [JaxRS][Java] issue with implFolder on windows, and required fields generation for containers (#88)</p></li><li><p>c91ce17ae Feature/javaPlayWithAsynchronousControllers</p></li><li><p>f00a1ef52 [JAVA] Correct consumes/produces attributes for Spring Controllers</p></li><li><p>d14318cf2 [JAVA][Spring] Optional params with delegate</p></li><li><p>3f81378d7 [java resteasy] fix string comparison (#134)</p></li><li><p>5ea3d3bb1 [JAX-RS][SPEC] Bug fix that prevents generating interfaces when interfaceOnly is false.</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="kotlin-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#kotlin-1" title="Direct link to heading">#</a>Kotlin</h3></li><li><p>7cad47dd3 [kotlin-server] --library=ktor (barebones implementation)</p></li><li><p>752b36e66 [Kotlin] Sanitize enumeration name to add underscore when it starts with digits (#77)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="nodejs"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#nodejs" title="Direct link to heading">#</a>NodeJS</h3></li><li><p>6d88d073c [NodeJS] make serverPort configurable via CLI option</p></li><li><p>e7f4fb3c4 Fix nodejs-server path issue in windows platform</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="php-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#php-1" title="Direct link to heading">#</a>PHP</h3></li><li><p>d30fcbabb Fixes for php-ze-ph generator</p></li><li><p>60e3339aa [Feature][PHP] Update for ze-ph generator</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="python-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#python-1" title="Direct link to heading">#</a>Python</h3></li><li><p>62b93fc5c [Python][Flask] Handles UUID format -  </p></li><li><p>9999eac52 fix python flask parameter naming</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="scala-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#scala-1" title="Direct link to heading">#</a>Scala</h3></li><li><p>d5c355a59 [Scalatra] Updated the version of Scalatra to the latest (2.6.2)</p></li><li><p>52322c47c [finch] Allow finch server to compile for CI checks (#7)</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="ruby-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#ruby-1" title="Direct link to heading">#</a>Ruby</h3></li><li><p>dcad9ae80 [Rails5] make version of the generated Rails stub server to strict Rails 5.0</p></li><li><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="rust-1"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#rust-1" title="Direct link to heading">#</a>Rust</h3></li><li><p>37faaf926 [rust-server] API version constant and composite version support</p></li><li><p>6c7813e79 [rust-server] asynchronous support via hyper v0.11</p></li><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="documentation"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#documentation" title="Direct link to heading">#</a>Documentation</h2></li><li><p>25a6a9d44 html: fix typo in class name  </p></li></ul><ul><li><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="miscellaneous"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#miscellaneous" title="Direct link to heading">#</a>Miscellaneous</h2></li><li>f04213285 Cli error message improvements (#172)</li><li>0ece706a4 Remove CodegenConfig.fromModel(String, Schema) method (#90)</li><li>64f2bea37 Fix getReferenced...() methods in ModelUtils (#157)</li><li>16ff5174e Update swagger-parser to 2.0.1 (#123)</li><li>76b7307a6 DefaultGenerator: ignore only form param schemas (#74)</li><li>a3aabd390 Create a default implementation of delegate if none could be autowired (#92)</li><li>ca89af808 Switch to Java 8</li><li>27426f7b5 Cli generator name option, replaces &#x27;language&#x27; options in CLI and Maven Plugin (#57)</li><li>a1ff50241 Rename datatype to dataType in CodegenProperty (#69)</li><li>3b9a2a7c3 CaseFormatLambda has been added, params for Rest-assured client has been refactored (#91)</li><li>488910362 Set parameters allowableValues dynamically (#65)</li><li>2821f18b9 Meta: set version for &quot;build-helper-maven-plugin&quot; (#89)</li><li>82d9e935e Add CORS configuration to openapi-generator-online (#71)</li><li>e3814f51d Improvements to online codegen (#55)</li><li>6b8079808 Consider minLength, maxLength and pattern in referenced schema (#45)</li><li>7c5dfbfa0 Minor improvements to OpenAPI Generator Online (#54)</li><li>8dd46a3fb Move online gen from jersey to spring boot (#44)</li><li>803821e21 Fix an issue with example generator when array is too large (#46)</li><li>673f2bc46 Add CodegenProperty.nameInSnakeCase  (#42)</li><li>67ebe17dd Fix isPrimitiveType flag for array of form parameters (#38)</li><li>10ac4024d Code clean-up: remove field declaration hiding existing fields (#35)</li><li>ab9c4b5a6 Code clean-up: Add own private static final LOGGER in each class (#26)</li><li>41b0ff351 Code clean-up: remove DefaultCodegen#getSimpleRef(String) (#19)</li><li>13f084e7b Fix dataTypeWithEnum for array of form parameters</li><li>fd3b883e8 [DefaultCodegen] Fill CodegenOperation::produces with unique media types</li><li>db9a899a0 update getSchemaType variable, remove unused import</li><li>d74b4cdf8 fix map type and collection format for form parameter (array)</li><li>d99f46cff Revise how to obtain the example value</li><li>b1eac05b2 Fix form datatype (array of string)</li><li>3c666a6d4 Fix array of form parameters</li><li>1492df6ce Override server port for Jetty configuration</li><li>622a75b2c Fix data type shadowing</li><li>861d11d01 use vendor extension in operation to set the body parameter name</li><li>80c8b92cb add postProcessParameter for body, form parameter</li><li>7fe555a51 Set collectionFormat default only for array</li><li>16589de97 default collection format to csv according to the spec</li><li>edbe4902a Consider &#x27;$ref&#x27; for consumes and produces in CodegenOperation</li><li>e24238a35 Improve getter name handling for boolean properties</li><li>6e2ca294b update discriminator to discriminatorName</li><li>74075c087 Primitive datatype in Schema components</li><li>d8abd4a14 support map in body parameter</li><li>186594115 Update swagger-core to 2.0.1</li><li>2034f61e5 Add HideGenerationTimestamp getter and setter in the CodegenConfig interface</li><li>d0e2d7684 Getter and Setter for hideGenerationTimestamp</li><li>adbde2fb6 replace fromOperation with postProcessOperations</li><li>9d1ae0dd2 fix bigdecimal in default codegen</li><li>ffa0e115d fix default value and type declaration</li><li>0e744adb8 Apply collection format to SIMPLE enum style</li><li>36ed29852 Tweak tests according to the parameter order changes</li><li>17b082793 Move &#x27;enum_query_double&#x27; to parameters section</li><li>28fcf48f4 Add a method returns discriminator name</li><li>7daa2ec5d Fix broken discriminator</li><li>faa901640 Replace with the helper function: <code>getTypeDeclaration</code></li><li>c8650d0e3 Make optional properties in models optional parameters</li><li>40c30dd2f Fix inputSpec for multi module builds</li><li>5326152cc add option to reorder form/body parameter</li><li>d1850091a Improve JMeter Template</li><li>fedfb0cda Factorize addOption/addSwitch method</li><li>e73eeb4fd fix for stripping prefix on single enums</li><li>13e3db59e Add operationIdOriginal to store the original operationId</li><li>0b2d80569 Expose getter/setter for serverPort to facilitate testing</li><li>8e270f465 add vendorExtensions field in CodegenSecurity class</li><li>1ee85de94 Added Intelli J ignore</li><li>7b8e409cf Added gitignore generation function</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/3.0.0-release-note.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/release-summary"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Release Summary</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/generators"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Generators List »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/f1d7b915.1ac91f23.js"></script>
+<script src="/f1d7b915.ae502643.js"></script>
 
 
 </body>
diff --git a/docs/release-summary/index.html b/docs/release-summary/index.html
index a7290ff7964..316d1cae6f8 100644
--- a/docs/release-summary/index.html
+++ b/docs/release-summary/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Release Summary</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="versioning"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#versioning" title="Direct link to heading">#</a>Versioning</h2><p>We version artifacts in the common <code>major.minor.patch</code> strategy.</p><p>We decided versions should be incremented according to the following rules. The examples provided below are not exhaustive.</p><table><thead><tr><th align="right">Part</th><th align="center">Breaking Changes?</th><th align="left">Rule</th><th align="left">Examples</th></tr></thead><tbody><tr><td align="right">major</td><td align="center">YES</td><td align="left">breaking changes without fallback</td><td align="left"><ul><li>New Features</li><li>Large refactors</li><li>Removal of deprecated code</li><li>Changes to coding interfaces</li><li>Large changes to template bound variables</li></ul></td></tr><tr><td align="right">minor</td><td align="center">ALLOWED</td><td align="left">breaking changes with fallback</td><td align="left"><ul><li>Adding new generator behavior which doesn&#x27;t affect custom templates (or does, with config option for old behavior)</li><li>Changing generator templates in a way in which switching to custom templates results in old behavior</li><li>Introducing deprecated methods in generators or other shared code</li></ul></td></tr><tr><td align="right">patch</td><td align="center">NO</td><td align="left">new features without breaking changes</td><td align="left"><ul><li>New generators</li><li>Bug fixes in template or generators</li></ul></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="cadence"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#cadence" title="Direct link to heading">#</a>Cadence</h2><p>For patch release (e.g. 3.0.5 to 3.0.6), we plan to do it on a <em>weekly basis</em>.</p><p>For minor release (e.g. 3.1.6 to 3.2.0), we plan to do it on a <em>monthly basis</em>.</p><p>For major releases (e.g. 3.3.6 to 4.0.0), we plan to do it on a <em>quarterly basis</em>.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/release-summary.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/fork-qna"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Swagger Codegen Fork: Q&amp;A</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/release-3-0-0"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Release Notes: 3.0.0 »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#versioning" class="contents__link">Versioning</a></li><li><a href="#cadence" class="contents__link">Cadence</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Release Summary</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="versioning"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#versioning" title="Direct link to heading">#</a>Versioning</h2><p>We version artifacts in the common <code>major.minor.patch</code> strategy.</p><p>We decided versions should be incremented according to the following rules. The examples provided below are not exhaustive.</p><table><thead><tr><th align="right">Part</th><th align="center">Breaking Changes?</th><th align="left">Rule</th><th align="left">Examples</th></tr></thead><tbody><tr><td align="right">major</td><td align="center">YES</td><td align="left">breaking changes without fallback</td><td align="left"><ul><li>New Features</li><li>Large refactors</li><li>Removal of deprecated code</li><li>Changes to coding interfaces</li><li>Large changes to template bound variables</li></ul></td></tr><tr><td align="right">minor</td><td align="center">ALLOWED</td><td align="left">breaking changes with fallback</td><td align="left"><ul><li>Adding new generator behavior which doesn&#x27;t affect custom templates (or does, with config option for old behavior)</li><li>Changing generator templates in a way in which switching to custom templates results in old behavior</li><li>Introducing deprecated methods in generators or other shared code</li></ul></td></tr><tr><td align="right">patch</td><td align="center">NO</td><td align="left">new features without breaking changes</td><td align="left"><ul><li>New generators</li><li>Bug fixes in template or generators</li></ul></td></tr></tbody></table><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="cadence"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#cadence" title="Direct link to heading">#</a>Cadence</h2><p>For patch release (e.g. 3.0.5 to 3.0.6), we plan to do it on a <em>weekly basis</em>.</p><p>For minor release (e.g. 3.1.6 to 3.2.0), we plan to do it on a <em>monthly basis</em>.</p><p>For major releases (e.g. 3.3.6 to 4.0.0), we plan to do it on a <em>quarterly basis</em>.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/release-summary.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/fork-qna"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Swagger Codegen Fork: Q&amp;A</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/release-3-0-0"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Release Notes: 3.0.0 »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#versioning" class="contents__link">Versioning</a></li><li><a href="#cadence" class="contents__link">Cadence</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/9cbcc25e.e906fc50.js"></script>
+<script src="/9cbcc25e.e39b6862.js"></script>
 
 
 </body>
diff --git a/docs/roadmap/index.html b/docs/roadmap/index.html
index 064d785baaf..55bbccd71aa 100644
--- a/docs/roadmap/index.html
+++ b/docs/roadmap/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Roadmap</h1></header><div class="markdown"><p>This document lists short-term, medium-term, and long-term goals for the project.</p><hr><p><strong>NOTE</strong></p><p>These are goals, not necessarily commitments. The sections are not intended to represent exclusive focus during these terms. For example, when you start at a college or university you may have a long-term goal to graduate and a short-term goal to find a job for supplemental income. We will similarly work toward many of our medium-term and long-term goals in the near future as we move toward meeting our short-term goals.</p><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="short-term"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#short-term" title="Direct link to heading">#</a>Short-term</h2><blockquote><p>Usability, stability, and marketing.</p></blockquote><p>Short term are focused on improving contributor and user productivity (part of this is getting the word out).</p><ul><li>CLI improvements<ul><li>Search functionality (e.g. what generators support retrofit, what generators are available for kotlin)</li></ul></li><li>Build automation improvements</li><li>Discuss consolidating current third-party build systems</li><li>Investigate custom docker containerization for prepared build environments</li><li>Automated release stability</li><li>General</li><li>OAS3.0 features support: anyOf, oneOf, callbacks, etc</li><li>Consider opt-in telemetry about generators being used, limited to a counter of invocations by generator name). This would allow us to make prioritization decisions based on statistics.</li><li>Code clean up<ul><li>centralize build scripts</li><li>organize samples/bin scripts according to new generator names</li><li>consolidate typescript generators</li><li>jaxrs =&gt; use Swagger core v3 (see <a href="https://github.com/OpenAPITools/openapi-generator/issues/27%5B#27%5D">https://github.com/OpenAPITools/openapi-generator/issues/27[#27]</a>)</li></ul></li><li>Documentation</li><li>Static pages, preferably on gh-pages, devoted to each generator</li><li>Explain generator options</li><li>Centralized docs on generated code usage/examples/configuration</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="medium-term"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#medium-term" title="Direct link to heading">#</a>Medium-term</h2><blockquote><p>Feature set, well-defined API (code and templates), and extensibility improvements.</p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="api"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#api" title="Direct link to heading">#</a>API</h3><ul><li>Typed representation of the model bound to our templates. As it is, everything is treated an an Object, and this can lead to changes in the interface which might be unexpected from the template perspective.</li><li>Feature set (potential generators to add; not an exhaustive list)<ul><li>Azure functions (node.js, server)</li><li>Finagle HTTP Client (Scala, client)</li><li>Finagle Http Server (Scala, server)</li><li>Finatra (Scala, server)</li><li>Kotlin Spring MVC/Springboot (server)</li><li>C++ Server, any framework (server)</li></ul></li></ul><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="general"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#general" title="Direct link to heading">#</a>General</h3><ul><li>Migrate from Maven to Gradle</li><li>Java 9+ support</li><li>Feature set (other options to investigate)</li><li>SPI plugins<ul><li>Templating engine</li><li>Language extensions</li><li>Custom extensions (e.g. allowing users to load support for <a href="https://github.com/Azure/azure-rest-api-specs">azure-rest-api-specs</a>)</li></ul></li><li>Customizable templating engines (handlebars support)</li><li>Unit-testing templates (to previously mentioned explicit type as an interface to the template)</li><li>Reduce coupling</li><li>Make types extending <code>CodegenConfig</code> become the generation entrypoint</li><li>Allow current <code>CodegenConfig</code> types to define templating engine</li><li>Allow current <code>CodegenConfig</code> types to modify workflow (currently encapsulated in <code>DefaultGenerator</code> and tightly coupled to the template engine</li><li>Clearer reuse of &quot;language&quot; features, outside of &quot;generator&quot; types. That is, rather than enforcing polymorphic sharing of &quot;language&quot; which currently allows the super type to redefine framework-specific mapping functionality, generators could compose one or more language support types.</li><li>Define template deprecation/removal process</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="long-term"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#long-term" title="Direct link to heading">#</a>Long-term</h2><blockquote><p>Expanding tooling offered, integrations, potentially SaaS offering to partially fund efforts.</p></blockquote><ul><li>Generator UI wrappers<ul><li>Move jimschubert/intellij-swagger-codegen plugin under the org, and rename</li><li>Look into an Eclipse UI wrapper around the generator</li><li>Look at Visual Studio Code (and/or Atom, sublime text) integration</li></ul></li><li>Provide a native GUI for viewing/editing specs. Most tools are currently geared toward developers, but often times it may be non-technical business users who are interested in an API.</li><li>A paid service (SaaS) for generation may be enticing for some users. Such a service would allow for statistics (mentioned earlier in telemetry)</li><li>Additional tools</li><li>node.js build system(s) integration (grunt/gulp/webpack/etc)</li><li>ruby gem</li><li>others (which may require previously mentioned SaaS API)</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/roadmap.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/new-generator"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Create a New Generator</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/swagger-codegen-migration"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Migrating from Swagger Codegen »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#short-term" class="contents__link">Short-term</a></li><li><a href="#medium-term" class="contents__link">Medium-term</a><ul><li><a href="#api" class="contents__link">API</a></li><li><a href="#general" class="contents__link">General</a></li></ul></li><li><a href="#long-term" class="contents__link">Long-term</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link navbar__link--active" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Roadmap</h1></header><div class="markdown"><p>This document lists short-term, medium-term, and long-term goals for the project.</p><hr><p><strong>NOTE</strong></p><p>These are goals, not necessarily commitments. The sections are not intended to represent exclusive focus during these terms. For example, when you start at a college or university you may have a long-term goal to graduate and a short-term goal to find a job for supplemental income. We will similarly work toward many of our medium-term and long-term goals in the near future as we move toward meeting our short-term goals.</p><hr><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="short-term"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#short-term" title="Direct link to heading">#</a>Short-term</h2><blockquote><p>Usability, stability, and marketing.</p></blockquote><p>Short term are focused on improving contributor and user productivity (part of this is getting the word out).</p><ul><li>CLI improvements<ul><li>Search functionality (e.g. what generators support retrofit, what generators are available for kotlin)</li></ul></li><li>Build automation improvements</li><li>Discuss consolidating current third-party build systems</li><li>Investigate custom docker containerization for prepared build environments</li><li>Automated release stability</li><li>General</li><li>OAS3.0 features support: anyOf, oneOf, callbacks, etc</li><li>Consider opt-in telemetry about generators being used, limited to a counter of invocations by generator name). This would allow us to make prioritization decisions based on statistics.</li><li>Code clean up<ul><li>centralize build scripts</li><li>organize samples/bin scripts according to new generator names</li><li>consolidate typescript generators</li><li>jaxrs =&gt; use Swagger core v3 (see <a href="https://github.com/OpenAPITools/openapi-generator/issues/27%5B#27%5D">https://github.com/OpenAPITools/openapi-generator/issues/27[#27]</a>)</li></ul></li><li>Documentation</li><li>Static pages, preferably on gh-pages, devoted to each generator</li><li>Explain generator options</li><li>Centralized docs on generated code usage/examples/configuration</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="medium-term"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#medium-term" title="Direct link to heading">#</a>Medium-term</h2><blockquote><p>Feature set, well-defined API (code and templates), and extensibility improvements.</p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="api"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#api" title="Direct link to heading">#</a>API</h3><ul><li>Typed representation of the model bound to our templates. As it is, everything is treated an an Object, and this can lead to changes in the interface which might be unexpected from the template perspective.</li><li>Feature set (potential generators to add; not an exhaustive list)<ul><li>Azure functions (node.js, server)</li><li>Finagle HTTP Client (Scala, client)</li><li>Finagle Http Server (Scala, server)</li><li>Finatra (Scala, server)</li><li>Kotlin Spring MVC/Springboot (server)</li><li>C++ Server, any framework (server)</li></ul></li></ul><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="general"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#general" title="Direct link to heading">#</a>General</h3><ul><li>Migrate from Maven to Gradle</li><li>Java 9+ support</li><li>Feature set (other options to investigate)</li><li>SPI plugins<ul><li>Templating engine</li><li>Language extensions</li><li>Custom extensions (e.g. allowing users to load support for <a href="https://github.com/Azure/azure-rest-api-specs">azure-rest-api-specs</a>)</li></ul></li><li>Customizable templating engines (handlebars support)</li><li>Unit-testing templates (to previously mentioned explicit type as an interface to the template)</li><li>Reduce coupling</li><li>Make types extending <code>CodegenConfig</code> become the generation entrypoint</li><li>Allow current <code>CodegenConfig</code> types to define templating engine</li><li>Allow current <code>CodegenConfig</code> types to modify workflow (currently encapsulated in <code>DefaultGenerator</code> and tightly coupled to the template engine</li><li>Clearer reuse of &quot;language&quot; features, outside of &quot;generator&quot; types. That is, rather than enforcing polymorphic sharing of &quot;language&quot; which currently allows the super type to redefine framework-specific mapping functionality, generators could compose one or more language support types.</li><li>Define template deprecation/removal process</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="long-term"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#long-term" title="Direct link to heading">#</a>Long-term</h2><blockquote><p>Expanding tooling offered, integrations, potentially SaaS offering to partially fund efforts.</p></blockquote><ul><li>Generator UI wrappers<ul><li>Move jimschubert/intellij-swagger-codegen plugin under the org, and rename</li><li>Look into an Eclipse UI wrapper around the generator</li><li>Look at Visual Studio Code (and/or Atom, sublime text) integration</li></ul></li><li>Provide a native GUI for viewing/editing specs. Most tools are currently geared toward developers, but often times it may be non-technical business users who are interested in an API.</li><li>A paid service (SaaS) for generation may be enticing for some users. Such a service would allow for statistics (mentioned earlier in telemetry)</li><li>Additional tools</li><li>node.js build system(s) integration (grunt/gulp/webpack/etc)</li><li>ruby gem</li><li>others (which may require previously mentioned SaaS API)</li></ul></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/roadmap.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/new-generator"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Create a New Generator</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/swagger-codegen-migration"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Migrating from Swagger Codegen »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#short-term" class="contents__link">Short-term</a></li><li><a href="#medium-term" class="contents__link">Medium-term</a><ul><li><a href="#api" class="contents__link">API</a></li><li><a href="#general" class="contents__link">General</a></li></ul></li><li><a href="#long-term" class="contents__link">Long-term</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/1777f326.6442d35a.js"></script>
+<script src="/1777f326.4e8d33e8.js"></script>
 
 
 </body>
diff --git a/docs/spec-info/index.html b/docs/spec-info/index.html
index 3787fe816cc..2de10a7fc04 100644
--- a/docs/spec-info/index.html
+++ b/docs/spec-info/index.html
@@ -27,12 +27,12 @@
 <body>
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}function e(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}var n=window.matchMedia("(prefers-color-scheme: dark)");n.addListener((function(n){null===e()&&t(n.matches?"dark":"")}));var a=e();null!==a?t(a):n.matches&&t("dark")}()</script>
 <div id="__docusaurus">
-<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Spec Info</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="openapi"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#openapi" title="Direct link to heading">#</a>OpenAPI</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="20"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#20" title="Direct link to heading">#</a>2.0</h3><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="3x"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#3x" title="Direct link to heading">#</a>3.x</h3><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="tags"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#tags" title="Direct link to heading">#</a>Tags</h3><p>Tags basically group endpoints into the same API class file. For example, an endpoint with the <code>store</code> tag will be generated in the StoreApi class file in most generators.</p><p>Ref: <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject">https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject</a></p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/specification-info.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#openapi" class="contents__link">OpenAPI</a><ul><li><a href="#20" class="contents__link">2.0</a></li><li><a href="#3x" class="contents__link">3.x</a></li><li><a href="#tags" class="contents__link">Tags</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+<nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Spec Info</h1></header><div class="markdown"><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="openapi"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#openapi" title="Direct link to heading">#</a>OpenAPI</h2><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="20"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#20" title="Direct link to heading">#</a>2.0</h3><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="3x"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#3x" title="Direct link to heading">#</a>3.x</h3><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="tags"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#tags" title="Direct link to heading">#</a>Tags</h3><p>Tags basically group endpoints into the same API class file. For example, an endpoint with the <code>store</code> tag will be generated in the StoreApi class file in most generators.</p><p>Ref: <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject">https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject</a></p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/specification-info.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"></div><div class="pagination-nav__item pagination-nav__item--next"></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#openapi" class="contents__link">OpenAPI</a><ul><li><a href="#20" class="contents__link">2.0</a></li><li><a href="#3x" class="contents__link">3.x</a></li><li><a href="#tags" class="contents__link">Tags</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -48,7 +48,7 @@
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/342fbc7e.50d7b074.js"></script>
+<script src="/342fbc7e.4475dc8f.js"></script>
 
 
 </body>
diff --git a/docs/swagger-codegen-migration/index.html b/docs/swagger-codegen-migration/index.html
index fc33c4be288..d74c93560ac 100644
--- a/docs/swagger-codegen-migration/index.html
+++ b/docs/swagger-codegen-migration/index.html
@@ -38,12 +38,12 @@ The syntax inside the file stays the same.</p><p>You don&#x27;t need to rename t
 (When there is no <code>.openapi-generator-ignore</code> in a folder, if a <code>.swagger-codegen-ignore</code> file is present it will be considered and renamed to <code>.openapi-generator-ignore</code>).</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="metadata-folder"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#metadata-folder" title="Direct link to heading">#</a>Metadata folder</h2><p>The metadata folder (to store the <code>VERSION</code> file for example) is now called <code>.openapi-generator/</code> instead of <code>.swagger-codegen/</code>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="new-default-values-for-the-generated-code"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#new-default-values-for-the-generated-code" title="Direct link to heading">#</a>New default values for the generated code</h2><p>If you use a generator without specifying each parameter, you might see some differences in the generated code.
 As example the default package name used in the generated code has changed.
 You need to have a look at the specific value, depending of your target language, but often <code>Swagger</code> îs replaced by <code>OpenAPITools</code> and <code>io.swagger</code> is replaced by <code>org.openapitools</code>.
-Concretely if you did not specify anything when you are generating java code, a file <code>org/openapitools/api/PetApi.java</code>  might be generated instead of <code>io/swagger/api/PetApi.java</code>.</p><p>If this is a problem for you, you need to explicitly set the the parameter value in order to match with the <code>swagger-codgen</code> default value (<code>apiPackage</code> == <code>io.swagger</code> in the previous example with the java generator).</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="new-fully-qualified-name-for-the-classes"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#new-fully-qualified-name-for-the-classes" title="Direct link to heading">#</a>New fully qualified name for the classes</h2><p>If you have extended some generators in your project, and you are looking for a specific class, replace the <code>io.swagger.codegen</code> package (old name) with <code>org.openapitools.codegen</code> package (new name).</p><p>Example: <code>org.openapitools.codegen.DefaultGenerator</code></p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="body-parameter-name"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#body-parameter-name" title="Direct link to heading">#</a>Body parameter name</h2><p>‼️ Since 4.0.0-beta, the body parameter name in OAS v2 is automatically preserved in the vendor extension <code>x-codegen-request-body-name</code></p><p>In OpenAPI spec v3, there&#x27;s no body parameter, which is replaced by <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#request-body-object">Request Body Object</a>. The parameter name for Request Body is named automatically based on the model name (e.g. User). To control how the &quot;Request Body&quot; parameter is named, please add the vendor extension <code>x-codegen-request-body-name</code> to the operation:</p><p>OpenAPI Spec v3:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">paths</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">/pet</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">post</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">tags</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> pet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">summary</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Add a new pet to the store</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">operationId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> addPet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">x-codegen-request-body-name</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> new_body_name</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">responses</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">&#x27;405&#x27;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Invalid input</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">security</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">petstore_auth</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;write:pets&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;read:pets&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">requestBody</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">$ref</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;#/components/requestBodies/Pet&#x27;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>OpenAPI Spec v2:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">paths</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">/pet</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">post</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">tags</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> pet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">summary</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Add a new pet to the store</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">operationId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> addPet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">x-codegen-request-body-name</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> new_body_name</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">consumes</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/json</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/xml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">produces</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/xml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/json</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">parameters</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">in</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> body</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> body</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Pet object that needs to be added to the store</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">required</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">true</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">schema</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">$ref</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;#/definitions/Pet&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">responses</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">&#x27;405&#x27;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Invalid input</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">security</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">petstore_auth</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;write:pets&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;read:pets&#x27;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>If your API client is using named parameters in the function call (e.g. Perl required &amp; optional parameters, Ruby optional parameters), you will need to add <code>x-codegen-request-body-name</code> to the spec to restore the original body parameter name.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="default-basepath"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#default-basepath" title="Direct link to heading">#</a>Default basePath</h2><p>The default <code>basePath</code> has been changed from <code>https://localhost</code> to <code>http://localhost</code> (http without s)</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="nullable"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#nullable" title="Direct link to heading">#</a>Nullable</h2><p>OpenAPI spec v3 has better support for <code>nullable</code>. If you&#x27;re still using OpenAPI/Swagger spec v2, please use <code>x-nullable: true</code> instead.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/migration-from-swagger-codegen.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/roadmap"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Roadmap</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/fork-qna"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Swagger Codegen Fork: Q&amp;A »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#new-docker-images" class="contents__link">New docker images</a></li><li><a href="#new-maven-coordinates" class="contents__link">New maven coordinates</a></li><li><a href="#changes-in-maven-plugin" class="contents__link">Changes in Maven Plugin</a></li><li><a href="#new-generators-names" class="contents__link">New generators names</a></li><li><a href="#new-parameters-name" class="contents__link">New parameters name</a></li><li><a href="#renamed-mustache-template-variables" class="contents__link">Renamed Mustache Template Variables</a></li><li><a href="#ignore-file" class="contents__link">Ignore file</a></li><li><a href="#metadata-folder" class="contents__link">Metadata folder</a></li><li><a href="#new-default-values-for-the-generated-code" class="contents__link">New default values for the generated code</a></li><li><a href="#new-fully-qualified-name-for-the-classes" class="contents__link">New fully qualified name for the classes</a></li><li><a href="#body-parameter-name" class="contents__link">Body parameter name</a></li><li><a href="#default-basepath" class="contents__link">Default basePath</a></li><li><a href="#nullable" class="contents__link">Nullable</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+Concretely if you did not specify anything when you are generating java code, a file <code>org/openapitools/api/PetApi.java</code>  might be generated instead of <code>io/swagger/api/PetApi.java</code>.</p><p>If this is a problem for you, you need to explicitly set the the parameter value in order to match with the <code>swagger-codgen</code> default value (<code>apiPackage</code> == <code>io.swagger</code> in the previous example with the java generator).</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="new-fully-qualified-name-for-the-classes"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#new-fully-qualified-name-for-the-classes" title="Direct link to heading">#</a>New fully qualified name for the classes</h2><p>If you have extended some generators in your project, and you are looking for a specific class, replace the <code>io.swagger.codegen</code> package (old name) with <code>org.openapitools.codegen</code> package (new name).</p><p>Example: <code>org.openapitools.codegen.DefaultGenerator</code></p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="body-parameter-name"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#body-parameter-name" title="Direct link to heading">#</a>Body parameter name</h2><p>‼️ Since 4.0.0-beta, the body parameter name in OAS v2 is automatically preserved in the vendor extension <code>x-codegen-request-body-name</code></p><p>In OpenAPI spec v3, there&#x27;s no body parameter, which is replaced by <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#request-body-object">Request Body Object</a>. The parameter name for Request Body is named automatically based on the model name (e.g. User). To control how the &quot;Request Body&quot; parameter is named, please add the vendor extension <code>x-codegen-request-body-name</code> to the operation:</p><p>OpenAPI Spec v3:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">paths</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">/pet</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">post</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">tags</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> pet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">summary</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Add a new pet to the store</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">operationId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> addPet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">x-codegen-request-body-name</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> new_body_name</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">responses</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">&#x27;405&#x27;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Invalid input</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">security</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">petstore_auth</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;write:pets&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;read:pets&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">requestBody</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">$ref</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;#/components/requestBodies/Pet&#x27;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>OpenAPI Spec v2:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">paths</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">/pet</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">post</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">tags</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> pet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">summary</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Add a new pet to the store</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">operationId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> addPet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">x-codegen-request-body-name</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> new_body_name</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">consumes</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/json</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/xml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">produces</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/xml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/json</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">parameters</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">in</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> body</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> body</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Pet object that needs to be added to the store</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">required</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">true</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">schema</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">$ref</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;#/definitions/Pet&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">responses</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">&#x27;405&#x27;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Invalid input</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">security</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">petstore_auth</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;write:pets&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;read:pets&#x27;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>If your API client is using named parameters in the function call (e.g. Perl required &amp; optional parameters, Ruby optional parameters), you will need to add <code>x-codegen-request-body-name</code> to the spec to restore the original body parameter name.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="default-basepath"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#default-basepath" title="Direct link to heading">#</a>Default basePath</h2><p>The default <code>basePath</code> has been changed from <code>https://localhost</code> to <code>http://localhost</code> (http without s)</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="nullable"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#nullable" title="Direct link to heading">#</a>Nullable</h2><p>OpenAPI spec v3 has better support for <code>nullable</code>. If you&#x27;re still using OpenAPI/Swagger spec v2, please use <code>x-nullable: true</code> instead.</p></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/migration-from-swagger-codegen.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/roadmap"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Roadmap</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/fork-qna"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Swagger Codegen Fork: Q&amp;A »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#new-docker-images" class="contents__link">New docker images</a></li><li><a href="#new-maven-coordinates" class="contents__link">New maven coordinates</a></li><li><a href="#changes-in-maven-plugin" class="contents__link">Changes in Maven Plugin</a></li><li><a href="#new-generators-names" class="contents__link">New generators names</a></li><li><a href="#new-parameters-name" class="contents__link">New parameters name</a></li><li><a href="#renamed-mustache-template-variables" class="contents__link">Renamed Mustache Template Variables</a></li><li><a href="#ignore-file" class="contents__link">Ignore file</a></li><li><a href="#metadata-folder" class="contents__link">Metadata folder</a></li><li><a href="#new-default-values-for-the-generated-code" class="contents__link">New default values for the generated code</a></li><li><a href="#new-fully-qualified-name-for-the-classes" class="contents__link">New fully qualified name for the classes</a></li><li><a href="#body-parameter-name" class="contents__link">Body parameter name</a></li><li><a href="#default-basepath" class="contents__link">Default basePath</a></li><li><a href="#nullable" class="contents__link">Nullable</a></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -59,7 +59,7 @@ Concretely if you did not specify anything when you are generating java code, a
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/9b517c7f.faf51264.js"></script>
+<script src="/9b517c7f.6c3050ec.js"></script>
 
 
 </body>
diff --git a/docs/templating/index.html b/docs/templating/index.html
index 86e18f289aa..98d629f1f07 100644
--- a/docs/templating/index.html
+++ b/docs/templating/index.html
@@ -32,12 +32,12 @@ You&#x27;ll see them referred to as &quot;Vendor Extensions&quot; in most places
 This is used to define names of the enum items.</p><p><code>x-enum-descriptions</code> can be used to provide an individual description for each value.
 This is used for comments in the code (like javadoc if the target language is java).</p><p><code>x-enum-descriptions</code> and <code>x-enum-varnames</code> are each expected to be list of items containing the same number of items as <code>enum</code>.
 The order of the items in the list matters: their position is used to group them together.</p><p>Example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">WeatherType</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">type</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> integer</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">format</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> int32</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">enum</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token number">42</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token number">18</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token number">56</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">x-enum-descriptions</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;Blue sky&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;Slightly overcast&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;Take an umbrella with you&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">x-enum-varnames</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> Sunny</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> Cloudy</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> Rainy</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>In the example for the integer value <code>42</code>, the description will be <code>Blue sky</code> and the name of the enum item will be <code>Sunny</code> (some generators changes it to <code>SUNNY</code> to respect some coding convention).</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="objc"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#objc" title="Direct link to heading">#</a>ObjC</h3><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="x-objc-operationid"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#x-objc-operationid" title="Direct link to heading">#</a>x-objc-operationId</h4><p>To customize the method name, you can provide a different name in x-objc-operationId, e.g.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">summary</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Add a new pet to the store</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;&#x27;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">operationId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> addPet</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">x-objc-operationId</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> CreateNewPet</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="java-feign"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#java-feign" title="Direct link to heading">#</a>Java (Feign)</h3><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="x-accepts"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#x-accepts" title="Direct link to heading">#</a>x-accepts</h4><p>A single <code>Accepts</code> value as the Feign API client needs a single value for <code>Accepts</code> header, e.g.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">consumes</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/json</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/xml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">x-accepts</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> application/json</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="x-content-type"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#x-content-type" title="Direct link to heading">#</a>x-content-type</h3><p>A single &quot;Content-Type&quot; value as the Feign API client needs a single value for <code>Content-Type</code> header, e.g.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">produces</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/xml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> application/json</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">x-content-type</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> application/json</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="rust-server"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#rust-server" title="Direct link to heading">#</a>Rust-server</h3><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="x-response-id"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#x-response-id" title="Direct link to heading">#</a>x-response-id</h4><p>Each response may specify a unique <code>x-response-id</code>. <code>rust-server</code> will use this to name the corresponding enum variant in the code. e.g.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">paths</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">/ping</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">get</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">responses</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">200</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> OK</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">x-response-id</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> Pong</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="mysql-schema"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#mysql-schema" title="Direct link to heading">#</a>MySQL Schema</h3><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="x-mysqlschema"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#x-mysqlschema" title="Direct link to heading">#</a>x-mysqlSchema</h4><p>MySQL schema generator creates vendor extensions based on openapi <code>dataType</code> and <code>dataFormat</code>. When user defined extensions with same key already exists codegen accepts those as is. It means it won&#x27;t validate properties or correct it for you. Every model in <code>definitions</code> can contain table related and column related extensions like in example below:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">definitions</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">Order</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> This should be most common InnoDB table</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">type</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> object</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">properties</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">id</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          This column should be unsigned BIGINT with AUTO_INCREMENT</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">type</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> integer</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">format</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> int64</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">x-mysqlSchema</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          </span><span class="token key atrule">columnDefinition</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">colName</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> id</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">colDataType</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> DECIMAL</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">colDataTypeArguments</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">              </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">argumentValue</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token number">16</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token key atrule">isString</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">false</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">              </span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"> </span><span class="token key atrule">argumentValue</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token number">4</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token key atrule">isString</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">false</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">colUnsigned</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">true</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">colNotNull</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">true</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">colDefault</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">              </span><span class="token key atrule">defaultValue</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> AUTO_INCREMENT</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">              </span><span class="token key atrule">isString</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">false</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">              </span><span class="token key atrule">isNumeric</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">false</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">              </span><span class="token key atrule">isKeyword</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">true</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token key atrule">colComment</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">              Column comment. This column should be unsigned BIGINT with AUTO_INCREMENT</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token key atrule">x-mysqlSchema</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">      </span><span class="token key atrule">tableDefinition</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">tblName</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> orders</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">tblStorageEngine</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> InnoDB</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token key atrule">tblComment</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">&gt;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">-</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">          Table comment. This should be most common InnoDB table</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>There are properties that are not implemented by now(<code>tblStorageEngine</code>), but you can see how generator can be enhanced in future.</p></blockquote><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="mustache-tips"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#mustache-tips" title="Direct link to heading">#</a>Mustache Tips</h2><p>Here are a few tips we&#x27;ve found useful for new template authors.
-For more details on Mustache see <a href="https://mustache.github.io/mustache.5.html">mustache.5</a>. See also <a href="https://github.com/samskivert/jmustache">samskivert/jmustache</a> for implementation-specific details.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="firstlast"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#firstlast" title="Direct link to heading">#</a>First/Last</h3><p>To access the first or last element in a list using Mustache:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#vars}}{{#-first}} this is the first element {{.}} {{/-first}}{{/vars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#vars}}{{#-last}} this is the last element {{.}} {{/-last}}{{/vars}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="this"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#this" title="Direct link to heading">#</a>This</h3><p>Mustache evaluates template variables contextually. If the variable isn&#x27;t found in the immediate object, mustache will search the parent. This is similar to JavaScript&#x27;s prototype object (if you&#x27;re familiar with the concept).</p><p>You can inspect this entire context by outputting <code>{{this}}</code>. For example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operations}}{{this}}{{/operations}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="index"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#index" title="Direct link to heading">#</a>Index</h3><p>If you&#x27;d like a 1-based index in your array traversal, you can use <code>{{-index}}</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#enums}}{{-index}} {{enum}}{{/enums}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/templating.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/file-post-processing"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« File post-processing</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/customization"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Customization »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#modifying-templates" class="contents__link">Modifying Templates</a><ul><li><a href="#retrieving-templates" class="contents__link">Retrieving Templates</a></li><li><a href="#custom-logic" class="contents__link">Custom Logic</a></li><li><a href="#custom-engines" class="contents__link">Custom Engines</a></li></ul></li><li><a href="#structures" class="contents__link">Structures</a><ul><li><a href="#operations" class="contents__link">Operations</a></li><li><a href="#models" class="contents__link">Models</a></li><li><a href="#supportingfiles" class="contents__link">supportingFiles</a></li></ul></li><li><a href="#variables" class="contents__link">Variables</a></li><li><a href="#mustache-lambdas" class="contents__link">Mustache Lambdas</a></li><li><a href="#extensions" class="contents__link">Extensions</a><ul><li><a href="#all-generators-core" class="contents__link">All generators (core)</a></li><li><a href="#objc" class="contents__link">ObjC</a></li><li><a href="#java-feign" class="contents__link">Java (Feign)</a></li><li><a href="#x-content-type" class="contents__link">x-content-type</a></li><li><a href="#rust-server" class="contents__link">Rust-server</a></li><li><a href="#mysql-schema" class="contents__link">MySQL Schema</a></li></ul></li><li><a href="#mustache-tips" class="contents__link">Mustache Tips</a><ul><li><a href="#firstlast" class="contents__link">First/Last</a></li><li><a href="#this" class="contents__link">This</a></li><li><a href="#index" class="contents__link">Index</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+For more details on Mustache see <a href="https://mustache.github.io/mustache.5.html">mustache.5</a>. See also <a href="https://github.com/samskivert/jmustache">samskivert/jmustache</a> for implementation-specific details.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="firstlast"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#firstlast" title="Direct link to heading">#</a>First/Last</h3><p>To access the first or last element in a list using Mustache:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#vars}}{{#-first}} this is the first element {{.}} {{/-first}}{{/vars}}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#vars}}{{#-last}} this is the last element {{.}} {{/-last}}{{/vars}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="this"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#this" title="Direct link to heading">#</a>This</h3><p>Mustache evaluates template variables contextually. If the variable isn&#x27;t found in the immediate object, mustache will search the parent. This is similar to JavaScript&#x27;s prototype object (if you&#x27;re familiar with the concept).</p><p>You can inspect this entire context by outputting <code>{{this}}</code>. For example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#operations}}{{this}}{{/operations}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="index"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#index" title="Direct link to heading">#</a>Index</h3><p>If you&#x27;d like a 1-based index in your array traversal, you can use <code>{{-index}}</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-mustache codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">{{#enums}}{{-index}} {{enum}}{{/enums}}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/templating.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/file-post-processing"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« File post-processing</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/customization"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Customization »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#modifying-templates" class="contents__link">Modifying Templates</a><ul><li><a href="#retrieving-templates" class="contents__link">Retrieving Templates</a></li><li><a href="#custom-logic" class="contents__link">Custom Logic</a></li><li><a href="#custom-engines" class="contents__link">Custom Engines</a></li></ul></li><li><a href="#structures" class="contents__link">Structures</a><ul><li><a href="#operations" class="contents__link">Operations</a></li><li><a href="#models" class="contents__link">Models</a></li><li><a href="#supportingfiles" class="contents__link">supportingFiles</a></li></ul></li><li><a href="#variables" class="contents__link">Variables</a></li><li><a href="#mustache-lambdas" class="contents__link">Mustache Lambdas</a></li><li><a href="#extensions" class="contents__link">Extensions</a><ul><li><a href="#all-generators-core" class="contents__link">All generators (core)</a></li><li><a href="#objc" class="contents__link">ObjC</a></li><li><a href="#java-feign" class="contents__link">Java (Feign)</a></li><li><a href="#x-content-type" class="contents__link">x-content-type</a></li><li><a href="#rust-server" class="contents__link">Rust-server</a></li><li><a href="#mysql-schema" class="contents__link">MySQL Schema</a></li></ul></li><li><a href="#mustache-tips" class="contents__link">Mustache Tips</a><ul><li><a href="#firstlast" class="contents__link">First/Last</a></li><li><a href="#this" class="contents__link">This</a></li><li><a href="#index" class="contents__link">Index</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -53,7 +53,7 @@ For more details on Mustache see <a href="https://mustache.github.io/mustache.5.
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/cf67c7b0.983797a8.js"></script>
+<script src="/cf67c7b0.2531a3d1.js"></script>
 
 
 </body>
diff --git a/docs/usage/index.html b/docs/usage/index.html
index f4bacba9827..80a24204b40 100644
--- a/docs/usage/index.html
+++ b/docs/usage/index.html
@@ -30,12 +30,12 @@
 <nav class="navbar navbar--light navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><div aria-label="Navigation bar toggle" class="navbar__toggle" role="button" tabindex="0"><svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 30 30" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></div><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a><a class="navbar__item navbar__link" href="/docs/installation">Getting Started</a><a class="navbar__item navbar__link" href="/docs/generators">Generators</a><a class="navbar__item navbar__link" href="/docs/roadmap">Roadmap</a><a class="navbar__item navbar__link" href="/docs/faq">FAQ</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></div><div class="navbar__items navbar__items--right"><div class="react-toggle react-toggle--disabled displayOnlyInLargeViewport_1gtM"><div class="react-toggle-track"><div class="react-toggle-track-check"><span class="toggle_keGJ moon_1gwN"></span></div><div class="react-toggle-track-x"><span class="toggle_keGJ sun_3CPA"></span></div></div><div class="react-toggle-thumb"></div><input type="checkbox" disabled="" aria-label="Dark mode toggle" class="react-toggle-screenreader-only"></div><div class="navbar__search"><span aria-label="expand searchbar" role="button" class="search-icon" tabindex="0"></span><input type="search" id="search_input_react" placeholder="Search" aria-label="Search" class="navbar__search-input search-bar"></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div><div class="navbar-sidebar"><div class="navbar-sidebar__brand"><a aria-current="page" class="navbar__brand active" href="/"><img class="navbar__logo" src="/img/mono-logo.svg" alt="OpenAPI Tools logo"><strong>OpenAPI Generator</strong></a></div><div class="navbar-sidebar__items"><div class="menu"><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">Getting Started</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/faq">FAQ</a></li><li class="menu__list-item"><a class="menu__link" href="/team">Team</a></li><li class="menu__list-item"><a class="menu__link" href="/blog">Blog</a></li><li class="menu__list-item"><a class="menu__link" activeclassname="navbar__link--active" to="https://api.openapi-generator.tech" href="https://api.openapi-generator.tech">API</a></li></ul></div></div></div></nav><div class="main-wrapper"><div class="docPage_1kjD"><div class="docSidebarContainer_1cYp"><div class="sidebar_1kLs"><div class="menu menu--responsive"><button aria-label="Open Menu" class="button button--secondary button--sm menu__button" type="button"><svg class="sidebarMenuIcon_2vk4" xmlns="http://www.w3.org/2000/svg" height="24" width="24" viewBox="0 0 32 32" role="img" focusable="false"><title>Menu</title><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><ul class="menu__list"><li class="menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#!">Getting Started</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/installation">CLI Installation</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/plugins">Plugins</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/online">Online</a></li><li class="menu__list-item"><a aria-current="page" class="menu__link menu__link--active" href="/docs/usage">Usage</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/globals">Global Properties</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/configuration">Configuration Options</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/file-post-processing">File post-processing</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Extending</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/templating">Using Templates</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/customization">Customization</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/debugging">Debugging</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/integrations">Workflow Integrations</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Contributing</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/contributing">Guidelines</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/contribute-building">Building the code</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/new-generator">Create a New Generator</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">About</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/roadmap">Roadmap</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">Releases</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/release-summary">Release Summary</a></li><li class="menu__list-item"><a class="menu__link" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></li><li class="menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#!">API</a><ul class="menu__list"><li class="menu__list-item"><a class="menu__link" href="/docs/generators">Generators List</a></li></ul></li></ul></div></div></div><main class="docMainContainer_FFX1"><div class="padding-vert--lg"><div class="container"><div class="row"><div class="col"><div class="docItemContainer_2cwg"><article><header><h1 class="docTitle_1vWb">Usage</h1></header><div class="markdown"><p>Options for OpenAPI Generator are the same whether you&#x27;re using the CLI, Maven/Gradle Plugins, or Online generation options.
 This page demonstrates navigating the options via CLI. Commands are presented here in a logical progression as a tutorial, but you&#x27;re welcome to skip directly to the <a href="#generate">generate</a> command.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="help"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#help" title="Direct link to heading">#</a>help</h2><p>The <code>help</code> option lists all commands available to the CLI.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">usage: openapi-generator-cli &lt;command&gt; [&lt;args&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">The most commonly used openapi-generator-cli commands are:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    author        Utilities for authoring generators or customizing templates.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    batch         Generate code in batch via external configs.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    config-help   Config help for chosen lang</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    generate      Generate code with the specified generator.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    help          Display help information about openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    list          Lists the available generators</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    meta          MetaGenerator. Generator for creating a new template set and configuration for Codegen.  The output will be based on the language you specify, and includes default templates to include.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    validate      Validate specification</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    version       Show version information used in tooling</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">See &#x27;openapi-generator-cli help &lt;command&gt;&#x27; for more information on a specific</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">command.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="version"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#version" title="Direct link to heading">#</a>version</h2><p>The version command provides version information, returning either the version by default, the git commit sha when passed <code>--sha</code>, or verbose output when passed <code>--full</code>.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli version - Show version information used in tooling</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli version [--full] [--sha]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --full</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Full version details</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --sha</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Git commit SHA version</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="list"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#list" title="Direct link to heading">#</a>list</h2><p>The <code>list</code> command outputs a formatted list of every available generator. Pass the <code>-s/--short</code> option if you would like a CSV output for easy parsing.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help list</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli list - Lists the available generators</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli list [(-i &lt;include&gt; | --include &lt;include&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-s | --short)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -i &lt;include&gt;, --include &lt;include&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            comma-separated list of stability indexes to include (value:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            all,beta,stable,experimental,deprecated). Excludes deprecated by</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            default.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -s, --short</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            shortened output (suitable for scripting)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli list -s </span><span class="token operator">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">tr</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;,&#x27;</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;</span><span class="token string entity" style="color:rgb(255, 121, 198)">\n</span><span class="token string" style="color:rgb(255, 121, 198)">&#x27;</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>For the full list of generators, refer to the <a href="/docs/generators">Generators List</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="config-help"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#config-help" title="Direct link to heading">#</a>config-help</h2><p>The <code>config-help</code> option provides details about </p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help config-help</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli config-help - Config help for chosen lang</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli config-help</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-f &lt;output format&gt; | --format &lt;output format&gt;)] [--feature-set]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--full-details]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--import-mappings] [--instantiation-types]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--language-specific-primitive] [--markdown-header] [--named-header]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-o &lt;output location&gt; | --output &lt;output location&gt;)] [--reserved-words]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -f &lt;output format&gt;, --format &lt;output format&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Write output files in the desired format. Options are &#x27;text&#x27;,</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            &#x27;markdown&#x27; or &#x27;yamlsample&#x27;. Default is &#x27;text&#x27;.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --feature-set</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            displays feature set as supported by the generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --full-details</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            displays CLI options as well as other configs/mappings (implies</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            --instantiation-types, --reserved-words,</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            --language-specific-primitives, --import-mappings,</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            --supporting-files)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -g &lt;generator name&gt;, --generator-name &lt;generator name&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generator to get config help for</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --import-mappings</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            displays the default import mappings (types and aliases, and what</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            imports they will pull into the template)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --instantiation-types</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            displays types used to instantiate simple type/alias names</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --language-specific-primitive</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            displays the language specific primitives (types which require no</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            additional imports, or which may conflict with user defined model</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            names)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --markdown-header</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            When format=markdown, include this option to write out markdown</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            headers (e.g. for docusaurus).</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --named-header</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Header includes the generator name, for clarity in output</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -o &lt;output location&gt;, --output &lt;output location&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Optionally write help to this location, otherwise default is</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            standard output</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --reserved-words</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            displays the reserved words which may result in renamed model or</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            property names</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The option of note is <code>-g/--generator-name</code> (other options are exposed for tooling).</p><p>You may pass any generator name (see <a href="#list">list</a> command) to <code>-g</code>, and options specific to that generator will be displayed. Some generators have <em>many</em> options, while others may have only a few.</p><p>Example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli config-help -g go</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Outputs:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">CONFIG OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    packageName</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Go package name (convention: lowercase). (Default: openapi)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    hideGenerationTimestamp</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Hides the generation timestamp when files are generated. (Default: true)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    packageVersion</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Go package version. (Default: 1.0.0)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    withGoCodegenComment</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        whether to include Go codegen comment to disable Go Lint and collapse by default in GitHub PRs and diffs (Default: false)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    withXml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML) (Default: false)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    prependFormOrBodyParameters</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        Add form or body parameters to the beginning of the parameter list. (Default: false)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>To pass these go client generator-specific options to the <code>generate</code> command for a go client, use the <code>--additional-properties</code> option. See the <a href="#generate">generate</a> command section for an example.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="meta"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#meta" title="Direct link to heading">#</a>meta</h2><p>The <code>meta</code> command creates a new Java class and template files, used for creating your own custom templates.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help meta</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli meta - MetaGenerator. Generator for creating a new</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        template set and configuration for Codegen. The output will be based on</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        the language you specify, and includes default templates to include.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli meta [(-l &lt;language&gt; | --language &lt;language&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-n &lt;name&gt; | --name &lt;name&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-o &lt;output directory&gt; | --output &lt;output directory&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-p &lt;package&gt; | --package &lt;package&gt;)] [(-t &lt;type&gt; | --type &lt;type&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -l &lt;language&gt;, --language &lt;language&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            the implementation language for the generator class</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -n &lt;name&gt;, --name &lt;name&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            the human-readable name of the generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -o &lt;output directory&gt;, --output &lt;output directory&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            where to write the generated files (current dir by default)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -p &lt;package&gt;, --package &lt;package&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            the package to put the main class into (defaults to</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            org.openapitools.codegen)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -t &lt;type&gt;, --type &lt;type&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            the type of generator that is created</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>For an in-depth example of using the <code>meta</code> command, see <a href="/docs/customization">Customization</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="validate"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#validate" title="Direct link to heading">#</a>validate</h2><p>The <code>validate</code> command allows you to validate an input specification, optionally providing recommendations for error fixes or other improvements (if available).</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help validate</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli validate - Validate specification</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli validate</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                (-i &lt;spec file&gt; | --input-spec &lt;spec file&gt;) [--recommend]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -i &lt;spec file&gt;, --input-spec &lt;spec file&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            location of the OpenAPI spec, as URL or file (required)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --recommend</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Valid Spec Example (using <a href="https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator-gradle-plugin/samples/local-spec/petstore-v3.0.yaml">petstore-v3.0.yaml</a>)</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli validate -i petstore-v3.0.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Validating spec (petstore-v3.0.yaml)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">No validation issues detected.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Invalid Spec Example (using <a href="https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator-gradle-plugin/samples/local-spec/petstore-v3.0-invalid.yaml">petstore-v3.0-invalid.yaml</a>):</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli validate -i petstore-v3.0-invalid.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">Validating spec (petstore-v3.0-invalid.yaml)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">Errors:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -attribute info is missing</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">[error] Spec has 1 errors.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="completion"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#completion" title="Direct link to heading">#</a>completion</h2><p>Although not documented in the <code>help</code> output, the CLI offers a <code>completion</code> command, which can be used for auto-completion.</p><p>This command takes one or more parameters representing the args list you would otherwise pass to <code>openapi-generator</code>. For example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli completion config-help</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">-o</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">--output</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">--named-header</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">-g</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">--generator-name</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">-f</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">--format</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">--markdown-header</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>An example bash completion script can be found in the repo at <a href="https://github.com/OpenAPITools/openapi-generator/blob/master/scripts/openapi-generator-cli-completion.bash">scripts/openapi-generator-cli-completion.bash</a>.</p><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="generate"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#generate" title="Direct link to heading">#</a>generate</h2><p>The <code>generate</code> command is the workhorse of the generator toolset. As such, it has <em>many</em> more options available than the previous commands. The abbreviated options are below, but you may expand the full descriptions.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help generate</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli generate - Generate code with the specified</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        generator.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli generate</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-a &lt;authorization&gt; | --auth &lt;authorization&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--api-name-suffix &lt;api name suffix&gt;] [--api-package &lt;api package&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--artifact-id &lt;artifact id&gt;] [--artifact-version &lt;artifact version&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-c &lt;configuration file&gt; | --config &lt;configuration file&gt;)] [--dry-run]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-e &lt;templating engine&gt; | --engine &lt;templating engine&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--enable-post-process-file]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--generate-alias-as-model] [--git-host &lt;git host&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--git-repo-id &lt;git repo id&gt;] [--git-user-id &lt;git user id&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--global-property &lt;global properties&gt;...] [--group-id &lt;group id&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--http-user-agent &lt;http user agent&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-i &lt;spec file&gt; | --input-spec &lt;spec file&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--ignore-file-override &lt;ignore file override location&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--import-mappings &lt;import mappings&gt;...]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--instantiation-types &lt;instantiation types&gt;...]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--invoker-package &lt;invoker package&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--language-specific-primitives &lt;language specific primitives&gt;...]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--legacy-discriminator-behavior] [--library &lt;library&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--log-to-stderr] [--minimal-update]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--model-name-prefix &lt;model name prefix&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--model-name-suffix &lt;model name suffix&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--model-package &lt;model package&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-o &lt;output directory&gt; | --output &lt;output directory&gt;)] [(-p &lt;additional properties&gt; | --additional-properties &lt;additional properties&gt;)...]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--package-name &lt;package name&gt;] [--release-note &lt;release note&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--remove-operation-id-prefix]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--reserved-words-mappings &lt;reserved word mappings&gt;...]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-s | --skip-overwrite)] [--server-variables &lt;server variables&gt;...]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--skip-operation-example] [--skip-validate-spec]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--strict-spec &lt;true/false strict behavior&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-t &lt;template directory&gt; | --template-dir &lt;template directory&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--type-mappings &lt;type mappings&gt;...] [(-v | --verbose)]</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><details><summary>generate OPTIONS</summary><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -a &lt;authorization&gt;, --auth &lt;authorization&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            adds authorization headers when fetching the OpenAPI definitions</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            remotely. Pass in a URL-encoded string of name:header with a comma</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            separating multiple values</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --api-name-suffix &lt;api name suffix&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Suffix that will be appended to all API names (&#x27;tags&#x27;). Default:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Api. e.g. Pet =&gt; PetApi. Note: Only ruby, python, jaxrs generators</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            support this feature at the moment.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --api-package &lt;api package&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            package for generated api classes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --artifact-id &lt;artifact id&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            artifactId in generated pom.xml. This also becomes part of the</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generated library&#x27;s filename</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --artifact-version &lt;artifact version&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            artifact version in generated pom.xml. This also becomes part of the</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generated library&#x27;s filename</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -c &lt;configuration file&gt;, --config &lt;configuration file&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Path to configuration file. It can be JSON or YAML. If file is JSON,</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            the content should have the format {&quot;optionKey&quot;:&quot;optionValue&quot;,</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            &quot;optionKey1&quot;:&quot;optionValue1&quot;...}. If file is YAML, the content should</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            have the format optionKey: optionValue. Supported options can be</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            different for each language. Run config-help -g {generator name}</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            command for language-specific config options.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --dry-run</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Try things out and report on potential changes (without actually</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            making changes).</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -e &lt;templating engine&gt;, --engine &lt;templating engine&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            templating engine: &quot;mustache&quot; (default) or &quot;handlebars&quot; (beta)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --enable-post-process-file</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Enable post-processing file using environment variables.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -g &lt;generator name&gt;, --generator-name &lt;generator name&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generator to use (see list command for list)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --generate-alias-as-model</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Generate model implementation for aliases to map and array schemas.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            An &#x27;alias&#x27; is an array, map, or list which is defined inline in a</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            OpenAPI document and becomes a model in the generated code. A &#x27;map&#x27;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            schema is an object that can have undeclared properties, i.e. the</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            &#x27;additionalproperties&#x27; attribute is set on that object. An &#x27;array&#x27;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            schema is a list of sub schemas in a OAS document</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --git-host &lt;git host&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Git host, e.g. gitlab.com.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --git-repo-id &lt;git repo id&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Git repo ID, e.g. openapi-generator.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --git-user-id &lt;git user id&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Git user ID, e.g. openapitools.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --global-property &lt;global properties&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            sets specified global properties (previously called &#x27;system</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            properties&#x27;) in the format of name=value,name=value (or multiple</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            options, each with name=value)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --group-id &lt;group id&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            groupId in generated pom.xml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --http-user-agent &lt;http user agent&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            HTTP user agent, e.g. codegen_csharp_api_client, default to</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            &#x27;OpenAPI-Generator/{packageVersion}/{language}&#x27;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -i &lt;spec file&gt;, --input-spec &lt;spec file&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            location of the OpenAPI spec, as URL or file (required if not loaded</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            via config using -c)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --ignore-file-override &lt;ignore file override location&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Specifies an override location for the .openapi-generator-ignore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            file. Most useful on initial generation.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --import-mappings &lt;import mappings&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            specifies mappings between a given class and the import that should</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            be used for that class in the format of type=import,type=import. You</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            can also have multiple occurrences of this option.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --instantiation-types &lt;instantiation types&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            sets instantiation type mappings in the format of</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            type=instantiatedType,type=instantiatedType.For example (in Java):</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            array=ArrayList,map=HashMap. In other words array types will get</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            instantiated as ArrayList in generated code. You can also have</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            multiple occurrences of this option.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --invoker-package &lt;invoker package&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            root package for generated code</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --language-specific-primitives &lt;language specific primitives&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            specifies additional language specific primitive types in the format</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            of type1,type2,type3,type3. For example:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            String,boolean,Boolean,Double. You can also have multiple</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            occurrences of this option.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --legacy-discriminator-behavior</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Set to false for generators with better support for discriminators.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            (Python, Java, Go, PowerShell, C#have this enabled by default).</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --library &lt;library&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            library template (sub-template)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --log-to-stderr</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            write all log messages (not just errors) to STDOUT. Useful for</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            piping the JSON output of debug options (e.g. `--global-property</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            debugOperations`) to an external parser directly while testing a</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generator.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --minimal-update</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Only write output files that have changed.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --model-name-prefix &lt;model name prefix&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Prefix that will be prepended to all model names.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --model-name-suffix &lt;model name suffix&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Suffix that will be appended to all model names.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --model-package &lt;model package&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            package for generated models</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -o &lt;output directory&gt;, --output &lt;output directory&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            where to write the generated files (current dir by default)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -p &lt;additional properties&gt;, --additional-properties &lt;additional</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        properties&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            sets additional properties that can be referenced by the mustache</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            templates in the format of name=value,name=value. You can also have</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            multiple occurrences of this option.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --package-name &lt;package name&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            package for generated classes (where supported)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --release-note &lt;release note&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Release note, default to &#x27;Minor update&#x27;.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --remove-operation-id-prefix</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Remove prefix of operationId, e.g. config_getId =&gt; getId</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --reserved-words-mappings &lt;reserved word mappings&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            specifies how a reserved name should be escaped to. Otherwise, the</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            default _&lt;name&gt; is used. For example id=identifier. You can also</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            have multiple occurrences of this option.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -s, --skip-overwrite</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            specifies if the existing files should be overwritten during the</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generation.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --server-variables &lt;server variables&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            sets server variables overrides for spec documents which support</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            variable templating of servers.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --skip-operation-example</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Skip examples defined in operations to avoid out of memory errors.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --skip-validate-spec</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Skips the default behavior of validating an input specification.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --strict-spec &lt;true/false strict behavior&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            &#x27;MUST&#x27; and &#x27;SHALL&#x27; wording in OpenAPI spec is strictly adhered to.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            e.g. when false, no fixes will be applied to documents which pass</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            validation but don&#x27;t follow the spec.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -t &lt;template directory&gt;, --template-dir &lt;template directory&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            folder containing the template files</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --type-mappings &lt;type mappings&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            sets mappings between OpenAPI spec types and generated code types in</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            the format of OpenAPIType=generatedType,OpenAPIType=generatedType.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            For example: array=List,map=Map,string=String. You can also have</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            multiple occurrences of this option.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -v, --verbose</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            verbose mode</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></details><p>At a minimum, <code>generate</code> requires:</p><ul><li><code>-g</code> to specify the generator</li><li><code>-o</code> to specify a meaningful output directory (defaults to the current directory!)</li><li><code>-i</code> to specify the input OpenAPI document</li></ul><blockquote><p><strong>NOTE</strong> You may also pass <code>-Dcolor</code> as a system property to colorize terminal outputs.</p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="examples"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#examples" title="Direct link to heading">#</a>Examples</h3><p>The following examples use <a href="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml">petstore.yaml</a>.</p><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="additional-properties"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#additional-properties" title="Direct link to heading">#</a>Additional Properties</h4><p>Generator-specific options should be passed as <code>--additional-properties</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli generate -g go --additional-properties</span><span class="token operator">=</span><span class="token plain">prependFormOrBodyParameters</span><span class="token operator">=</span><span class="token plain">true </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -o out -i petstore.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Pass more options via comma delimited key/value pairs:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--additional-properties</span><span class="token operator">=</span><span class="token plain">key1</span><span class="token operator">=</span><span class="token plain">value1,key2</span><span class="token operator">=</span><span class="token plain">value2</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>For the full list of generator-specific parameters, refer to <a href="/docs/generators">generators docs</a>.</p><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="type-mappings-and-import-mappings"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#type-mappings-and-import-mappings" title="Direct link to heading">#</a>Type Mappings and Import Mappings</h4><p>Most generators allow for types bound to the OpenAPI Specification&#x27;s types to be remapped to a user&#x27;s desired types. Not <em>all</em> type mappings can be reassigned, as some generators define mappings which are tightly coupled to the built-in templates.</p><p>If you&#x27;re not using your own templates with star/glob package imports, you will most likely need to combine <code>--type-mappings</code> and <code>--import-mappings</code> together.</p><ul><li><code>--type-mappings</code> Defines the user&#x27;s target type</li><li><code>--import-mappings</code> Informs the template of the type to be imported</li></ul><p>Here&#x27;s how one might change the <code>kotlin-spring</code> server generator&#x27;s default of <code>OffsetDateTime</code> to <code>LocalDateTime</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli generate </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -i petstore.yaml </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -g kotlin-spring </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -o out </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    --additional-properties</span><span class="token operator">=</span><span class="token plain">library</span><span class="token operator">=</span><span class="token plain">spring-boot,beanValidations</span><span class="token operator">=</span><span class="token plain">true,swaggerAnnotations</span><span class="token operator">=</span><span class="token plain">true,serviceImplementation</span><span class="token operator">=</span><span class="token plain">true </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    --import-mappings</span><span class="token operator">=</span><span class="token plain">DateTime</span><span class="token operator">=</span><span class="token plain">java.time.LocalDateTime </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    --type-mappings</span><span class="token operator">=</span><span class="token plain">DateTime</span><span class="token operator">=</span><span class="token plain">java.time.LocalDateTime</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><blockquote><p>NOTE: mappings are applied to <code>DateTime</code>, as this is the representation of the primitive type. See <a href="https://github.com/OpenAPITools/openapi-generator/blob/7cee999543fcc00b7c1eb9f70f0456b707c7f9e2/modules/openapi-generator/src/main/java/org/openapitools/codegen/DefaultCodegen.java#L1431">DefaultCodegen</a>.</p></blockquote><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="file-post-processing"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#file-post-processing" title="Direct link to heading">#</a>File Post-Processing</h4><p>The <code>--enable-post-process-file</code> option enables specific generators to invoke some external language-specific formatting script. Each filename is passed <em>individually</em> to this external script, allowing for linting, formatting, or other custom clean-up.</p><p>For more details, see <a href="/docs/file-post-processing">File Post-Processing</a>.</p><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="target-external-models"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#target-external-models" title="Direct link to heading">#</a>Target External Models</h3><p>Sometimes you don&#x27;t want the codegen to make a model for you--you might want to just include one that already exists in your codebase.  Say you already have a <code>User</code> object and want to reuse that, which has a different model package from the other generated files:</p><p>First, indicate that the class is already included by default. This will keep the codegen from trying to generate the class.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--language-specific-primitives</span><span class="token operator">=</span><span class="token plain">Pet</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>This command line option will tell the generator to consider <code>Pet</code> a &quot;primitive&quot; type.</p><p>Next, if the <code>Pet</code> class is a different package, add an <code>--import-mapping</code> to tell the generator to include that import wherever <code>Pet</code> is used:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings</span><span class="token operator">=</span><span class="token plain">Pet</span><span class="token operator">=</span><span class="token plain">com.yourpackage.models.Pet</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Now the codegen will know what to import from that specific package.</p><p>NOTE: <code>import-mappings</code> is assigned a key-value pair in this example, but multiple values can be comma-separate. For instance:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">--import-mappings</span><span class="token operator">=</span><span class="token plain">Pet</span><span class="token operator">=</span><span class="token plain">com.yourpackage.models.Pet,User</span><span class="token operator">=</span><span class="token plain">com.yourpackage.models.User</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h4><a aria-hidden="true" tabindex="-1" class="anchor" id="configuration-file"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#configuration-file" title="Direct link to heading">#</a>Configuration File</h4><p>Rather than passing generator options in a CSV of <code>--additional-properties</code>, you may also provide the settings via JSON file or YAML file.</p><p>For example, one of our typescript samples has the following configuration file:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-json codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;npmName&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;@swagger/typescript-fetch-petstore&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;npmVersion&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.0.0&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;npmRepository&quot;</span><span class="token plain"> </span><span class="token operator">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://skimdb.npmjs.com/registry&quot;</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;snapshot&quot;</span><span class="token plain"> </span><span class="token operator">:</span><span class="token plain"> </span><span class="token boolean">false</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token property">&quot;supportsES6&quot;</span><span class="token operator">:</span><span class="token plain"> </span><span class="token boolean">true</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>These settings can be passed via <code>-c filename</code>. Here, we&#x27;ve saved the above as <code>config.json</code>:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli generate -i petstore.yaml -g typescript-fetch -o out </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -c config.json</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Same configuration file can be passed into YAML format having following equivalent content:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-yaml codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token key atrule">npmName</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;@swagger/typescript-fetch-petstore&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">npmVersion</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;1.0.0&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">npmRepository</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">&quot;https://skimdb.npmjs.com/registry&quot;</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">snapshot</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">false</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">supportsES6</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean important">true</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>The settings are passed exactly the same as for <code>config.json</code>. The most important part is the file extension. Supported values are <code>yml</code> or <code>yaml</code>.
 The name of the file should be <code>config.yml</code> or <code>config.yaml</code> (in our example it will be <code>config.yaml</code>.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli generate -i petstore.yaml -g typescript-fetch -o out </span><span class="token punctuation" style="color:rgb(248, 248, 242)">\</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    -c config.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="batch"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#batch" title="Direct link to heading">#</a>batch</h2><p>The <code>batch</code> command allows you to move all CLI arguments supported by the <code>generate</code> command into a YAML or JSON file.</p><p><em>NOTE</em>: This command supports an additional <code>!include</code> property which may point to another &quot;shared&quot; file, the base path to which can be
-modified by <code>--includes-base-dir</code>. Starting with 5.0.0, the <code>!batch</code> command supports multiple <code>!include</code> properties, either sequential or nested. In order to support multiple <code>!include</code> properties in a JSON file, the property name can have a suffix, e.g. <code>!include1</code>, <code>!include2</code>, etc. The suffix have no meaning other than providing unique property names.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help batch</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli batch - Generate code in batch via external</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        configs.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli batch [--clean] [--fail-fast]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--includes-base-dir &lt;includes&gt;] [(-r &lt;threads&gt; | --threads &lt;threads&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--root-dir &lt;root&gt;] [--timeout &lt;timeout&gt;] [(-v | --verbose)] [--]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                &lt;configs&gt;...</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --clean</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            clean output of previously written files before generation</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --fail-fast</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            fail fast on any errors</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --includes-base-dir &lt;includes&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            base directory used for includes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -r &lt;threads&gt;, --threads &lt;threads&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            thread count</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --root-dir &lt;root&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            root directory used output/includes (includes can be overridden)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --timeout &lt;timeout&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            execution timeout (minutes)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -v, --verbose</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            verbose mode</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            This option can be used to separate command-line options from the</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            list of argument, (useful when arguments might be mistaken for</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            command-line options</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        &lt;configs&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Generator configuration files.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># create &quot;shared&quot; config</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">mkdir</span><span class="token plain"> shared </span><span class="token operator">&amp;&amp;</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">cat</span><span class="token plain"> </span><span class="token operator">&gt;</span><span class="token plain"> shared/common.yaml </span><span class="token operator">&lt;&lt;</span><span class="token string" style="color:rgb(255, 121, 198)">EOF</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">inputSpec: https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">    x-ext-name: &quot;Your Name&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">EOF</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># create &quot;standard&quot; configs</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">cat</span><span class="token plain"> </span><span class="token operator">&gt;</span><span class="token plain"> kotlin.yaml </span><span class="token operator">&lt;&lt;</span><span class="token string" style="color:rgb(255, 121, 198)">EOF</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">&#x27;!include&#x27;: &#x27;shared/common.yaml&#x27;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">outputDir: out/kotlin</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">generatorName: kotlin</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">artifactId: kotlin-petstore-string</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  dateLibrary: string</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  serializableModel: &quot;true&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">EOF</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">cat</span><span class="token plain"> </span><span class="token operator">&gt;</span><span class="token plain"> csharp.yaml </span><span class="token operator">&lt;&lt;</span><span class="token string" style="color:rgb(255, 121, 198)">EOF</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">&#x27;!include&#x27;: &#x27;shared/common.yaml&#x27;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">outputDir: out/csharp-netcore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">generatorName: csharp-netcore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  packageGuid: &quot;{321C8C3F-0156-40C1-AE42-D59761FB9B6C}&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  useCompareNetObjects: &quot;true&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">EOF</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Generate them</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli batch *.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="author"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#author" title="Direct link to heading">#</a>author</h2><p>This command group contains utilities for authoring generators or customizing templates.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help author</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author - Utilities for authoring generators or</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        customizing templates.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author template [--library &lt;library&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-v | --verbose)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-o &lt;output directory&gt; | --output &lt;output directory&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                (-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --help</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Display help about the tool</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Display full version output</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">COMMANDS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        With no arguments, Display help information about openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        template</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Retrieve templates for local modification</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --library option, library template (sub-template)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --verbose option, verbose mode</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --output option, where to write the template files (defaults to</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            &#x27;out&#x27;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --generator-name option, generator to use (see list command for</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            list)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="template"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#template" title="Direct link to heading">#</a>template</h3><p>This command allows user to extract templates from the CLI jar which simplifies customization efforts.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help author template</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author template - Retrieve templates for local</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        modification</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author template</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                (-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--library &lt;library&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-o &lt;output directory&gt; | --output &lt;output directory&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-v | --verbose)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -g &lt;generator name&gt;, --generator-name &lt;generator name&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generator to use (see list command for list)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --library &lt;library&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            library template (sub-template)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -o &lt;output directory&gt;, --output &lt;output directory&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            where to write the template files (defaults to &#x27;out&#x27;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -v, --verbose</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            verbose mode</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Example:</p><p>Extract Java templates, limiting to the <code>webclient</code> library.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli author template -g java --library webclient</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Extract all Java templates:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli author template -g java</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/usage.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-09T01:35:42.000Z" class="docLastUpdatedAt_1sqk">2022-4-9</time> by <strong>Josh Burton</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/online"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Online</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/globals"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Global Properties »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#help" class="contents__link">help</a></li><li><a href="#version" class="contents__link">version</a></li><li><a href="#list" class="contents__link">list</a></li><li><a href="#config-help" class="contents__link">config-help</a></li><li><a href="#meta" class="contents__link">meta</a></li><li><a href="#validate" class="contents__link">validate</a></li><li><a href="#completion" class="contents__link">completion</a></li><li><a href="#generate" class="contents__link">generate</a><ul><li><a href="#examples" class="contents__link">Examples</a></li><li><a href="#target-external-models" class="contents__link">Target External Models</a></li></ul></li><li><a href="#batch" class="contents__link">batch</a></li><li><a href="#author" class="contents__link">author</a><ul><li><a href="#template" class="contents__link">template</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
+modified by <code>--includes-base-dir</code>. Starting with 5.0.0, the <code>!batch</code> command supports multiple <code>!include</code> properties, either sequential or nested. In order to support multiple <code>!include</code> properties in a JSON file, the property name can have a suffix, e.g. <code>!include1</code>, <code>!include2</code>, etc. The suffix have no meaning other than providing unique property names.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help batch</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli batch - Generate code in batch via external</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        configs.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli batch [--clean] [--fail-fast]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--includes-base-dir &lt;includes&gt;] [(-r &lt;threads&gt; | --threads &lt;threads&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--root-dir &lt;root&gt;] [--timeout &lt;timeout&gt;] [(-v | --verbose)] [--]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                &lt;configs&gt;...</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --clean</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            clean output of previously written files before generation</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --fail-fast</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            fail fast on any errors</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --includes-base-dir &lt;includes&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            base directory used for includes</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -r &lt;threads&gt;, --threads &lt;threads&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            thread count</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --root-dir &lt;root&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            root directory used output/includes (includes can be overridden)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --timeout &lt;timeout&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            execution timeout (minutes)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -v, --verbose</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            verbose mode</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            This option can be used to separate command-line options from the</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            list of argument, (useful when arguments might be mistaken for</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            command-line options</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        &lt;configs&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Generator configuration files.</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Example:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># create &quot;shared&quot; config</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">mkdir</span><span class="token plain"> shared </span><span class="token operator">&amp;&amp;</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">cat</span><span class="token plain"> </span><span class="token operator">&gt;</span><span class="token plain"> shared/common.yaml </span><span class="token operator">&lt;&lt;</span><span class="token string" style="color:rgb(255, 121, 198)">EOF</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">inputSpec: https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">    x-ext-name: &quot;Your Name&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">EOF</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># create &quot;standard&quot; configs</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">cat</span><span class="token plain"> </span><span class="token operator">&gt;</span><span class="token plain"> kotlin.yaml </span><span class="token operator">&lt;&lt;</span><span class="token string" style="color:rgb(255, 121, 198)">EOF</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">&#x27;!include&#x27;: &#x27;shared/common.yaml&#x27;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">outputDir: out/kotlin</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">generatorName: kotlin</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">artifactId: kotlin-petstore-string</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  dateLibrary: string</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  serializableModel: &quot;true&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">EOF</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">cat</span><span class="token plain"> </span><span class="token operator">&gt;</span><span class="token plain"> csharp.yaml </span><span class="token operator">&lt;&lt;</span><span class="token string" style="color:rgb(255, 121, 198)">EOF</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">&#x27;!include&#x27;: &#x27;shared/common.yaml&#x27;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">outputDir: out/csharp-netcore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">generatorName: csharp-netcore</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">additionalProperties:</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  packageGuid: &quot;{321C8C3F-0156-40C1-AE42-D59761FB9B6C}&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">  useCompareNetObjects: &quot;true&quot;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token string" style="color:rgb(255, 121, 198)">EOF</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)"># Generate them</span><span class="token plain"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli batch *.yaml</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h2><a aria-hidden="true" tabindex="-1" class="anchor" id="author"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#author" title="Direct link to heading">#</a>author</h2><p>This command group contains utilities for authoring generators or customizing templates.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help author</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author - Utilities for authoring generators or</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        customizing templates.</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author template [--library &lt;library&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-v | --verbose)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-o &lt;output directory&gt; | --output &lt;output directory&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                (-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --help</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Display help about the tool</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --version</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Display full version output</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">COMMANDS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        With no arguments, Display help information about openapi-generator</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        template</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            Retrieve templates for local modification</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --library option, library template (sub-template)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --verbose option, verbose mode</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --output option, where to write the template files (defaults to</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            &#x27;out&#x27;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            With --generator-name option, generator to use (see list command for</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            list)</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><h3><a aria-hidden="true" tabindex="-1" class="anchor" id="template"></a><a aria-hidden="true" tabindex="-1" class="hash-link" href="#template" title="Direct link to heading">#</a>template</h3><p>This command allows user to extract templates from the CLI jar which simplifies customization efforts.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-text codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli help author template</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">NAME</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author template - Retrieve templates for local</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        modification</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">SYNOPSIS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        openapi-generator-cli author template</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                (-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [--library &lt;library&gt;]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-o &lt;output directory&gt; | --output &lt;output directory&gt;)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                [(-v | --verbose)]</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">OPTIONS</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -g &lt;generator name&gt;, --generator-name &lt;generator name&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            generator to use (see list command for list)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        --library &lt;library&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            library template (sub-template)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -o &lt;output directory&gt;, --output &lt;output directory&gt;</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            where to write the template files (defaults to &#x27;out&#x27;)</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        -v, --verbose</span></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            verbose mode</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Example:</p><p>Extract Java templates, limiting to the <code>webclient</code> library.</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli author template -g java --library webclient</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre><p>Extract all Java templates:</p><pre class="mdxCodeBlock_iHAB"><div class="codeBlockWrapper_2QGZ"><pre class="prism-code language-bash codeBlock_19pQ" style="color:#F8F8F2;background-color:#282A36"><div class="token-line" style="color:#F8F8F2"><span class="token plain">openapi-generator-cli author template -g java</span></div></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_1BYj">Copy</button></div></pre></div></article><div class="margin-vert--xl"><div class="row"><div class="col"><a href="https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/usage.md" target="_blank" rel="noreferrer noopener"><svg fill="currentColor" height="1.2em" width="1.2em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 40 40" style="margin-right:0.3em;vertical-align:sub"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col text--right"><em><small>Last updated on <time datetime="2022-04-10T01:53:55.000Z" class="docLastUpdatedAt_1sqk">2022-4-10</time> by <strong>Peter Leibiger</strong></small></em></div></div></div><div class="margin-vert--lg"><nav class="pagination-nav"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/online"><h5 class="pagination-nav__link--sublabel">Previous</h5><h4 class="pagination-nav__link--label">« Online</h4></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/globals"><h5 class="pagination-nav__link--sublabel">Next</h5><h4 class="pagination-nav__link--label">Global Properties »</h4></a></div></nav></div></div></div><div class="col col--3"><div class="tableOfContents_TbNY"><ul class="contents contents__left-border"><li><a href="#help" class="contents__link">help</a></li><li><a href="#version" class="contents__link">version</a></li><li><a href="#list" class="contents__link">list</a></li><li><a href="#config-help" class="contents__link">config-help</a></li><li><a href="#meta" class="contents__link">meta</a></li><li><a href="#validate" class="contents__link">validate</a></li><li><a href="#completion" class="contents__link">completion</a></li><li><a href="#generate" class="contents__link">generate</a><ul><li><a href="#examples" class="contents__link">Examples</a></li><li><a href="#target-external-models" class="contents__link">Target External Models</a></li></ul></li><li><a href="#batch" class="contents__link">batch</a></li><li><a href="#author" class="contents__link">author</a><ul><li><a href="#template" class="contents__link">template</a></li></ul></li></ul></div></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container"><div class="row footer__links"><div class="col footer__col"><h4 class="footer__title">Docs</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/customization">Customizing Generators</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/installation">Installation</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">Community</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/users">User Showcase</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://stackoverflow.com/questions/tagged/openapi-generator">Stack Overflow</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g">Chat Room</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://twitter.com/oas_generator">Twitter</a></li></ul></div><div class="col footer__col"><h4 class="footer__title">More</h4><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" target="_blank" rel="noopener noreferrer" href="https://github.com/OpenAPITools/openapi-generator">GitHub</a></li></ul></div></div><div class="text--center"><div class="margin-bottom--sm"><a href="https://openapi-generator.tech/" target="_blank" rel="noopener noreferrer" class="footerLogoLink_1Wg7"><img class="footer__logo" alt="OpenAPI Tools" src="/img/mono-logo.svg"></a></div>Copyright © 2022 OpenAPI-Generator Contributors (https://openapi-generator.tech)</div></div></footer>
 </div>
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
@@ -51,7 +51,7 @@ modified by <code>--includes-base-dir</code>. Starting with 5.0.0, the <code>!ba
 
 <script src="/17896441.c3776424.js"></script>
 
-<script src="/912fe03d.5abc8bcb.js"></script>
+<script src="/912fe03d.cb2ebb32.js"></script>
 
 
 </body>
diff --git a/e360e27f.12407e7d.js b/e360e27f.12407e7d.js
new file mode 100644
index 00000000000..e9c1ac61c58
--- /dev/null
+++ b/e360e27f.12407e7d.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[162],{286:function(e,n,t){"use strict";t.r(n),t.d(n,"frontMatter",(function(){return l})),t.d(n,"metadata",(function(){return i})),t.d(n,"rightToc",(function(){return p})),t.d(n,"default",(function(){return s}));var a=t(1),r=t(9),o=(t(0),t(312)),l={id:"plugins",title:"Plugins"},i={id:"plugins",title:"Plugins",description:"## Maven",source:"@site/../docs/plugins.md",permalink:"/docs/plugins",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/plugins.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"CLI Installation",permalink:"/docs/installation"},next:{title:"Online",permalink:"/docs/online"}},p=[{value:"Maven",id:"maven",children:[{value:"Example",id:"example",children:[]},{value:"Dependencies",id:"dependencies",children:[]}]},{value:"Gradle",id:"gradle",children:[{value:"Example",id:"example-1",children:[]}]}],c={rightToc:p};function s(e){var n=e.components,t=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(a.a)({},c,t,{components:n,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"maven"},"Maven"),Object(o.b)("p",null,"A Maven plugin to support the OpenAPI generator project"),Object(o.b)("h3",{id:"example"},"Example"),Object(o.b)("p",null,"Add to your ",Object(o.b)("inlineCode",{parentName:"p"},"build->plugins")," section (default phase is ",Object(o.b)("inlineCode",{parentName:"p"},"generate-sources")," phase)"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<plugin>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator-maven-plugin</artifactId>\n    \x3c!-- RELEASE_VERSION --\x3e\n    <version>5.1.0</version>\n    \x3c!-- /RELEASE_VERSION --\x3e\n    <executions>\n        <execution>\n            <goals>\n                <goal>generate</goal>\n            </goals>\n            <configuration>\n                <inputSpec>${project.basedir}/src/main/resources/api.yaml</inputSpec>\n                <generatorName>java</generatorName>\n                <configOptions>\n                   <sourceFolder>src/gen/java/main</sourceFolder>\n                </configOptions>\n            </configuration>\n        </execution>\n    </executions>\n</plugin>\n")),Object(o.b)("p",null,"Followed by:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"mvn clean compile\n")),Object(o.b)("p",null,"For full details of all options, see the ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin"}),"plugin README"),"."),Object(o.b)("h3",{id:"dependencies"},"Dependencies"),Object(o.b)("p",null,"The generated models use commonly used Swagger v2 annotations like ",Object(o.b)("inlineCode",{parentName:"p"},"@ApiModelProperty"),". A user may add Swagger v3 annotations:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger.core.v3</groupId>\n    <artifactId>swagger-annotations</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"But this will not work. This dependency is not binary compatible with Swagger v2 annotations. The resulting code will fail to compile."),Object(o.b)("p",null,"As alternative instead use the following dependency:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger.parser.v3</groupId>\n    <artifactId>swagger-parser</artifactId>\n</dependency>\n")),Object(o.b)("h2",{id:"gradle"},"Gradle"),Object(o.b)("p",null,"This gradle plugin offers a declarative DSL via extensions (these are Gradle project extensions). These map almost fully 1:1 with the options you\u2019d pass to the CLI or Maven plugin. The plugin maps the extensions to a task of the same name to provide a clean API. If you\u2019re interested in the extension/task mapping concept from a high-level, you can check out ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.gradle.org/current/userguide/custom_plugins.html#sec:mapping_extension_properties_to_task_properties"}),"Gradle\u2019s docs"),"."),Object(o.b)("p",null,"To include in your project, add the following to ",Object(o.b)("inlineCode",{parentName:"p"},"build.gradle"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-groovy"}),'buildscript {\n  repositories {\n    mavenLocal()\n    maven { url "https://repo1.maven.org/maven2" }\n  }\n  dependencies {\n    classpath "org.openapitools:openapi-generator-gradle-plugin:5.0.0"\n  }\n}\n\napply plugin: \'org.openapi.generator\'\n')),Object(o.b)("p",null,"This gives access to the following tasks:"),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(a.a)({parentName:"tr"},{align:null}),"Task"),Object(o.b)("th",Object(a.a)({parentName:"tr"},{align:null}),"Description"))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiGenerate"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Generate code via Open API Tools Generator for Open API 2.0 or 3.x specification documents.")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiGenerators"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Lists generators available via Open API Generators.")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiMeta"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Generates a new generator to be consumed via Open API Generator.")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiValidate"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Validates an Open API 2.0 or 3.x specification document.")))),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"The plugin implements the above tasks as project extensions of the same name. If you\u2019d like to declare these tasks as dependencies to other tasks (using ",Object(o.b)("inlineCode",{parentName:"p"},"dependsOn"),"), you\u2019ll need a task reference. e.g.:"),Object(o.b)("pre",{parentName:"blockquote"},Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-groovy"}),"compileJava.dependsOn tasks.openApiGenerate\n"))),Object(o.b)("p",null,"For full details of all options, see the ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin"}),"plugin README"),"."),Object(o.b)("h3",{id:"example-1"},"Example"),Object(o.b)("p",null,"An example task for generating a kotlin client:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-groovy"}),'openApiGenerate {\n    generatorName = "kotlin"\n    inputSpec = "$rootDir/specs/petstore-v3.0.yaml".toString()\n    outputDir = "$buildDir/generated".toString()\n    apiPackage = "org.openapi.example.api"\n    invokerPackage = "org.openapi.example.invoker"\n    modelPackage = "org.openapi.example.model"\n    configOptions = [\n        dateLibrary: "java8"\n    ]\n}\n')))}s.isMDXComponent=!0},312:function(e,n,t){"use strict";t.d(n,"a",(function(){return b})),t.d(n,"b",(function(){return g}));var a=t(0),r=t.n(a);function o(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function l(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);n&&(a=a.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,a)}return t}function i(e){for(var n=1;n<arguments.length;n++){var t=null!=arguments[n]?arguments[n]:{};n%2?l(Object(t),!0).forEach((function(n){o(e,n,t[n])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):l(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))}))}return e}function p(e,n){if(null==e)return{};var t,a,r=function(e,n){if(null==e)return{};var t,a,r={},o=Object.keys(e);for(a=0;a<o.length;a++)t=o[a],n.indexOf(t)>=0||(r[t]=e[t]);return r}(e,n);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a<o.length;a++)t=o[a],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(r[t]=e[t])}return r}var c=r.a.createContext({}),s=function(e){var n=r.a.useContext(c),t=n;return e&&(t="function"==typeof e?e(n):i({},n,{},e)),t},b=function(e){var n=s(e.components);return r.a.createElement(c.Provider,{value:n},e.children)},u={inlineCode:"code",wrapper:function(e){var n=e.children;return r.a.createElement(r.a.Fragment,{},n)}},d=Object(a.forwardRef)((function(e,n){var t=e.components,a=e.mdxType,o=e.originalType,l=e.parentName,c=p(e,["components","mdxType","originalType","parentName"]),b=s(t),d=a,g=b["".concat(l,".").concat(d)]||b[d]||u[d]||o;return t?r.a.createElement(g,i({ref:n},c,{components:t})):r.a.createElement(g,i({ref:n},c))}));function g(e,n){var t=arguments,a=n&&n.mdxType;if("string"==typeof e||a){var o=t.length,l=new Array(o);l[0]=d;var i={};for(var p in n)hasOwnProperty.call(n,p)&&(i[p]=n[p]);i.originalType=e,i.mdxType="string"==typeof e?e:a,l[1]=i;for(var c=2;c<o;c++)l[c]=t[c];return r.a.createElement.apply(null,l)}return r.a.createElement.apply(null,t)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/e360e27f.5bb331e6.js b/e360e27f.5bb331e6.js
deleted file mode 100644
index f21229b5065..00000000000
--- a/e360e27f.5bb331e6.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[162],{286:function(e,n,t){"use strict";t.r(n),t.d(n,"frontMatter",(function(){return l})),t.d(n,"metadata",(function(){return p})),t.d(n,"rightToc",(function(){return i})),t.d(n,"default",(function(){return s}));var a=t(1),r=t(9),o=(t(0),t(312)),l={id:"plugins",title:"Plugins"},p={id:"plugins",title:"Plugins",description:"## Maven",source:"@site/../docs/plugins.md",permalink:"/docs/plugins",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/plugins.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"CLI Installation",permalink:"/docs/installation"},next:{title:"Online",permalink:"/docs/online"}},i=[{value:"Maven",id:"maven",children:[{value:"Example",id:"example",children:[]},{value:"Dependencies",id:"dependencies",children:[]}]},{value:"Gradle",id:"gradle",children:[{value:"Example",id:"example-1",children:[]}]}],c={rightToc:i};function s(e){var n=e.components,t=Object(r.a)(e,["components"]);return Object(o.b)("wrapper",Object(a.a)({},c,t,{components:n,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"maven"},"Maven"),Object(o.b)("p",null,"A Maven plugin to support the OpenAPI generator project"),Object(o.b)("h3",{id:"example"},"Example"),Object(o.b)("p",null,"Add to your ",Object(o.b)("inlineCode",{parentName:"p"},"build->plugins")," section (default phase is ",Object(o.b)("inlineCode",{parentName:"p"},"generate-sources")," phase)"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<plugin>\n    <groupId>org.openapitools</groupId>\n    <artifactId>openapi-generator-maven-plugin</artifactId>\n    \x3c!-- RELEASE_VERSION --\x3e\n    <version>5.1.0</version>\n    \x3c!-- /RELEASE_VERSION --\x3e\n    <executions>\n        <execution>\n            <goals>\n                <goal>generate</goal>\n            </goals>\n            <configuration>\n                <inputSpec>${project.basedir}/src/main/resources/api.yaml</inputSpec>\n                <generatorName>java</generatorName>\n                <configOptions>\n                   <sourceFolder>src/gen/java/main</sourceFolder>\n                </configOptions>\n            </configuration>\n        </execution>\n    </executions>\n</plugin>\n")),Object(o.b)("p",null,"Followed by:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-bash"}),"mvn clean compile\n")),Object(o.b)("p",null,"For full details of all options, see the ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin"}),"plugin README"),"."),Object(o.b)("h3",{id:"dependencies"},"Dependencies"),Object(o.b)("p",null,"The generated models use commonly used Swagger v2 annotations like ",Object(o.b)("inlineCode",{parentName:"p"},"@ApiModelProperty"),". A user may add Swagger v3 annotations:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger.core.v3</groupId>\n    <artifactId>swagger-annotations</artifactId>\n</dependency>\n")),Object(o.b)("p",null,"But this will not work. This dependency is not binary compatible with Swagger v2 annotations. The resulting code will fail to compile."),Object(o.b)("p",null,"As alternative instead use the following dependency:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-xml"}),"<dependency>\n    <groupId>io.swagger.parser.v3</groupId>\n    <artifactId>swagger-parser</artifactId>\n</dependency>\n")),Object(o.b)("h2",{id:"gradle"},"Gradle"),Object(o.b)("p",null,"This gradle plugin offers a declarative DSL via extensions (these are Gradle project extensions). These map almost fully 1:1 with the options you\u2019d pass to the CLI or Maven plugin. The plugin maps the extensions to a task of the same name to provide a clean API. If you\u2019re interested in the extension/task mapping concept from a high-level, you can check out ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"https://docs.gradle.org/current/userguide/custom_plugins.html#sec:mapping_extension_properties_to_task_properties"}),"Gradle\u2019s docs"),"."),Object(o.b)("p",null,"To include in your project, add the following to ",Object(o.b)("inlineCode",{parentName:"p"},"build.gradle"),":"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-groovy"}),'buildscript {\n  repositories {\n    mavenLocal()\n    maven { url "https://repo1.maven.org/maven2" }\n  }\n  dependencies {\n    classpath "org.openapitools:openapi-generator-gradle-plugin:5.0.0"\n  }\n}\n\napply plugin: \'org.openapi.generator\'\n')),Object(o.b)("p",null,"This gives access to the following tasks:"),Object(o.b)("table",null,Object(o.b)("thead",{parentName:"table"},Object(o.b)("tr",{parentName:"thead"},Object(o.b)("th",Object(a.a)({parentName:"tr"},{align:null}),"Task"),Object(o.b)("th",Object(a.a)({parentName:"tr"},{align:null}),"Description"))),Object(o.b)("tbody",{parentName:"table"},Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiGenerate"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Generate code via Open API Tools Generator for Open API 2.0 or 3.x specification documents.")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiGenerators"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Lists generators available via Open API Generators.")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiMeta"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Generates a new generator to be consumed via Open API Generator.")),Object(o.b)("tr",{parentName:"tbody"},Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"openApiValidate"),Object(o.b)("td",Object(a.a)({parentName:"tr"},{align:null}),"Validates an Open API 2.0 or 3.x specification document.")))),Object(o.b)("blockquote",null,Object(o.b)("p",{parentName:"blockquote"},"The plugin implements the above tasks as project extensions of the same name. If you\u2019d like to declare these tasks as dependencies to other tasks (using ",Object(o.b)("inlineCode",{parentName:"p"},"dependsOn"),"), you\u2019ll need a task reference. e.g.:"),Object(o.b)("pre",{parentName:"blockquote"},Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-groovy"}),"compileJava.dependsOn tasks.openApiGenerate\n"))),Object(o.b)("p",null,"For full details of all options, see the ",Object(o.b)("a",Object(a.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-gradle-plugin"}),"plugin README"),"."),Object(o.b)("h3",{id:"example-1"},"Example"),Object(o.b)("p",null,"An example task for generating a kotlin client:"),Object(o.b)("pre",null,Object(o.b)("code",Object(a.a)({parentName:"pre"},{className:"language-groovy"}),'openApiGenerate {\n    generatorName = "kotlin"\n    inputSpec = "$rootDir/specs/petstore-v3.0.yaml".toString()\n    outputDir = "$buildDir/generated".toString()\n    apiPackage = "org.openapi.example.api"\n    invokerPackage = "org.openapi.example.invoker"\n    modelPackage = "org.openapi.example.model"\n    configOptions = [\n        dateLibrary: "java8"\n    ]\n}\n')))}s.isMDXComponent=!0},312:function(e,n,t){"use strict";t.d(n,"a",(function(){return b})),t.d(n,"b",(function(){return g}));var a=t(0),r=t.n(a);function o(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function l(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);n&&(a=a.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,a)}return t}function p(e){for(var n=1;n<arguments.length;n++){var t=null!=arguments[n]?arguments[n]:{};n%2?l(Object(t),!0).forEach((function(n){o(e,n,t[n])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):l(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))}))}return e}function i(e,n){if(null==e)return{};var t,a,r=function(e,n){if(null==e)return{};var t,a,r={},o=Object.keys(e);for(a=0;a<o.length;a++)t=o[a],n.indexOf(t)>=0||(r[t]=e[t]);return r}(e,n);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a<o.length;a++)t=o[a],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(r[t]=e[t])}return r}var c=r.a.createContext({}),s=function(e){var n=r.a.useContext(c),t=n;return e&&(t="function"==typeof e?e(n):p({},n,{},e)),t},b=function(e){var n=s(e.components);return r.a.createElement(c.Provider,{value:n},e.children)},u={inlineCode:"code",wrapper:function(e){var n=e.children;return r.a.createElement(r.a.Fragment,{},n)}},d=Object(a.forwardRef)((function(e,n){var t=e.components,a=e.mdxType,o=e.originalType,l=e.parentName,c=i(e,["components","mdxType","originalType","parentName"]),b=s(t),d=a,g=b["".concat(l,".").concat(d)]||b[d]||u[d]||o;return t?r.a.createElement(g,p({ref:n},c,{components:t})):r.a.createElement(g,p({ref:n},c))}));function g(e,n){var t=arguments,a=n&&n.mdxType;if("string"==typeof e||a){var o=t.length,l=new Array(o);l[0]=d;var p={};for(var i in n)hasOwnProperty.call(n,i)&&(p[i]=n[i]);p.originalType=e,p.mdxType="string"==typeof e?e:a,l[1]=p;for(var c=2;c<o;c++)l[c]=t[c];return r.a.createElement.apply(null,l)}return r.a.createElement.apply(null,t)}d.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/ecfe08ed.b9e52a69.js b/ecfe08ed.b9e52a69.js
new file mode 100644
index 00000000000..220b6d7354b
--- /dev/null
+++ b/ecfe08ed.b9e52a69.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[168],{292:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return r})),a.d(t,"metadata",(function(){return s})),a.d(t,"rightToc",(function(){return l})),a.d(t,"default",(function(){return b}));var n=a(1),i=a(9),o=(a(0),a(312)),r={id:"contributing",title:"Guidelines For Contributing",sidebar_label:"Guidelines"},s={id:"contributing",title:"Guidelines For Contributing",description:"## Before submitting an issue",source:"@site/../docs/contributing.md",permalink:"/docs/contributing",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/contributing.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar_label:"Guidelines",sidebar:"docs",previous:{title:"Workflow Integrations",permalink:"/docs/integrations"},next:{title:"Code of Conduct",permalink:"/docs/code-of-conduct"}},l=[{value:"Before submitting an issue",id:"before-submitting-an-issue",children:[]},{value:"Before submitting a PR",id:"before-submitting-a-pr",children:[]},{value:"How to contribute",id:"how-to-contribute",children:[{value:"git",id:"git",children:[]},{value:"Branches",id:"branches",children:[]},{value:"Code generators",id:"code-generators",children:[]},{value:"Templates",id:"templates",children:[]},{value:"Style guide",id:"style-guide",children:[]},{value:"Testing",id:"testing",children:[]},{value:"Tips",id:"tips",children:[]}]}],c={rightToc:l};function b(e){var t=e.components,a=Object(i.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},c,a,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"before-submitting-an-issue"},"Before submitting an issue"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"If you're not using the latest master to generate API clients or server stubs, please give it another try by pulling the latest master as the issue may have already been addressed. Ref: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator#getting-started"}),"Getting Started")),Object(o.b)("li",{parentName:"ul"},"Search the ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues"}),"open issue")," and ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed"}),"closed issue")," to ensure no one else has reported something similar before."),Object(o.b)("li",{parentName:"ul"},"File an ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues/new"}),"issue ticket")," by providing all the required information. Failure to provide enough detail may result in slow response from the community."),Object(o.b)("li",{parentName:"ul"},"Test with the latest master by building the JAR locally to see if the issue has already been addressed."),Object(o.b)("li",{parentName:"ul"},'You can also make a suggestion or ask a question by opening an "issue".')),Object(o.b)("h2",{id:"before-submitting-a-pr"},"Before submitting a PR"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Search the ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues"}),"open issue")," to ensure no one else has reported something similar and no one is actively working on similar proposed change."),Object(o.b)("li",{parentName:"ul"},"If no one has suggested something similar, open an ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues"}),'"issue"')," with your suggestion to gather feedback from the community."),Object(o.b)("li",{parentName:"ul"},"If you're adding a new option to a generator, please consider using the ",Object(o.b)("inlineCode",{parentName:"li"},"-t")," option with customized templates instead or start a discussion first by opening an issue as we want to avoid adding too many options to the generator."),Object(o.b)("li",{parentName:"ul"},"It's recommended to ",Object(o.b)("strong",{parentName:"li"},"create a new git branch")," for the change so that the merge commit message looks nicer in the commit history.")),Object(o.b)("h2",{id:"how-to-contribute"},"How to contribute"),Object(o.b)("h3",{id:"git"},"git"),Object(o.b)("p",null,"If you're new to git, you may find the following FAQs useful:"),Object(o.b)("p",null,Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/wiki/FAQ#git"}),"https://github.com/openapitools/openapi-generator/wiki/FAQ#git")),Object(o.b)("h3",{id:"branches"},"Branches"),Object(o.b)("p",null,"Please file the pull request against the correct branch, e.g. ",Object(o.b)("inlineCode",{parentName:"p"},"master")," for non-breaking changes. See the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches"}),"Git Branches")," page for more information."),Object(o.b)("h3",{id:"code-generators"},"Code generators"),Object(o.b)("p",null,"All the code generators can be found in ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages"}),"modules/openapi-generator/src/main/java/org/openapitools/codegen/languages")),Object(o.b)("p",null,"If you want to add a new generator, follow the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/new-generator"}),"new-generator")," guide. "),Object(o.b)("h3",{id:"templates"},"Templates"),Object(o.b)("p",null,"All the templates (",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://mustache.github.io/"}),"mustache"),") can be found in ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources"}),"modules/openapi-generator/src/main/resources"),"."),Object(o.b)("p",null,"For a list of variables available in the template, please refer to this ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/wiki/Mustache-Template-Variables"}),"page")),Object(o.b)("h3",{id:"style-guide"},"Style guide"),Object(o.b)("p",null,"Code change should conform to the programming style guide of the respective languages:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Ada: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation"}),"https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation")),Object(o.b)("li",{parentName:"ul"},"Android: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://source.android.com/source/code-style.html"}),"https://source.android.com/source/code-style.html")),Object(o.b)("li",{parentName:"ul"},"Bash: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/bahamas10/bash-style-guide"}),"https://github.com/bahamas10/bash-style-guide")),Object(o.b)("li",{parentName:"ul"},"C#: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx"}),"https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx")),Object(o.b)("li",{parentName:"ul"},"C++: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://google.github.io/styleguide/cppguide.html"}),"https://google.github.io/styleguide/cppguide.html")),Object(o.b)("li",{parentName:"ul"},"C++ (Tizen): ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style"}),"https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style")),Object(o.b)("li",{parentName:"ul"},"C++ (Unreal Engine 4): ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html"}),"https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html")),Object(o.b)("li",{parentName:"ul"},"Clojure: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/bbatsov/clojure-style-guide"}),"https://github.com/bbatsov/clojure-style-guide")),Object(o.b)("li",{parentName:"ul"},"Crystal: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://crystal-lang.org/reference/conventions/coding_style.html"}),"https://crystal-lang.org/reference/conventions/coding_style.html")),Object(o.b)("li",{parentName:"ul"},"Dart: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://www.dartlang.org/guides/language/effective-dart/style"}),"https://www.dartlang.org/guides/language/effective-dart/style")),Object(o.b)("li",{parentName:"ul"},"Elixir: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/christopheradams/elixir_style_guide"}),"https://github.com/christopheradams/elixir_style_guide")),Object(o.b)("li",{parentName:"ul"},"Eiffel: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://www.eiffel.org/doc/eiffel/Coding%20Standards"}),"https://www.eiffel.org/doc/eiffel/Coding%20Standards")),Object(o.b)("li",{parentName:"ul"},"Erlang: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/inaka/erlang_guidelines"}),"https://github.com/inaka/erlang_guidelines")),Object(o.b)("li",{parentName:"ul"},"Haskell: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md"}),"https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md")),Object(o.b)("li",{parentName:"ul"},"Java: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://google.github.io/styleguide/javaguide.html"}),"https://google.github.io/styleguide/javaguide.html")),Object(o.b)("li",{parentName:"ul"},"JavaScript: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/airbnb/javascript/"}),"https://github.com/airbnb/javascript/")),Object(o.b)("li",{parentName:"ul"},"Kotlin: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://kotlinlang.org/docs/reference/coding-conventions.html"}),"https://kotlinlang.org/docs/reference/coding-conventions.html")),Object(o.b)("li",{parentName:"ul"},"Groovy: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://groovy-lang.org/style-guide.html"}),"http://groovy-lang.org/style-guide.html")),Object(o.b)("li",{parentName:"ul"},"Go: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/golang/go/wiki/CodeReviewComments"}),"https://github.com/golang/go/wiki/CodeReviewComments")),Object(o.b)("li",{parentName:"ul"},"ObjC: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/NYTimes/objective-c-style-guide"}),"https://github.com/NYTimes/objective-c-style-guide")),Object(o.b)("li",{parentName:"ul"},"Perl: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://perldoc.perl.org/perlstyle.html"}),"http://perldoc.perl.org/perlstyle.html")),Object(o.b)("li",{parentName:"ul"},"PHP: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md"}),"https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md")),Object(o.b)("li",{parentName:"ul"},"PowerShell: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx"}),"https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx")),Object(o.b)("li",{parentName:"ul"},"Python: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://www.python.org/dev/peps/pep-0008/"}),"https://www.python.org/dev/peps/pep-0008/")),Object(o.b)("li",{parentName:"ul"},"R: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://google.github.io/styleguide/Rguide.xml"}),"https://google.github.io/styleguide/Rguide.xml")),Object(o.b)("li",{parentName:"ul"},"Ruby: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/bbatsov/ruby-style-guide"}),"https://github.com/bbatsov/ruby-style-guide")),Object(o.b)("li",{parentName:"ul"},"Rust: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md"}),"https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md")," (the default ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/rust-lang-nursery/rustfmt"}),"rustfmt")," configuration)"),Object(o.b)("li",{parentName:"ul"},"Scala: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://docs.scala-lang.org/style/"}),"http://docs.scala-lang.org/style/")),Object(o.b)("li",{parentName:"ul"},"Swift: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/TheBasics.html"}),"Apple Developer")),Object(o.b)("li",{parentName:"ul"},"TypeScript: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines"}),"https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines"))),Object(o.b)("p",null,"For other languages, feel free to suggest."),Object(o.b)("p",null,"You may find the current code base not 100% conform to the coding style and we welcome contributions to fix those."),Object(o.b)("p",null,"For ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#vendorExtensions"}),"Vendor Extensions"),", please follow the naming convention below:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"For general vendor extension, use lower case and hyphen. e.g. ",Object(o.b)("inlineCode",{parentName:"li"},"x-is-unique"),", ",Object(o.b)("inlineCode",{parentName:"li"},"x-content-type")),Object(o.b)("li",{parentName:"ul"},"For language-specified vendor extension, put it in the form of ",Object(o.b)("inlineCode",{parentName:"li"},"x-{lang}-{extension-name}"),". e.g. ",Object(o.b)("inlineCode",{parentName:"li"},"x-objc-operation-id"),", ",Object(o.b)("inlineCode",{parentName:"li"},"x-java-feign-retry-limit")),Object(o.b)("li",{parentName:"ul"},"For a list of existing vendor extensions in use, please refer to ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions"}),"https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions"),". If you've added new vendor extensions as part of your PR, please update the wiki page.")),Object(o.b)("h3",{id:"testing"},"Testing"),Object(o.b)("p",null,"To add test cases (optional) covering the change in the code generator, please refer to ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/test/java/org/openapitools/codegen"}),"modules/openapi-generator/src/test/java/org/openapitools/codegen")),Object(o.b)("p",null,"To test the templates, please perform the following:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Update the Petstore sample by running the shell scripts under the ",Object(o.b)("inlineCode",{parentName:"li"},"bin")," folder. For example, run ",Object(o.b)("inlineCode",{parentName:"li"},"./bin/generate-samples.sh ./bin/configs/python*")," to update the Python-related samples under ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/tree/master/samples"}),Object(o.b)("inlineCode",{parentName:"a"},"samples")),". For Windows, please install ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://gitforwindows.org/"}),"GIT bash"),". (If you find that there are new files generated or unexpected changes as a result of the update, that's not unusual as the test cases are added to the OpenAPI spec from time to time. If you've questions or concerns, please open a ticket to start a discussion)"),Object(o.b)("li",{parentName:"ul"},"During development, it can be helpful to quickly regenerate the samples without recompiling all of openapi-generator, e.g. when you have only updated the mustache templates. This can be done by passing the ",Object(o.b)("inlineCode",{parentName:"li"},"-t")," parameter: ",Object(o.b)("inlineCode",{parentName:"li"},"-t modules/openapi-generator/src/main/resources/python"),"."),Object(o.b)("li",{parentName:"ul"},"Run the tests in the sample folder using maven ",Object(o.b)("inlineCode",{parentName:"li"},"mvn integration-test -f /path/to/pom.xml"),", e.g. ",Object(o.b)("inlineCode",{parentName:"li"},"mvn integration-test -f samples/client/petstore/python/pom.xml"),". (some languages may not contain unit testing for Petstore and we're looking for contribution from the community to implement those tests)"),Object(o.b)("li",{parentName:"ul"},"Finally, git commit the updated samples files: ",Object(o.b)("inlineCode",{parentName:"li"},"git commit -a")," (",Object(o.b)("inlineCode",{parentName:"li"},"git add -A")," if added files with new test cases)"),Object(o.b)("li",{parentName:"ul"},"For new test cases, please add to the ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml"}),"Fake Petstore spec"))),Object(o.b)("p",null,"To start the CI tests, you can:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Run ",Object(o.b)("inlineCode",{parentName:"li"},"mvn verify -Psamples"),", assuming you have all the required tools installed to run tests for different languages."),Object(o.b)("li",{parentName:"ul"},"Leverage ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://travis-ci.org"}),"http://travis-ci.org")," to run the CI tests by adding your own openapi-generator repository."),Object(o.b)("li",{parentName:"ul"},"Run some of the CI tests in your local workspace.")),Object(o.b)("p",null,"See ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/wiki/Integration-Tests"}),"OpenAPI Tools wiki")," for more information about the integration tests."),Object(o.b)("h3",{id:"tips"},"Tips"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Smaller changes are easier to review"),Object(o.b)("li",{parentName:"ul"},"[Optional]"," For bug fixes, provide a OpenAPI Spec to repeat the issue so that the reviewer can use it to confirm the fix"),Object(o.b)("li",{parentName:"ul"},"Add test case(s) to cover the change"),Object(o.b)("li",{parentName:"ul"},"Document the fix in the code to make the code more readable"),Object(o.b)("li",{parentName:"ul"},"Make sure test cases passed after the change (one way is to leverage ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://travis-ci.org/"}),"https://travis-ci.org/")," to run the CI tests)"),Object(o.b)("li",{parentName:"ul"},"File a PR with meaningful title, description and commit messages"),Object(o.b)("li",{parentName:"ul"},'Make sure the option "Allow edits from maintainers" in the PR is selected so that the maintainers can update your PRs with minor fixes, if needed.'),Object(o.b)("li",{parentName:"ul"},"Recommended git settings",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"git config core.autocrlf input")," to tell Git convert CRLF to LF on commit but not the other way around "))),Object(o.b)("li",{parentName:"ul"},'To close an issue (e.g. issue 1542) automatically after a PR is merged, use keywords "fix", "close", "resolve" in the PR description, e.g. ',Object(o.b)("inlineCode",{parentName:"li"},"fix #1542"),". (Ref: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://help.github.com/articles/closing-issues-using-keywords/"}),"closing issues using keywords"),")")))}b.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return p})),a.d(t,"b",(function(){return h}));var n=a(0),i=a.n(n);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function s(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?r(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function l(e,t){if(null==e)return{};var a,n,i=function(e,t){if(null==e)return{};var a,n,i={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=i.a.createContext({}),b=function(e){var t=i.a.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):s({},t,{},e)),a},p=function(e){var t=b(e.components);return i.a.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return i.a.createElement(i.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,r=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),p=b(a),m=n,h=p["".concat(r,".").concat(m)]||p[m]||u[m]||o;return a?i.a.createElement(h,s({ref:t},c,{components:a})):i.a.createElement(h,s({ref:t},c))}));function h(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,r=new Array(o);r[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:n,r[1]=s;for(var c=2;c<o;c++)r[c]=a[c];return i.a.createElement.apply(null,r)}return i.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/ecfe08ed.facb9733.js b/ecfe08ed.facb9733.js
deleted file mode 100644
index 861819ea8df..00000000000
--- a/ecfe08ed.facb9733.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[168],{292:function(e,t,a){"use strict";a.r(t),a.d(t,"frontMatter",(function(){return r})),a.d(t,"metadata",(function(){return s})),a.d(t,"rightToc",(function(){return l})),a.d(t,"default",(function(){return b}));var n=a(1),i=a(9),o=(a(0),a(312)),r={id:"contributing",title:"Guidelines For Contributing",sidebar_label:"Guidelines"},s={id:"contributing",title:"Guidelines For Contributing",description:"## Before submitting an issue",source:"@site/../docs/contributing.md",permalink:"/docs/contributing",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/contributing.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar_label:"Guidelines",sidebar:"docs",previous:{title:"Workflow Integrations",permalink:"/docs/integrations"},next:{title:"Code of Conduct",permalink:"/docs/code-of-conduct"}},l=[{value:"Before submitting an issue",id:"before-submitting-an-issue",children:[]},{value:"Before submitting a PR",id:"before-submitting-a-pr",children:[]},{value:"How to contribute",id:"how-to-contribute",children:[{value:"git",id:"git",children:[]},{value:"Branches",id:"branches",children:[]},{value:"Code generators",id:"code-generators",children:[]},{value:"Templates",id:"templates",children:[]},{value:"Style guide",id:"style-guide",children:[]},{value:"Testing",id:"testing",children:[]},{value:"Tips",id:"tips",children:[]}]}],c={rightToc:l};function b(e){var t=e.components,a=Object(i.a)(e,["components"]);return Object(o.b)("wrapper",Object(n.a)({},c,a,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"before-submitting-an-issue"},"Before submitting an issue"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"If you're not using the latest master to generate API clients or server stubs, please give it another try by pulling the latest master as the issue may have already been addressed. Ref: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator#getting-started"}),"Getting Started")),Object(o.b)("li",{parentName:"ul"},"Search the ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues"}),"open issue")," and ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed"}),"closed issue")," to ensure no one else has reported something similar before."),Object(o.b)("li",{parentName:"ul"},"File an ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues/new"}),"issue ticket")," by providing all the required information. Failure to provide enough detail may result in slow response from the community."),Object(o.b)("li",{parentName:"ul"},"Test with the latest master by building the JAR locally to see if the issue has already been addressed."),Object(o.b)("li",{parentName:"ul"},'You can also make a suggestion or ask a question by opening an "issue".')),Object(o.b)("h2",{id:"before-submitting-a-pr"},"Before submitting a PR"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Search the ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues"}),"open issue")," to ensure no one else has reported something similar and no one is actively working on similar proposed change."),Object(o.b)("li",{parentName:"ul"},"If no one has suggested something similar, open an ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/issues"}),'"issue"')," with your suggestion to gather feedback from the community."),Object(o.b)("li",{parentName:"ul"},"If you're adding a new option to a generator, please consider using the ",Object(o.b)("inlineCode",{parentName:"li"},"-t")," option with customized templates instead or start a discussion first by opening an issue as we want to avoid adding too many options to the generator."),Object(o.b)("li",{parentName:"ul"},"It's recommended to ",Object(o.b)("strong",{parentName:"li"},"create a new git branch")," for the change so that the merge commit message looks nicer in the commit history.")),Object(o.b)("h2",{id:"how-to-contribute"},"How to contribute"),Object(o.b)("h3",{id:"git"},"git"),Object(o.b)("p",null,"If you're new to git, you may find the following FAQs useful:"),Object(o.b)("p",null,Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/wiki/FAQ#git"}),"https://github.com/openapitools/openapi-generator/wiki/FAQ#git")),Object(o.b)("h3",{id:"branches"},"Branches"),Object(o.b)("p",null,"Please file the pull request against the correct branch, e.g. ",Object(o.b)("inlineCode",{parentName:"p"},"master")," for non-breaking changes. See the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches"}),"Git Branches")," page for more information."),Object(o.b)("h3",{id:"code-generators"},"Code generators"),Object(o.b)("p",null,"All the code generators can be found in ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages"}),"modules/openapi-generator/src/main/java/org/openapitools/codegen/languages")),Object(o.b)("p",null,"If you want to add a new generator, follow the ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://openapi-generator.tech/docs/new-generator"}),"new-generator")," guide. "),Object(o.b)("h3",{id:"templates"},"Templates"),Object(o.b)("p",null,"All the templates (",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://mustache.github.io/"}),"mustache"),") can be found in ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/main/resources"}),"modules/openapi-generator/src/main/resources"),"."),Object(o.b)("p",null,"For a list of variables available in the template, please refer to this ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/wiki/Mustache-Template-Variables"}),"page")),Object(o.b)("h3",{id:"style-guide"},"Style guide"),Object(o.b)("p",null,"Code change should conform to the programming style guide of the respective languages:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Ada: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation"}),"https://en.wikibooks.org/wiki/Ada_Style_Guide/Source_Code_Presentation")),Object(o.b)("li",{parentName:"ul"},"Android: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://source.android.com/source/code-style.html"}),"https://source.android.com/source/code-style.html")),Object(o.b)("li",{parentName:"ul"},"Bash: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/bahamas10/bash-style-guide"}),"https://github.com/bahamas10/bash-style-guide")),Object(o.b)("li",{parentName:"ul"},"C#: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx"}),"https://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx")),Object(o.b)("li",{parentName:"ul"},"C++: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://google.github.io/styleguide/cppguide.html"}),"https://google.github.io/styleguide/cppguide.html")),Object(o.b)("li",{parentName:"ul"},"C++ (Tizen): ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style"}),"https://wiki.tizen.org/Native_Platform_Coding_Idiom_and_Style_Guide#C.2B.2B_Coding_Style")),Object(o.b)("li",{parentName:"ul"},"C++ (Unreal Engine 4): ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html"}),"https://docs.unrealengine.com/en-US/ProductionPipelines/DevelopmentSetup/CodingStandard/index.html")),Object(o.b)("li",{parentName:"ul"},"Clojure: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/bbatsov/clojure-style-guide"}),"https://github.com/bbatsov/clojure-style-guide")),Object(o.b)("li",{parentName:"ul"},"Crystal: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://crystal-lang.org/reference/conventions/coding_style.html"}),"https://crystal-lang.org/reference/conventions/coding_style.html")),Object(o.b)("li",{parentName:"ul"},"Dart: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://www.dartlang.org/guides/language/effective-dart/style"}),"https://www.dartlang.org/guides/language/effective-dart/style")),Object(o.b)("li",{parentName:"ul"},"Elixir: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/christopheradams/elixir_style_guide"}),"https://github.com/christopheradams/elixir_style_guide")),Object(o.b)("li",{parentName:"ul"},"Eiffel: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://www.eiffel.org/doc/eiffel/Coding%20Standards"}),"https://www.eiffel.org/doc/eiffel/Coding%20Standards")),Object(o.b)("li",{parentName:"ul"},"Erlang: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/inaka/erlang_guidelines"}),"https://github.com/inaka/erlang_guidelines")),Object(o.b)("li",{parentName:"ul"},"Haskell: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md"}),"https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md")),Object(o.b)("li",{parentName:"ul"},"Java: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://google.github.io/styleguide/javaguide.html"}),"https://google.github.io/styleguide/javaguide.html")),Object(o.b)("li",{parentName:"ul"},"JavaScript: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/airbnb/javascript/"}),"https://github.com/airbnb/javascript/")),Object(o.b)("li",{parentName:"ul"},"Kotlin: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://kotlinlang.org/docs/reference/coding-conventions.html"}),"https://kotlinlang.org/docs/reference/coding-conventions.html")),Object(o.b)("li",{parentName:"ul"},"Groovy: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://groovy-lang.org/style-guide.html"}),"http://groovy-lang.org/style-guide.html")),Object(o.b)("li",{parentName:"ul"},"Go: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/golang/go/wiki/CodeReviewComments"}),"https://github.com/golang/go/wiki/CodeReviewComments")),Object(o.b)("li",{parentName:"ul"},"ObjC: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/NYTimes/objective-c-style-guide"}),"https://github.com/NYTimes/objective-c-style-guide")),Object(o.b)("li",{parentName:"ul"},"Perl: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://perldoc.perl.org/perlstyle.html"}),"http://perldoc.perl.org/perlstyle.html")),Object(o.b)("li",{parentName:"ul"},"PHP: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md"}),"https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-12-extended-coding-style-guide.md")),Object(o.b)("li",{parentName:"ul"},"PowerShell: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx"}),"https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx")),Object(o.b)("li",{parentName:"ul"},"Python: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://www.python.org/dev/peps/pep-0008/"}),"https://www.python.org/dev/peps/pep-0008/")),Object(o.b)("li",{parentName:"ul"},"R: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://google.github.io/styleguide/Rguide.xml"}),"https://google.github.io/styleguide/Rguide.xml")),Object(o.b)("li",{parentName:"ul"},"Ruby: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/bbatsov/ruby-style-guide"}),"https://github.com/bbatsov/ruby-style-guide")),Object(o.b)("li",{parentName:"ul"},"Rust: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md"}),"https://github.com/rust-lang-nursery/fmt-rfcs/blob/master/guide/guide.md")," (the default ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/rust-lang-nursery/rustfmt"}),"rustfmt")," configuration)"),Object(o.b)("li",{parentName:"ul"},"Scala: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://docs.scala-lang.org/style/"}),"http://docs.scala-lang.org/style/")),Object(o.b)("li",{parentName:"ul"},"Swift: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/Swift_Programming_Language/TheBasics.html"}),"Apple Developer")),Object(o.b)("li",{parentName:"ul"},"TypeScript: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines"}),"https://github.com/Microsoft/TypeScript/wiki/Coding-guidelines"))),Object(o.b)("p",null,"For other languages, feel free to suggest."),Object(o.b)("p",null,"You may find the current code base not 100% conform to the coding style and we welcome contributions to fix those."),Object(o.b)("p",null,"For ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#vendorExtensions"}),"Vendor Extensions"),", please follow the naming convention below:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"For general vendor extension, use lower case and hyphen. e.g. ",Object(o.b)("inlineCode",{parentName:"li"},"x-is-unique"),", ",Object(o.b)("inlineCode",{parentName:"li"},"x-content-type")),Object(o.b)("li",{parentName:"ul"},"For language-specified vendor extension, put it in the form of ",Object(o.b)("inlineCode",{parentName:"li"},"x-{lang}-{extension-name}"),". e.g. ",Object(o.b)("inlineCode",{parentName:"li"},"x-objc-operation-id"),", ",Object(o.b)("inlineCode",{parentName:"li"},"x-java-feign-retry-limit")),Object(o.b)("li",{parentName:"ul"},"For a list of existing vendor extensions in use, please refer to ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions"}),"https://github.com/openapitools/openapi-generator/wiki/Vendor-Extensions"),". If you've added new vendor extensions as part of your PR, please update the wiki page.")),Object(o.b)("h3",{id:"testing"},"Testing"),Object(o.b)("p",null,"To add test cases (optional) covering the change in the code generator, please refer to ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/openapitools/openapi-generator/tree/master/modules/openapi-generator/src/test/java/org/openapitools/codegen"}),"modules/openapi-generator/src/test/java/org/openapitools/codegen")),Object(o.b)("p",null,"To test the templates, please perform the following:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Update the Petstore sample by running the shell scripts under the ",Object(o.b)("inlineCode",{parentName:"li"},"bin")," folder. For example, run ",Object(o.b)("inlineCode",{parentName:"li"},"./bin/generate-samples.sh ./bin/configs/python*")," to update the Python-related samples under ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/openapitools/openapi-generator/tree/master/samples"}),Object(o.b)("inlineCode",{parentName:"a"},"samples")),". For Windows, please install ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://gitforwindows.org/"}),"GIT bash"),". (If you find that there are new files generated or unexpected changes as a result of the update, that's not unusual as the test cases are added to the OpenAPI spec from time to time. If you've questions or concerns, please open a ticket to start a discussion)"),Object(o.b)("li",{parentName:"ul"},"During development, it can be helpful to quickly regenerate the samples without recompiling all of openapi-generator, e.g. when you have only updated the mustache templates. This can be done by passing the ",Object(o.b)("inlineCode",{parentName:"li"},"-t")," parameter: ",Object(o.b)("inlineCode",{parentName:"li"},"-t modules/openapi-generator/src/main/resources/python"),"."),Object(o.b)("li",{parentName:"ul"},"Run the tests in the sample folder using maven ",Object(o.b)("inlineCode",{parentName:"li"},"mvn integration-test -f /path/to/pom.xml"),", e.g. ",Object(o.b)("inlineCode",{parentName:"li"},"mvn integration-test -f samples/client/petstore/python/pom.xml"),". (some languages may not contain unit testing for Petstore and we're looking for contribution from the community to implement those tests)"),Object(o.b)("li",{parentName:"ul"},"Finally, git commit the updated samples files: ",Object(o.b)("inlineCode",{parentName:"li"},"git commit -a")," (",Object(o.b)("inlineCode",{parentName:"li"},"git add -A")," if added files with new test cases)"),Object(o.b)("li",{parentName:"ul"},"For new test cases, please add to the ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml"}),"Fake Petstore spec"))),Object(o.b)("p",null,"To start the CI tests, you can:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Run ",Object(o.b)("inlineCode",{parentName:"li"},"mvn verify -Psamples"),", assuming you have all the required tools installed to run tests for different languages."),Object(o.b)("li",{parentName:"ul"},"Leverage ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"http://travis-ci.org"}),"http://travis-ci.org")," to run the CI tests by adding your own openapi-generator repository."),Object(o.b)("li",{parentName:"ul"},"Run some of the CI tests in your local workspace.")),Object(o.b)("p",null,"See ",Object(o.b)("a",Object(n.a)({parentName:"p"},{href:"https://github.com/OpenAPITools/openapi-generator/wiki/Integration-Tests"}),"OpenAPI Tools wiki")," for more information about the integration tests."),Object(o.b)("h3",{id:"tips"},"Tips"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Smaller changes are easier to review"),Object(o.b)("li",{parentName:"ul"},"[Optional]"," For bug fixes, provide a OpenAPI Spec to repeat the issue so that the reviewer can use it to confirm the fix"),Object(o.b)("li",{parentName:"ul"},"Add test case(s) to cover the change"),Object(o.b)("li",{parentName:"ul"},"Document the fix in the code to make the code more readable"),Object(o.b)("li",{parentName:"ul"},"Make sure test cases passed after the change (one way is to leverage ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://travis-ci.org/"}),"https://travis-ci.org/")," to run the CI tests)"),Object(o.b)("li",{parentName:"ul"},"File a PR with meaningful title, description and commit messages"),Object(o.b)("li",{parentName:"ul"},'Make sure the option "Allow edits from maintainers" in the PR is selected so that the maintainers can update your PRs with minor fixes, if needed.'),Object(o.b)("li",{parentName:"ul"},"Recommended git settings",Object(o.b)("ul",{parentName:"li"},Object(o.b)("li",{parentName:"ul"},Object(o.b)("inlineCode",{parentName:"li"},"git config core.autocrlf input")," to tell Git convert CRLF to LF on commit but not the other way around "))),Object(o.b)("li",{parentName:"ul"},'To close an issue (e.g. issue 1542) automatically after a PR is merged, use keywords "fix", "close", "resolve" in the PR description, e.g. ',Object(o.b)("inlineCode",{parentName:"li"},"fix #1542"),". (Ref: ",Object(o.b)("a",Object(n.a)({parentName:"li"},{href:"https://help.github.com/articles/closing-issues-using-keywords/"}),"closing issues using keywords"),")")))}b.isMDXComponent=!0},312:function(e,t,a){"use strict";a.d(t,"a",(function(){return p})),a.d(t,"b",(function(){return h}));var n=a(0),i=a.n(n);function o(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function r(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function s(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?r(Object(a),!0).forEach((function(t){o(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):r(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function l(e,t){if(null==e)return{};var a,n,i=function(e,t){if(null==e)return{};var a,n,i={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(i[a]=e[a]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(i[a]=e[a])}return i}var c=i.a.createContext({}),b=function(e){var t=i.a.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):s({},t,{},e)),a},p=function(e){var t=b(e.components);return i.a.createElement(c.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return i.a.createElement(i.a.Fragment,{},t)}},m=Object(n.forwardRef)((function(e,t){var a=e.components,n=e.mdxType,o=e.originalType,r=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),p=b(a),m=n,h=p["".concat(r,".").concat(m)]||p[m]||u[m]||o;return a?i.a.createElement(h,s({ref:t},c,{components:a})):i.a.createElement(h,s({ref:t},c))}));function h(e,t){var a=arguments,n=t&&t.mdxType;if("string"==typeof e||n){var o=a.length,r=new Array(o);r[0]=m;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:n,r[1]=s;for(var c=2;c<o;c++)r[c]=a[c];return i.a.createElement.apply(null,r)}return i.a.createElement.apply(null,a)}m.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/f1d7b915.1ac91f23.js b/f1d7b915.1ac91f23.js
deleted file mode 100644
index e4082ee7568..00000000000
--- a/f1d7b915.1ac91f23.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[172],{296:function(e,a,t){"use strict";t.r(a),t.d(a,"frontMatter",(function(){return i})),t.d(a,"metadata",(function(){return l})),t.d(a,"rightToc",(function(){return p})),t.d(a,"default",(function(){return m}));var r=t(1),b=t(9),n=(t(0),t(312)),i={id:"release-3-0-0",title:"Release Notes: 3.0.0",sidebar_label:"Release Notes: 3.0.0"},l={id:"release-3-0-0",title:"Release Notes: 3.0.0",description:"* ## Docker",source:"@site/../docs/3.0.0-release-note.md",permalink:"/docs/release-3-0-0",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/3.0.0-release-note.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar_label:"Release Notes: 3.0.0",sidebar:"docs",previous:{title:"Release Summary",permalink:"/docs/release-summary"},next:{title:"Generators List",permalink:"/docs/generators"}},p=[],c={rightToc:p};function m(e){var a=e.components,t=Object(b.a)(e,["components"]);return Object(n.b)("wrapper",Object(r.a)({},c,t,{components:a,mdxType:"MDXLayout"}),Object(n.b)("ul",null,Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"docker"}),"Docker")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7dfd94002 Docker: use correct MAVEN_CONFIG (#182)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b5a0d173d Revise the usage of OpenAPI Generator online (docker image) (#73)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e58dc2c77 Fix COPY in Dockerfile (#64)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9d7feaaeb Fix online generator (docker push) (#58)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9247cd01e Changes for Docker")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"64037ee59 update docker-related files to ues jdk8")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"plug-ins"}),"Plug-ins")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b6b8c0db8 ","[","gradle-plugin] Initial implementation (#162)  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0a28aad73 ","[","MAVEN PLUGIN] Checking for null configOptions before looking for property")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9c79297d6 ","[","MAVEN PLUGIN] Use latest version in dependencies snippet")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9e1bbe0c1 Add maven wrapper")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"api-clients"}),"API Clients")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"ada"}),"Ada")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"edf6be8c0 ","[","Ada] bug fix by defining x-is-model-type when property is local to the YML file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9ba74f484 ","[","Ada] Fix GNAT project and server skeleton to avoid sending a response when an error is returned")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ea27924f5 ","[","Ada] changed default project/package name, to solve circular dependencies")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6b9d38d40 remove trailing spaces in ada template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0de7f972f Fix the Ada server skeleton to check the authsMethods in the Shared_Instance generic package")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4bd8fc6e8 Fix 7511: ","[","Ada] Client call is not correct with multiple parameters and application/x-www-urlencoded")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3035bc629 ","[","Ada] Hotfix/ada model sort")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'43f0e8692 Ada code generator corrected: "=>" instead of "->".  ')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7d2b49085 ","[","Ada] wrong order for generated structures in models.ads files")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2b2b85eec ","[","Ada] wrong JSON in POST operations")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c"}),"C#")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0e34bcf4e ","[","csharp] ctor params should always be camelCase")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"872471996 ","[","csharp] Support arrays of arrays for properties and models")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1c4e6b7d4 ","[","csharp] Fix ToJson to work with composition and polymorphism")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ed7af73f6 ","[","csharp] Reference this.Configuration in client API template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c-1"}),"C++")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e796e4c36 ","[","C++] Add linux as a reserve keyword")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"36f69a034 remove trailing spaces in qt5 c++ templates")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f192613f1 fix string type in c++ generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"409015461 fix file type in qt5cpp")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a4bcb3bc7 fix datetime and map type for qt5cpp")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"23b31aba8 ","[","qt5cpp] Fix crash when API return a map container")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3b031ed2b ","[","qt5cpp] delete callback data allocated before signal emission")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1bb1e44d1 ","[","qt5cpp] Remove qt5 pro.user file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"194722015 Qt5cpp plug memleaks part2")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"12f3661d6 Qt5cpp plug memleaks")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ea4b94842 ","[","qt5cpp] Add nullptr guard to prevent crash when empty model is being serialized")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0bf430a80 Qt5cpp Add support for nested containers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0b3ec6b1f fix NPE with cpp qt5, add logic to avoid NPE with composed schema")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7c734445b fix file parameter in header file (cpprest)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"070b5c00b fix object type declaration in cpprest")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bad1885b4 ","[","cpprest] add parameterToString for number type with unspecified format (double)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"73bd24db7 ","[","cpprest] Add support for nested vectors")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ee2eb74f7 ","[","qt] update Qt client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d82499944 Adding qt project generation fix")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9bd94b4db ","[","qt] Fix warning message")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"clojure"}),"Clojure")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d7e374504 ","[","Clojure] Add util method to set the api-context globally (#93)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"dart"}),"Dart")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f1638a659 ","[","Dart] Allow setting an accessToken for OAuth")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a5e26a44f ","[","Dart] - Rework Dart client generator to be flutter-compatible")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"elixir"}),"Elixir")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f9b2839a3 ","[","Elixir] Check date value before calling to_iso8601")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"elm"}),"Elm")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5a87fe695 ","[","elm] Fix operations with empty responses (#171)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a5cf27b60 Fix Petstore example for Elm (#96)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c522927d5 Fix Elm generator for polymorphism (#78)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7d9fb9f51 Add CI test for Elm in travis (#40)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"769a65c95 ","[","Elm] Add support for array schemas")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"56a0268e3 ","[","elm] missing '->' in Main elm template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"erlang"}),"Erlang")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c73118524 ","[","erlang-client] Erlang request utils")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"049eef9c5 Test erlang client, server petstore")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bcc7b788e fix erlang client compilation error")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"go"}),"Go")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"acb63fd5e Fix go readme, remove resty install")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5d8362d85 Update go client, fix double body read")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"47614bb76 Properly capitalize exported go types")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ee561fcd6 Add withXml option for Go language")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0f6696089 ","[","Go] Use consistent indentation in readme  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"72abb20f2 ","[","Go] Fix operation files clobbering model files. ","[","2.4.0]")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"haskell"}),"Haskell")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"34db79b9b ","[","haskell-http-client] update dependency versions + readme (#81)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e45b3784f Fix NPE with Haskell client generator with OAS3 spec")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d3401396f ","[","haskell-http-client] remove duplicates in produces/consumes; fix pathParam paramName issue")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4bc99b9da minor fixes to haskell http client generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2d0bafb6b ","[","haskell-http-client] default InlineMimeTypes=true")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9fba9c325 ","[","haskell-http-client] add config options: cabalPackage, cabalVersion, baseModule, requestType, configType")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"kotlin"}),"Kotlin")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a3322fbf7 ","[","kotlin] Add OkHttpClient.Builder to ApiClient.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3c5fb1d80 ","[","kotlin] Add json annotation to each enum value.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"39fa375e3 ","[","kotlin] Fix NPE for POST/PUT/PATCH with empty request models.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c599906f1 Kotlin: Correct data_class.mustache to use proper property for inner enum data type")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c69925b53 ","[","Kotlin] Fix issues with threetenbp  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a811a48c3 minor fix to kotlin client generator due to merge conflict")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"914275fe7 ","[","kotlin] support selection of datelibrary")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a61d23265 Fixed incorrect renaming of header and query param to camel cases for Kotlin Client template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"lua"}),"Lua")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"dbe78e23e ","[","Lua] Improve auto-generated test files")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6c79052ac Add auto-generated Lua spec files for APIs, models")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"38a2c1dde ","[","Lua] Fix Rockpec")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a2410b210 Add auto-generated rockspec file to Lua API client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"df10c725a Add lua test script, minor fix to Lua API files")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"java"}),"Java")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2e69e6c03 build.gradle should not have commas")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1a4e5a4e5 Java client: Add constants for libraries (#163)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7db0201a8 Fix NPEs in Java generator (#154)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4d7ff8cfb JavaDoc fixes for Java/RESTEasy client (#151)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"072ce070b resteasy: fix outer enum case (#139)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ccd002966 ","[","Java] rest-assured: fix javadoc in templates")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e7410d4c8 Allow $ in java var name")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"03490e923 Fix Java binary mapping")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"70b4b55fa Fix performance linting problem with maps in Java ApiClient template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"cddcda0fe ","[","Java]","[Jersey2]"," Make generated client code thread safe")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"298ca8d35 use correct jackson date library when using Java 8")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"53eeb0c04 ","[","Java] fix connection leak on retrofit OAuth token renewal")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"61c25e711 ","[","Java] Fixes for retrofit")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f02332755 ","[","JAVA] 4709: codegen with parcelableMode fails to build if using arrays in swagger.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4eeb974cb ","[","Java]","[google-api-client]"," Fix bug with empty POST request not sending content-type")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d4543a99e ","[","Java]","[retrofit2]"," file upload sets filename as baseName instead of a dynamic filename")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"62a930223 ","[","JAVA]","[Rest-assured]"," reqSpec() method has been added into api.mustache for requests custom\u2026")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"fec0363f7 ","[","Java] Add back byte array enhancement")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"59ff4c198 ","[","Java]","[library: vertx]"," Add default value and required parameter support to vertx server temp\u2026")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3bd2da9a8 ","[","Java] Fix build warnings")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"429b96ae7 ","[","JAVA] equals and hashCode for models with byte[] and binary strings")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"495971c2c ","[","Java] use html entities in javadoc of generated code (#106)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"82ee8656f ","[","java] Enum in array of array (#66)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bf7e4e7df Java gson: add @SerializedName value as constant  (#22)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"30c1448d7 Fix build.gradle for Java RESTEasy client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"642c0566d ","[","Java] Use Rx2 Completable for Void Retrofit2 responses")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"72221b1cf Adding @Deprecated to retrofit2 client interfaces.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"47111b324 ","[","Java] fix gson deserialize format byte")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9e06f7063 ","[","Java] Fix assignment of new object instance to variable")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"006f084b5 ","[","Java] Allow to set values with setApiPackage(..) and setModelPackage(..)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"javascriptnodejs"}),"JavaScript/NodeJS")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d80e29585 Fix JS test using baseName in default value (#5)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"fe15f4690 fix toDefaultValueWithParam in JS")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"90859575e Fixing variable name typo (instane -> instance)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"objective-c"}),"Objective-C")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9fb2c29a4 7644 objc deprecated afnetworking datataskwithrequest")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5d1874028 add class as a keyword in objc generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1b8df5c20 Update ObjcClientCodegen.java")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"246ed5754 restore objc reserved word: property")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"php"}),"PHP")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3beeb4e77 ","[","PHP] Not-required properties now shows as nullable (#129)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"37df59d6f ","[","PHP] Adjust the names (script, sample folder, generator) to lang option (#159)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4a5d16b23 ","[","PHP] Fix string length validation")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d58835e57 ","[","PHP] Improve: Make validation strict")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"cf8d8d56f ","[","PHP] Fix code example from README. Variable name was missing when using Basic auth.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0adbf7e51 ","[","PHP] Improve: update sample tests automatically")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"32cf2f16f ","[","PHP] Non required enum property")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3bcf0ff76 ","[","PHP] Add path & file separator (/) to return the correct path when deserializing a file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"14e1e1980 ","[","PHP] Improve validation on empty arrays")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"809e1f4c9 ","[","PHP] Cleanup tests")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"76907cacd ","[","PHP] declare property headerSelector")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"python"}),"Python")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7184f1ec6 ","[","python] asyncio supports _preload_content; remove unused imports (#107)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d74d2ba03 fix: python clients")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"8e0a0ebd6 Fix python / tornado body handling")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b39c35c76 Fix inconsistency between model name and file name in python client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"dfbef4374 Fixed unicode error and supported allow_nonstandard_methods in tornado based python client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f6e0e297e ","[","python-asyncio] tests and fixes")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"r"}),"R")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"61e58d649 Add R namespace file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"ruby"}),"Ruby")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a08164592 fix ruby parameters in documentation, fix requiredParams, optionalParams")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"8e34f9a98 update to newer version of ruby")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"aa6b217bb ","[","Ruby] Add auto-generated rubocop config file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"rust"}),"Rust")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b44357394 ","[","Rust] Implement minimal auth support")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0b845a57e ","[","Rust] Changes hard coded body to dynamic parameter name -  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a3c97753f ","[","Rust] Handles UUID as string")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"027df610b ","[","Rust] Handle error response statuses")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"66be7a791 ","[","Rust] Add user agent handling for rust template (master)  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3029b7b0f ","[","Rust] Format example with rustfmt")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"scala"}),"Scala")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"197b4481e normalize akka-scala and Java README")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"612cfb7af ","[","Akka-scala] Clean unused dependencies such swagger-core")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"86697fedb ","[","Scala]","[Gatling]"," correct body params filename")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"832919b84 ","[","Scala]","[Akka]"," Remove unused dep when model package is empty")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"swift"}),"Swift")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"40d5d0990 ","[","Swift4] accept empty content with default client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3b7230b17 ","[","Swift 4] Fix APIHelper to accept array parameter")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e22faf4cd ","[","Swift] Add public initializer for modelObject.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b184fb1d9 ","[","Swift3] escape URL parameters")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"52f606b8d Fix Swift3 test cases and add pom.xml, travis config for iOS test")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a3d0f1d4b Swift4: make generated models structs instead of classes")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"typescript"}),"TypeScript")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f615d823f update ts node dependencies")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9ac9bc0dc ","[","TypeScript] enhance ts import")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"009dcf009 Mark ",Object(n.b)("inlineCode",{parentName:"p"},"not required")," swagger properties as optional typescript properties")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bdd2c2a4e Misc typescript Angular code generation improvements")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"260375c9e Fix typescript-node generation of array type models")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d1933b5fc Fix a problem in the generation of typescript-jquery when we have enum in a query param")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"20305139b ","[","Feature]","[TypeScript]"," request param enum as literal unions")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"524f162e6 Use supportsES6 flag in ts compilation for language typescript-angular")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9b8602311 ","[","TypeScript] Make OpenAPI Generator serialize subclasses properly (#102)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4bc5ffe86 ","[","typescript-angular] add provided in support (#120)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ef832e715 ","[","Feature]","[TS Angular]"," improve docs angular import")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"fc7e08346 ","[","TS]","[Fetch]"," Add interfaces option")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"157e6b7fa ","[","angular] Add option to generate tagged unions")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7faaa091c Fix generated module imports in Aurelia APIs")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b5f0b24ba ","[","TS] fix object declaration in model")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"api-servers"}),"API Servers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c-2"}),"C++")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6fef0a7ff fix string issue with restbed generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a339422bd move get type declaration method to c++ restbed")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c-3"}),"C#")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d9d653016 ","[","aspnetcore] Make the use of Swashbuckle optional (#110)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9a8183ab0 ","[","aspnetcore] Fix openapi.json location rename (#56)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"12abfb968 ","[","aspnetcore] Update Dockerfile")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"866817587 ","[","aspnetcore] Fix string enum generation")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"java-1"}),"Java")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bd50d368e ","[","JAVA - jaxrs-resteasy-eap] Add import to models (#179)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7efda597c Fix issue with useBeanValidation option in Java server generators (#160)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"71b5de3ed Do not set contextPath for spring-boot (#104)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b73ab0260 jaxrs-cxf-cdi: fix outer enum (#131)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4d7fc046f ","[",'JaxRS] Add "validation-api" dependency in jetty (#30)')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ce930e7a6 ","[","Jaxrs-cxf] Add bean-level cascaded beanvalidation for pojos (@Valid)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'386b9f432 Modify "postProcessOperations" for "jaxrs-cxf-client"  ')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5d92717dc update jaxrs to listen at port 10080")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7c2031675 update artifact id for jaxrs datelib j8")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"88c5112f2 Adds support for returning response in jaxrs-spec interfaces")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6bf84d5fa ","[","JAXRS-SPEC] Fix lowercase enums sent as uppercase")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'3a1922bc9 Fix version for "spring-boot-maven-plugin" (#85)')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"161948657 Add reactive option for Spring Boot (webflux)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ff1178ad7 ","[","Java]","[Spring]"," fix missing optional query params")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2103fadab Fix package declaration for play-framework")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2c6380c84 fix inner item (list, map) for play framework")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e33b350c8 Fix an issue in Play Framework generator where a CSV is empty and transferred to the controllerImp with an empty item.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"99fc27246 ","[","JAX-RS]","[Spec]"," Removes throws Exception.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'fe2a44339 Fixes issue  (SpringCodeGen dateLibrary "java8-localdatetime" option is ignored).')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d890d733f ","[","JaxRS]","[Java]"," issue with implFolder on windows, and required fields generation for containers (#88)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c91ce17ae Feature/javaPlayWithAsynchronousControllers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f00a1ef52 ","[","JAVA] Correct consumes/produces attributes for Spring Controllers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d14318cf2 ","[","JAVA]","[Spring]"," Optional params with delegate")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3f81378d7 ","[","java resteasy] fix string comparison (#134)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5ea3d3bb1 ","[","JAX-RS]","[SPEC]"," Bug fix that prevents generating interfaces when interfaceOnly is false.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"kotlin-1"}),"Kotlin")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7cad47dd3 ","[","kotlin-server] --library=ktor (barebones implementation)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"752b36e66 ","[","Kotlin] Sanitize enumeration name to add underscore when it starts with digits (#77)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"nodejs"}),"NodeJS")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6d88d073c ","[","NodeJS] make serverPort configurable via CLI option")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e7f4fb3c4 Fix nodejs-server path issue in windows platform")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"php-1"}),"PHP")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d30fcbabb Fixes for php-ze-ph generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"60e3339aa ","[","Feature]","[PHP]"," Update for ze-ph generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"python-1"}),"Python")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"62b93fc5c ","[","Python]","[Flask]"," Handles UUID format -  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9999eac52 fix python flask parameter naming")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"scala-1"}),"Scala")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d5c355a59 ","[","Scalatra] Updated the version of Scalatra to the latest (2.6.2)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"52322c47c ","[","finch] Allow finch server to compile for CI checks (#7)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"ruby-1"}),"Ruby")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"dcad9ae80 ","[","Rails5] make version of the generated Rails stub server to strict Rails 5.0")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"rust-1"}),"Rust")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"37faaf926 ","[","rust-server] API version constant and composite version support")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6c7813e79 ","[","rust-server] asynchronous support via hyper v0.11")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"documentation"}),"Documentation")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"25a6a9d44 html: fix typo in class name  "))),Object(n.b)("ul",null,Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"miscellaneous"}),"Miscellaneous")),Object(n.b)("li",{parentName:"ul"},"f04213285 Cli error message improvements (#172)"),Object(n.b)("li",{parentName:"ul"},"0ece706a4 Remove CodegenConfig.fromModel(String, Schema) method (#90)"),Object(n.b)("li",{parentName:"ul"},"64f2bea37 Fix getReferenced...() methods in ModelUtils (#157)"),Object(n.b)("li",{parentName:"ul"},"16ff5174e Update swagger-parser to 2.0.1 (#123)"),Object(n.b)("li",{parentName:"ul"},"76b7307a6 DefaultGenerator: ignore only form param schemas (#74)"),Object(n.b)("li",{parentName:"ul"},"a3aabd390 Create a default implementation of delegate if none could be autowired (#92)"),Object(n.b)("li",{parentName:"ul"},"ca89af808 Switch to Java 8"),Object(n.b)("li",{parentName:"ul"},"27426f7b5 Cli generator name option, replaces 'language' options in CLI and Maven Plugin (#57)"),Object(n.b)("li",{parentName:"ul"},"a1ff50241 Rename datatype to dataType in CodegenProperty (#69)"),Object(n.b)("li",{parentName:"ul"},"3b9a2a7c3 CaseFormatLambda has been added, params for Rest-assured client has been refactored (#91)"),Object(n.b)("li",{parentName:"ul"},"488910362 Set parameters allowableValues dynamically (#65)"),Object(n.b)("li",{parentName:"ul"},'2821f18b9 Meta: set version for "build-helper-maven-plugin" (#89)'),Object(n.b)("li",{parentName:"ul"},"82d9e935e Add CORS configuration to openapi-generator-online (#71)"),Object(n.b)("li",{parentName:"ul"},"e3814f51d Improvements to online codegen (#55)"),Object(n.b)("li",{parentName:"ul"},"6b8079808 Consider minLength, maxLength and pattern in referenced schema (#45)"),Object(n.b)("li",{parentName:"ul"},"7c5dfbfa0 Minor improvements to OpenAPI Generator Online (#54)"),Object(n.b)("li",{parentName:"ul"},"8dd46a3fb Move online gen from jersey to spring boot (#44)"),Object(n.b)("li",{parentName:"ul"},"803821e21 Fix an issue with example generator when array is too large (#46)"),Object(n.b)("li",{parentName:"ul"},"673f2bc46 Add CodegenProperty.nameInSnakeCase  (#42)"),Object(n.b)("li",{parentName:"ul"},"67ebe17dd Fix isPrimitiveType flag for array of form parameters (#38)"),Object(n.b)("li",{parentName:"ul"},"10ac4024d Code clean-up: remove field declaration hiding existing fields (#35)"),Object(n.b)("li",{parentName:"ul"},"ab9c4b5a6 Code clean-up: Add own private static final LOGGER in each class (#26)"),Object(n.b)("li",{parentName:"ul"},"41b0ff351 Code clean-up: remove DefaultCodegen#getSimpleRef(String) (#19)"),Object(n.b)("li",{parentName:"ul"},"13f084e7b Fix dataTypeWithEnum for array of form parameters"),Object(n.b)("li",{parentName:"ul"},"fd3b883e8 ","[","DefaultCodegen] Fill CodegenOperation::produces with unique media types"),Object(n.b)("li",{parentName:"ul"},"db9a899a0 update getSchemaType variable, remove unused import"),Object(n.b)("li",{parentName:"ul"},"d74b4cdf8 fix map type and collection format for form parameter (array)"),Object(n.b)("li",{parentName:"ul"},"d99f46cff Revise how to obtain the example value"),Object(n.b)("li",{parentName:"ul"},"b1eac05b2 Fix form datatype (array of string)"),Object(n.b)("li",{parentName:"ul"},"3c666a6d4 Fix array of form parameters"),Object(n.b)("li",{parentName:"ul"},"1492df6ce Override server port for Jetty configuration"),Object(n.b)("li",{parentName:"ul"},"622a75b2c Fix data type shadowing"),Object(n.b)("li",{parentName:"ul"},"861d11d01 use vendor extension in operation to set the body parameter name"),Object(n.b)("li",{parentName:"ul"},"80c8b92cb add postProcessParameter for body, form parameter"),Object(n.b)("li",{parentName:"ul"},"7fe555a51 Set collectionFormat default only for array"),Object(n.b)("li",{parentName:"ul"},"16589de97 default collection format to csv according to the spec"),Object(n.b)("li",{parentName:"ul"},"edbe4902a Consider '$ref' for consumes and produces in CodegenOperation"),Object(n.b)("li",{parentName:"ul"},"e24238a35 Improve getter name handling for boolean properties"),Object(n.b)("li",{parentName:"ul"},"6e2ca294b update discriminator to discriminatorName"),Object(n.b)("li",{parentName:"ul"},"74075c087 Primitive datatype in Schema components"),Object(n.b)("li",{parentName:"ul"},"d8abd4a14 support map in body parameter"),Object(n.b)("li",{parentName:"ul"},"186594115 Update swagger-core to 2.0.1"),Object(n.b)("li",{parentName:"ul"},"2034f61e5 Add HideGenerationTimestamp getter and setter in the CodegenConfig interface"),Object(n.b)("li",{parentName:"ul"},"d0e2d7684 Getter and Setter for hideGenerationTimestamp"),Object(n.b)("li",{parentName:"ul"},"adbde2fb6 replace fromOperation with postProcessOperations"),Object(n.b)("li",{parentName:"ul"},"9d1ae0dd2 fix bigdecimal in default codegen"),Object(n.b)("li",{parentName:"ul"},"ffa0e115d fix default value and type declaration"),Object(n.b)("li",{parentName:"ul"},"0e744adb8 Apply collection format to SIMPLE enum style"),Object(n.b)("li",{parentName:"ul"},"36ed29852 Tweak tests according to the parameter order changes"),Object(n.b)("li",{parentName:"ul"},"17b082793 Move 'enum_query_double' to parameters section"),Object(n.b)("li",{parentName:"ul"},"28fcf48f4 Add a method returns discriminator name"),Object(n.b)("li",{parentName:"ul"},"7daa2ec5d Fix broken discriminator"),Object(n.b)("li",{parentName:"ul"},"faa901640 Replace with the helper function: ",Object(n.b)("inlineCode",{parentName:"li"},"getTypeDeclaration")),Object(n.b)("li",{parentName:"ul"},"c8650d0e3 Make optional properties in models optional parameters"),Object(n.b)("li",{parentName:"ul"},"40c30dd2f Fix inputSpec for multi module builds"),Object(n.b)("li",{parentName:"ul"},"5326152cc add option to reorder form/body parameter"),Object(n.b)("li",{parentName:"ul"},"d1850091a Improve JMeter Template"),Object(n.b)("li",{parentName:"ul"},"fedfb0cda Factorize addOption/addSwitch method"),Object(n.b)("li",{parentName:"ul"},"e73eeb4fd fix for stripping prefix on single enums"),Object(n.b)("li",{parentName:"ul"},"13e3db59e Add operationIdOriginal to store the original operationId"),Object(n.b)("li",{parentName:"ul"},"0b2d80569 Expose getter/setter for serverPort to facilitate testing"),Object(n.b)("li",{parentName:"ul"},"8e270f465 add vendorExtensions field in CodegenSecurity class"),Object(n.b)("li",{parentName:"ul"},"1ee85de94 Added Intelli J ignore"),Object(n.b)("li",{parentName:"ul"},"7b8e409cf Added gitignore generation function")))}m.isMDXComponent=!0},312:function(e,a,t){"use strict";t.d(a,"a",(function(){return o})),t.d(a,"b",(function(){return j}));var r=t(0),b=t.n(r);function n(e,a,t){return a in e?Object.defineProperty(e,a,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[a]=t,e}function i(e,a){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);a&&(r=r.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),t.push.apply(t,r)}return t}function l(e){for(var a=1;a<arguments.length;a++){var t=null!=arguments[a]?arguments[a]:{};a%2?i(Object(t),!0).forEach((function(a){n(e,a,t[a])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):i(Object(t)).forEach((function(a){Object.defineProperty(e,a,Object.getOwnPropertyDescriptor(t,a))}))}return e}function p(e,a){if(null==e)return{};var t,r,b=function(e,a){if(null==e)return{};var t,r,b={},n=Object.keys(e);for(r=0;r<n.length;r++)t=n[r],a.indexOf(t)>=0||(b[t]=e[t]);return b}(e,a);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r<n.length;r++)t=n[r],a.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(b[t]=e[t])}return b}var c=b.a.createContext({}),m=function(e){var a=b.a.useContext(c),t=a;return e&&(t="function"==typeof e?e(a):l({},a,{},e)),t},o=function(e){var a=m(e.components);return b.a.createElement(c.Provider,{value:a},e.children)},d={inlineCode:"code",wrapper:function(e){var a=e.children;return b.a.createElement(b.a.Fragment,{},a)}},s=Object(r.forwardRef)((function(e,a){var t=e.components,r=e.mdxType,n=e.originalType,i=e.parentName,c=p(e,["components","mdxType","originalType","parentName"]),o=m(t),s=r,j=o["".concat(i,".").concat(s)]||o[s]||d[s]||n;return t?b.a.createElement(j,l({ref:a},c,{components:t})):b.a.createElement(j,l({ref:a},c))}));function j(e,a){var t=arguments,r=a&&a.mdxType;if("string"==typeof e||r){var n=t.length,i=new Array(n);i[0]=s;var l={};for(var p in a)hasOwnProperty.call(a,p)&&(l[p]=a[p]);l.originalType=e,l.mdxType="string"==typeof e?e:r,i[1]=l;for(var c=2;c<n;c++)i[c]=t[c];return b.a.createElement.apply(null,i)}return b.a.createElement.apply(null,t)}s.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/f1d7b915.ae502643.js b/f1d7b915.ae502643.js
new file mode 100644
index 00000000000..8bd2c66d636
--- /dev/null
+++ b/f1d7b915.ae502643.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[172],{296:function(e,a,t){"use strict";t.r(a),t.d(a,"frontMatter",(function(){return i})),t.d(a,"metadata",(function(){return l})),t.d(a,"rightToc",(function(){return p})),t.d(a,"default",(function(){return m}));var r=t(1),b=t(9),n=(t(0),t(312)),i={id:"release-3-0-0",title:"Release Notes: 3.0.0",sidebar_label:"Release Notes: 3.0.0"},l={id:"release-3-0-0",title:"Release Notes: 3.0.0",description:"* ## Docker",source:"@site/../docs/3.0.0-release-note.md",permalink:"/docs/release-3-0-0",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/3.0.0-release-note.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar_label:"Release Notes: 3.0.0",sidebar:"docs",previous:{title:"Release Summary",permalink:"/docs/release-summary"},next:{title:"Generators List",permalink:"/docs/generators"}},p=[],c={rightToc:p};function m(e){var a=e.components,t=Object(b.a)(e,["components"]);return Object(n.b)("wrapper",Object(r.a)({},c,t,{components:a,mdxType:"MDXLayout"}),Object(n.b)("ul",null,Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"docker"}),"Docker")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7dfd94002 Docker: use correct MAVEN_CONFIG (#182)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b5a0d173d Revise the usage of OpenAPI Generator online (docker image) (#73)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e58dc2c77 Fix COPY in Dockerfile (#64)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9d7feaaeb Fix online generator (docker push) (#58)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9247cd01e Changes for Docker")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"64037ee59 update docker-related files to ues jdk8")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"plug-ins"}),"Plug-ins")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b6b8c0db8 ","[","gradle-plugin] Initial implementation (#162)  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0a28aad73 ","[","MAVEN PLUGIN] Checking for null configOptions before looking for property")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9c79297d6 ","[","MAVEN PLUGIN] Use latest version in dependencies snippet")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9e1bbe0c1 Add maven wrapper")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"api-clients"}),"API Clients")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"ada"}),"Ada")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"edf6be8c0 ","[","Ada] bug fix by defining x-is-model-type when property is local to the YML file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9ba74f484 ","[","Ada] Fix GNAT project and server skeleton to avoid sending a response when an error is returned")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ea27924f5 ","[","Ada] changed default project/package name, to solve circular dependencies")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6b9d38d40 remove trailing spaces in ada template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0de7f972f Fix the Ada server skeleton to check the authsMethods in the Shared_Instance generic package")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4bd8fc6e8 Fix 7511: ","[","Ada] Client call is not correct with multiple parameters and application/x-www-urlencoded")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3035bc629 ","[","Ada] Hotfix/ada model sort")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'43f0e8692 Ada code generator corrected: "=>" instead of "->".  ')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7d2b49085 ","[","Ada] wrong order for generated structures in models.ads files")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2b2b85eec ","[","Ada] wrong JSON in POST operations")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c"}),"C#")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0e34bcf4e ","[","csharp] ctor params should always be camelCase")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"872471996 ","[","csharp] Support arrays of arrays for properties and models")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1c4e6b7d4 ","[","csharp] Fix ToJson to work with composition and polymorphism")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ed7af73f6 ","[","csharp] Reference this.Configuration in client API template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c-1"}),"C++")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e796e4c36 ","[","C++] Add linux as a reserve keyword")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"36f69a034 remove trailing spaces in qt5 c++ templates")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f192613f1 fix string type in c++ generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"409015461 fix file type in qt5cpp")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a4bcb3bc7 fix datetime and map type for qt5cpp")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"23b31aba8 ","[","qt5cpp] Fix crash when API return a map container")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3b031ed2b ","[","qt5cpp] delete callback data allocated before signal emission")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1bb1e44d1 ","[","qt5cpp] Remove qt5 pro.user file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"194722015 Qt5cpp plug memleaks part2")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"12f3661d6 Qt5cpp plug memleaks")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ea4b94842 ","[","qt5cpp] Add nullptr guard to prevent crash when empty model is being serialized")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0bf430a80 Qt5cpp Add support for nested containers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0b3ec6b1f fix NPE with cpp qt5, add logic to avoid NPE with composed schema")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7c734445b fix file parameter in header file (cpprest)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"070b5c00b fix object type declaration in cpprest")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bad1885b4 ","[","cpprest] add parameterToString for number type with unspecified format (double)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"73bd24db7 ","[","cpprest] Add support for nested vectors")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ee2eb74f7 ","[","qt] update Qt client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d82499944 Adding qt project generation fix")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9bd94b4db ","[","qt] Fix warning message")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"clojure"}),"Clojure")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d7e374504 ","[","Clojure] Add util method to set the api-context globally (#93)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"dart"}),"Dart")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f1638a659 ","[","Dart] Allow setting an accessToken for OAuth")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a5e26a44f ","[","Dart] - Rework Dart client generator to be flutter-compatible")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"elixir"}),"Elixir")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f9b2839a3 ","[","Elixir] Check date value before calling to_iso8601")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"elm"}),"Elm")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5a87fe695 ","[","elm] Fix operations with empty responses (#171)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a5cf27b60 Fix Petstore example for Elm (#96)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c522927d5 Fix Elm generator for polymorphism (#78)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7d9fb9f51 Add CI test for Elm in travis (#40)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"769a65c95 ","[","Elm] Add support for array schemas")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"56a0268e3 ","[","elm] missing '->' in Main elm template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"erlang"}),"Erlang")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c73118524 ","[","erlang-client] Erlang request utils")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"049eef9c5 Test erlang client, server petstore")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bcc7b788e fix erlang client compilation error")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"go"}),"Go")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"acb63fd5e Fix go readme, remove resty install")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5d8362d85 Update go client, fix double body read")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"47614bb76 Properly capitalize exported go types")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ee561fcd6 Add withXml option for Go language")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0f6696089 ","[","Go] Use consistent indentation in readme  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"72abb20f2 ","[","Go] Fix operation files clobbering model files. ","[","2.4.0]")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"haskell"}),"Haskell")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"34db79b9b ","[","haskell-http-client] update dependency versions + readme (#81)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e45b3784f Fix NPE with Haskell client generator with OAS3 spec")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d3401396f ","[","haskell-http-client] remove duplicates in produces/consumes; fix pathParam paramName issue")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4bc99b9da minor fixes to haskell http client generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2d0bafb6b ","[","haskell-http-client] default InlineMimeTypes=true")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9fba9c325 ","[","haskell-http-client] add config options: cabalPackage, cabalVersion, baseModule, requestType, configType")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"kotlin"}),"Kotlin")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a3322fbf7 ","[","kotlin] Add OkHttpClient.Builder to ApiClient.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3c5fb1d80 ","[","kotlin] Add json annotation to each enum value.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"39fa375e3 ","[","kotlin] Fix NPE for POST/PUT/PATCH with empty request models.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c599906f1 Kotlin: Correct data_class.mustache to use proper property for inner enum data type")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c69925b53 ","[","Kotlin] Fix issues with threetenbp  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a811a48c3 minor fix to kotlin client generator due to merge conflict")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"914275fe7 ","[","kotlin] support selection of datelibrary")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a61d23265 Fixed incorrect renaming of header and query param to camel cases for Kotlin Client template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"lua"}),"Lua")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"dbe78e23e ","[","Lua] Improve auto-generated test files")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6c79052ac Add auto-generated Lua spec files for APIs, models")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"38a2c1dde ","[","Lua] Fix Rockpec")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a2410b210 Add auto-generated rockspec file to Lua API client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"df10c725a Add lua test script, minor fix to Lua API files")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"java"}),"Java")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2e69e6c03 build.gradle should not have commas")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1a4e5a4e5 Java client: Add constants for libraries (#163)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7db0201a8 Fix NPEs in Java generator (#154)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4d7ff8cfb JavaDoc fixes for Java/RESTEasy client (#151)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"072ce070b resteasy: fix outer enum case (#139)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ccd002966 ","[","Java] rest-assured: fix javadoc in templates")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e7410d4c8 Allow $ in java var name")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"03490e923 Fix Java binary mapping")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"70b4b55fa Fix performance linting problem with maps in Java ApiClient template")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"cddcda0fe ","[","Java]","[Jersey2]"," Make generated client code thread safe")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"298ca8d35 use correct jackson date library when using Java 8")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"53eeb0c04 ","[","Java] fix connection leak on retrofit OAuth token renewal")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"61c25e711 ","[","Java] Fixes for retrofit")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f02332755 ","[","JAVA] 4709: codegen with parcelableMode fails to build if using arrays in swagger.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4eeb974cb ","[","Java]","[google-api-client]"," Fix bug with empty POST request not sending content-type")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d4543a99e ","[","Java]","[retrofit2]"," file upload sets filename as baseName instead of a dynamic filename")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"62a930223 ","[","JAVA]","[Rest-assured]"," reqSpec() method has been added into api.mustache for requests custom\u2026")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"fec0363f7 ","[","Java] Add back byte array enhancement")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"59ff4c198 ","[","Java]","[library: vertx]"," Add default value and required parameter support to vertx server temp\u2026")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3bd2da9a8 ","[","Java] Fix build warnings")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"429b96ae7 ","[","JAVA] equals and hashCode for models with byte[] and binary strings")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"495971c2c ","[","Java] use html entities in javadoc of generated code (#106)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"82ee8656f ","[","java] Enum in array of array (#66)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bf7e4e7df Java gson: add @SerializedName value as constant  (#22)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"30c1448d7 Fix build.gradle for Java RESTEasy client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"642c0566d ","[","Java] Use Rx2 Completable for Void Retrofit2 responses")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"72221b1cf Adding @Deprecated to retrofit2 client interfaces.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"47111b324 ","[","Java] fix gson deserialize format byte")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9e06f7063 ","[","Java] Fix assignment of new object instance to variable")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"006f084b5 ","[","Java] Allow to set values with setApiPackage(..) and setModelPackage(..)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"javascriptnodejs"}),"JavaScript/NodeJS")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d80e29585 Fix JS test using baseName in default value (#5)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"fe15f4690 fix toDefaultValueWithParam in JS")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"90859575e Fixing variable name typo (instane -> instance)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"objective-c"}),"Objective-C")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9fb2c29a4 7644 objc deprecated afnetworking datataskwithrequest")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5d1874028 add class as a keyword in objc generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"1b8df5c20 Update ObjcClientCodegen.java")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"246ed5754 restore objc reserved word: property")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"php"}),"PHP")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3beeb4e77 ","[","PHP] Not-required properties now shows as nullable (#129)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"37df59d6f ","[","PHP] Adjust the names (script, sample folder, generator) to lang option (#159)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4a5d16b23 ","[","PHP] Fix string length validation")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d58835e57 ","[","PHP] Improve: Make validation strict")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"cf8d8d56f ","[","PHP] Fix code example from README. Variable name was missing when using Basic auth.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0adbf7e51 ","[","PHP] Improve: update sample tests automatically")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"32cf2f16f ","[","PHP] Non required enum property")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3bcf0ff76 ","[","PHP] Add path & file separator (/) to return the correct path when deserializing a file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"14e1e1980 ","[","PHP] Improve validation on empty arrays")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"809e1f4c9 ","[","PHP] Cleanup tests")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"76907cacd ","[","PHP] declare property headerSelector")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"python"}),"Python")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7184f1ec6 ","[","python] asyncio supports _preload_content; remove unused imports (#107)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d74d2ba03 fix: python clients")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"8e0a0ebd6 Fix python / tornado body handling")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b39c35c76 Fix inconsistency between model name and file name in python client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"dfbef4374 Fixed unicode error and supported allow_nonstandard_methods in tornado based python client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f6e0e297e ","[","python-asyncio] tests and fixes")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"r"}),"R")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"61e58d649 Add R namespace file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"ruby"}),"Ruby")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a08164592 fix ruby parameters in documentation, fix requiredParams, optionalParams")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"8e34f9a98 update to newer version of ruby")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"aa6b217bb ","[","Ruby] Add auto-generated rubocop config file")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"rust"}),"Rust")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b44357394 ","[","Rust] Implement minimal auth support")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"0b845a57e ","[","Rust] Changes hard coded body to dynamic parameter name -  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a3c97753f ","[","Rust] Handles UUID as string")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"027df610b ","[","Rust] Handle error response statuses")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"66be7a791 ","[","Rust] Add user agent handling for rust template (master)  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3029b7b0f ","[","Rust] Format example with rustfmt")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"scala"}),"Scala")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"197b4481e normalize akka-scala and Java README")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"612cfb7af ","[","Akka-scala] Clean unused dependencies such swagger-core")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"86697fedb ","[","Scala]","[Gatling]"," correct body params filename")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"832919b84 ","[","Scala]","[Akka]"," Remove unused dep when model package is empty")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"swift"}),"Swift")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"40d5d0990 ","[","Swift4] accept empty content with default client")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3b7230b17 ","[","Swift 4] Fix APIHelper to accept array parameter")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e22faf4cd ","[","Swift] Add public initializer for modelObject.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b184fb1d9 ","[","Swift3] escape URL parameters")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"52f606b8d Fix Swift3 test cases and add pom.xml, travis config for iOS test")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a3d0f1d4b Swift4: make generated models structs instead of classes")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"typescript"}),"TypeScript")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f615d823f update ts node dependencies")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9ac9bc0dc ","[","TypeScript] enhance ts import")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"009dcf009 Mark ",Object(n.b)("inlineCode",{parentName:"p"},"not required")," swagger properties as optional typescript properties")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bdd2c2a4e Misc typescript Angular code generation improvements")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"260375c9e Fix typescript-node generation of array type models")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d1933b5fc Fix a problem in the generation of typescript-jquery when we have enum in a query param")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"20305139b ","[","Feature]","[TypeScript]"," request param enum as literal unions")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"524f162e6 Use supportsES6 flag in ts compilation for language typescript-angular")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9b8602311 ","[","TypeScript] Make OpenAPI Generator serialize subclasses properly (#102)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4bc5ffe86 ","[","typescript-angular] add provided in support (#120)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ef832e715 ","[","Feature]","[TS Angular]"," improve docs angular import")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"fc7e08346 ","[","TS]","[Fetch]"," Add interfaces option")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"157e6b7fa ","[","angular] Add option to generate tagged unions")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7faaa091c Fix generated module imports in Aurelia APIs")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b5f0b24ba ","[","TS] fix object declaration in model")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"api-servers"}),"API Servers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c-2"}),"C++")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6fef0a7ff fix string issue with restbed generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"a339422bd move get type declaration method to c++ restbed")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"c-3"}),"C#")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d9d653016 ","[","aspnetcore] Make the use of Swashbuckle optional (#110)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9a8183ab0 ","[","aspnetcore] Fix openapi.json location rename (#56)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"12abfb968 ","[","aspnetcore] Update Dockerfile")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"866817587 ","[","aspnetcore] Fix string enum generation")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"java-1"}),"Java")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"bd50d368e ","[","JAVA - jaxrs-resteasy-eap] Add import to models (#179)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7efda597c Fix issue with useBeanValidation option in Java server generators (#160)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"71b5de3ed Do not set contextPath for spring-boot (#104)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"b73ab0260 jaxrs-cxf-cdi: fix outer enum (#131)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"4d7fc046f ","[",'JaxRS] Add "validation-api" dependency in jetty (#30)')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ce930e7a6 ","[","Jaxrs-cxf] Add bean-level cascaded beanvalidation for pojos (@Valid)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'386b9f432 Modify "postProcessOperations" for "jaxrs-cxf-client"  ')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5d92717dc update jaxrs to listen at port 10080")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7c2031675 update artifact id for jaxrs datelib j8")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"88c5112f2 Adds support for returning response in jaxrs-spec interfaces")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6bf84d5fa ","[","JAXRS-SPEC] Fix lowercase enums sent as uppercase")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'3a1922bc9 Fix version for "spring-boot-maven-plugin" (#85)')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"161948657 Add reactive option for Spring Boot (webflux)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"ff1178ad7 ","[","Java]","[Spring]"," fix missing optional query params")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2103fadab Fix package declaration for play-framework")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"2c6380c84 fix inner item (list, map) for play framework")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e33b350c8 Fix an issue in Play Framework generator where a CSV is empty and transferred to the controllerImp with an empty item.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"99fc27246 ","[","JAX-RS]","[Spec]"," Removes throws Exception.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},'fe2a44339 Fixes issue  (SpringCodeGen dateLibrary "java8-localdatetime" option is ignored).')),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d890d733f ","[","JaxRS]","[Java]"," issue with implFolder on windows, and required fields generation for containers (#88)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"c91ce17ae Feature/javaPlayWithAsynchronousControllers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"f00a1ef52 ","[","JAVA] Correct consumes/produces attributes for Spring Controllers")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d14318cf2 ","[","JAVA]","[Spring]"," Optional params with delegate")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"3f81378d7 ","[","java resteasy] fix string comparison (#134)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"5ea3d3bb1 ","[","JAX-RS]","[SPEC]"," Bug fix that prevents generating interfaces when interfaceOnly is false.")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"kotlin-1"}),"Kotlin")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"7cad47dd3 ","[","kotlin-server] --library=ktor (barebones implementation)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"752b36e66 ","[","Kotlin] Sanitize enumeration name to add underscore when it starts with digits (#77)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"nodejs"}),"NodeJS")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6d88d073c ","[","NodeJS] make serverPort configurable via CLI option")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"e7f4fb3c4 Fix nodejs-server path issue in windows platform")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"php-1"}),"PHP")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d30fcbabb Fixes for php-ze-ph generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"60e3339aa ","[","Feature]","[PHP]"," Update for ze-ph generator")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"python-1"}),"Python")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"62b93fc5c ","[","Python]","[Flask]"," Handles UUID format -  ")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"9999eac52 fix python flask parameter naming")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"scala-1"}),"Scala")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"d5c355a59 ","[","Scalatra] Updated the version of Scalatra to the latest (2.6.2)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"52322c47c ","[","finch] Allow finch server to compile for CI checks (#7)")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"ruby-1"}),"Ruby")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"dcad9ae80 ","[","Rails5] make version of the generated Rails stub server to strict Rails 5.0")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h3",Object(r.a)({parentName:"li"},{id:"rust-1"}),"Rust")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"37faaf926 ","[","rust-server] API version constant and composite version support")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"6c7813e79 ","[","rust-server] asynchronous support via hyper v0.11")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"documentation"}),"Documentation")),Object(n.b)("li",{parentName:"ul"},Object(n.b)("p",{parentName:"li"},"25a6a9d44 html: fix typo in class name  "))),Object(n.b)("ul",null,Object(n.b)("li",{parentName:"ul"},Object(n.b)("h2",Object(r.a)({parentName:"li"},{id:"miscellaneous"}),"Miscellaneous")),Object(n.b)("li",{parentName:"ul"},"f04213285 Cli error message improvements (#172)"),Object(n.b)("li",{parentName:"ul"},"0ece706a4 Remove CodegenConfig.fromModel(String, Schema) method (#90)"),Object(n.b)("li",{parentName:"ul"},"64f2bea37 Fix getReferenced...() methods in ModelUtils (#157)"),Object(n.b)("li",{parentName:"ul"},"16ff5174e Update swagger-parser to 2.0.1 (#123)"),Object(n.b)("li",{parentName:"ul"},"76b7307a6 DefaultGenerator: ignore only form param schemas (#74)"),Object(n.b)("li",{parentName:"ul"},"a3aabd390 Create a default implementation of delegate if none could be autowired (#92)"),Object(n.b)("li",{parentName:"ul"},"ca89af808 Switch to Java 8"),Object(n.b)("li",{parentName:"ul"},"27426f7b5 Cli generator name option, replaces 'language' options in CLI and Maven Plugin (#57)"),Object(n.b)("li",{parentName:"ul"},"a1ff50241 Rename datatype to dataType in CodegenProperty (#69)"),Object(n.b)("li",{parentName:"ul"},"3b9a2a7c3 CaseFormatLambda has been added, params for Rest-assured client has been refactored (#91)"),Object(n.b)("li",{parentName:"ul"},"488910362 Set parameters allowableValues dynamically (#65)"),Object(n.b)("li",{parentName:"ul"},'2821f18b9 Meta: set version for "build-helper-maven-plugin" (#89)'),Object(n.b)("li",{parentName:"ul"},"82d9e935e Add CORS configuration to openapi-generator-online (#71)"),Object(n.b)("li",{parentName:"ul"},"e3814f51d Improvements to online codegen (#55)"),Object(n.b)("li",{parentName:"ul"},"6b8079808 Consider minLength, maxLength and pattern in referenced schema (#45)"),Object(n.b)("li",{parentName:"ul"},"7c5dfbfa0 Minor improvements to OpenAPI Generator Online (#54)"),Object(n.b)("li",{parentName:"ul"},"8dd46a3fb Move online gen from jersey to spring boot (#44)"),Object(n.b)("li",{parentName:"ul"},"803821e21 Fix an issue with example generator when array is too large (#46)"),Object(n.b)("li",{parentName:"ul"},"673f2bc46 Add CodegenProperty.nameInSnakeCase  (#42)"),Object(n.b)("li",{parentName:"ul"},"67ebe17dd Fix isPrimitiveType flag for array of form parameters (#38)"),Object(n.b)("li",{parentName:"ul"},"10ac4024d Code clean-up: remove field declaration hiding existing fields (#35)"),Object(n.b)("li",{parentName:"ul"},"ab9c4b5a6 Code clean-up: Add own private static final LOGGER in each class (#26)"),Object(n.b)("li",{parentName:"ul"},"41b0ff351 Code clean-up: remove DefaultCodegen#getSimpleRef(String) (#19)"),Object(n.b)("li",{parentName:"ul"},"13f084e7b Fix dataTypeWithEnum for array of form parameters"),Object(n.b)("li",{parentName:"ul"},"fd3b883e8 ","[","DefaultCodegen] Fill CodegenOperation::produces with unique media types"),Object(n.b)("li",{parentName:"ul"},"db9a899a0 update getSchemaType variable, remove unused import"),Object(n.b)("li",{parentName:"ul"},"d74b4cdf8 fix map type and collection format for form parameter (array)"),Object(n.b)("li",{parentName:"ul"},"d99f46cff Revise how to obtain the example value"),Object(n.b)("li",{parentName:"ul"},"b1eac05b2 Fix form datatype (array of string)"),Object(n.b)("li",{parentName:"ul"},"3c666a6d4 Fix array of form parameters"),Object(n.b)("li",{parentName:"ul"},"1492df6ce Override server port for Jetty configuration"),Object(n.b)("li",{parentName:"ul"},"622a75b2c Fix data type shadowing"),Object(n.b)("li",{parentName:"ul"},"861d11d01 use vendor extension in operation to set the body parameter name"),Object(n.b)("li",{parentName:"ul"},"80c8b92cb add postProcessParameter for body, form parameter"),Object(n.b)("li",{parentName:"ul"},"7fe555a51 Set collectionFormat default only for array"),Object(n.b)("li",{parentName:"ul"},"16589de97 default collection format to csv according to the spec"),Object(n.b)("li",{parentName:"ul"},"edbe4902a Consider '$ref' for consumes and produces in CodegenOperation"),Object(n.b)("li",{parentName:"ul"},"e24238a35 Improve getter name handling for boolean properties"),Object(n.b)("li",{parentName:"ul"},"6e2ca294b update discriminator to discriminatorName"),Object(n.b)("li",{parentName:"ul"},"74075c087 Primitive datatype in Schema components"),Object(n.b)("li",{parentName:"ul"},"d8abd4a14 support map in body parameter"),Object(n.b)("li",{parentName:"ul"},"186594115 Update swagger-core to 2.0.1"),Object(n.b)("li",{parentName:"ul"},"2034f61e5 Add HideGenerationTimestamp getter and setter in the CodegenConfig interface"),Object(n.b)("li",{parentName:"ul"},"d0e2d7684 Getter and Setter for hideGenerationTimestamp"),Object(n.b)("li",{parentName:"ul"},"adbde2fb6 replace fromOperation with postProcessOperations"),Object(n.b)("li",{parentName:"ul"},"9d1ae0dd2 fix bigdecimal in default codegen"),Object(n.b)("li",{parentName:"ul"},"ffa0e115d fix default value and type declaration"),Object(n.b)("li",{parentName:"ul"},"0e744adb8 Apply collection format to SIMPLE enum style"),Object(n.b)("li",{parentName:"ul"},"36ed29852 Tweak tests according to the parameter order changes"),Object(n.b)("li",{parentName:"ul"},"17b082793 Move 'enum_query_double' to parameters section"),Object(n.b)("li",{parentName:"ul"},"28fcf48f4 Add a method returns discriminator name"),Object(n.b)("li",{parentName:"ul"},"7daa2ec5d Fix broken discriminator"),Object(n.b)("li",{parentName:"ul"},"faa901640 Replace with the helper function: ",Object(n.b)("inlineCode",{parentName:"li"},"getTypeDeclaration")),Object(n.b)("li",{parentName:"ul"},"c8650d0e3 Make optional properties in models optional parameters"),Object(n.b)("li",{parentName:"ul"},"40c30dd2f Fix inputSpec for multi module builds"),Object(n.b)("li",{parentName:"ul"},"5326152cc add option to reorder form/body parameter"),Object(n.b)("li",{parentName:"ul"},"d1850091a Improve JMeter Template"),Object(n.b)("li",{parentName:"ul"},"fedfb0cda Factorize addOption/addSwitch method"),Object(n.b)("li",{parentName:"ul"},"e73eeb4fd fix for stripping prefix on single enums"),Object(n.b)("li",{parentName:"ul"},"13e3db59e Add operationIdOriginal to store the original operationId"),Object(n.b)("li",{parentName:"ul"},"0b2d80569 Expose getter/setter for serverPort to facilitate testing"),Object(n.b)("li",{parentName:"ul"},"8e270f465 add vendorExtensions field in CodegenSecurity class"),Object(n.b)("li",{parentName:"ul"},"1ee85de94 Added Intelli J ignore"),Object(n.b)("li",{parentName:"ul"},"7b8e409cf Added gitignore generation function")))}m.isMDXComponent=!0},312:function(e,a,t){"use strict";t.d(a,"a",(function(){return o})),t.d(a,"b",(function(){return j}));var r=t(0),b=t.n(r);function n(e,a,t){return a in e?Object.defineProperty(e,a,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[a]=t,e}function i(e,a){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);a&&(r=r.filter((function(a){return Object.getOwnPropertyDescriptor(e,a).enumerable}))),t.push.apply(t,r)}return t}function l(e){for(var a=1;a<arguments.length;a++){var t=null!=arguments[a]?arguments[a]:{};a%2?i(Object(t),!0).forEach((function(a){n(e,a,t[a])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):i(Object(t)).forEach((function(a){Object.defineProperty(e,a,Object.getOwnPropertyDescriptor(t,a))}))}return e}function p(e,a){if(null==e)return{};var t,r,b=function(e,a){if(null==e)return{};var t,r,b={},n=Object.keys(e);for(r=0;r<n.length;r++)t=n[r],a.indexOf(t)>=0||(b[t]=e[t]);return b}(e,a);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(r=0;r<n.length;r++)t=n[r],a.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(b[t]=e[t])}return b}var c=b.a.createContext({}),m=function(e){var a=b.a.useContext(c),t=a;return e&&(t="function"==typeof e?e(a):l({},a,{},e)),t},o=function(e){var a=m(e.components);return b.a.createElement(c.Provider,{value:a},e.children)},d={inlineCode:"code",wrapper:function(e){var a=e.children;return b.a.createElement(b.a.Fragment,{},a)}},s=Object(r.forwardRef)((function(e,a){var t=e.components,r=e.mdxType,n=e.originalType,i=e.parentName,c=p(e,["components","mdxType","originalType","parentName"]),o=m(t),s=r,j=o["".concat(i,".").concat(s)]||o[s]||d[s]||n;return t?b.a.createElement(j,l({ref:a},c,{components:t})):b.a.createElement(j,l({ref:a},c))}));function j(e,a){var t=arguments,r=a&&a.mdxType;if("string"==typeof e||r){var n=t.length,i=new Array(n);i[0]=s;var l={};for(var p in a)hasOwnProperty.call(a,p)&&(l[p]=a[p]);l.originalType=e,l.mdxType="string"==typeof e?e:r,i[1]=l;for(var c=2;c<n;c++)i[c]=t[c];return b.a.createElement.apply(null,i)}return b.a.createElement.apply(null,t)}s.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/f70cb32f.2f523636.js b/f70cb32f.2f523636.js
new file mode 100644
index 00000000000..8b0650f5554
--- /dev/null
+++ b/f70cb32f.2f523636.js
@@ -0,0 +1 @@
+(window.webpackJsonp=window.webpackJsonp||[]).push([[176],{300:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return a})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return p}));var r=n(1),i=n(9),o=(n(0),n(312)),a={id:"code-of-conduct",title:"Code of Conduct"},c={id:"code-of-conduct",title:"Code of Conduct",description:"## Our Pledge",source:"@site/../docs/conduct.md",permalink:"/docs/code-of-conduct",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/conduct.md",lastUpdatedBy:"Peter Leibiger",lastUpdatedAt:1649555635,sidebar:"docs",previous:{title:"Guidelines For Contributing",permalink:"/docs/contributing"},next:{title:"Building the code",permalink:"/docs/contribute-building"}},l=[{value:"Our Pledge",id:"our-pledge",children:[]},{value:"Our Standards",id:"our-standards",children:[]},{value:"Our Responsibilities",id:"our-responsibilities",children:[]},{value:"Scope",id:"scope",children:[]},{value:"Enforcement",id:"enforcement",children:[]},{value:"Attribution",id:"attribution",children:[]}],s={rightToc:l};function p(e){var t=e.components,n=Object(i.a)(e,["components"]);return Object(o.b)("wrapper",Object(r.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(o.b)("h2",{id:"our-pledge"},"Our Pledge"),Object(o.b)("p",null,"In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation."),Object(o.b)("h2",{id:"our-standards"},"Our Standards"),Object(o.b)("p",null,"Examples of behavior that contributes to creating a positive environment include:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"Using welcoming and inclusive language"),Object(o.b)("li",{parentName:"ul"},"Being respectful of differing viewpoints and experiences"),Object(o.b)("li",{parentName:"ul"},"Gracefully accepting constructive criticism"),Object(o.b)("li",{parentName:"ul"},"Focusing on what is best for the community"),Object(o.b)("li",{parentName:"ul"},"Showing empathy towards other community members")),Object(o.b)("p",null,"Examples of unacceptable behavior by participants include:"),Object(o.b)("ul",null,Object(o.b)("li",{parentName:"ul"},"The use of sexualized language or imagery and unwelcome sexual attention or advances"),Object(o.b)("li",{parentName:"ul"},"Trolling, insulting/derogatory comments, and personal or political attacks"),Object(o.b)("li",{parentName:"ul"},"Public or private harassment"),Object(o.b)("li",{parentName:"ul"},"Publishing others' private information, such as a physical or electronic address, without explicit permission"),Object(o.b)("li",{parentName:"ul"},"Other conduct which could reasonably be considered inappropriate in a professional setting")),Object(o.b)("h2",{id:"our-responsibilities"},"Our Responsibilities"),Object(o.b)("p",null,"Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior."),Object(o.b)("p",null,"Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful."),Object(o.b)("h2",{id:"scope"},"Scope"),Object(o.b)("p",null,"This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers."),Object(o.b)("h2",{id:"enforcement"},"Enforcement"),Object(o.b)("p",null,"Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at team@openapitools.org. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately."),Object(o.b)("p",null,"Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership."),Object(o.b)("h2",{id:"attribution"},"Attribution"),Object(o.b)("p",null,"This Code of Conduct is adapted from the ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"http://contributor-covenant.org"}),"Contributor Covenant"),", version 1.4, available at ",Object(o.b)("a",Object(r.a)({parentName:"p"},{href:"http://contributor-covenant.org/version/1/4/"}),"http://contributor-covenant.org/version/1/4")))}p.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return m}));var r=n(0),i=n.n(r);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){o(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,i=function(e,t){if(null==e)return{};var n,r,i={},o=Object.keys(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)n=o[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var s=i.a.createContext({}),p=function(e){var t=i.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},u=function(e){var t=p(e.components);return i.a.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return i.a.createElement(i.a.Fragment,{},t)}},b=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,a=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),u=p(n),b=r,m=u["".concat(a,".").concat(b)]||u[b]||d[b]||o;return n?i.a.createElement(m,c({ref:t},s,{components:n})):i.a.createElement(m,c({ref:t},s))}));function m(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,a=new Array(o);a[0]=b;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:r,a[1]=c;for(var s=2;s<o;s++)a[s]=n[s];return i.a.createElement.apply(null,a)}return i.a.createElement.apply(null,n)}b.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/f70cb32f.e3324f4c.js b/f70cb32f.e3324f4c.js
deleted file mode 100644
index b75b4c7811c..00000000000
--- a/f70cb32f.e3324f4c.js
+++ /dev/null
@@ -1 +0,0 @@
-(window.webpackJsonp=window.webpackJsonp||[]).push([[176],{300:function(e,t,n){"use strict";n.r(t),n.d(t,"frontMatter",(function(){return a})),n.d(t,"metadata",(function(){return c})),n.d(t,"rightToc",(function(){return l})),n.d(t,"default",(function(){return p}));var r=n(1),o=n(9),i=(n(0),n(312)),a={id:"code-of-conduct",title:"Code of Conduct"},c={id:"code-of-conduct",title:"Code of Conduct",description:"## Our Pledge",source:"@site/../docs/conduct.md",permalink:"/docs/code-of-conduct",editUrl:"https://github.com/OpenAPITools/openapi-generator/edit/master/website/../docs/conduct.md",lastUpdatedBy:"Josh Burton",lastUpdatedAt:1649468142,sidebar:"docs",previous:{title:"Guidelines For Contributing",permalink:"/docs/contributing"},next:{title:"Building the code",permalink:"/docs/contribute-building"}},l=[{value:"Our Pledge",id:"our-pledge",children:[]},{value:"Our Standards",id:"our-standards",children:[]},{value:"Our Responsibilities",id:"our-responsibilities",children:[]},{value:"Scope",id:"scope",children:[]},{value:"Enforcement",id:"enforcement",children:[]},{value:"Attribution",id:"attribution",children:[]}],s={rightToc:l};function p(e){var t=e.components,n=Object(o.a)(e,["components"]);return Object(i.b)("wrapper",Object(r.a)({},s,n,{components:t,mdxType:"MDXLayout"}),Object(i.b)("h2",{id:"our-pledge"},"Our Pledge"),Object(i.b)("p",null,"In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation."),Object(i.b)("h2",{id:"our-standards"},"Our Standards"),Object(i.b)("p",null,"Examples of behavior that contributes to creating a positive environment include:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"Using welcoming and inclusive language"),Object(i.b)("li",{parentName:"ul"},"Being respectful of differing viewpoints and experiences"),Object(i.b)("li",{parentName:"ul"},"Gracefully accepting constructive criticism"),Object(i.b)("li",{parentName:"ul"},"Focusing on what is best for the community"),Object(i.b)("li",{parentName:"ul"},"Showing empathy towards other community members")),Object(i.b)("p",null,"Examples of unacceptable behavior by participants include:"),Object(i.b)("ul",null,Object(i.b)("li",{parentName:"ul"},"The use of sexualized language or imagery and unwelcome sexual attention or advances"),Object(i.b)("li",{parentName:"ul"},"Trolling, insulting/derogatory comments, and personal or political attacks"),Object(i.b)("li",{parentName:"ul"},"Public or private harassment"),Object(i.b)("li",{parentName:"ul"},"Publishing others' private information, such as a physical or electronic address, without explicit permission"),Object(i.b)("li",{parentName:"ul"},"Other conduct which could reasonably be considered inappropriate in a professional setting")),Object(i.b)("h2",{id:"our-responsibilities"},"Our Responsibilities"),Object(i.b)("p",null,"Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior."),Object(i.b)("p",null,"Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful."),Object(i.b)("h2",{id:"scope"},"Scope"),Object(i.b)("p",null,"This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers."),Object(i.b)("h2",{id:"enforcement"},"Enforcement"),Object(i.b)("p",null,"Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at team@openapitools.org. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately."),Object(i.b)("p",null,"Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership."),Object(i.b)("h2",{id:"attribution"},"Attribution"),Object(i.b)("p",null,"This Code of Conduct is adapted from the ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"http://contributor-covenant.org"}),"Contributor Covenant"),", version 1.4, available at ",Object(i.b)("a",Object(r.a)({parentName:"p"},{href:"http://contributor-covenant.org/version/1/4/"}),"http://contributor-covenant.org/version/1/4")))}p.isMDXComponent=!0},312:function(e,t,n){"use strict";n.d(t,"a",(function(){return u})),n.d(t,"b",(function(){return m}));var r=n(0),o=n.n(r);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function a(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function c(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?a(Object(n),!0).forEach((function(t){i(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):a(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function l(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n,r,o={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var s=o.a.createContext({}),p=function(e){var t=o.a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):c({},t,{},e)),n},u=function(e){var t=p(e.components);return o.a.createElement(s.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return o.a.createElement(o.a.Fragment,{},t)}},b=Object(r.forwardRef)((function(e,t){var n=e.components,r=e.mdxType,i=e.originalType,a=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),u=p(n),b=r,m=u["".concat(a,".").concat(b)]||u[b]||d[b]||i;return n?o.a.createElement(m,c({ref:t},s,{components:n})):o.a.createElement(m,c({ref:t},s))}));function m(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=n.length,a=new Array(i);a[0]=b;var c={};for(var l in t)hasOwnProperty.call(t,l)&&(c[l]=t[l]);c.originalType=e,c.mdxType="string"==typeof e?e:r,a[1]=c;for(var s=2;s<i;s++)a[s]=n[s];return o.a.createElement.apply(null,a)}return o.a.createElement.apply(null,n)}b.displayName="MDXCreateElement"}}]);
\ No newline at end of file
diff --git a/index.html b/index.html
index 062f3ed1b49..01300485c2f 100644
--- a/index.html
+++ b/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/runtime~main.0aa9274f.js b/runtime~main.1cdf5172.js
similarity index 89%
rename from runtime~main.0aa9274f.js
rename to runtime~main.1cdf5172.js
index 875e377bd71..f2dce495b5d 100644
--- a/runtime~main.0aa9274f.js
+++ b/runtime~main.1cdf5172.js
@@ -1 +1 @@
-!function(e){function f(f){for(var d,a,r=f[0],n=f[1],o=f[2],u=0,i=[];u<r.length;u++)a=r[u],Object.prototype.hasOwnProperty.call(b,a)&&b[a]&&i.push(b[a][0]),b[a]=0;for(d in n)Object.prototype.hasOwnProperty.call(n,d)&&(e[d]=n[d]);for(l&&l(f);i.length;)i.shift()();return t.push.apply(t,o||[]),c()}function c(){for(var e,f=0;f<t.length;f++){for(var c=t[f],d=!0,a=1;a<c.length;a++){var r=c[a];0!==b[r]&&(d=!1)}d&&(t.splice(f--,1),e=n(n.s=c[0]))}return e}var d={},a={184:0},b={184:0},t=[];function r(e){return n.p+""+({4:"00163030",5:"013f42ef",6:"0196741a",7:"0358ea4a",8:"03abeb31",9:"03b044fb",10:"065a8d55",11:"06d5d70a",12:"088716a6",13:"0978a33a",14:"09ccb289",15:"0cae4475",16:"10211c0a",17:"1131f29a",18:"13187f39",19:"133e23d9",20:"1444fc1b",21:"1777f326",22:"17896441",23:"1a02600c",24:"1be78505",25:"1dba9094",26:"1fc4ffdf",27:"209b41dc",28:"20ac7829",29:"21936a93",30:"22cafcd3",31:"25cfb3f3",32:"2606bf23",33:"294e02c4",34:"2af05231",35:"2b0b4d70",36:"2b362a87",37:"2bbf879d",38:"2c087a87",39:"2c08d080",40:"2cdde719",41:"2f840b51",42:"30674823",43:"32e37b42",44:"33f8468c",45:"342fbc7e",46:"369d3d94",47:"397fa735",48:"3ac458cf",49:"3d70cde6",50:"4086254d",51:"47462ed9",52:"482f7566",53:"4b45c44c",54:"4b8333e5",55:"4c5ebba5",56:"4e9e65dc",57:"4fd0afdf",58:"50799408",59:"50bbcf89",60:"5446bf9c",61:"5f7cf4b7",62:"61aaf4b5",63:"6664be73",64:"6b573900",65:"6c98f389",66:"6d0633c8",67:"6db4087d",68:"712b85c0",69:"726258db",70:"72e09efa",71:"773b7ddf",72:"7755c98f",73:"77aecd65",74:"781ad36b",75:"782001b8",76:"7a0eaed6",77:"7e0f18f4",78:"7eeb204a",79:"838bab07",80:"858d8181",81:"859cc09f",82:"8926c06f",83:"8b743bdd",84:"8b77bac1",85:"8c015133",86:"8c0a1edc",87:"8e2963ef",88:"912fe03d",89:"92c3ba78",90:"935c1f16",91:"93f4d3a6",92:"94fb9a13",93:"96fb2cf3",94:"9972b359",95:"9aa688bb",96:"9b517c7f",97:"9cbcc25e",98:"9cccaf3a",99:"9cee5900",100:"9cf894bb",101:"9d9ec3e3",102:"9e1c1430",103:"9e229734",104:"9e443e3b",105:"a1dcf46f",106:"a2b71ef9",107:"a361f4e3",108:"a43f9649",109:"a598bb04",110:"a5c65c7b",111:"a5fabd44",112:"a6aa9e1f",113:"a85ef2bb",114:"a8834710",115:"a8f86885",116:"a97f53bd",117:"a9f38005",118:"ac312d55",119:"ac8b7f2e",120:"acbe0809",121:"algolia",122:"b26e5421",123:"b2b85c76",124:"b3764198",125:"b505ee9d",126:"b6a32428",127:"b8dda33a",128:"b9cf024a",129:"baaf877f",130:"bbb4ffb5",131:"bd7019e0",132:"bdaab79f",133:"be2eb782",134:"be5da56a",135:"c0a62421",136:"c4f5d8e4",137:"c5da328a",138:"c601bd32",139:"c698896a",140:"c70d243d",141:"cc2f38e0",142:"cc8e85bd",143:"ccc49370",144:"cda7cfb0",145:"cf67c7b0",146:"d14a9d06",147:"d43f6e1a",148:"d7e2094c",149:"d924db8b",150:"d9b8b8b3",151:"da5134d7",152:"da796f38",153:"dc895aaf",154:"dd058668",155:"de9a7b5a",156:"dea345ca",157:"defa8226",158:"df7ab5c6",159:"e0ce3759",160:"e0f8f6f1",161:"e3035694",162:"e360e27f",163:"e3d432cb",164:"e5ad4e18",165:"e9ea91ed",166:"ea9ce23f",167:"eab5709a",168:"ecfe08ed",169:"ed13c9fe",170:"ed46ee25",171:"f131602e",172:"f1d7b915",173:"f3069005",174:"f594f170",175:"f6c9e83f",176:"f70cb32f",177:"f8c929ff",178:"f9fb43b6",179:"fa0d1b31",180:"fa2528e9",181:"fa668fca",182:"fba73214"}[e]||e)+"."+{1:"279fb529",2:"81c7fc62",3:"4a9fbfcc",4:"34ba4610",5:"582d370a",6:"a12e2c95",7:"319c66aa",8:"8a0f7431",9:"d1bc766c",10:"8f0aabe0",11:"d7daddda",12:"095a8dec",13:"792bf4ef",14:"26fa41a8",15:"982252e5",16:"240a2561",17:"d9e2c364",18:"43c0d161",19:"9fe1937d",20:"3092f638",21:"6442d35a",22:"c3776424",23:"579c2295",24:"ce8a5db8",25:"d7ef43a1",26:"299688c7",27:"ef56ba62",28:"25126d58",29:"11baa6d5",30:"47db2275",31:"37746880",32:"0b1512ee",33:"d72191fa",34:"2fb2f555",35:"c5aa142e",36:"b905cd27",37:"75ffa3a9",38:"08cb999a",39:"3ad118c8",40:"4a172fe6",41:"23e33bd5",42:"25f52794",43:"217f744a",44:"d8688d9d",45:"50d7b074",46:"66ab72b9",47:"6d4dd557",48:"2d928750",49:"b291aef1",50:"8909f898",51:"6f9c0f5b",52:"dbddbe55",53:"c2fd3a3b",54:"8957de64",55:"3d84a160",56:"acfc4155",57:"de3edcb7",58:"1a184cf8",59:"2bb03a38",60:"3bf64572",61:"97dacab2",62:"60664722",63:"ab2b79a5",64:"6ff09d71",65:"9ed7e66a",66:"e3d13c8b",67:"0d3d744a",68:"f22d63d8",69:"7a6414e5",70:"d9ac40ee",71:"efe0e210",72:"170ec0e8",73:"b2a489eb",74:"7d09c6f9",75:"0ed78374",76:"19c44313",77:"c518d350",78:"287f1ae6",79:"e5a68e27",80:"c45d4e37",81:"90565206",82:"437f0e08",83:"823aa36f",84:"87050d3f",85:"1c20b5f9",86:"8d616964",87:"134de6cf",88:"5abc8bcb",89:"5a9d101c",90:"ef6dd895",91:"6b7a183f",92:"e9854188",93:"e7049fd7",94:"7aeeee44",95:"3b1c2f5a",96:"faf51264",97:"e906fc50",98:"fbff7b00",99:"d3539a0c",100:"db9f7d2a",101:"51da6e88",102:"a0376943",103:"110e984d",104:"91b409da",105:"71e9be7e",106:"950f9e85",107:"c26d7f97",108:"d71af5de",109:"dd902c6a",110:"1aff2bac",111:"c0e5ac87",112:"b5160615",113:"f31ed285",114:"9001c074",115:"6d88373a",116:"368e6498",117:"d401ace8",118:"894fad0f",119:"2ce29d45",120:"77f5b58e",121:"6f6edb2d",122:"191fba67",123:"bd868f62",124:"e9fa5b8e",125:"c58f9154",126:"1b40b8d9",127:"a976af02",128:"e9ed5ba5",129:"3e93ce23",130:"0e6954f0",131:"8c73583d",132:"1ff1951f",133:"a296a629",134:"4b5575fc",135:"7ce12847",136:"3dc84ee2",137:"a539114d",138:"e4110366",139:"52a366f2",140:"e5cf0a87",141:"118bac35",142:"fbe53461",143:"fa656dd2",144:"030cf100",145:"983797a8",146:"61be5b45",147:"eeda92c9",148:"08dc82f0",149:"233caba6",150:"e0b8f5ee",151:"6d299e19",152:"7ab6f256",153:"f5e9dc70",154:"be7b6e55",155:"b20453c4",156:"d8d9e77b",157:"2cbd1ad7",158:"b6b994bf",159:"5753d83a",160:"2e48233a",161:"092213fb",162:"5bb331e6",163:"c0a83b29",164:"16573d73",165:"da3a704c",166:"f7055620",167:"2966ff62",168:"facb9733",169:"e5eca4b2",170:"8b1da7cf",171:"a0e6d0ae",172:"1ac91f23",173:"b3b989f5",174:"1a6131d6",175:"0e8b52d8",176:"e3324f4c",177:"79f59412",178:"069e7977",179:"d53a4e7d",180:"185e3462",181:"bc62a8b7",182:"238a44c7",185:"ccd78957",186:"ec909b2e"}[e]+".js"}function n(f){if(d[f])return d[f].exports;var c=d[f]={i:f,l:!1,exports:{}};return e[f].call(c.exports,c,c.exports,n),c.l=!0,c.exports}n.e=function(e){var f=[];a[e]?f.push(a[e]):0!==a[e]&&{121:1}[e]&&f.push(a[e]=new Promise((function(f,c){for(var d=({4:"00163030",5:"013f42ef",6:"0196741a",7:"0358ea4a",8:"03abeb31",9:"03b044fb",10:"065a8d55",11:"06d5d70a",12:"088716a6",13:"0978a33a",14:"09ccb289",15:"0cae4475",16:"10211c0a",17:"1131f29a",18:"13187f39",19:"133e23d9",20:"1444fc1b",21:"1777f326",22:"17896441",23:"1a02600c",24:"1be78505",25:"1dba9094",26:"1fc4ffdf",27:"209b41dc",28:"20ac7829",29:"21936a93",30:"22cafcd3",31:"25cfb3f3",32:"2606bf23",33:"294e02c4",34:"2af05231",35:"2b0b4d70",36:"2b362a87",37:"2bbf879d",38:"2c087a87",39:"2c08d080",40:"2cdde719",41:"2f840b51",42:"30674823",43:"32e37b42",44:"33f8468c",45:"342fbc7e",46:"369d3d94",47:"397fa735",48:"3ac458cf",49:"3d70cde6",50:"4086254d",51:"47462ed9",52:"482f7566",53:"4b45c44c",54:"4b8333e5",55:"4c5ebba5",56:"4e9e65dc",57:"4fd0afdf",58:"50799408",59:"50bbcf89",60:"5446bf9c",61:"5f7cf4b7",62:"61aaf4b5",63:"6664be73",64:"6b573900",65:"6c98f389",66:"6d0633c8",67:"6db4087d",68:"712b85c0",69:"726258db",70:"72e09efa",71:"773b7ddf",72:"7755c98f",73:"77aecd65",74:"781ad36b",75:"782001b8",76:"7a0eaed6",77:"7e0f18f4",78:"7eeb204a",79:"838bab07",80:"858d8181",81:"859cc09f",82:"8926c06f",83:"8b743bdd",84:"8b77bac1",85:"8c015133",86:"8c0a1edc",87:"8e2963ef",88:"912fe03d",89:"92c3ba78",90:"935c1f16",91:"93f4d3a6",92:"94fb9a13",93:"96fb2cf3",94:"9972b359",95:"9aa688bb",96:"9b517c7f",97:"9cbcc25e",98:"9cccaf3a",99:"9cee5900",100:"9cf894bb",101:"9d9ec3e3",102:"9e1c1430",103:"9e229734",104:"9e443e3b",105:"a1dcf46f",106:"a2b71ef9",107:"a361f4e3",108:"a43f9649",109:"a598bb04",110:"a5c65c7b",111:"a5fabd44",112:"a6aa9e1f",113:"a85ef2bb",114:"a8834710",115:"a8f86885",116:"a97f53bd",117:"a9f38005",118:"ac312d55",119:"ac8b7f2e",120:"acbe0809",121:"algolia",122:"b26e5421",123:"b2b85c76",124:"b3764198",125:"b505ee9d",126:"b6a32428",127:"b8dda33a",128:"b9cf024a",129:"baaf877f",130:"bbb4ffb5",131:"bd7019e0",132:"bdaab79f",133:"be2eb782",134:"be5da56a",135:"c0a62421",136:"c4f5d8e4",137:"c5da328a",138:"c601bd32",139:"c698896a",140:"c70d243d",141:"cc2f38e0",142:"cc8e85bd",143:"ccc49370",144:"cda7cfb0",145:"cf67c7b0",146:"d14a9d06",147:"d43f6e1a",148:"d7e2094c",149:"d924db8b",150:"d9b8b8b3",151:"da5134d7",152:"da796f38",153:"dc895aaf",154:"dd058668",155:"de9a7b5a",156:"dea345ca",157:"defa8226",158:"df7ab5c6",159:"e0ce3759",160:"e0f8f6f1",161:"e3035694",162:"e360e27f",163:"e3d432cb",164:"e5ad4e18",165:"e9ea91ed",166:"ea9ce23f",167:"eab5709a",168:"ecfe08ed",169:"ed13c9fe",170:"ed46ee25",171:"f131602e",172:"f1d7b915",173:"f3069005",174:"f594f170",175:"f6c9e83f",176:"f70cb32f",177:"f8c929ff",178:"f9fb43b6",179:"fa0d1b31",180:"fa2528e9",181:"fa668fca",182:"fba73214"}[e]||e)+"."+{1:"31d6cfe0",2:"31d6cfe0",3:"31d6cfe0",4:"31d6cfe0",5:"31d6cfe0",6:"31d6cfe0",7:"31d6cfe0",8:"31d6cfe0",9:"31d6cfe0",10:"31d6cfe0",11:"31d6cfe0",12:"31d6cfe0",13:"31d6cfe0",14:"31d6cfe0",15:"31d6cfe0",16:"31d6cfe0",17:"31d6cfe0",18:"31d6cfe0",19:"31d6cfe0",20:"31d6cfe0",21:"31d6cfe0",22:"31d6cfe0",23:"31d6cfe0",24:"31d6cfe0",25:"31d6cfe0",26:"31d6cfe0",27:"31d6cfe0",28:"31d6cfe0",29:"31d6cfe0",30:"31d6cfe0",31:"31d6cfe0",32:"31d6cfe0",33:"31d6cfe0",34:"31d6cfe0",35:"31d6cfe0",36:"31d6cfe0",37:"31d6cfe0",38:"31d6cfe0",39:"31d6cfe0",40:"31d6cfe0",41:"31d6cfe0",42:"31d6cfe0",43:"31d6cfe0",44:"31d6cfe0",45:"31d6cfe0",46:"31d6cfe0",47:"31d6cfe0",48:"31d6cfe0",49:"31d6cfe0",50:"31d6cfe0",51:"31d6cfe0",52:"31d6cfe0",53:"31d6cfe0",54:"31d6cfe0",55:"31d6cfe0",56:"31d6cfe0",57:"31d6cfe0",58:"31d6cfe0",59:"31d6cfe0",60:"31d6cfe0",61:"31d6cfe0",62:"31d6cfe0",63:"31d6cfe0",64:"31d6cfe0",65:"31d6cfe0",66:"31d6cfe0",67:"31d6cfe0",68:"31d6cfe0",69:"31d6cfe0",70:"31d6cfe0",71:"31d6cfe0",72:"31d6cfe0",73:"31d6cfe0",74:"31d6cfe0",75:"31d6cfe0",76:"31d6cfe0",77:"31d6cfe0",78:"31d6cfe0",79:"31d6cfe0",80:"31d6cfe0",81:"31d6cfe0",82:"31d6cfe0",83:"31d6cfe0",84:"31d6cfe0",85:"31d6cfe0",86:"31d6cfe0",87:"31d6cfe0",88:"31d6cfe0",89:"31d6cfe0",90:"31d6cfe0",91:"31d6cfe0",92:"31d6cfe0",93:"31d6cfe0",94:"31d6cfe0",95:"31d6cfe0",96:"31d6cfe0",97:"31d6cfe0",98:"31d6cfe0",99:"31d6cfe0",100:"31d6cfe0",101:"31d6cfe0",102:"31d6cfe0",103:"31d6cfe0",104:"31d6cfe0",105:"31d6cfe0",106:"31d6cfe0",107:"31d6cfe0",108:"31d6cfe0",109:"31d6cfe0",110:"31d6cfe0",111:"31d6cfe0",112:"31d6cfe0",113:"31d6cfe0",114:"31d6cfe0",115:"31d6cfe0",116:"31d6cfe0",117:"31d6cfe0",118:"31d6cfe0",119:"31d6cfe0",120:"31d6cfe0",121:"76fc5962",122:"31d6cfe0",123:"31d6cfe0",124:"31d6cfe0",125:"31d6cfe0",126:"31d6cfe0",127:"31d6cfe0",128:"31d6cfe0",129:"31d6cfe0",130:"31d6cfe0",131:"31d6cfe0",132:"31d6cfe0",133:"31d6cfe0",134:"31d6cfe0",135:"31d6cfe0",136:"31d6cfe0",137:"31d6cfe0",138:"31d6cfe0",139:"31d6cfe0",140:"31d6cfe0",141:"31d6cfe0",142:"31d6cfe0",143:"31d6cfe0",144:"31d6cfe0",145:"31d6cfe0",146:"31d6cfe0",147:"31d6cfe0",148:"31d6cfe0",149:"31d6cfe0",150:"31d6cfe0",151:"31d6cfe0",152:"31d6cfe0",153:"31d6cfe0",154:"31d6cfe0",155:"31d6cfe0",156:"31d6cfe0",157:"31d6cfe0",158:"31d6cfe0",159:"31d6cfe0",160:"31d6cfe0",161:"31d6cfe0",162:"31d6cfe0",163:"31d6cfe0",164:"31d6cfe0",165:"31d6cfe0",166:"31d6cfe0",167:"31d6cfe0",168:"31d6cfe0",169:"31d6cfe0",170:"31d6cfe0",171:"31d6cfe0",172:"31d6cfe0",173:"31d6cfe0",174:"31d6cfe0",175:"31d6cfe0",176:"31d6cfe0",177:"31d6cfe0",178:"31d6cfe0",179:"31d6cfe0",180:"31d6cfe0",181:"31d6cfe0",182:"31d6cfe0",185:"31d6cfe0",186:"31d6cfe0"}[e]+".css",b=n.p+d,t=document.getElementsByTagName("link"),r=0;r<t.length;r++){var o=(i=t[r]).getAttribute("data-href")||i.getAttribute("href");if("stylesheet"===i.rel&&(o===d||o===b))return f()}var u=document.getElementsByTagName("style");for(r=0;r<u.length;r++){var i;if((o=(i=u[r]).getAttribute("data-href"))===d||o===b)return f()}var l=document.createElement("link");l.rel="stylesheet",l.type="text/css",l.onload=f,l.onerror=function(f){var d=f&&f.target&&f.target.src||b,t=new Error("Loading CSS chunk "+e+" failed.\n("+d+")");t.code="CSS_CHUNK_LOAD_FAILED",t.request=d,delete a[e],l.parentNode.removeChild(l),c(t)},l.href=b,document.getElementsByTagName("head")[0].appendChild(l)})).then((function(){a[e]=0})));var c=b[e];if(0!==c)if(c)f.push(c[2]);else{var d=new Promise((function(f,d){c=b[e]=[f,d]}));f.push(c[2]=d);var t,o=document.createElement("script");o.charset="utf-8",o.timeout=120,n.nc&&o.setAttribute("nonce",n.nc),o.src=r(e);var u=new Error;t=function(f){o.onerror=o.onload=null,clearTimeout(i);var c=b[e];if(0!==c){if(c){var d=f&&("load"===f.type?"missing":f.type),a=f&&f.target&&f.target.src;u.message="Loading chunk "+e+" failed.\n("+d+": "+a+")",u.name="ChunkLoadError",u.type=d,u.request=a,c[1](u)}b[e]=void 0}};var i=setTimeout((function(){t({type:"timeout",target:o})}),12e4);o.onerror=o.onload=t,document.head.appendChild(o)}return Promise.all(f)},n.m=e,n.c=d,n.d=function(e,f,c){n.o(e,f)||Object.defineProperty(e,f,{enumerable:!0,get:c})},n.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},n.t=function(e,f){if(1&f&&(e=n(e)),8&f)return e;if(4&f&&"object"==typeof e&&e&&e.__esModule)return e;var c=Object.create(null);if(n.r(c),Object.defineProperty(c,"default",{enumerable:!0,value:e}),2&f&&"string"!=typeof e)for(var d in e)n.d(c,d,function(f){return e[f]}.bind(null,d));return c},n.n=function(e){var f=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(f,"a",f),f},n.o=function(e,f){return Object.prototype.hasOwnProperty.call(e,f)},n.p="/",n.gca=function(e){return r(e={17896441:"22",30674823:"42",50799408:"58","00163030":"4","013f42ef":"5","0196741a":"6","0358ea4a":"7","03abeb31":"8","03b044fb":"9","065a8d55":"10","06d5d70a":"11","088716a6":"12","0978a33a":"13","09ccb289":"14","0cae4475":"15","10211c0a":"16","1131f29a":"17","13187f39":"18","133e23d9":"19","1444fc1b":"20","1777f326":"21","1a02600c":"23","1be78505":"24","1dba9094":"25","1fc4ffdf":"26","209b41dc":"27","20ac7829":"28","21936a93":"29","22cafcd3":"30","25cfb3f3":"31","2606bf23":"32","294e02c4":"33","2af05231":"34","2b0b4d70":"35","2b362a87":"36","2bbf879d":"37","2c087a87":"38","2c08d080":"39","2cdde719":"40","2f840b51":"41","32e37b42":"43","33f8468c":"44","342fbc7e":"45","369d3d94":"46","397fa735":"47","3ac458cf":"48","3d70cde6":"49","4086254d":"50","47462ed9":"51","482f7566":"52","4b45c44c":"53","4b8333e5":"54","4c5ebba5":"55","4e9e65dc":"56","4fd0afdf":"57","50bbcf89":"59","5446bf9c":"60","5f7cf4b7":"61","61aaf4b5":"62","6664be73":"63","6b573900":"64","6c98f389":"65","6d0633c8":"66","6db4087d":"67","712b85c0":"68","726258db":"69","72e09efa":"70","773b7ddf":"71","7755c98f":"72","77aecd65":"73","781ad36b":"74","782001b8":"75","7a0eaed6":"76","7e0f18f4":"77","7eeb204a":"78","838bab07":"79","858d8181":"80","859cc09f":"81","8926c06f":"82","8b743bdd":"83","8b77bac1":"84","8c015133":"85","8c0a1edc":"86","8e2963ef":"87","912fe03d":"88","92c3ba78":"89","935c1f16":"90","93f4d3a6":"91","94fb9a13":"92","96fb2cf3":"93","9972b359":"94","9aa688bb":"95","9b517c7f":"96","9cbcc25e":"97","9cccaf3a":"98","9cee5900":"99","9cf894bb":"100","9d9ec3e3":"101","9e1c1430":"102","9e229734":"103","9e443e3b":"104",a1dcf46f:"105",a2b71ef9:"106",a361f4e3:"107",a43f9649:"108",a598bb04:"109",a5c65c7b:"110",a5fabd44:"111",a6aa9e1f:"112",a85ef2bb:"113",a8834710:"114",a8f86885:"115",a97f53bd:"116",a9f38005:"117",ac312d55:"118",ac8b7f2e:"119",acbe0809:"120",algolia:"121",b26e5421:"122",b2b85c76:"123",b3764198:"124",b505ee9d:"125",b6a32428:"126",b8dda33a:"127",b9cf024a:"128",baaf877f:"129",bbb4ffb5:"130",bd7019e0:"131",bdaab79f:"132",be2eb782:"133",be5da56a:"134",c0a62421:"135",c4f5d8e4:"136",c5da328a:"137",c601bd32:"138",c698896a:"139",c70d243d:"140",cc2f38e0:"141",cc8e85bd:"142",ccc49370:"143",cda7cfb0:"144",cf67c7b0:"145",d14a9d06:"146",d43f6e1a:"147",d7e2094c:"148",d924db8b:"149",d9b8b8b3:"150",da5134d7:"151",da796f38:"152",dc895aaf:"153",dd058668:"154",de9a7b5a:"155",dea345ca:"156",defa8226:"157",df7ab5c6:"158",e0ce3759:"159",e0f8f6f1:"160",e3035694:"161",e360e27f:"162",e3d432cb:"163",e5ad4e18:"164",e9ea91ed:"165",ea9ce23f:"166",eab5709a:"167",ecfe08ed:"168",ed13c9fe:"169",ed46ee25:"170",f131602e:"171",f1d7b915:"172",f3069005:"173",f594f170:"174",f6c9e83f:"175",f70cb32f:"176",f8c929ff:"177",f9fb43b6:"178",fa0d1b31:"179",fa2528e9:"180",fa668fca:"181",fba73214:"182"}[e]||e)},n.oe=function(e){throw console.error(e),e};var o=window.webpackJsonp=window.webpackJsonp||[],u=o.push.bind(o);o.push=f,o=o.slice();for(var i=0;i<o.length;i++)f(o[i]);var l=u;c()}([]);
\ No newline at end of file
+!function(e){function f(f){for(var d,a,r=f[0],n=f[1],o=f[2],u=0,i=[];u<r.length;u++)a=r[u],Object.prototype.hasOwnProperty.call(b,a)&&b[a]&&i.push(b[a][0]),b[a]=0;for(d in n)Object.prototype.hasOwnProperty.call(n,d)&&(e[d]=n[d]);for(l&&l(f);i.length;)i.shift()();return t.push.apply(t,o||[]),c()}function c(){for(var e,f=0;f<t.length;f++){for(var c=t[f],d=!0,a=1;a<c.length;a++){var r=c[a];0!==b[r]&&(d=!1)}d&&(t.splice(f--,1),e=n(n.s=c[0]))}return e}var d={},a={184:0},b={184:0},t=[];function r(e){return n.p+""+({4:"00163030",5:"013f42ef",6:"0196741a",7:"0358ea4a",8:"03abeb31",9:"03b044fb",10:"065a8d55",11:"06d5d70a",12:"088716a6",13:"0978a33a",14:"09ccb289",15:"0cae4475",16:"10211c0a",17:"1131f29a",18:"13187f39",19:"133e23d9",20:"1444fc1b",21:"1777f326",22:"17896441",23:"1a02600c",24:"1be78505",25:"1dba9094",26:"1fc4ffdf",27:"209b41dc",28:"20ac7829",29:"21936a93",30:"22cafcd3",31:"25cfb3f3",32:"2606bf23",33:"294e02c4",34:"2af05231",35:"2b0b4d70",36:"2b362a87",37:"2bbf879d",38:"2c087a87",39:"2c08d080",40:"2cdde719",41:"2f840b51",42:"30674823",43:"32e37b42",44:"33f8468c",45:"342fbc7e",46:"369d3d94",47:"397fa735",48:"3ac458cf",49:"3d70cde6",50:"4086254d",51:"47462ed9",52:"482f7566",53:"4b45c44c",54:"4b8333e5",55:"4c5ebba5",56:"4e9e65dc",57:"4fd0afdf",58:"50799408",59:"50bbcf89",60:"5446bf9c",61:"5f7cf4b7",62:"61aaf4b5",63:"6664be73",64:"6b573900",65:"6c98f389",66:"6d0633c8",67:"6db4087d",68:"712b85c0",69:"726258db",70:"72e09efa",71:"773b7ddf",72:"7755c98f",73:"77aecd65",74:"781ad36b",75:"782001b8",76:"7a0eaed6",77:"7e0f18f4",78:"7eeb204a",79:"838bab07",80:"858d8181",81:"859cc09f",82:"8926c06f",83:"8b743bdd",84:"8b77bac1",85:"8c015133",86:"8c0a1edc",87:"8e2963ef",88:"912fe03d",89:"92c3ba78",90:"935c1f16",91:"93f4d3a6",92:"94fb9a13",93:"96fb2cf3",94:"9972b359",95:"9aa688bb",96:"9b517c7f",97:"9cbcc25e",98:"9cccaf3a",99:"9cee5900",100:"9cf894bb",101:"9d9ec3e3",102:"9e1c1430",103:"9e229734",104:"9e443e3b",105:"a1dcf46f",106:"a2b71ef9",107:"a361f4e3",108:"a43f9649",109:"a598bb04",110:"a5c65c7b",111:"a5fabd44",112:"a6aa9e1f",113:"a85ef2bb",114:"a8834710",115:"a8f86885",116:"a97f53bd",117:"a9f38005",118:"ac312d55",119:"ac8b7f2e",120:"acbe0809",121:"algolia",122:"b26e5421",123:"b2b85c76",124:"b3764198",125:"b505ee9d",126:"b6a32428",127:"b8dda33a",128:"b9cf024a",129:"baaf877f",130:"bbb4ffb5",131:"bd7019e0",132:"bdaab79f",133:"be2eb782",134:"be5da56a",135:"c0a62421",136:"c4f5d8e4",137:"c5da328a",138:"c601bd32",139:"c698896a",140:"c70d243d",141:"cc2f38e0",142:"cc8e85bd",143:"ccc49370",144:"cda7cfb0",145:"cf67c7b0",146:"d14a9d06",147:"d43f6e1a",148:"d7e2094c",149:"d924db8b",150:"d9b8b8b3",151:"da5134d7",152:"da796f38",153:"dc895aaf",154:"dd058668",155:"de9a7b5a",156:"dea345ca",157:"defa8226",158:"df7ab5c6",159:"e0ce3759",160:"e0f8f6f1",161:"e3035694",162:"e360e27f",163:"e3d432cb",164:"e5ad4e18",165:"e9ea91ed",166:"ea9ce23f",167:"eab5709a",168:"ecfe08ed",169:"ed13c9fe",170:"ed46ee25",171:"f131602e",172:"f1d7b915",173:"f3069005",174:"f594f170",175:"f6c9e83f",176:"f70cb32f",177:"f8c929ff",178:"f9fb43b6",179:"fa0d1b31",180:"fa2528e9",181:"fa668fca",182:"fba73214"}[e]||e)+"."+{1:"279fb529",2:"81c7fc62",3:"4a9fbfcc",4:"34ba4610",5:"582d370a",6:"a12e2c95",7:"eb6d82ad",8:"b27e9b33",9:"d1bc766c",10:"8f0aabe0",11:"d7daddda",12:"095a8dec",13:"792bf4ef",14:"26fa41a8",15:"608d273a",16:"d66e8115",17:"d9e2c364",18:"43c0d161",19:"9fe1937d",20:"3092f638",21:"4e8d33e8",22:"c3776424",23:"579c2295",24:"ce8a5db8",25:"d7ef43a1",26:"299688c7",27:"ef56ba62",28:"25126d58",29:"11baa6d5",30:"47db2275",31:"37746880",32:"0b1512ee",33:"d72191fa",34:"2fb2f555",35:"c5aa142e",36:"b905cd27",37:"eaee5317",38:"08cb999a",39:"3ad118c8",40:"4a172fe6",41:"23e33bd5",42:"25f52794",43:"217f744a",44:"d8688d9d",45:"4475dc8f",46:"66ab72b9",47:"6d4dd557",48:"2d928750",49:"3e5453f3",50:"8909f898",51:"77c23de4",52:"dbddbe55",53:"c2fd3a3b",54:"8957de64",55:"3d84a160",56:"acfc4155",57:"de3edcb7",58:"1a184cf8",59:"2bb03a38",60:"3bf64572",61:"3b4dc9f4",62:"60664722",63:"ab2b79a5",64:"6ff09d71",65:"9ed7e66a",66:"e3d13c8b",67:"21fab80e",68:"f22d63d8",69:"c102ce0a",70:"d9ac40ee",71:"956b3208",72:"170ec0e8",73:"b2a489eb",74:"7d09c6f9",75:"0ed78374",76:"19c44313",77:"c518d350",78:"89e49b42",79:"4c814ca2",80:"c45d4e37",81:"90565206",82:"437f0e08",83:"823aa36f",84:"87050d3f",85:"1c20b5f9",86:"8d616964",87:"134de6cf",88:"cb2ebb32",89:"5a9d101c",90:"ef6dd895",91:"6b7a183f",92:"e9854188",93:"40226c94",94:"7aeeee44",95:"3b1c2f5a",96:"6c3050ec",97:"e39b6862",98:"fbff7b00",99:"d3539a0c",100:"db9f7d2a",101:"93741e5c",102:"a0376943",103:"110e984d",104:"91b409da",105:"71e9be7e",106:"950f9e85",107:"c26d7f97",108:"742d4b78",109:"dd902c6a",110:"e83132ce",111:"c0e5ac87",112:"b5160615",113:"f31ed285",114:"9001c074",115:"6d88373a",116:"368e6498",117:"d401ace8",118:"894fad0f",119:"73beb1ba",120:"77f5b58e",121:"6f6edb2d",122:"191fba67",123:"bd868f62",124:"e9fa5b8e",125:"c58f9154",126:"7992dd6c",127:"a976af02",128:"e9ed5ba5",129:"3e93ce23",130:"0e6954f0",131:"8c73583d",132:"01df211b",133:"a296a629",134:"4b5575fc",135:"7ce12847",136:"3dc84ee2",137:"a539114d",138:"e4110366",139:"52a366f2",140:"e5cf0a87",141:"118bac35",142:"fbe53461",143:"fa656dd2",144:"030cf100",145:"2531a3d1",146:"61be5b45",147:"eeda92c9",148:"08dc82f0",149:"233caba6",150:"bc7f414b",151:"e68f5ed7",152:"7ab6f256",153:"f5e9dc70",154:"be7b6e55",155:"b20453c4",156:"d8d9e77b",157:"2cbd1ad7",158:"8f17f2b9",159:"5753d83a",160:"2e48233a",161:"092213fb",162:"12407e7d",163:"c0a83b29",164:"16573d73",165:"da3a704c",166:"f7055620",167:"2966ff62",168:"b9e52a69",169:"e5eca4b2",170:"8b1da7cf",171:"a0e6d0ae",172:"ae502643",173:"b3b989f5",174:"1a6131d6",175:"0e8b52d8",176:"2f523636",177:"79f59412",178:"069e7977",179:"d53a4e7d",180:"185e3462",181:"bc62a8b7",182:"238a44c7",185:"ccd78957",186:"ec909b2e"}[e]+".js"}function n(f){if(d[f])return d[f].exports;var c=d[f]={i:f,l:!1,exports:{}};return e[f].call(c.exports,c,c.exports,n),c.l=!0,c.exports}n.e=function(e){var f=[];a[e]?f.push(a[e]):0!==a[e]&&{121:1}[e]&&f.push(a[e]=new Promise((function(f,c){for(var d=({4:"00163030",5:"013f42ef",6:"0196741a",7:"0358ea4a",8:"03abeb31",9:"03b044fb",10:"065a8d55",11:"06d5d70a",12:"088716a6",13:"0978a33a",14:"09ccb289",15:"0cae4475",16:"10211c0a",17:"1131f29a",18:"13187f39",19:"133e23d9",20:"1444fc1b",21:"1777f326",22:"17896441",23:"1a02600c",24:"1be78505",25:"1dba9094",26:"1fc4ffdf",27:"209b41dc",28:"20ac7829",29:"21936a93",30:"22cafcd3",31:"25cfb3f3",32:"2606bf23",33:"294e02c4",34:"2af05231",35:"2b0b4d70",36:"2b362a87",37:"2bbf879d",38:"2c087a87",39:"2c08d080",40:"2cdde719",41:"2f840b51",42:"30674823",43:"32e37b42",44:"33f8468c",45:"342fbc7e",46:"369d3d94",47:"397fa735",48:"3ac458cf",49:"3d70cde6",50:"4086254d",51:"47462ed9",52:"482f7566",53:"4b45c44c",54:"4b8333e5",55:"4c5ebba5",56:"4e9e65dc",57:"4fd0afdf",58:"50799408",59:"50bbcf89",60:"5446bf9c",61:"5f7cf4b7",62:"61aaf4b5",63:"6664be73",64:"6b573900",65:"6c98f389",66:"6d0633c8",67:"6db4087d",68:"712b85c0",69:"726258db",70:"72e09efa",71:"773b7ddf",72:"7755c98f",73:"77aecd65",74:"781ad36b",75:"782001b8",76:"7a0eaed6",77:"7e0f18f4",78:"7eeb204a",79:"838bab07",80:"858d8181",81:"859cc09f",82:"8926c06f",83:"8b743bdd",84:"8b77bac1",85:"8c015133",86:"8c0a1edc",87:"8e2963ef",88:"912fe03d",89:"92c3ba78",90:"935c1f16",91:"93f4d3a6",92:"94fb9a13",93:"96fb2cf3",94:"9972b359",95:"9aa688bb",96:"9b517c7f",97:"9cbcc25e",98:"9cccaf3a",99:"9cee5900",100:"9cf894bb",101:"9d9ec3e3",102:"9e1c1430",103:"9e229734",104:"9e443e3b",105:"a1dcf46f",106:"a2b71ef9",107:"a361f4e3",108:"a43f9649",109:"a598bb04",110:"a5c65c7b",111:"a5fabd44",112:"a6aa9e1f",113:"a85ef2bb",114:"a8834710",115:"a8f86885",116:"a97f53bd",117:"a9f38005",118:"ac312d55",119:"ac8b7f2e",120:"acbe0809",121:"algolia",122:"b26e5421",123:"b2b85c76",124:"b3764198",125:"b505ee9d",126:"b6a32428",127:"b8dda33a",128:"b9cf024a",129:"baaf877f",130:"bbb4ffb5",131:"bd7019e0",132:"bdaab79f",133:"be2eb782",134:"be5da56a",135:"c0a62421",136:"c4f5d8e4",137:"c5da328a",138:"c601bd32",139:"c698896a",140:"c70d243d",141:"cc2f38e0",142:"cc8e85bd",143:"ccc49370",144:"cda7cfb0",145:"cf67c7b0",146:"d14a9d06",147:"d43f6e1a",148:"d7e2094c",149:"d924db8b",150:"d9b8b8b3",151:"da5134d7",152:"da796f38",153:"dc895aaf",154:"dd058668",155:"de9a7b5a",156:"dea345ca",157:"defa8226",158:"df7ab5c6",159:"e0ce3759",160:"e0f8f6f1",161:"e3035694",162:"e360e27f",163:"e3d432cb",164:"e5ad4e18",165:"e9ea91ed",166:"ea9ce23f",167:"eab5709a",168:"ecfe08ed",169:"ed13c9fe",170:"ed46ee25",171:"f131602e",172:"f1d7b915",173:"f3069005",174:"f594f170",175:"f6c9e83f",176:"f70cb32f",177:"f8c929ff",178:"f9fb43b6",179:"fa0d1b31",180:"fa2528e9",181:"fa668fca",182:"fba73214"}[e]||e)+"."+{1:"31d6cfe0",2:"31d6cfe0",3:"31d6cfe0",4:"31d6cfe0",5:"31d6cfe0",6:"31d6cfe0",7:"31d6cfe0",8:"31d6cfe0",9:"31d6cfe0",10:"31d6cfe0",11:"31d6cfe0",12:"31d6cfe0",13:"31d6cfe0",14:"31d6cfe0",15:"31d6cfe0",16:"31d6cfe0",17:"31d6cfe0",18:"31d6cfe0",19:"31d6cfe0",20:"31d6cfe0",21:"31d6cfe0",22:"31d6cfe0",23:"31d6cfe0",24:"31d6cfe0",25:"31d6cfe0",26:"31d6cfe0",27:"31d6cfe0",28:"31d6cfe0",29:"31d6cfe0",30:"31d6cfe0",31:"31d6cfe0",32:"31d6cfe0",33:"31d6cfe0",34:"31d6cfe0",35:"31d6cfe0",36:"31d6cfe0",37:"31d6cfe0",38:"31d6cfe0",39:"31d6cfe0",40:"31d6cfe0",41:"31d6cfe0",42:"31d6cfe0",43:"31d6cfe0",44:"31d6cfe0",45:"31d6cfe0",46:"31d6cfe0",47:"31d6cfe0",48:"31d6cfe0",49:"31d6cfe0",50:"31d6cfe0",51:"31d6cfe0",52:"31d6cfe0",53:"31d6cfe0",54:"31d6cfe0",55:"31d6cfe0",56:"31d6cfe0",57:"31d6cfe0",58:"31d6cfe0",59:"31d6cfe0",60:"31d6cfe0",61:"31d6cfe0",62:"31d6cfe0",63:"31d6cfe0",64:"31d6cfe0",65:"31d6cfe0",66:"31d6cfe0",67:"31d6cfe0",68:"31d6cfe0",69:"31d6cfe0",70:"31d6cfe0",71:"31d6cfe0",72:"31d6cfe0",73:"31d6cfe0",74:"31d6cfe0",75:"31d6cfe0",76:"31d6cfe0",77:"31d6cfe0",78:"31d6cfe0",79:"31d6cfe0",80:"31d6cfe0",81:"31d6cfe0",82:"31d6cfe0",83:"31d6cfe0",84:"31d6cfe0",85:"31d6cfe0",86:"31d6cfe0",87:"31d6cfe0",88:"31d6cfe0",89:"31d6cfe0",90:"31d6cfe0",91:"31d6cfe0",92:"31d6cfe0",93:"31d6cfe0",94:"31d6cfe0",95:"31d6cfe0",96:"31d6cfe0",97:"31d6cfe0",98:"31d6cfe0",99:"31d6cfe0",100:"31d6cfe0",101:"31d6cfe0",102:"31d6cfe0",103:"31d6cfe0",104:"31d6cfe0",105:"31d6cfe0",106:"31d6cfe0",107:"31d6cfe0",108:"31d6cfe0",109:"31d6cfe0",110:"31d6cfe0",111:"31d6cfe0",112:"31d6cfe0",113:"31d6cfe0",114:"31d6cfe0",115:"31d6cfe0",116:"31d6cfe0",117:"31d6cfe0",118:"31d6cfe0",119:"31d6cfe0",120:"31d6cfe0",121:"76fc5962",122:"31d6cfe0",123:"31d6cfe0",124:"31d6cfe0",125:"31d6cfe0",126:"31d6cfe0",127:"31d6cfe0",128:"31d6cfe0",129:"31d6cfe0",130:"31d6cfe0",131:"31d6cfe0",132:"31d6cfe0",133:"31d6cfe0",134:"31d6cfe0",135:"31d6cfe0",136:"31d6cfe0",137:"31d6cfe0",138:"31d6cfe0",139:"31d6cfe0",140:"31d6cfe0",141:"31d6cfe0",142:"31d6cfe0",143:"31d6cfe0",144:"31d6cfe0",145:"31d6cfe0",146:"31d6cfe0",147:"31d6cfe0",148:"31d6cfe0",149:"31d6cfe0",150:"31d6cfe0",151:"31d6cfe0",152:"31d6cfe0",153:"31d6cfe0",154:"31d6cfe0",155:"31d6cfe0",156:"31d6cfe0",157:"31d6cfe0",158:"31d6cfe0",159:"31d6cfe0",160:"31d6cfe0",161:"31d6cfe0",162:"31d6cfe0",163:"31d6cfe0",164:"31d6cfe0",165:"31d6cfe0",166:"31d6cfe0",167:"31d6cfe0",168:"31d6cfe0",169:"31d6cfe0",170:"31d6cfe0",171:"31d6cfe0",172:"31d6cfe0",173:"31d6cfe0",174:"31d6cfe0",175:"31d6cfe0",176:"31d6cfe0",177:"31d6cfe0",178:"31d6cfe0",179:"31d6cfe0",180:"31d6cfe0",181:"31d6cfe0",182:"31d6cfe0",185:"31d6cfe0",186:"31d6cfe0"}[e]+".css",b=n.p+d,t=document.getElementsByTagName("link"),r=0;r<t.length;r++){var o=(i=t[r]).getAttribute("data-href")||i.getAttribute("href");if("stylesheet"===i.rel&&(o===d||o===b))return f()}var u=document.getElementsByTagName("style");for(r=0;r<u.length;r++){var i;if((o=(i=u[r]).getAttribute("data-href"))===d||o===b)return f()}var l=document.createElement("link");l.rel="stylesheet",l.type="text/css",l.onload=f,l.onerror=function(f){var d=f&&f.target&&f.target.src||b,t=new Error("Loading CSS chunk "+e+" failed.\n("+d+")");t.code="CSS_CHUNK_LOAD_FAILED",t.request=d,delete a[e],l.parentNode.removeChild(l),c(t)},l.href=b,document.getElementsByTagName("head")[0].appendChild(l)})).then((function(){a[e]=0})));var c=b[e];if(0!==c)if(c)f.push(c[2]);else{var d=new Promise((function(f,d){c=b[e]=[f,d]}));f.push(c[2]=d);var t,o=document.createElement("script");o.charset="utf-8",o.timeout=120,n.nc&&o.setAttribute("nonce",n.nc),o.src=r(e);var u=new Error;t=function(f){o.onerror=o.onload=null,clearTimeout(i);var c=b[e];if(0!==c){if(c){var d=f&&("load"===f.type?"missing":f.type),a=f&&f.target&&f.target.src;u.message="Loading chunk "+e+" failed.\n("+d+": "+a+")",u.name="ChunkLoadError",u.type=d,u.request=a,c[1](u)}b[e]=void 0}};var i=setTimeout((function(){t({type:"timeout",target:o})}),12e4);o.onerror=o.onload=t,document.head.appendChild(o)}return Promise.all(f)},n.m=e,n.c=d,n.d=function(e,f,c){n.o(e,f)||Object.defineProperty(e,f,{enumerable:!0,get:c})},n.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},n.t=function(e,f){if(1&f&&(e=n(e)),8&f)return e;if(4&f&&"object"==typeof e&&e&&e.__esModule)return e;var c=Object.create(null);if(n.r(c),Object.defineProperty(c,"default",{enumerable:!0,value:e}),2&f&&"string"!=typeof e)for(var d in e)n.d(c,d,function(f){return e[f]}.bind(null,d));return c},n.n=function(e){var f=e&&e.__esModule?function(){return e.default}:function(){return e};return n.d(f,"a",f),f},n.o=function(e,f){return Object.prototype.hasOwnProperty.call(e,f)},n.p="/",n.gca=function(e){return r(e={17896441:"22",30674823:"42",50799408:"58","00163030":"4","013f42ef":"5","0196741a":"6","0358ea4a":"7","03abeb31":"8","03b044fb":"9","065a8d55":"10","06d5d70a":"11","088716a6":"12","0978a33a":"13","09ccb289":"14","0cae4475":"15","10211c0a":"16","1131f29a":"17","13187f39":"18","133e23d9":"19","1444fc1b":"20","1777f326":"21","1a02600c":"23","1be78505":"24","1dba9094":"25","1fc4ffdf":"26","209b41dc":"27","20ac7829":"28","21936a93":"29","22cafcd3":"30","25cfb3f3":"31","2606bf23":"32","294e02c4":"33","2af05231":"34","2b0b4d70":"35","2b362a87":"36","2bbf879d":"37","2c087a87":"38","2c08d080":"39","2cdde719":"40","2f840b51":"41","32e37b42":"43","33f8468c":"44","342fbc7e":"45","369d3d94":"46","397fa735":"47","3ac458cf":"48","3d70cde6":"49","4086254d":"50","47462ed9":"51","482f7566":"52","4b45c44c":"53","4b8333e5":"54","4c5ebba5":"55","4e9e65dc":"56","4fd0afdf":"57","50bbcf89":"59","5446bf9c":"60","5f7cf4b7":"61","61aaf4b5":"62","6664be73":"63","6b573900":"64","6c98f389":"65","6d0633c8":"66","6db4087d":"67","712b85c0":"68","726258db":"69","72e09efa":"70","773b7ddf":"71","7755c98f":"72","77aecd65":"73","781ad36b":"74","782001b8":"75","7a0eaed6":"76","7e0f18f4":"77","7eeb204a":"78","838bab07":"79","858d8181":"80","859cc09f":"81","8926c06f":"82","8b743bdd":"83","8b77bac1":"84","8c015133":"85","8c0a1edc":"86","8e2963ef":"87","912fe03d":"88","92c3ba78":"89","935c1f16":"90","93f4d3a6":"91","94fb9a13":"92","96fb2cf3":"93","9972b359":"94","9aa688bb":"95","9b517c7f":"96","9cbcc25e":"97","9cccaf3a":"98","9cee5900":"99","9cf894bb":"100","9d9ec3e3":"101","9e1c1430":"102","9e229734":"103","9e443e3b":"104",a1dcf46f:"105",a2b71ef9:"106",a361f4e3:"107",a43f9649:"108",a598bb04:"109",a5c65c7b:"110",a5fabd44:"111",a6aa9e1f:"112",a85ef2bb:"113",a8834710:"114",a8f86885:"115",a97f53bd:"116",a9f38005:"117",ac312d55:"118",ac8b7f2e:"119",acbe0809:"120",algolia:"121",b26e5421:"122",b2b85c76:"123",b3764198:"124",b505ee9d:"125",b6a32428:"126",b8dda33a:"127",b9cf024a:"128",baaf877f:"129",bbb4ffb5:"130",bd7019e0:"131",bdaab79f:"132",be2eb782:"133",be5da56a:"134",c0a62421:"135",c4f5d8e4:"136",c5da328a:"137",c601bd32:"138",c698896a:"139",c70d243d:"140",cc2f38e0:"141",cc8e85bd:"142",ccc49370:"143",cda7cfb0:"144",cf67c7b0:"145",d14a9d06:"146",d43f6e1a:"147",d7e2094c:"148",d924db8b:"149",d9b8b8b3:"150",da5134d7:"151",da796f38:"152",dc895aaf:"153",dd058668:"154",de9a7b5a:"155",dea345ca:"156",defa8226:"157",df7ab5c6:"158",e0ce3759:"159",e0f8f6f1:"160",e3035694:"161",e360e27f:"162",e3d432cb:"163",e5ad4e18:"164",e9ea91ed:"165",ea9ce23f:"166",eab5709a:"167",ecfe08ed:"168",ed13c9fe:"169",ed46ee25:"170",f131602e:"171",f1d7b915:"172",f3069005:"173",f594f170:"174",f6c9e83f:"175",f70cb32f:"176",f8c929ff:"177",f9fb43b6:"178",fa0d1b31:"179",fa2528e9:"180",fa668fca:"181",fba73214:"182"}[e]||e)},n.oe=function(e){throw console.error(e),e};var o=window.webpackJsonp=window.webpackJsonp||[],u=o.push.bind(o);o.push=f,o=o.slice();for(var i=0;i<o.length;i++)f(o[i]);var l=u;c()}([]);
\ No newline at end of file
diff --git a/team/index.html b/team/index.html
index 319a51484b3..67e13340ab6 100644
--- a/team/index.html
+++ b/team/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/users.html b/users.html
index a9590754270..7d8a59eb6df 100644
--- a/users.html
+++ b/users.html
@@ -28,7 +28,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>
 
diff --git a/users/index.html b/users/index.html
index 17e2b2da5fa..4ae430ee44a 100644
--- a/users/index.html
+++ b/users/index.html
@@ -32,7 +32,7 @@
 
 <script src="/styles.9346efff.js"></script>
 
-<script src="/runtime~main.0aa9274f.js"></script>
+<script src="/runtime~main.1cdf5172.js"></script>
 
 <script src="/main.9e815ea7.js"></script>