loafle/openapi-generator
3
0
Fork 0
forked from loafle/openapi-generator-original
Code Pull Requests Activity
openapi-generator/docs/usage.html
wing328 83e04efef2 Deploy website 
Deploy website version based on e32a2f012135c394a128051c2e220fd3b9b2936c
2020-01-31 11:52:18 +00:00

598 lines
51 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Usage · OpenAPI Generator</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Options for OpenAPI Generator are the same whether you&#x27;re using the CLI, Maven/Gradle Plugins, or Online generation options."/><meta name="docsearch:language" content="en"/><meta property="og:title" content="Usage · OpenAPI Generator"/><meta property="og:type" content="website"/><meta property="og:url" content="https://openapi-generator.tech/"/><meta property="og:description" content="Options for OpenAPI Generator are the same whether you&#x27;re using the CLI, Maven/Gradle Plugins, or Online generation options."/><meta property="og:image" content="https://openapi-generator.tech/img/docusaurus.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://openapi-generator.tech/img/icons/twitter.svg"/><link rel="shortcut icon" href="/img/favicon.png"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css"/><link rel="alternate" type="application/atom+xml" href="https://openapi-generator.tech/blog/atom.xml" title="OpenAPI Generator Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://openapi-generator.tech/blog/feed.xml" title="OpenAPI Generator Blog RSS Feed"/><script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-132927057-1', 'auto');
ga('send', 'pageview');
</script><script type="text/javascript" src="https://buttons.github.io/buttons.js"></script><script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.0/clipboard.min.js"></script><script type="text/javascript" src="/js/code-block-buttons.js"></script><script src="https://unpkg.com/vanilla-back-to-top@7.1.14/dist/vanilla-back-to-top.min.js"></script><script>
document.addEventListener('DOMContentLoaded', function() {
addBackToTop(
{"zIndex":100}
)
});
</script><script src="/js/scrollSpy.js"></script><link rel="stylesheet" href="/css/main.css"/><script src="/js/codetabs.js"></script></head><body class="sideNavVisible separateOnPageNav"><div class="fixedHeaderContainer"><div class="headerWrapper wrapper"><header><a href="/"><img class="logo" src="/img/mono-logo.svg" alt="OpenAPI Generator"/><h2 class="headerTitleWithLogo">OpenAPI Generator</h2></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class="siteNavGroupActive"><a href="/docs/installation" target="_self">Get Started</a></li><li class="siteNavGroupActive"><a href="/docs/generators" target="_self">Generators</a></li><li class="siteNavGroupActive"><a href="/docs/roadmap" target="_self">Roadmap</a></li><li class=""><a href="/team" target="_self">Team</a></li><li class=""><a href="/docs/faq" target="_self">FAQ</a></li><li class=""><a href="/blog/" target="_self">Blog</a></li></ul></nav></div></header></div></div><div class="navPusher"><div class="docMainWrapper wrapper"><div class="docsNavContainer" id="docsNav"><nav class="toc"><div class="toggleNav"><section class="navWrapper wrapper"><div class="navBreadcrumb wrapper"><div class="navToggle" id="navToggler"><div class="hamburger-menu"><div class="line1"></div><div class="line2"></div><div class="line3"></div></div></div><h2><i>›</i><span>Getting Started</span></h2><div class="tocToggler" id="tocToggler"><i class="icon-toc"></i></div></div><div class="navGroups"><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Getting Started<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/installation">CLI Installation</a></li><li class="navListItem"><a class="navItem" href="/docs/plugins">Plugins</a></li><li class="navListItem"><a class="navItem" href="/docs/online">Online</a></li><li class="navListItem navListItemActive"><a class="navItem" href="/docs/usage">Usage</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Extending<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/templating">Using Templates</a></li><li class="navListItem"><a class="navItem" href="/docs/customization">Customization</a></li><li class="navListItem"><a class="navItem" href="/docs/debugging">Debugging</a></li><li class="navListItem"><a class="navItem" href="/docs/integrations">Workflow Integrations</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Contributing<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/contributing">Guidelines</a></li><li class="navListItem"><a class="navItem" href="/docs/code-of-conduct">Code of Conduct</a></li><li class="navListItem"><a class="navItem" href="/docs/contribute-building">Building the code</a></li><li class="navListItem"><a class="navItem" href="/docs/new-generator">Create a New Generator</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">About<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/roadmap">Roadmap</a></li><li class="navListItem"><a class="navItem" href="/docs/swagger-codegen-migration">Migrating from Swagger Codegen</a></li><li class="navListItem"><a class="navItem" href="/docs/fork-qna">Swagger Codegen Fork: Q&amp;A</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Releases<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/release-summary">Release Summary</a></li><li class="navListItem"><a class="navItem" href="/docs/release-3-0-0">Release Notes: 3.0.0</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">API<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/generators">Generators List</a></li></ul></div></div></section></div><script>
var coll = document.getElementsByClassName('collapsible');
var checkActiveCategory = true;
for (var i = 0; i < coll.length; i++) {
var links = coll[i].nextElementSibling.getElementsByTagName('*');
if (checkActiveCategory){
for (var j = 0; j < links.length; j++) {
if (links[j].classList.contains('navListItemActive')){
coll[i].nextElementSibling.classList.toggle('hide');
coll[i].childNodes[1].classList.toggle('rotate');
checkActiveCategory = false;
break;
}
}
}
coll[i].addEventListener('click', function() {
var arrow = this.childNodes[1];
arrow.classList.toggle('rotate');
var content = this.nextElementSibling;
content.classList.toggle('hide');
});
}
document.addEventListener('DOMContentLoaded', function() {
createToggler('#navToggler', '#docsNav', 'docsSliderActive');
createToggler('#tocToggler', 'body', 'tocActive');
var headings = document.querySelector('.toc-headings');
headings && headings.addEventListener('click', function(event) {
var el = event.target;
while(el !== headings){
if (el.tagName === 'A') {
document.body.classList.remove('tocActive');
break;
} else{
el = el.parentNode;
}
}
}, false);
function createToggler(togglerSelector, targetSelector, className) {
var toggler = document.querySelector(togglerSelector);
var target = document.querySelector(targetSelector);
if (!toggler) {
return;
}
toggler.onclick = function(event) {
event.preventDefault();
target.classList.toggle(className);
};
}
});
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><h1 id="__docusaurus" class="postHeaderTitle">Usage</h1></header><article><div><span><p>Options for OpenAPI Generator are the same whether you'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're welcome to skip directly to the <a href="#generate">generate</a> command.</p>
<h2><a class="anchor" aria-hidden="true" id="help"></a><a href="#help" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>help</h2>
<p>The <code>help</code> option lists all commands available to the CLI.</p>
<pre><code class="hljs css language-bash">openapi-generator <span class="hljs-built_in">help</span>
usage: openapi-generator-cli &lt;<span class="hljs-built_in">command</span>&gt; [&lt;args&gt;]
The most commonly used openapi-generator-cli commands are:
config-help Config <span class="hljs-built_in">help</span> <span class="hljs-keyword">for</span> chosen lang
generate Generate code with the specified generator.
<span class="hljs-built_in">help</span> Display <span class="hljs-built_in">help</span> information
list Lists the available generators
meta MetaGenerator. Generator <span class="hljs-keyword">for</span> creating a new template <span class="hljs-built_in">set</span> and configuration <span class="hljs-keyword">for</span> Codegen. The output will be based on the language you specify, and includes default templates to include.
validate Validate specification
version Show version information
See <span class="hljs-string">'openapi-generator-cli help &lt;command&gt;'</span> <span class="hljs-keyword">for</span> more information on a specific
<span class="hljs-built_in">command</span>.
</code></pre>
<h2><a class="anchor" aria-hidden="true" id="list"></a><a href="#list" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></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><code class="hljs css language-bash">openapi-generator <span class="hljs-built_in">help</span> list
NAME
openapi-generator-cli list - Lists the available generators
SYNOPSIS
openapi-generator-cli list [(-i &lt;include&gt; | --include &lt;include&gt;)]
[(-s | --short)]
OPTIONS
-i &lt;include&gt;, --include &lt;include&gt;
comma-separated list of stability indexes to include (value:
all,beta,stable,experimental,deprecated). Excludes deprecated by
default.
-s, --short
shortened output (suitable <span class="hljs-keyword">for</span> scripting)
</code></pre>
<p>Example:</p>
<pre><code class="hljs css language-bash">openapi-generator list -s | tr <span class="hljs-string">','</span> <span class="hljs-string">'\n'</span>
</code></pre>
<p>For the full list of generators, refer to the <a href="/docs/generators">Generators List</a>.</p>
<h2><a class="anchor" aria-hidden="true" id="config-help"></a><a href="#config-help" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>config-help</h2>
<p>The <code>config-help</code> option provides details about</p>
<pre><code class="hljs css language-bash">openapi-generator <span class="hljs-built_in">help</span> config-help
NAME
openapi-generator-cli config-help - Config <span class="hljs-built_in">help</span> <span class="hljs-keyword">for</span> chosen lang
SYNOPSIS
openapi-generator-cli config-help
[(-f &lt;output format&gt; | --format &lt;output format&gt;)]
[(-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)]
[--markdown-header] [--named-header]
[(-o &lt;output location&gt; | --output &lt;output location&gt;)]
OPTIONS
-f &lt;output format&gt;, --format &lt;output format&gt;
Write output files <span class="hljs-keyword">in</span> the desired format. Options are <span class="hljs-string">'text'</span>,
<span class="hljs-string">'markdown'</span> or <span class="hljs-string">'yamlsample'</span>. Default is <span class="hljs-string">'text'</span>.
-g &lt;generator name&gt;, --generator-name &lt;generator name&gt;
generator to get config <span class="hljs-built_in">help</span> <span class="hljs-keyword">for</span>
--markdown-header
When format=markdown, include this option to write out markdown
headers (e.g. <span class="hljs-keyword">for</span> docusaurus).
--named-header
Header includes the generator name, <span class="hljs-keyword">for</span> clarity <span class="hljs-keyword">in</span> output
-o &lt;output location&gt;, --output &lt;output location&gt;
Optionally write <span class="hljs-built_in">help</span> to this location, otherwise default is
standard output
</code></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><code class="hljs css language-bash">openapi-generator config-help -g go
</code></pre>
<p>Outputs:</p>
<pre><code class="hljs css language-text">CONFIG OPTIONS
packageName
Go package name (convention: lowercase). (Default: openapi)
hideGenerationTimestamp
Hides the generation timestamp when files are generated. (Default: true)
packageVersion
Go package version. (Default: 1.0.0)
withGoCodegenComment
whether to include Go codegen comment to disable Go Lint and collapse by default GitHub in PRs and diffs (Default: false)
withXml
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)
prependFormOrBodyParameters
Add form or body parameters to the beginning of the parameter list. (Default: false)
</code></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 class="anchor" aria-hidden="true" id="meta"></a><a href="#meta" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></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><code class="hljs css language-bash">openapi-generator <span class="hljs-built_in">help</span> meta
NAME
openapi-generator-cli meta - MetaGenerator. Generator <span class="hljs-keyword">for</span> creating a new
template <span class="hljs-built_in">set</span> and configuration <span class="hljs-keyword">for</span> Codegen. The output will be based on
the language you specify, and includes default templates to include.
SYNOPSIS
openapi-generator-cli meta [(-n &lt;name&gt; | --name &lt;name&gt;)]
[(-o &lt;output directory&gt; | --output &lt;output directory&gt;)]
[(-p &lt;package&gt; | --package &lt;package&gt;)] [(-t &lt;<span class="hljs-built_in">type</span>&gt; | --<span class="hljs-built_in">type</span> &lt;<span class="hljs-built_in">type</span>&gt;)]
OPTIONS
-n &lt;name&gt;, --name &lt;name&gt;
the human-readable name of the generator
-o &lt;output directory&gt;, --output &lt;output directory&gt;
<span class="hljs-built_in">where</span> to write the generated files (current dir by default)
-p &lt;package&gt;, --package &lt;package&gt;
the package to put the main class into (defaults to
org.openapitools.codegen)
-t &lt;<span class="hljs-built_in">type</span>&gt;, --<span class="hljs-built_in">type</span> &lt;<span class="hljs-built_in">type</span>&gt;
the <span class="hljs-built_in">type</span> of generator that is created
</code></pre>
<p>For an in-depth example of using the <code>meta</code> command, see <a href="/docs/customization">Customization</a>.</p>
<h2><a class="anchor" aria-hidden="true" id="validate"></a><a href="#validate" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></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><code class="hljs css language-bash">openapi-generator <span class="hljs-built_in">help</span> validate
NAME
openapi-generator-cli validate - Validate specification
SYNOPSIS
openapi-generator-cli validate
(-i &lt;spec file&gt; | --input-spec &lt;spec file&gt;) [--recommend]
OPTIONS
-i &lt;spec file&gt;, --input-spec &lt;spec file&gt;
location of the OpenAPI spec, as URL or file (required)
--recommend
</code></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><code class="hljs css language-bash">openapi-generator validate -i petstore-v3.0.yaml
</code></pre>
<pre><code class="hljs css language-text">Validating spec (petstore-v3.0.yaml)
No validation issues detected.
</code></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><code class="hljs css language-bash">openapi-generator validate -i petstore-v3.0-invalid.yaml
</code></pre>
<pre><code class="hljs css language-text">Validating spec (petstore-v3.0-invalid.yaml)
Errors:
-attribute info is missing
[error] Spec has 1 errors.
</code></pre>
<h2><a class="anchor" aria-hidden="true" id="completion"></a><a href="#completion" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></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><code class="hljs css language-bash">openapi-generator completion config-help
-o
--output
--named-header
-g
--generator-name
-f
--format
--markdown-header
</code></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 class="anchor" aria-hidden="true" id="generate"></a><a href="#generate" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></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 and the previous commands. The options are abbreviated below, but you may expand the full descriptions.</p>
<pre><code class="hljs css language-bash">openapi-generator <span class="hljs-built_in">help</span> generate
NAME
openapi-generator-cli generate - Generate code with the specified
generator.
SYNOPSIS
openapi-generator-cli generate
[(-a &lt;authorization&gt; | --auth &lt;authorization&gt;)]
[--api-package &lt;api package&gt;] [--artifact-id &lt;artifact id&gt;]
[--artifact-version &lt;artifact version&gt;]
[(-c &lt;configuration file&gt; | --config &lt;configuration file&gt;)]
[-D &lt;system properties&gt;...]
[(-e &lt;templating engine&gt; | --engine &lt;templating engine&gt;)]
[--<span class="hljs-built_in">enable</span>-post-process-file]
[(-g &lt;generator name&gt; | --generator-name &lt;generator name&gt;)]
[--generate-alias-as-model] [--git-repo-id &lt;git repo id&gt;]
[--git-user-id &lt;git user id&gt;] [--group-id &lt;group id&gt;]
[--http-user-agent &lt;http user agent&gt;]
(-i &lt;spec file&gt; | --input-spec &lt;spec file&gt;)
[--ignore-file-override &lt;ignore file override location&gt;]
[--import-mappings &lt;import mappings&gt;...]
[--instantiation-types &lt;instantiation types&gt;...]
[--invoker-package &lt;invoker package&gt;]
[--language-specific-primitives &lt;language specific primitives&gt;...]
[--library &lt;library&gt;] [--<span class="hljs-built_in">log</span>-to-stderr] [--minimal-update]
[--model-name-prefix &lt;model name prefix&gt;]
[--model-name-suffix &lt;model name suffix&gt;]
[--model-package &lt;model package&gt;]
[(-o &lt;output directory&gt; | --output &lt;output directory&gt;)]
[(-p &lt;additional properties&gt; | --additional-properties &lt;additional properties&gt;)...]
[--package-name &lt;package name&gt;] [--release-note &lt;release note&gt;]
[--remove-operation-id-prefix]
[--reserved-words-mappings &lt;reserved word mappings&gt;...]
[(-s | --skip-overwrite)] [--server-variables &lt;server variables&gt;...]
[--skip-validate-spec] [--strict-spec &lt;<span class="hljs-literal">true</span>/<span class="hljs-literal">false</span> strict behavior&gt;]
[(-t &lt;template directory&gt; | --template-dir &lt;template directory&gt;)]
[--<span class="hljs-built_in">type</span>-mappings &lt;<span class="hljs-built_in">type</span> mappings&gt;...] [(-v | --verbose)]
</code></pre>
<p><details>
<summary>generate OPTIONS</summary></p>
<pre><code class="hljs css language-bash">OPTIONS
-a &lt;authorization&gt;, --auth &lt;authorization&gt;
adds authorization headers when fetching the OpenAPI definitions
remotely. Pass <span class="hljs-keyword">in</span> a URL-encoded string of name:header with a comma
separating multiple values
--api-package &lt;api package&gt;
package <span class="hljs-keyword">for</span> generated api classes
--artifact-id &lt;artifact id&gt;
artifactId <span class="hljs-keyword">in</span> generated pom.xml. This also becomes part of the
generated library<span class="hljs-string">'s filename
--artifact-version &lt;artifact version&gt;
artifact version in generated pom.xml. This also becomes part of the
generated library'</span>s filename
-c &lt;configuration file&gt;, --config &lt;configuration file&gt;
Path to configuration file configuration file. It can be json or
yaml.If file is json, the content should have the format
{<span class="hljs-string">"optionKey"</span>:<span class="hljs-string">"optionValue"</span>, <span class="hljs-string">"optionKey1"</span>:<span class="hljs-string">"optionValue1"</span>...}.If file
is yaml, the content should have the format optionKey:
optionValueSupported options can be different <span class="hljs-keyword">for</span> each language. Run
config-help -g {generator name} <span class="hljs-built_in">command</span> <span class="hljs-keyword">for</span> language specific config
options.
-D &lt;system properties&gt;
sets specified system properties <span class="hljs-keyword">in</span> the format of
name=value,name=value (or multiple options, each with name=value)
-e &lt;templating engine&gt;, --engine &lt;templating engine&gt;
templating engine: <span class="hljs-string">"mustache"</span> (default) or <span class="hljs-string">"handlebars"</span> (beta)
--<span class="hljs-built_in">enable</span>-post-process-file
enablePostProcessFile
-g &lt;generator name&gt;, --generator-name &lt;generator name&gt;
generator to use (see list <span class="hljs-built_in">command</span> <span class="hljs-keyword">for</span> list)
--generate-alias-as-model
Generate <span class="hljs-built_in">alias</span> to map, array as models
--git-repo-id &lt;git repo id&gt;
Git repo ID, e.g. openapi-generator.
--git-user-id &lt;git user id&gt;
Git user ID, e.g. openapitools.
--group-id &lt;group id&gt;
groupId <span class="hljs-keyword">in</span> generated pom.xml
--http-user-agent &lt;http user agent&gt;
HTTP user agent, e.g. codegen_csharp_api_client, default to
<span class="hljs-string">'OpenAPI-Generator/{packageVersion}}/{language}'</span>
-i &lt;spec file&gt;, --input-spec &lt;spec file&gt;
location of the OpenAPI spec, as URL or file (required)
--ignore-file-override &lt;ignore file override location&gt;
Specifies an override location <span class="hljs-keyword">for</span> the .openapi-generator-ignore
file. Most useful on initial generation.
--import-mappings &lt;import mappings&gt;
specifies mappings between a given class and the import that should
be used <span class="hljs-keyword">for</span> that class <span class="hljs-keyword">in</span> the format of <span class="hljs-built_in">type</span>=import,<span class="hljs-built_in">type</span>=import. You
can also have multiple occurrences of this option.
--instantiation-types &lt;instantiation types&gt;
sets instantiation <span class="hljs-built_in">type</span> mappings <span class="hljs-keyword">in</span> the format of
<span class="hljs-built_in">type</span>=instantiatedType,<span class="hljs-built_in">type</span>=instantiatedType.For example (<span class="hljs-keyword">in</span> Java):
array=ArrayList,map=HashMap. In other words array types will get
instantiated as ArrayList <span class="hljs-keyword">in</span> generated code. You can also have
multiple occurrences of this option.
--invoker-package &lt;invoker package&gt;
root package <span class="hljs-keyword">for</span> generated code
--language-specific-primitives &lt;language specific primitives&gt;
specifies additional language specific primitive types <span class="hljs-keyword">in</span> the format
of type1,type2,type3,type3. For example:
String,boolean,Boolean,Double. You can also have multiple
occurrences of this option.
--library &lt;library&gt;
library template (sub-template)
--<span class="hljs-built_in">log</span>-to-stderr
write all <span class="hljs-built_in">log</span> messages (not just errors) to STDOUT. Useful <span class="hljs-keyword">for</span>
piping the JSON output of debug options (e.g. `-DdebugOperations`)
to an external parser directly <span class="hljs-keyword">while</span> testing a generator.
--minimal-update
Only write output files that have changed.
--model-name-prefix &lt;model name prefix&gt;
Prefix that will be prepended to all model names. Default is the
empty string.
--model-name-suffix &lt;model name suffix&gt;
Suffix that will be appended to all model names. Default is the
empty string.
--model-package &lt;model package&gt;
package <span class="hljs-keyword">for</span> generated models
-o &lt;output directory&gt;, --output &lt;output directory&gt;
<span class="hljs-built_in">where</span> to write the generated files (current dir by default)
-p &lt;additional properties&gt;, --additional-properties &lt;additional
properties&gt;
sets additional properties that can be referenced by the mustache
templates <span class="hljs-keyword">in</span> the format of name=value,name=value. You can also have
multiple occurrences of this option.
--package-name &lt;package name&gt;
package <span class="hljs-keyword">for</span> generated classes (<span class="hljs-built_in">where</span> supported)
--release-note &lt;release note&gt;
Release note, default to <span class="hljs-string">'Minor update'</span>.
--remove-operation-id-prefix
Remove prefix of operationId, e.g. config_getId =&gt; getId
--reserved-words-mappings &lt;reserved word mappings&gt;
specifies how a reserved name should be escaped to. Otherwise, the
default _&lt;name&gt; is used. For example id=identifier. You can also
have multiple occurrences of this option.
-s, --skip-overwrite
specifies <span class="hljs-keyword">if</span> the existing files should be overwritten during the
generation.
--server-variables &lt;server variables&gt;
sets server variables <span class="hljs-keyword">for</span> spec documents <span class="hljs-built_in">which</span> support variable
templating of servers.
--skip-validate-spec
Skips the default behavior of validating an input specification.
--strict-spec &lt;<span class="hljs-literal">true</span>/<span class="hljs-literal">false</span> strict behavior&gt;
<span class="hljs-string">'MUST'</span> and <span class="hljs-string">'SHALL'</span> wording <span class="hljs-keyword">in</span> OpenAPI spec is strictly adhered to.
e.g. when <span class="hljs-literal">false</span>, no fixes will be applied to documents <span class="hljs-built_in">which</span> pass
validation but don<span class="hljs-string">'t follow the spec.
-t &lt;template directory&gt;, --template-dir &lt;template directory&gt;
folder containing the template files
--type-mappings &lt;type mappings&gt;
sets mappings between OpenAPI spec types and generated code types in
the format of OpenAPIType=generatedType,OpenAPIType=generatedType.
For example: array=List,map=Map,string=String. You can also have
multiple occurrences of this option.
-v, --verbose
verbose mode
</span></code></pre>
<p></details></p>
<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>
<h3><a class="anchor" aria-hidden="true" id="examples"></a><a href="#examples" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Examples</h3>
<p>The following examples use <a href="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml">petstore.yaml</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="additional-properties"></a><a href="#additional-properties" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Additional Properties</h4>
<p>Generator-specific options should be passed as <code>--additional-properties</code>:</p>
<pre><code class="hljs css language-bash">openapi-generator generate -g go --additional-properties=prependFormOrBodyParameters=<span class="hljs-literal">true</span> \
-o out -i petstore.yaml
</code></pre>
<p>To pass more than one generator property, these can be combined via comma:</p>
<pre><code class="hljs css language-bash">--additional-properties=key1=value1,key2=value2
</code></pre>
<p>For the full list of generator-specified parameters, refer to <a href="/docs/generators">generators docs</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="type-mappings-and-import-mappings"></a><a href="#type-mappings-and-import-mappings" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Type Mappings and Import Mappings</h4>
<p>Most generators allow for types bound to the OpenAPI Specification's types to be remapped to a user'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'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's target type</li>
<li><code>--import-mappings</code> Informs the template of the type to be imported</li>
</ul>
<p>Here's how one might change the <code>kotlin-spring</code> server generator's default of <code>OffsetDateTime</code> to <code>LocalDateTime</code>:</p>
<pre><code class="hljs css language-bash">openapi-generator generate \
-i petstore.yaml \
-g kotlin-spring \
-o out \
--additional-properties=library=spring-boot,beanValidations=<span class="hljs-literal">true</span>,swaggerAnnotations=<span class="hljs-literal">true</span>,serviceImplementation=<span class="hljs-literal">true</span> \
--import-mappings=DateTime=java.time.LocalDateTime \
--<span class="hljs-built_in">type</span>-mappings=DateTime=java.time.LocalDateTime
</code></pre>
<!-- TODO: Document all primitive types here -->
<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>
<h3><a class="anchor" aria-hidden="true" id="target-external-models"></a><a href="#target-external-models" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Target External Models</h3>
<p>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 <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><code class="hljs css language-bash">--language-specific-primitives=Pet
</code></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><code class="hljs css language-bash">--import-mappings=Pet=com.yourpackage.models.Pet
</code></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><code class="hljs css language-bash">--import-mappings=Pet=com.yourpackage.models.Pet,User=com.yourpackage.models.User
</code></pre>
<h4><a class="anchor" aria-hidden="true" id="configuration-file"></a><a href="#configuration-file" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></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><code class="hljs css language-json">{
<span class="hljs-attr">"npmName"</span>: <span class="hljs-string">"@swagger/typescript-fetch-petstore"</span>,
<span class="hljs-attr">"npmVersion"</span>: <span class="hljs-string">"1.0.0"</span>,
<span class="hljs-attr">"npmRepository"</span> : <span class="hljs-string">"https://skimdb.npmjs.com/registry"</span>,
<span class="hljs-attr">"snapshot"</span> : <span class="hljs-literal">false</span>,
<span class="hljs-attr">"supportsES6"</span>: <span class="hljs-literal">true</span>
}
</code></pre>
<p>These settings can be passed via <code>-c filename</code>. Here, we've saved the above as <code>config.json</code>:</p>
<pre><code class="hljs css language-bash">openapi-generator generate -i petstore.yaml -g typescript-fetch -o out \
-c config.json
</code></pre>
<p>Same configuration file can be passed into YAML format having following equivalent content:</p>
<pre><code class="hljs css language-yaml"><span class="hljs-attr">npmName:</span> <span class="hljs-string">"@swagger/typescript-fetch-petstore"</span>
<span class="hljs-attr">npmVersion:</span> <span class="hljs-string">"1.0.0"</span>
<span class="hljs-attr">npmRepository:</span> <span class="hljs-string">"https://skimdb.npmjs.com/registry"</span>
<span class="hljs-attr">snapshot:</span> <span class="hljs-literal">false</span>
<span class="hljs-attr">supportsES6:</span> <span class="hljs-literal">true</span>
</code></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><code class="hljs css language-bash">openapi-generator generate -i petstore.yaml -g typescript-fetch -o out \
-c config.yaml
</code></pre>
<h2><a class="anchor" aria-hidden="true" id="batch"></a><a href="#batch" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></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>.</p>
<pre><code class="hljs css language-bash">openapi-generator <span class="hljs-built_in">help</span> batch
NAME
openapi-generator-cli batch - Generate code <span class="hljs-keyword">in</span> batch via external
configs.
SYNOPSIS
openapi-generator-cli batch [--fail-fast]
[--includes-base-dir &lt;includes&gt;] [(-r &lt;threads&gt; | --threads &lt;threads&gt;)]
[--root-dir &lt;root&gt;] [--timeout &lt;timeout&gt;] [(-v | --verbose)] [--]
&lt;configs&gt;...
OPTIONS
--fail-fast
fail fast on any errors
--includes-base-dir &lt;includes&gt;
base directory used <span class="hljs-keyword">for</span> includes
-r &lt;threads&gt;, --threads &lt;threads&gt;
thread count
--root-dir &lt;root&gt;
root directory used output/includes (includes can be overridden)
--timeout &lt;timeout&gt;
execution timeout (minutes)
-v, --verbose
verbose mode
--
This option can be used to separate <span class="hljs-built_in">command</span>-line options from the
list of argument, (useful when arguments might be mistaken <span class="hljs-keyword">for</span>
<span class="hljs-built_in">command</span>-line options
&lt;configs&gt;
Generator configuration files.
</code></pre>
<p>Example:</p>
<pre><code class="hljs css language-bash"><span class="hljs-comment"># create "shared" config</span>
mkdir shared &amp;&amp; cat &gt; shared/common.yaml &lt;&lt;EOF
inputSpec: https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/<span class="hljs-built_in">test</span>/resources/2_0/petstore.yaml
additionalProperties:
x-ext-name: <span class="hljs-string">"Your Name"</span>
EOF
<span class="hljs-comment"># create "standard" configs</span>
cat &gt; kotlin.yaml &lt;&lt;EOF
<span class="hljs-string">'!include'</span>: <span class="hljs-string">'shared/common.yaml'</span>
outputDir: out/kotlin
generatorName: kotlin
artifactId: kotlin-petstore-string
additionalProperties:
dateLibrary: string
serializableModel: <span class="hljs-string">"true"</span>
EOF
cat &gt; csharp.yaml &lt;&lt;EOF
<span class="hljs-string">'!include'</span>: <span class="hljs-string">'shared/common.yaml'</span>
outputDir: out/csharp-netcore
generatorName: csharp-netcore
additionalProperties:
packageGuid: <span class="hljs-string">"{321C8C3F-0156-40C1-AE42-D59761FB9B6C}"</span>
useCompareNetObjects: <span class="hljs-string">"true"</span>
EOF
<span class="hljs-comment"># Generate them</span>
openapi-generator batch *.yaml
</code></pre>
</span></div></article></div><div class="docLastUpdate"><em>Last updated on 11/22/2019</em></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/online"><span class="arrow-prev">← </span><span>Online</span></a><a class="docs-next button" href="/docs/templating"><span>Using Templates</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#help">help</a></li><li><a href="#list">list</a></li><li><a href="#config-help">config-help</a></li><li><a href="#meta">meta</a></li><li><a href="#validate">validate</a></li><li><a href="#completion">completion</a></li><li><a href="#generate">generate</a><ul class="toc-headings"><li><a href="#examples">Examples</a></li><li><a href="#target-external-models">Target External Models</a></li></ul></li><li><a href="#batch">batch</a></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/mono-logo.svg" alt="OpenAPI Generator" width="66" height="58"/></a><div><h5>Docs</h5><a href="/docs/en/customization.html">Customizing Generators</a><a href="/docs/en/integrations.html">Workflow Integrations</a></div><div><h5>Community</h5><a href="/en/users.html">User Showcase</a><a href="http://stackoverflow.com/questions/tagged/openapi-generator" target="_blank" rel="noreferrer noopener">Stack Overflow</a><a href="https://join.slack.com/t/openapi-generator/shared_invite/enQtNzAyNDMyOTU0OTE1LTY5ZDBiNDI5NzI5ZjQ1Y2E5OWVjMjZkYzY1ZGM2MWQ4YWFjMzcyNDY5MGI4NjQxNDBiMTlmZTc5NjY2ZTQ5MGM">Chat Room</a><a href="https://twitter.com/oas_generator" target="_blank" rel="noreferrer noopener">Twitter</a></div><div><h5>More</h5><a href="/blog">Blog</a><a href="https://github.com/OpenAPITools/openapi-generator">GitHub Repo</a><a class="github-button" href="https://github.com/OpenAPITools/openapi-generator" data-icon="octicon-star" data-count-href="/OpenAPITools/openapi-generator/stargazers" data-show-count="true" data-count-aria-label="# stargazers on GitHub" aria-label="Star this project on GitHub">Star</a></div></section><section class="copyright">Copyright © 2020 OpenAPI-Generator Contributors (https://openapi-generator.tech). (Both &quot;OpenAPI Tools&quot; (https://OpenAPITools.org) and &quot;OpenAPI Generator&quot; are not affiliated with OpenAPI Initiative (OAI))</section></footer></div></body></html>
View Git Blame Copy Permalink