forked from loafle/openapi-generator-original
Compare commits
435 Commits
enable-has
...
cpp-oatpp-
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
8a7472fd1c | ||
|
|
eceac6a63c | ||
|
|
eacf61de7e | ||
|
|
08fb59009a | ||
|
|
05515040d5 | ||
|
|
bc76d8e58d | ||
|
|
b5473d2fda | ||
|
|
01d0b5d478 | ||
|
|
b3bc926b1d | ||
|
|
739249917c | ||
|
|
aff1af7be5 | ||
|
|
2f30960349 | ||
|
|
e3121af4b4 | ||
|
|
b6091571aa | ||
|
|
998e0fdaa2 | ||
|
|
ebf2f2e30f | ||
|
|
d179574b4e | ||
|
|
9377dbca56 | ||
|
|
ca6fcaf92a | ||
|
|
4f2f80766e | ||
|
|
ca3fcd882e | ||
|
|
4f1934c3c7 | ||
|
|
46b36c2e65 | ||
|
|
d5a7102785 | ||
|
|
96efc76ed5 | ||
|
|
8f06876a2a | ||
|
|
70323adf9f | ||
|
|
d5212ac834 | ||
|
|
a8bd859397 | ||
|
|
0e994eabf7 | ||
|
|
ab93cec952 | ||
|
|
b43103a029 | ||
|
|
913ec2019e | ||
|
|
87b4f45d40 | ||
|
|
ea2cdd23c2 | ||
|
|
44f5f2bdd8 | ||
|
|
d90fd10a75 | ||
|
|
44ec0caba4 | ||
|
|
042fc81f31 | ||
|
|
5d27799bad | ||
|
|
4860eb65e1 | ||
|
|
3d6bd48b67 | ||
|
|
1b67171d39 | ||
|
|
fe38a50365 | ||
|
|
37743c059b | ||
|
|
b70edd7f1b | ||
|
|
07c23f4d1a | ||
|
|
3c62cc4867 | ||
|
|
c0e36b3ff6 | ||
|
|
e11a427cf5 | ||
|
|
f30d6c8399 | ||
|
|
3be89e4c00 | ||
|
|
490068ad90 | ||
|
|
9af73d0a0c | ||
|
|
a5aeb5fdec | ||
|
|
50f3706c5c | ||
|
|
aa28775295 | ||
|
|
8c084e2dc0 | ||
|
|
7e7bfc74de | ||
|
|
e09d1bee43 | ||
|
|
ee3dd70636 | ||
|
|
240c046f35 | ||
|
|
ec74b06d2c | ||
|
|
b059b786a5 | ||
|
|
28e92f9e32 | ||
|
|
19249e597c | ||
|
|
072b309100 | ||
|
|
12acf2eb72 | ||
|
|
b1ea1ece87 | ||
|
|
b28c3ee14a | ||
|
|
7318ff72d7 | ||
|
|
d6c71ff0fb | ||
|
|
c1f2b1cad9 | ||
|
|
5bac98cd99 | ||
|
|
1dec9ebfb8 | ||
|
|
b733312707 | ||
|
|
e8ba2901df | ||
|
|
3d337db207 | ||
|
|
2ee0913d4a | ||
|
|
fed9d0637a | ||
|
|
30fad9defa | ||
|
|
ee1cbf6f4b | ||
|
|
34d2e25899 | ||
|
|
c387d58d26 | ||
|
|
cc5e0fee2d | ||
|
|
41851b45e1 | ||
|
|
e1e38c8783 | ||
|
|
8afb067ec9 | ||
|
|
e58b1f6abb | ||
|
|
0ad39cc533 | ||
|
|
edf153eede | ||
|
|
f76d72edf1 | ||
|
|
53eb67166b | ||
|
|
b888423fd8 | ||
|
|
6046c3da94 | ||
|
|
b768e42704 | ||
|
|
3c869d5b12 | ||
|
|
177e536bdf | ||
|
|
305d30102b | ||
|
|
45e6accf99 | ||
|
|
94c5a80551 | ||
|
|
a5083398de | ||
|
|
0cfe02348b | ||
|
|
f8a71cab5c | ||
|
|
bd329c13fb | ||
|
|
8fd9991ec2 | ||
|
|
2ec96f7f90 | ||
|
|
0a51c81f2e | ||
|
|
874b4a6472 | ||
|
|
ee2a7352a1 | ||
|
|
b208a311db | ||
|
|
b0fa00b860 | ||
|
|
25d10bb6cc | ||
|
|
4acc8eab45 | ||
|
|
931c4e361f | ||
|
|
242f648379 | ||
|
|
53fb864c66 | ||
|
|
2984497731 | ||
|
|
c6ab073a29 | ||
|
|
214d81553f | ||
|
|
86fd8b1aa4 | ||
|
|
8416fff568 | ||
|
|
690be29f4b | ||
|
|
fe31b9e2ce | ||
|
|
157c01d031 | ||
|
|
44f713fc34 | ||
|
|
d5002f4beb | ||
|
|
3d36d491df | ||
|
|
001533fa63 | ||
|
|
a1c8e248e7 | ||
|
|
8d0053fa9f | ||
|
|
bbf9c30c7a | ||
|
|
1c3d6e5e6f | ||
|
|
5fce12321e | ||
|
|
d8ba49b267 | ||
|
|
b1da09625d | ||
|
|
08a1bdcb57 | ||
|
|
cad0161f7e | ||
|
|
9236d5699d | ||
|
|
8c11c8f582 | ||
|
|
ae95c2b19b | ||
|
|
c0553ddc37 | ||
|
|
e9c6d65f2d | ||
|
|
8c17a01bda | ||
|
|
0e1d131076 | ||
|
|
61b543f03d | ||
|
|
4bde3a12d1 | ||
|
|
4e5ecf271a | ||
|
|
48762b5d4e | ||
|
|
3560cd252b | ||
|
|
a287c51b97 | ||
|
|
bb4e0c0058 | ||
|
|
6ade544904 | ||
|
|
150e24dc55 | ||
|
|
206f3f7238 | ||
|
|
4fe76fcb01 | ||
|
|
e1fd221898 | ||
|
|
626481bb07 | ||
|
|
b7f5265ae5 | ||
|
|
494c02e60f | ||
|
|
d854c89272 | ||
|
|
d6783c2f57 | ||
|
|
130109748c | ||
|
|
4bf81a0263 | ||
|
|
e852d42693 | ||
|
|
336521b464 | ||
|
|
b8de51f2fd | ||
|
|
6db283c03b | ||
|
|
f7570df5c3 | ||
|
|
2d30714d5e | ||
|
|
3f18d0fd10 | ||
|
|
54dd18535a | ||
|
|
d7dfcc20c0 | ||
|
|
785cbbbb63 | ||
|
|
8b39335859 | ||
|
|
7a98580f45 | ||
|
|
b72d5ca81e | ||
|
|
ec815ca33a | ||
|
|
2c59f1dc8c | ||
|
|
a5ee2e0454 | ||
|
|
cb4b03fcf3 | ||
|
|
f608803a40 | ||
|
|
9ace82ae14 | ||
|
|
5472943134 | ||
|
|
d6bfecf2ef | ||
|
|
9ba943318a | ||
|
|
f3fbc7d782 | ||
|
|
5f3d974a08 | ||
|
|
9778d970ac | ||
|
|
5dffbabc74 | ||
|
|
7b1563326a | ||
|
|
49760f7a34 | ||
|
|
596bbb9c58 | ||
|
|
29ca272a95 | ||
|
|
5ebf26e0d2 | ||
|
|
bc799b2488 | ||
|
|
7dd4fd1d98 | ||
|
|
bdc964a6c1 | ||
|
|
6612c16624 | ||
|
|
874c2a19d8 | ||
|
|
94ed8187f9 | ||
|
|
56c9f0dc1e | ||
|
|
6e937ba9f9 | ||
|
|
1716ee3154 | ||
|
|
d2aabc5f80 | ||
|
|
8c78f13a41 | ||
|
|
04b39cc86b | ||
|
|
2157d526e1 | ||
|
|
a5fcb17416 | ||
|
|
96bba3769b | ||
|
|
f8c20c22e1 | ||
|
|
27680214fd | ||
|
|
7fa02ee5f0 | ||
|
|
be151fca64 | ||
|
|
985c4b36a7 | ||
|
|
a29d9a9ff4 | ||
|
|
4f27939879 | ||
|
|
8cd503f194 | ||
|
|
c7d5275b62 | ||
|
|
3ca6bc2518 | ||
|
|
35d42728d9 | ||
|
|
77f24a4234 | ||
|
|
5675d5fe61 | ||
|
|
80bef2f79a | ||
|
|
ea559b5e20 | ||
|
|
92f7a306a1 | ||
|
|
3f7a3f2b59 | ||
|
|
29ed2342e5 | ||
|
|
874daad7e7 | ||
|
|
ef42977097 | ||
|
|
7424489607 | ||
|
|
9754748321 | ||
|
|
bfe4a7ff87 | ||
|
|
ca5d384081 | ||
|
|
620f8db3d6 | ||
|
|
6a4aed91ca | ||
|
|
6909c888d2 | ||
|
|
bb00d88283 | ||
|
|
32c591d9a7 | ||
|
|
be40dbe540 | ||
|
|
c04d9cd59a | ||
|
|
c44865279a | ||
|
|
0b6229607f | ||
|
|
8dd3e561fa | ||
|
|
4e05912ae7 | ||
|
|
8556cb8d71 | ||
|
|
0173acd1d3 | ||
|
|
bf0bd29ef1 | ||
|
|
1a709a731b | ||
|
|
8fad36c898 | ||
|
|
634e3eb838 | ||
|
|
09200eb04e | ||
|
|
684b77166b | ||
|
|
0a2ef5a725 | ||
|
|
00e20ffb2c | ||
|
|
df441fe2ee | ||
|
|
f396da4c7e | ||
|
|
1eb8c2991d | ||
|
|
4d8ac0e055 | ||
|
|
37de486c43 | ||
|
|
7b6cc2032a | ||
|
|
e7f83595e5 | ||
|
|
67ba67ef96 | ||
|
|
c39aef2a79 | ||
|
|
f9514705a1 | ||
|
|
7ac7974ef5 | ||
|
|
089e1f7271 | ||
|
|
9a6e3fa74a | ||
|
|
06434fcfce | ||
|
|
681e821b71 | ||
|
|
2d5b2726d0 | ||
|
|
b38968456a | ||
|
|
dd42e0e428 | ||
|
|
0e2e031ece | ||
|
|
5e512e8aa4 | ||
|
|
662c77a283 | ||
|
|
2fd23f505e | ||
|
|
212b4f7847 | ||
|
|
14d41310b9 | ||
|
|
1f50207bda | ||
|
|
e0ec332e38 | ||
|
|
151752aa9d | ||
|
|
a6d30cac9d | ||
|
|
91ea6a17d9 | ||
|
|
966b87e66c | ||
|
|
d50d31cd5e | ||
|
|
20eb4d0b91 | ||
|
|
26bb348354 | ||
|
|
972120c35a | ||
|
|
ab5b0fa8d4 | ||
|
|
9fd66fbbcb | ||
|
|
19c5ed783a | ||
|
|
14a500c6fe | ||
|
|
b9662dc25d | ||
|
|
7032c401ea | ||
|
|
15de43f7e4 | ||
|
|
8eea149e14 | ||
|
|
30074833cd | ||
|
|
d5a680e85f | ||
|
|
da9f2f7c9b | ||
|
|
2c65605289 | ||
|
|
f681016ffd | ||
|
|
1f95199f82 | ||
|
|
08fe44c764 | ||
|
|
26c17c5774 | ||
|
|
892836f772 | ||
|
|
b4edfe477a | ||
|
|
8c1f6fcdc1 | ||
|
|
f11b2e6772 | ||
|
|
11a674f248 | ||
|
|
98582d5780 | ||
|
|
6913b0520c | ||
|
|
e6d3201623 | ||
|
|
bc4994e82c | ||
|
|
2e243abf25 | ||
|
|
546bc37935 | ||
|
|
1852f61f3a | ||
|
|
d868fd6dc8 | ||
|
|
a97feaf533 | ||
|
|
54a6c791f7 | ||
|
|
1dc65f0033 | ||
|
|
8bd2dd4c9d | ||
|
|
19140dc00d | ||
|
|
3e734a0b54 | ||
|
|
c893b92775 | ||
|
|
029fd669e5 | ||
|
|
5e79aaaf0a | ||
|
|
c1de6c2651 | ||
|
|
f70d48ea73 | ||
|
|
0747694636 | ||
|
|
7bb8a8d9ff | ||
|
|
fff5bfe8cb | ||
|
|
f371f7ff07 | ||
|
|
2e61a37833 | ||
|
|
027f752613 | ||
|
|
0e9c6dd9a8 | ||
|
|
da84d8e3bf | ||
|
|
a78a72b3d7 | ||
|
|
301cd4093d | ||
|
|
cbdedff0ad | ||
|
|
e8e6229d1b | ||
|
|
f0fd2cbb22 | ||
|
|
06ab5b5c0f | ||
|
|
d3017ffba8 | ||
|
|
71321bd049 | ||
|
|
866df36c94 | ||
|
|
c19350b179 | ||
|
|
81d0f72bd5 | ||
|
|
cf0385676b | ||
|
|
ed1e30e75e | ||
|
|
98c606c32d | ||
|
|
bee03685f0 | ||
|
|
1ff16d0db7 | ||
|
|
86240f476b | ||
|
|
5bb27c22ec | ||
|
|
528c2f6bd4 | ||
|
|
b7b009082a | ||
|
|
e26a4222c7 | ||
|
|
9a03850828 | ||
|
|
31d5652c3d | ||
|
|
f0e2e372db | ||
|
|
14c14bf9a2 | ||
|
|
554747d59c | ||
|
|
b3b4526bf7 | ||
|
|
2b0c5819c0 | ||
|
|
208106d179 | ||
|
|
85e1fa1b68 | ||
|
|
b6f1f0172e | ||
|
|
dc90adb539 | ||
|
|
ae6abfc5f3 | ||
|
|
c9939a2754 | ||
|
|
9ba34b2805 | ||
|
|
a1484dac77 | ||
|
|
6653cedcc7 | ||
|
|
f609120236 | ||
|
|
b48112d941 | ||
|
|
13c94eeea0 | ||
|
|
c89a5c416d | ||
|
|
d37216a411 | ||
|
|
1ee57ea853 | ||
|
|
780b55a518 | ||
|
|
256d498d0e | ||
|
|
69a410550a | ||
|
|
e4c858cd25 | ||
|
|
6f0bef61ba | ||
|
|
5bbcf30c9c | ||
|
|
930c622d11 | ||
|
|
f1989cc70f | ||
|
|
d78e91517e | ||
|
|
2a17625e1f | ||
|
|
03a0dc7713 | ||
|
|
5abf8b8378 | ||
|
|
4811785c43 | ||
|
|
57ee092abd | ||
|
|
159936d85a | ||
|
|
227fb50b2b | ||
|
|
5ad2c8315e | ||
|
|
5a68bcf532 | ||
|
|
742b8bd650 | ||
|
|
4a7c4ac81d | ||
|
|
201ac77d0c | ||
|
|
be02a33c72 | ||
|
|
f752f29af2 | ||
|
|
f5775f483a | ||
|
|
51c45eb28b | ||
|
|
c1b8c294aa | ||
|
|
aa698633b3 | ||
|
|
9f1d012d14 | ||
|
|
c1b53df345 | ||
|
|
cbcb7ff848 | ||
|
|
66cd0f6511 | ||
|
|
0cb4c43c42 | ||
|
|
b8e87bb6fc | ||
|
|
ba8a50137a | ||
|
|
ca3fa4b9cb | ||
|
|
34f0d02f38 | ||
|
|
7a846a193a | ||
|
|
6a08ec59c0 | ||
|
|
1be98b4920 | ||
|
|
1ffe2a780a | ||
|
|
a9576a1e2b | ||
|
|
93159de77d | ||
|
|
761364eec9 | ||
|
|
43471bacbc | ||
|
|
647d253ac8 | ||
|
|
800d9453a4 | ||
|
|
44726ef471 | ||
|
|
828bdebdac | ||
|
|
5b22d08d41 | ||
|
|
62e5950799 | ||
|
|
d143f8db5c | ||
|
|
a7ccc4addd | ||
|
|
f49ab2a7ed | ||
|
|
b838e1885f | ||
|
|
0f3edb13f5 |
14
.github/ISSUE_TEMPLATE/bug_report.md
vendored
14
.github/ISSUE_TEMPLATE/bug_report.md
vendored
@@ -11,10 +11,10 @@ assignees: ''
|
|||||||
|
|
||||||
- [ ] Have you provided a full/minimal spec to reproduce the issue?
|
- [ ] Have you provided a full/minimal spec to reproduce the issue?
|
||||||
- [ ] Have you validated the input using an OpenAPI validator ([example](https://apidevtools.org/swagger-parser/online/))?
|
- [ ] Have you validated the input using an OpenAPI validator ([example](https://apidevtools.org/swagger-parser/online/))?
|
||||||
- [ ] What's the version of OpenAPI Generator used?
|
- [ ] Have you [tested with the latest master](https://github.com/OpenAPITools/openapi-generator/wiki/FAQ#how-to-test-with-the-latest-master-of-openapi-generator) to confirm the issue still exists?
|
||||||
- [ ] Have you search for related issues/PRs?
|
- [ ] Have you searched for related issues/PRs?
|
||||||
- [ ] What's the actual output vs expected output?
|
- [ ] What's the actual output vs expected output?
|
||||||
- [ ] [Optional] Bounty to sponsor the fix ([example](https://www.bountysource.com/issues/66123212-javascript-client-produces-a-wrong-object-for-a-string-enum-type-that-is-used-with-ref))
|
- [ ] [Optional] Sponsorship to speed up the bug fix or feature request ([example](https://github.com/OpenAPITools/openapi-generator/issues/6178))
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
Please follow the issue template below for bug reports.
|
Please follow the issue template below for bug reports.
|
||||||
@@ -45,9 +45,13 @@ please create a Gist (https://gist.github.com) or upload it somewhere else and
|
|||||||
link it here.
|
link it here.
|
||||||
-->
|
-->
|
||||||
|
|
||||||
##### Command line used for generation
|
##### Generation Details
|
||||||
|
|
||||||
<!-- including the language, libraries and various options -->
|
<!--
|
||||||
|
Prefer CLI steps, including the language, libraries and various options.
|
||||||
|
Providing config-based settings allows for simpler testing across CLI and plugins.
|
||||||
|
For examples, see https://github.com/OpenAPITools/openapi-generator/tree/master/bin/configs
|
||||||
|
-->
|
||||||
|
|
||||||
##### Steps to reproduce
|
##### Steps to reproduce
|
||||||
|
|
||||||
|
|||||||
3
.github/PULL_REQUEST_TEMPLATE.md
vendored
3
.github/PULL_REQUEST_TEMPLATE.md
vendored
@@ -2,8 +2,9 @@
|
|||||||
|
|
||||||
<!-- Please check the completed items below -->
|
<!-- Please check the completed items below -->
|
||||||
### PR checklist
|
### PR checklist
|
||||||
|
|
||||||
- [ ] Read the [contribution guidelines](https://github.com/openapitools/openapi-generator/blob/master/CONTRIBUTING.md).
|
- [ ] Read the [contribution guidelines](https://github.com/openapitools/openapi-generator/blob/master/CONTRIBUTING.md).
|
||||||
|
- [ ] Pull Request title clearly describes the work in the pull request and Pull Request description provides details about how to validate the work. Missing information here may result in delayed response from the community.
|
||||||
- [ ] If contributing template-only or documentation-only changes which will change sample output, [build the project](https://github.com/OpenAPITools/openapi-generator#14---build-projects) beforehand.
|
- [ ] If contributing template-only or documentation-only changes which will change sample output, [build the project](https://github.com/OpenAPITools/openapi-generator#14---build-projects) beforehand.
|
||||||
- [ ] Run the shell script `./bin/generate-samples.sh`to update all Petstore samples related to your fix. This is important, as CI jobs will verify _all_ generator outputs of your HEAD commit as it would merge with master. These must match the expectations made by your contribution. You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example `./bin/generate-samples.sh bin/configs/java*`. For Windows users, please run the script in [Git BASH](https://gitforwindows.org/).
|
- [ ] Run the shell script `./bin/generate-samples.sh`to update all Petstore samples related to your fix. This is important, as CI jobs will verify _all_ generator outputs of your HEAD commit as it would merge with master. These must match the expectations made by your contribution. You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example `./bin/generate-samples.sh bin/configs/java*`. For Windows users, please run the script in [Git BASH](https://gitforwindows.org/).
|
||||||
- [ ] File the PR against the [correct branch](https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches): `master`
|
- [ ] File the PR against the [correct branch](https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches): `master`
|
||||||
|
|||||||
94
.github/workflows/check-supported-versions.yaml
vendored
Normal file
94
.github/workflows/check-supported-versions.yaml
vendored
Normal file
@@ -0,0 +1,94 @@
|
|||||||
|
name: Check Supported Java Versions
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches:
|
||||||
|
- master
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build:
|
||||||
|
name: 'Build: JDK ${{ matrix.java }} (${{ matrix.os }})'
|
||||||
|
runs-on: ${{ matrix.os }}
|
||||||
|
strategy:
|
||||||
|
matrix:
|
||||||
|
java: [8, 11]
|
||||||
|
os: [ubuntu-latest]
|
||||||
|
include:
|
||||||
|
- java: 8
|
||||||
|
os: windows-latest
|
||||||
|
- java: 13
|
||||||
|
os: ubuntu-latest
|
||||||
|
# Need to update to Gradle version with v13 support in modules/openapi-generator-gradle-plugin/pom.xml
|
||||||
|
flags: -am -pl modules/openapi-generator-cli
|
||||||
|
steps:
|
||||||
|
- name: Check out code
|
||||||
|
uses: actions/checkout@v2
|
||||||
|
|
||||||
|
- name: Set up JDK ${{ matrix.java }}
|
||||||
|
uses: actions/setup-java@v1
|
||||||
|
with:
|
||||||
|
java-version: ${{ matrix.java }}
|
||||||
|
|
||||||
|
- uses: actions/cache@v1
|
||||||
|
with:
|
||||||
|
path: ~/.m2/repository
|
||||||
|
key: ${{ runner.os }}-maven-${{ hashFiles('pom.xml', 'modules/**/pom.xml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-maven-
|
||||||
|
|
||||||
|
- uses: actions/cache@v2
|
||||||
|
with:
|
||||||
|
path: |
|
||||||
|
~/.gradle/caches
|
||||||
|
~/.gradle/wrapper
|
||||||
|
key: ${{ runner.os }}-gradle-${{ hashFiles('modules/openapi-generator-gradle-plugin/pom.xml') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-gradle-
|
||||||
|
|
||||||
|
- name: Build with Maven
|
||||||
|
shell: bash
|
||||||
|
run: mvn -nsu -B --quiet -Djacoco.skip=true -Dorg.slf4j.simpleLogger.defaultLogLevel=error --no-transfer-progress clean install --file pom.xml ${{ matrix.flags }}
|
||||||
|
|
||||||
|
- name: Upload Maven build artifact
|
||||||
|
uses: actions/upload-artifact@v1
|
||||||
|
if: matrix.java == '8' && matrix.os == 'ubuntu-latest'
|
||||||
|
with:
|
||||||
|
name: artifact
|
||||||
|
path: modules/openapi-generator-cli/target/openapi-generator-cli.jar
|
||||||
|
|
||||||
|
- name: Test Gradle plugin usage
|
||||||
|
shell: bash
|
||||||
|
run: gradle -b modules/openapi-generator-gradle-plugin/samples/local-spec/build.gradle buildGoSdk --stacktrace
|
||||||
|
|
||||||
|
- name: Test Maven plugin integration
|
||||||
|
if: matrix.java == '8'
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
cd modules/openapi-generator-maven-plugin
|
||||||
|
mvn verify -Pintegration
|
||||||
|
|
||||||
|
verify:
|
||||||
|
name: Verify outputs on ${{ matrix.os }}
|
||||||
|
needs: build
|
||||||
|
runs-on: ${{ matrix.os }}
|
||||||
|
strategy:
|
||||||
|
matrix:
|
||||||
|
os: [ubuntu-latest]
|
||||||
|
# include:
|
||||||
|
# - os: windows-latest
|
||||||
|
# flags: --skip-docs
|
||||||
|
steps:
|
||||||
|
- name: Check out code
|
||||||
|
uses: actions/checkout@v2
|
||||||
|
- name: Download build artifact
|
||||||
|
uses: actions/download-artifact@v1
|
||||||
|
with:
|
||||||
|
name: artifact
|
||||||
|
- name: Run Ensures Script
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
git config --global core.fileMode false
|
||||||
|
git config --global core.safecrlf false
|
||||||
|
git config --global core.autocrlf true
|
||||||
|
mkdir -p modules/openapi-generator-cli/target/
|
||||||
|
mv artifact/openapi-generator-cli.jar modules/openapi-generator-cli/target/
|
||||||
|
./bin/utils/ensure-up-to-date ${{ matrix.flags }}
|
||||||
9
.github/workflows/sonar.yml
vendored
9
.github/workflows/sonar.yml
vendored
@@ -4,6 +4,7 @@ on:
|
|||||||
branches:
|
branches:
|
||||||
- master
|
- master
|
||||||
- '[4-9]+.[0-9]+.x'
|
- '[4-9]+.[0-9]+.x'
|
||||||
|
- sonar
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
build:
|
build:
|
||||||
@@ -12,13 +13,13 @@ jobs:
|
|||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v1
|
- uses: actions/checkout@v1
|
||||||
- name: Set up JDK 1.8
|
- name: Set up JDK 11
|
||||||
uses: actions/setup-java@v1
|
uses: actions/setup-java@v1
|
||||||
with:
|
with:
|
||||||
java-version: 1.8
|
java-version: 11
|
||||||
- name: Compile with Maven
|
- name: Compile with Maven
|
||||||
run: mvn clean package jacoco:report
|
run: mvn -B -q clean install jacoco:report
|
||||||
- name: Jacoco Aggregate
|
- name: Jacoco Aggregate
|
||||||
run: mvn jacoco:report-aggregate
|
run: mvn jacoco:report-aggregate
|
||||||
- name: Publish to Sonar
|
- name: Publish to Sonar
|
||||||
run: mvn -B -q sonar:sonar -Dsonar.projectKey=OpenAPITools_openapi-generator -Dsonar.organization=openapitools -Dsonar.host.url=https://sonarcloud.io -Dsonar.login=${{ secrets.SONAR_LOGIN }} -Dsonar.branch.name=${GITHUB_REF##*/}
|
run: mvn -B -q -nsu sonar:sonar -Dsonar.projectKey=OpenAPITools_openapi-generator -Dsonar.organization=openapitools -Dsonar.host.url=https://sonarcloud.io -Dsonar.login=${{ secrets.SONAR_LOGIN }} -Dsonar.branch.name=${GITHUB_REF##*/}
|
||||||
|
|||||||
10
.gitignore
vendored
10
.gitignore
vendored
@@ -173,6 +173,16 @@ samples/client/petstore/python-asyncio/.venv/
|
|||||||
samples/client/petstore/python-asyncio/.pytest_cache/
|
samples/client/petstore/python-asyncio/.pytest_cache/
|
||||||
samples/client/petstore/python-tornado/.venv/
|
samples/client/petstore/python-tornado/.venv/
|
||||||
|
|
||||||
|
# PHP
|
||||||
|
samples/client/petstore/php/OpenAPIClient-php/composer.lock
|
||||||
|
samples/openapi3/server/petstore/php-symfony/SymfonyBundle-php/composer.lock
|
||||||
|
samples/openapi3/server/petstore/php-ze-ph/composer.lock
|
||||||
|
samples/server/petstore/php-laravel/lib/composer.lock
|
||||||
|
samples/server/petstore/php-lumen/lib/composer.lock
|
||||||
|
samples/server/petstore/php-slim4/composer.lock
|
||||||
|
samples/server/petstore/php-symfony/SymfonyBundle-php/composer.lock
|
||||||
|
samples/server/petstore/php-ze-ph/composer.lock
|
||||||
|
|
||||||
# ts
|
# ts
|
||||||
samples/client/petstore/typescript-angular2/npm/npm-debug.log
|
samples/client/petstore/typescript-angular2/npm/npm-debug.log
|
||||||
samples/client/petstore/typescript-node/npm/npm-debug.log
|
samples/client/petstore/typescript-node/npm/npm-debug.log
|
||||||
|
|||||||
@@ -3,10 +3,7 @@
|
|||||||
##
|
##
|
||||||
## You can build _just_ this part with:
|
## You can build _just_ this part with:
|
||||||
## docker --target builder -t container-name:builder -f .hub.cli.dockerfile .
|
## docker --target builder -t container-name:builder -f .hub.cli.dockerfile .
|
||||||
FROM jimschubert/8-jdk-alpine-mvn:1.0 as builder
|
FROM maven:3.6.3-jdk-11-openj9 as builder
|
||||||
|
|
||||||
RUN set -x && \
|
|
||||||
apk add --no-cache bash
|
|
||||||
|
|
||||||
ENV GEN_DIR /opt/openapi-generator
|
ENV GEN_DIR /opt/openapi-generator
|
||||||
WORKDIR ${GEN_DIR}
|
WORKDIR ${GEN_DIR}
|
||||||
@@ -18,11 +15,10 @@ RUN mvn -am -pl "modules/openapi-generator-cli" package
|
|||||||
## The final (release) image
|
## The final (release) image
|
||||||
## The resulting container here only needs the target jar
|
## The resulting container here only needs the target jar
|
||||||
## and ca-certificates (to be able to query HTTPS hosted specs)
|
## and ca-certificates (to be able to query HTTPS hosted specs)
|
||||||
FROM openjdk:8-jre-alpine
|
FROM openjdk:11.0.8-jre-slim-buster
|
||||||
|
|
||||||
ENV GEN_DIR /opt/openapi-generator
|
ENV GEN_DIR /opt/openapi-generator
|
||||||
|
|
||||||
RUN apk --no-cache add ca-certificates bash
|
|
||||||
RUN mkdir -p ${GEN_DIR}/modules/openapi-generator-cli/target
|
RUN mkdir -p ${GEN_DIR}/modules/openapi-generator-cli/target
|
||||||
|
|
||||||
WORKDIR ${GEN_DIR}/modules/openapi-generator-cli/target
|
WORKDIR ${GEN_DIR}/modules/openapi-generator-cli/target
|
||||||
|
|||||||
@@ -3,10 +3,7 @@
|
|||||||
##
|
##
|
||||||
## You can build _just_ this part with:
|
## You can build _just_ this part with:
|
||||||
## docker --target builder -t container-name:builder -f .hub.online.dockerfile .
|
## docker --target builder -t container-name:builder -f .hub.online.dockerfile .
|
||||||
FROM jimschubert/8-jdk-alpine-mvn:1.0 as builder
|
FROM maven:3.6.3-jdk-11-openj9 as builder
|
||||||
|
|
||||||
RUN set -x && \
|
|
||||||
apk add --no-cache bash
|
|
||||||
|
|
||||||
ENV GEN_DIR /opt/openapi-generator
|
ENV GEN_DIR /opt/openapi-generator
|
||||||
WORKDIR ${GEN_DIR}
|
WORKDIR ${GEN_DIR}
|
||||||
@@ -17,7 +14,7 @@ RUN mvn -am -pl "modules/openapi-generator-online" package
|
|||||||
|
|
||||||
## The final (release) image
|
## The final (release) image
|
||||||
## The resulting container here only needs the target jar
|
## The resulting container here only needs the target jar
|
||||||
FROM openjdk:8-jre-alpine
|
FROM openjdk:11.0.8-jre-slim-buster
|
||||||
|
|
||||||
ENV GEN_DIR /opt/openapi-generator
|
ENV GEN_DIR /opt/openapi-generator
|
||||||
ENV TARGET_DIR /generator
|
ENV TARGET_DIR /generator
|
||||||
|
|||||||
31
.travis.yml
31
.travis.yml
@@ -77,11 +77,13 @@ before_install:
|
|||||||
- docker pull swaggerapi/petstore
|
- docker pull swaggerapi/petstore
|
||||||
- docker run -d -e SWAGGER_HOST=http://petstore.swagger.io -e SWAGGER_BASE_PATH=/v2 -p 80:8080 swaggerapi/petstore
|
- docker run -d -e SWAGGER_HOST=http://petstore.swagger.io -e SWAGGER_BASE_PATH=/v2 -p 80:8080 swaggerapi/petstore
|
||||||
- docker ps -a
|
- docker ps -a
|
||||||
|
# -- skip bash test to shorten build time
|
||||||
# Add bats test framework and cURL for Bash script integration tests
|
# Add bats test framework and cURL for Bash script integration tests
|
||||||
- sudo add-apt-repository ppa:duggan/bats --yes
|
#- sudo add-apt-repository ppa:duggan/bats --yes
|
||||||
- sudo apt-get update -qq
|
#- sudo apt-get update -qq
|
||||||
- sudo apt-get install -qq bats
|
#- sudo apt-get install -qq bats
|
||||||
- sudo apt-get install -qq curl
|
#- sudo apt-get install -qq curl
|
||||||
|
# -- skip bash test end
|
||||||
# install dart
|
# install dart
|
||||||
#- sudo apt-get update
|
#- sudo apt-get update
|
||||||
#- sudo apt-get install apt-transport-https
|
#- sudo apt-get install apt-transport-https
|
||||||
@@ -93,9 +95,6 @@ before_install:
|
|||||||
- phpenv versions
|
- phpenv versions
|
||||||
- phpenv global 7.2.15
|
- phpenv global 7.2.15
|
||||||
- php -v
|
- php -v
|
||||||
# install perl module
|
|
||||||
#- cpanm --local-lib=~/perl5 local::lib && eval $(perl -I ~/perl5/lib/perl5/ -Mlocal::lib)
|
|
||||||
#- cpanm Test::Exception Test::More Log::Any LWP::UserAgent JSON URI:Query Module::Runtime DateTime Module::Find Moose::Role
|
|
||||||
# comment out below as installation failed in travis
|
# comment out below as installation failed in travis
|
||||||
# Add rebar3 build tool and recent Erlang/OTP for Erlang petstore server tests.
|
# Add rebar3 build tool and recent Erlang/OTP for Erlang petstore server tests.
|
||||||
# - Travis CI does not support rebar3 [yet](https://github.com/travis-ci/travis-ci/issues/6506#issuecomment-275189490).
|
# - Travis CI does not support rebar3 [yet](https://github.com/travis-ci/travis-ci/issues/6506#issuecomment-275189490).
|
||||||
@@ -107,9 +106,11 @@ before_install:
|
|||||||
# install Qt5
|
# install Qt5
|
||||||
- sudo apt install -y --no-install-recommends qt5-default
|
- sudo apt install -y --no-install-recommends qt5-default
|
||||||
- cmake --version
|
- cmake --version
|
||||||
|
# -- skip perl test to shorten build time
|
||||||
# perl dep
|
# perl dep
|
||||||
- cpanm --local-lib=~/perl5 local::lib && eval $(perl -I ~/perl5/lib/perl5/ -Mlocal::lib)
|
#- cpanm --local-lib=~/perl5 local::lib && eval $(perl -I ~/perl5/lib/perl5/ -Mlocal::lib)
|
||||||
- cpanm --quiet --no-interactive Test::Exception Test::More Log::Any LWP::UserAgent URI::Query Module::Runtime DateTime Module::Find Moose::Role JSON || echo "Igorned failure from cpanm"
|
#- cpanm --quiet --no-interactive Test::Exception Test::More Log::Any LWP::UserAgent URI::Query Module::Runtime DateTime Module::Find Moose::Role JSON || echo "Igorned failure from cpanm"
|
||||||
|
# -- skip perl test end
|
||||||
# show host table to confirm petstore.swagger.io is mapped to localhost
|
# show host table to confirm petstore.swagger.io is mapped to localhost
|
||||||
- cat /etc/hosts
|
- cat /etc/hosts
|
||||||
# show java version
|
# show java version
|
||||||
@@ -147,16 +148,8 @@ script:
|
|||||||
- /bin/bash ./bin/utils/detect_tab_in_java_class.sh
|
- /bin/bash ./bin/utils/detect_tab_in_java_class.sh
|
||||||
# run integration tests defined in maven pom.xml
|
# run integration tests defined in maven pom.xml
|
||||||
# WARN: Travis will timeout after 10 minutes of no stdout/stderr activity, which is problematic with mvn --quiet.
|
# WARN: Travis will timeout after 10 minutes of no stdout/stderr activity, which is problematic with mvn --quiet.
|
||||||
- mvn --no-snapshot-updates --quiet --batch-mode --show-version clean install -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
- mvn -e --no-snapshot-updates --quiet --batch-mode --show-version clean install -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
||||||
- mvn --no-snapshot-updates --quiet --batch-mode --show-version verify -Psamples -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
- mvn -e --no-snapshot-updates --quiet --batch-mode --show-version verify -Psamples -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
||||||
# test maven plugin
|
|
||||||
- mvn --no-snapshot-updates --quiet clean compile -f modules/openapi-generator-maven-plugin/examples/java-client.xml -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
|
||||||
- mvn --no-snapshot-updates --quiet clean compile -f modules/openapi-generator-maven-plugin/examples/multi-module/pom.xml -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
|
||||||
- mvn --no-snapshot-updates --quiet clean compile -f modules/openapi-generator-maven-plugin/examples/kotlin.xml -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
|
||||||
- mvn --no-snapshot-updates --quiet clean compile -f modules/openapi-generator-maven-plugin/examples/spring.xml -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
|
||||||
# test gradle plugin
|
|
||||||
- (cd modules/openapi-generator-gradle-plugin/samples/local-spec && ./gradlew buildGoSdk)
|
|
||||||
- (cd modules/openapi-generator-gradle-plugin/samples/local-spec && ./gradlew openApiGenerate)
|
|
||||||
after_success:
|
after_success:
|
||||||
# push to maven repo
|
# push to maven repo
|
||||||
- if [ $SONATYPE_USERNAME ] && [ "$TRAVIS_PULL_REQUEST" == "false" ]; then
|
- if [ $SONATYPE_USERNAME ] && [ "$TRAVIS_PULL_REQUEST" == "false" ]; then
|
||||||
|
|||||||
@@ -2,6 +2,15 @@ kind: pipeline
|
|||||||
name: default
|
name: default
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
|
# test protobuf schema generator
|
||||||
|
- name: protobuf-schema-test
|
||||||
|
image: nanoservice/protobuf-go
|
||||||
|
commands:
|
||||||
|
- protoc --version
|
||||||
|
- mkdir /var/tmp/go/
|
||||||
|
- cd samples/config/petstore/protobuf-schema
|
||||||
|
- protoc --go_out=/var/tmp/go/ services/*
|
||||||
|
- protoc --go_out=/var/tmp/go/ models/*
|
||||||
# test aspnetcore 3.x
|
# test aspnetcore 3.x
|
||||||
- name: aspnetcore-test
|
- name: aspnetcore-test
|
||||||
image: mcr.microsoft.com/dotnet/core/sdk:3.1
|
image: mcr.microsoft.com/dotnet/core/sdk:3.1
|
||||||
@@ -28,7 +37,7 @@ steps:
|
|||||||
- name: java11-test
|
- name: java11-test
|
||||||
image: openjdk:11.0
|
image: openjdk:11.0
|
||||||
commands:
|
commands:
|
||||||
- ./mvnw -quiet clean install -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
- ./mvnw --quiet clean install -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
||||||
- ./mvnw --quiet verify -Psamples.droneio -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
- ./mvnw --quiet verify -Psamples.droneio -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
||||||
# test java native client
|
# test java native client
|
||||||
- ./mvnw clean test -f samples/client/petstore/java/native/pom.xml
|
- ./mvnw clean test -f samples/client/petstore/java/native/pom.xml
|
||||||
|
|||||||
@@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
- 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: [Getting Started](https://github.com/openapitools/openapi-generator#getting-started)
|
- 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: [Getting Started](https://github.com/openapitools/openapi-generator#getting-started)
|
||||||
- Search the [open issue](https://github.com/openapitools/openapi-generator/issues) and [closed issue](https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed) to ensure no one else has reported something similar before.
|
- Search the [open issue](https://github.com/openapitools/openapi-generator/issues) and [closed issue](https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed) to ensure no one else has reported something similar before.
|
||||||
- File an [issue ticket](https://github.com/openapitools/openapi-generator/issues/new) by providing all the required information.
|
- File an [issue ticket](https://github.com/openapitools/openapi-generator/issues/new) by providing all the required information. Failure to provide enough detail may result in slow response from the community.
|
||||||
- Test with the latest master by building the JAR locally to see if the issue has already been addressed.
|
- Test with the latest master by building the JAR locally to see if the issue has already been addressed.
|
||||||
- You can also make a suggestion or ask a question by opening an "issue".
|
- You can also make a suggestion or ask a question by opening an "issue".
|
||||||
|
|
||||||
@@ -87,10 +87,7 @@ To add test cases (optional) covering the change in the code generator, please r
|
|||||||
To test the templates, please perform the following:
|
To test the templates, please perform the following:
|
||||||
|
|
||||||
- Update the Petstore sample by running the shell scripts under the `bin` folder. For example, run `./bin/generate-samples.sh .
|
- Update the Petstore sample by running the shell scripts under the `bin` folder. For example, run `./bin/generate-samples.sh .
|
||||||
/bin/configs/python*` to update the Python-related samples under [`samples`](https://github.com/openapitools/openapi-generator/t
|
/bin/configs/python*` to update the Python-related samples under [`samples`](https://github.com/openapitools/openapi-generator/tree/master/samples). For Windows, please install [GIT bash](https://gitforwindows.org/). (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)
|
||||||
ree/master/samples). For Windows, please install [GIT bash](https://gitforwindows.org/). (If you find that there are new files g
|
|
||||||
enerated or unexpected changes as a result of the update, that's not unusual as the test cases are added to the OpenAPI spec fro
|
|
||||||
m time to time. If you've questions or concerns, please open a ticket to start a discussion)
|
|
||||||
- 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 `-t` parameter: `-t modules/openapi-generator/src/main/resources/python`.
|
- 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 `-t` parameter: `-t modules/openapi-generator/src/main/resources/python`.
|
||||||
- Run the tests in the sample folder using maven `mvn integration-test -f /path/to/pom.xml`, e.g. `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)
|
- Run the tests in the sample folder using maven `mvn integration-test -f /path/to/pom.xml`, e.g. `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)
|
||||||
- Finally, git commit the updated samples files: `git commit -a`
|
- Finally, git commit the updated samples files: `git commit -a`
|
||||||
|
|||||||
@@ -1,7 +1,4 @@
|
|||||||
FROM jimschubert/8-jdk-alpine-mvn:1.0
|
FROM maven:3.6.3-jdk-11-openj9
|
||||||
|
|
||||||
RUN set -x && \
|
|
||||||
apk add --no-cache bash
|
|
||||||
|
|
||||||
ENV GEN_DIR /opt/openapi-generator
|
ENV GEN_DIR /opt/openapi-generator
|
||||||
WORKDIR ${GEN_DIR}
|
WORKDIR ${GEN_DIR}
|
||||||
@@ -29,6 +26,6 @@ RUN mvn -am -pl "modules/openapi-generator-cli" package
|
|||||||
COPY docker-entrypoint.sh /usr/local/bin/
|
COPY docker-entrypoint.sh /usr/local/bin/
|
||||||
RUN ln -s /usr/local/bin/docker-entrypoint.sh /usr/local/bin/openapi-generator
|
RUN ln -s /usr/local/bin/docker-entrypoint.sh /usr/local/bin/openapi-generator
|
||||||
|
|
||||||
ENTRYPOINT ["docker-entrypoint.sh"]
|
ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
|
||||||
|
|
||||||
CMD ["help"]
|
CMD ["help"]
|
||||||
|
|||||||
78
README.md
78
README.md
@@ -1,21 +1,22 @@
|
|||||||
<h1 align="center">OpenAPI Generator</h1>
|
<h1 align="center">OpenAPI Generator</h1>
|
||||||
|
|
||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
[Master](https://github.com/OpenAPITools/openapi-generator/tree/master) (`5.0.0`): [](https://travis-ci.org/OpenAPITools/openapi-generator)
|
[](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.openapitools%22%20AND%20a%3A%22openapi-generator%22) [](./LICENSE)  [](https://join.slack.com/t/openapi-generator/shared_invite/enQtNzAyNDMyOTU0OTE1LTY5ZDBiNDI5NzI5ZjQ1Y2E5OWVjMjZkYzY1ZGM2MWQ4YWFjMzcyNDY5MGI4NjQxNDBiMTlmZTc5NjY2ZTQ5MGM) [](https://twitter.com/oas_generator)
|
||||||
[](https://circleci.com/gh/OpenAPITools/openapi-generator)
|
|
||||||
[](https://app.shippable.com/github/OpenAPITools/openapi-generator)
|
|
||||||
[](https://ci.appveyor.com/project/WilliamCheng/openapi-generator-wh2wu)
|
|
||||||
[](https://cloud.drone.io/OpenAPITools/openapi-generator)
|
|
||||||
[](https://app.bitrise.io/app/4a2b10a819d12b67)
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
[](https://join.slack.com/t/openapi-generator/shared_invite/enQtNzAyNDMyOTU0OTE1LTY5ZDBiNDI5NzI5ZjQ1Y2E5OWVjMjZkYzY1ZGM2MWQ4YWFjMzcyNDY5MGI4NjQxNDBiMTlmZTc5NjY2ZTQ5MGM)
|
[Master](https://github.com/OpenAPITools/openapi-generator/tree/master) (`5.0.0`):
|
||||||
[](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.openapitools%22%20AND%20a%3A%22openapi-generator%22)
|
[](https://travis-ci.org/OpenAPITools/openapi-generator)
|
||||||
[](https://twitter.com/oas_generator)
|
[](https://circleci.com/gh/OpenAPITools/openapi-generator)
|
||||||
|
[](https://app.shippable.com/github/OpenAPITools/openapi-generator)
|
||||||
|
[](https://ci.appveyor.com/project/WilliamCheng/openapi-generator-wh2wu)
|
||||||
|
[](https://cloud.drone.io/OpenAPITools/openapi-generator)
|
||||||
|
[](https://app.bitrise.io/app/4a2b10a819d12b67)
|
||||||
|
[](https://github.com/OpenAPITools/openapi-generator/actions?query=workflow%3A%22Check+Supported+Java+Versions%22)
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -59,7 +60,7 @@ OpenAPI Generator allows generation of API client libraries (SDK generation), se
|
|||||||
|
|
||||||
| | Languages/Frameworks |
|
| | Languages/Frameworks |
|
||||||
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
| **API clients** | **ActionScript**, **Ada**, **Apex**, **Bash**, **C**, **C#** (.net 2.0, 3.5 or later, .NET Standard 1.3 - 2.0, .NET Core 2.0), **C++** (cpp-restsdk, Qt5, Tizen), **Clojure**, **Dart (1.x, 2.x)**, **Elixir**, **Elm**, **Eiffel**, **Erlang**, **Go**, **Groovy**, **Haskell** (http-client, Servant), **Java** (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured, Spring 5 Web Client, MicroProfile Rest Client), **k6**, **Kotlin**, **Lua**, **Nim**, **Node.js/JavaScript** (ES5, ES6, AngularJS with Google Closure Compiler annotations, Flow types, Apollo GraphQL DataStore), **Objective-C**, **OCaml**, **Perl**, **PHP**, **PowerShell**, **Python**, **R**, **Ruby**, **Rust** (rust, rust-server), **Scala** (akka, http4s, scalaz, sttp, swagger-async-httpclient), **Swift** (2.x, 3.x, 4.x, 5.x), **Typescript** (AngularJS, Angular (2.x - 8.x), Aurelia, Axios, Fetch, Inversify, jQuery, Node, Rxjs) |
|
| **API clients** | **ActionScript**, **Ada**, **Apex**, **Bash**, **C**, **C#** (.net 2.0, 3.5 or later, .NET Standard 1.3 - 2.0, .NET Core 2.0), **C++** (cpp-restsdk, Qt5, Tizen), **Clojure**, **Dart**, **Elixir**, **Elm**, **Eiffel**, **Erlang**, **Go**, **Groovy**, **Haskell** (http-client, Servant), **Java** (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured, Spring 5 Web Client, MicroProfile Rest Client), **k6**, **Kotlin**, **Lua**, **Nim**, **Node.js/JavaScript** (ES5, ES6, AngularJS with Google Closure Compiler annotations, Flow types, Apollo GraphQL DataStore), **Objective-C**, **OCaml**, **Perl**, **PHP**, **PowerShell**, **Python**, **R**, **Ruby**, **Rust** (rust, rust-server), **Scala** (akka, http4s, scalaz, sttp, swagger-async-httpclient), **Swift** (2.x, 3.x, 4.x, 5.x), **Typescript** (AngularJS, Angular (2.x - 8.x), Aurelia, Axios, Fetch, Inversify, jQuery, Node, Rxjs) |
|
||||||
| **Server stubs** | **Ada**, **C#** (ASP.NET Core, NancyFx), **C++** (Pistache, Restbed, Qt5 QHTTPEngine), **Erlang**, **F#** (Giraffe), **Go** (net/http, Gin), **Haskell** (Servant), **Java** (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, Jersey, RestEasy, Play Framework, [PKMST](https://github.com/ProKarma-Inc/pkmst-getting-started-examples), [Vert.x](https://vertx.io/)), **Kotlin** (Spring Boot, Ktor, Vertx), **PHP** (Laravel, Lumen, Slim, Silex, [Symfony](https://symfony.com/), [Zend Expressive](https://github.com/zendframework/zend-expressive)), **Python** (Flask), **NodeJS**, **Ruby** (Sinatra, Rails5), **Rust** (rust-server), **Scala** (Akka, [Finch](https://github.com/finagle/finch), [Lagom](https://github.com/lagom/lagom), [Play](https://www.playframework.com/), Scalatra) |
|
| **Server stubs** | **Ada**, **C#** (ASP.NET Core, NancyFx), **C++** (Pistache, Restbed, Qt5 QHTTPEngine), **Erlang**, **F#** (Giraffe), **Go** (net/http, Gin), **Haskell** (Servant), **Java** (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, Jersey, RestEasy, Play Framework, [PKMST](https://github.com/ProKarma-Inc/pkmst-getting-started-examples), [Vert.x](https://vertx.io/)), **Kotlin** (Spring Boot, Ktor, Vertx), **PHP** (Laravel, Lumen, Slim, Silex, [Symfony](https://symfony.com/), [Zend Expressive](https://github.com/zendframework/zend-expressive)), **Python** (Flask), **NodeJS**, **Ruby** (Sinatra, Rails5), **Rust** (rust-server), **Scala** (Akka, [Finch](https://github.com/finagle/finch), [Lagom](https://github.com/lagom/lagom), [Play](https://www.playframework.com/), Scalatra) |
|
||||||
| **API documentation generators** | **HTML**, **Confluence Wiki**, **Asciidoc** |
|
| **API documentation generators** | **HTML**, **Confluence Wiki**, **Asciidoc** |
|
||||||
| **Configuration files** | [**Apache2**](https://httpd.apache.org/) |
|
| **Configuration files** | [**Apache2**](https://httpd.apache.org/) |
|
||||||
@@ -102,7 +103,8 @@ The OpenAPI Specification has undergone 3 revisions since initial creation in 20
|
|||||||
| OpenAPI Generator Version | Release Date | Notes |
|
| OpenAPI Generator Version | Release Date | Notes |
|
||||||
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------- |
|
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------- |
|
||||||
| 5.0.0 (upcoming major release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/5.0.0-SNAPSHOT/) | TBD | Major release with breaking changes (no fallback) |
|
| 5.0.0 (upcoming major release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/5.0.0-SNAPSHOT/) | TBD | Major release with breaking changes (no fallback) |
|
||||||
| 5.0.0-beta2 (upcoming beta release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/5.0.0-SNAPSHOT/) | 30.07.2020 | Major beta release with breaking changes (no fallback) |
|
| 5.0.0-beta3 (upcoming beta release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/5.0.0-SNAPSHOT/) | 01.11.2020 | Major beta release with breaking changes (no fallback) |
|
||||||
|
| [5.0.0-beta2](https://github.com/OpenAPITools/openapi-generator/releases/tag/v5.0.0-beta2) (latest beta release) | 04.09.2020 | Major beta release with breaking changes (no fallback) |
|
||||||
| [5.0.0-beta](https://github.com/OpenAPITools/openapi-generator/releases/tag/v5.0.0-beta) (latest beta release) | 30.06.2020 | Major beta release with breaking changes (no fallback) |
|
| [5.0.0-beta](https://github.com/OpenAPITools/openapi-generator/releases/tag/v5.0.0-beta) (latest beta release) | 30.06.2020 | Major beta release with breaking changes (no fallback) |
|
||||||
| [4.3.1](https://github.com/OpenAPITools/openapi-generator/releases/tag/v4.3.1) (latest stable release) | 06.05.2020 | Patch release (enhancements, bug fixes, etc) |
|
| [4.3.1](https://github.com/OpenAPITools/openapi-generator/releases/tag/v4.3.1) (latest stable release) | 06.05.2020 | Patch release (enhancements, bug fixes, etc) |
|
||||||
|
|
||||||
@@ -160,16 +162,16 @@ See the different versions of the [openapi-generator-cli](https://mvnrepository.
|
|||||||
<!-- RELEASE_VERSION -->
|
<!-- RELEASE_VERSION -->
|
||||||
If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):
|
If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):
|
||||||
|
|
||||||
JAR location: `https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta/openapi-generator-cli-5.0.0-beta.jar`
|
JAR location: `https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta2/openapi-generator-cli-5.0.0-beta2.jar`
|
||||||
|
|
||||||
For **Mac/Linux** users:
|
For **Mac/Linux** users:
|
||||||
```sh
|
```sh
|
||||||
wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta/openapi-generator-cli-5.0.0-beta.jar -O openapi-generator-cli.jar
|
wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta2/openapi-generator-cli-5.0.0-beta2.jar -O openapi-generator-cli.jar
|
||||||
```
|
```
|
||||||
|
|
||||||
For **Windows** users, you will need to install [wget](http://gnuwin32.sourceforge.net/packages/wget.htm) or you can use Invoke-WebRequest in PowerShell (3.0+), e.g.
|
For **Windows** users, you will need to install [wget](http://gnuwin32.sourceforge.net/packages/wget.htm) or you can use Invoke-WebRequest in PowerShell (3.0+), e.g.
|
||||||
```
|
```
|
||||||
Invoke-WebRequest -OutFile openapi-generator-cli.jar https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta/openapi-generator-cli-5.0.0-beta.jar
|
Invoke-WebRequest -OutFile openapi-generator-cli.jar https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta2/openapi-generator-cli-5.0.0-beta2.jar
|
||||||
```
|
```
|
||||||
|
|
||||||
After downloading the JAR, run `java -jar openapi-generator-cli.jar help` to show the usage.
|
After downloading the JAR, run `java -jar openapi-generator-cli.jar help` to show the usage.
|
||||||
@@ -253,7 +255,7 @@ To install, run `brew install openapi-generator`
|
|||||||
|
|
||||||
Here is an example usage to generate a Ruby client:
|
Here is an example usage to generate a Ruby client:
|
||||||
```sh
|
```sh
|
||||||
openapi-generator generate -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g ruby -o /tmp/test/
|
openapi-generator generate -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g ruby -o /tmp/test/
|
||||||
```
|
```
|
||||||
|
|
||||||
To reinstall with the latest master, run `brew uninstall openapi-generator && brew install --HEAD openapi-generator`
|
To reinstall with the latest master, run `brew uninstall openapi-generator && brew install --HEAD openapi-generator`
|
||||||
@@ -288,7 +290,7 @@ Example:
|
|||||||
|
|
||||||
```sh
|
```sh
|
||||||
docker run --rm -v "${PWD}:/local" openapitools/openapi-generator-cli generate \
|
docker run --rm -v "${PWD}:/local" openapitools/openapi-generator-cli generate \
|
||||||
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-g go \
|
-g go \
|
||||||
-o /local/out/go
|
-o /local/out/go
|
||||||
```
|
```
|
||||||
@@ -313,12 +315,12 @@ GEN_IP=$(docker inspect --format '{{.NetworkSettings.IPAddress}}' $CID)
|
|||||||
|
|
||||||
# Execute an HTTP request to generate a Ruby client
|
# Execute an HTTP request to generate a Ruby client
|
||||||
> curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' \
|
> curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' \
|
||||||
-d '{"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml"}' \
|
-d '{"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"}' \
|
||||||
'http://localhost:8888/api/gen/clients/ruby'
|
'http://localhost:8888/api/gen/clients/ruby'
|
||||||
|
|
||||||
{"code":"c2d483.3.4672-40e9-91df-b9ffd18d22b8","link":"http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8"}
|
{"code":"c2d483.3.4672-40e9-91df-b9ffd18d22b8","link":"http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8"}
|
||||||
|
|
||||||
# Download the generated zip file
|
# Download the generated zip file
|
||||||
> wget http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8
|
> wget http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8
|
||||||
|
|
||||||
# Unzip the file
|
# Unzip the file
|
||||||
@@ -349,7 +351,7 @@ Once built, `run-in-docker.sh` will act as an executable for openapi-generator-c
|
|||||||
./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli
|
./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli
|
||||||
./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli
|
./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli
|
||||||
./run-in-docker.sh /gen/bin/go-petstore.sh # Builds the Go client
|
./run-in-docker.sh /gen/bin/go-petstore.sh # Builds the Go client
|
||||||
./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-g go -o /gen/out/go-petstore --package-name=petstore # generates go client, outputs locally to ./out/go-petstore
|
-g go -o /gen/out/go-petstore --package-name=petstore # generates go client, outputs locally to ./out/go-petstore
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -387,14 +389,14 @@ Install it globally to get the CLI available on the command line:
|
|||||||
|
|
||||||
```sh
|
```sh
|
||||||
npm install @openapitools/openapi-generator-cli -g
|
npm install @openapitools/openapi-generator-cli -g
|
||||||
openapi-generator version
|
openapi-generator-cli version
|
||||||
```
|
```
|
||||||
|
|
||||||
<!-- RELEASE_VERSION -->
|
<!-- RELEASE_VERSION -->
|
||||||
Or install a particular OpenAPI Generator version (e.g. v5.0.0-beta):
|
To use a specific version of "openapi-generator-cli"
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
npm install @openapitools/openapi-generator-cli@cli-5.0.0-beta -g
|
openapi-generator-cli version-manager set 4.3.1
|
||||||
```
|
```
|
||||||
|
|
||||||
Or install it as dev-dependency:
|
Or install it as dev-dependency:
|
||||||
@@ -405,20 +407,20 @@ npm install @openapitools/openapi-generator-cli -D
|
|||||||
<!-- /RELEASE_VERSION -->
|
<!-- /RELEASE_VERSION -->
|
||||||
## [2 - Getting Started](#table-of-contents)
|
## [2 - Getting Started](#table-of-contents)
|
||||||
|
|
||||||
To generate a PHP client for [petstore.yaml](https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml), please run the following
|
To generate a PHP client for [petstore.yaml](https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml), please run the following
|
||||||
```sh
|
```sh
|
||||||
git clone https://github.com/openapitools/openapi-generator
|
git clone https://github.com/openapitools/openapi-generator
|
||||||
cd openapi-generator
|
cd openapi-generator
|
||||||
mvn clean package
|
mvn clean package
|
||||||
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
||||||
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-g php \
|
-g php \
|
||||||
-o /var/tmp/php_api_client
|
-o /var/tmp/php_api_client
|
||||||
```
|
```
|
||||||
(if you're on Windows, replace the last command with `java -jar modules\openapi-generator-cli\target\openapi-generator-cli.jar generate -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g php -o c:\temp\php_api_client`)
|
(if you're on Windows, replace the last command with `java -jar modules\openapi-generator-cli\target\openapi-generator-cli.jar generate -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g php -o c:\temp\php_api_client`)
|
||||||
|
|
||||||
<!-- RELEASE_VERSION -->
|
<!-- RELEASE_VERSION -->
|
||||||
You can also download the JAR (latest release) directly from [maven.org](https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta/openapi-generator-cli-5.0.0-beta.jar)
|
You can also download the JAR (latest release) directly from [maven.org](https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta2/openapi-generator-cli-5.0.0-beta2.jar)
|
||||||
<!-- /RELEASE_VERSION -->
|
<!-- /RELEASE_VERSION -->
|
||||||
|
|
||||||
To get a list of **general** options available, please run `java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar help generate`
|
To get a list of **general** options available, please run `java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar help generate`
|
||||||
@@ -428,7 +430,7 @@ To get a list of PHP specified options (which can be passed to the generator wit
|
|||||||
## [3 - Usage](#table-of-contents)
|
## [3 - Usage](#table-of-contents)
|
||||||
|
|
||||||
### To generate a sample client library
|
### To generate a sample client library
|
||||||
You can build a client against the [Petstore API](https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml) as follows:
|
You can build a client against the [Petstore API](https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml) as follows:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
./bin/java-petstore-okhttp-gson.sh
|
./bin/java-petstore-okhttp-gson.sh
|
||||||
@@ -440,7 +442,7 @@ This script uses the default library, which is `okhttp-gson`. It will run the ge
|
|||||||
|
|
||||||
```sh
|
```sh
|
||||||
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
||||||
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-g java \
|
-g java \
|
||||||
-o samples/client/petstore/java/okhttp-gson
|
-o samples/client/petstore/java/okhttp-gson
|
||||||
```
|
```
|
||||||
@@ -561,6 +563,7 @@ Here is a list of community-conitributed IDE plug-ins that integrate with OpenAP
|
|||||||
Here are some companies/projects (alphabetical order) using OpenAPI Generator in production. To add your company/project to the list, please visit [README.md](README.md) and click on the icon to edit the page.
|
Here are some companies/projects (alphabetical order) using OpenAPI Generator in production. To add your company/project to the list, please visit [README.md](README.md) and click on the icon to edit the page.
|
||||||
|
|
||||||
- [Adaptant Solutions AG](https://www.adaptant.io/)
|
- [Adaptant Solutions AG](https://www.adaptant.io/)
|
||||||
|
- [adesso SE](https://www.adesso.de/)
|
||||||
- [Agoda](https://www.agoda.com/)
|
- [Agoda](https://www.agoda.com/)
|
||||||
- [Allianz](https://www.allianz.com)
|
- [Allianz](https://www.allianz.com)
|
||||||
- [Angular.Schule](https://angular.schule/)
|
- [Angular.Schule](https://angular.schule/)
|
||||||
@@ -621,25 +624,30 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
|
|||||||
- [openVALIDATION](https://openvalidation.io/)
|
- [openVALIDATION](https://openvalidation.io/)
|
||||||
- [Oracle](https://www.oracle.com/)
|
- [Oracle](https://www.oracle.com/)
|
||||||
- [Paxos](https://www.paxos.com)
|
- [Paxos](https://www.paxos.com)
|
||||||
|
- [PLAID, Inc.](https://plaid.co.jp/)
|
||||||
- [Ponicode](https://ponicode.dev/)
|
- [Ponicode](https://ponicode.dev/)
|
||||||
- [Pricefx](https://www.pricefx.com/)
|
- [Pricefx](https://www.pricefx.com/)
|
||||||
- [Prometheus/Alertmanager](https://github.com/prometheus/alertmanager)
|
- [Prometheus/Alertmanager](https://github.com/prometheus/alertmanager)
|
||||||
- [QEDIT](https://qed-it.com)
|
- [QEDIT](https://qed-it.com)
|
||||||
- [Qulix Systems](https://www.qulix.com)
|
- [Qulix Systems](https://www.qulix.com)
|
||||||
|
- [Raksul](https://corp.raksul.com)
|
||||||
- [Raiffeisen Schweiz Genossenschaft](https://www.raiffeisen.ch)
|
- [Raiffeisen Schweiz Genossenschaft](https://www.raiffeisen.ch)
|
||||||
- [RedHat](https://www.redhat.com)
|
- [RedHat](https://www.redhat.com)
|
||||||
- [RepreZen API Studio](https://www.reprezen.com/swagger-openapi-code-generation-api-first-microservices-enterprise-development)
|
- [RepreZen API Studio](https://www.reprezen.com/swagger-openapi-code-generation-api-first-microservices-enterprise-development)
|
||||||
- [REST United](https://restunited.com)
|
- [REST United](https://restunited.com)
|
||||||
- [Robotinfra](https://www.robotinfra.com)
|
- [Robotinfra](https://www.robotinfra.com)
|
||||||
|
- [SmartHR](https://smarthr.co.jp/)
|
||||||
- [Sony Interactive Entertainment](https://www.sie.com/en/index.html)
|
- [Sony Interactive Entertainment](https://www.sie.com/en/index.html)
|
||||||
- [Splitit](https://www.splitit.com/)
|
- [Splitit](https://www.splitit.com/)
|
||||||
- [Stingray](http://www.stingray.com)
|
- [Stingray](http://www.stingray.com)
|
||||||
- [Suva](https://www.suva.ch/)
|
- [Suva](https://www.suva.ch/)
|
||||||
- [Telstra](https://dev.telstra.com)
|
- [Telstra](https://dev.telstra.com)
|
||||||
- [TravelTime platform](https://www.traveltimeplatform.com/)
|
- [TravelTime platform](https://www.traveltimeplatform.com/)
|
||||||
|
- [TribalScale](https://www.tribalscale.com)
|
||||||
- [TUI InfoTec GmbH](http://www.tui-infotec.com/)
|
- [TUI InfoTec GmbH](http://www.tui-infotec.com/)
|
||||||
- [unblu inc.](https://www.unblu.com/)
|
- [unblu inc.](https://www.unblu.com/)
|
||||||
- [Veamly](https://www.veamly.com/)
|
- [Veamly](https://www.veamly.com/)
|
||||||
|
- [wbt-solutions](https://www.wbt-solutions.de/)
|
||||||
- [Woleet](https://www.woleet.io/)
|
- [Woleet](https://www.woleet.io/)
|
||||||
- [WSO2](https://wso2.com/)
|
- [WSO2](https://wso2.com/)
|
||||||
- [Vouchery.io](https://vouchery.io)
|
- [Vouchery.io](https://vouchery.io)
|
||||||
@@ -671,7 +679,7 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
|
|||||||
- 2019/01/03 - [Calling a Swagger service from Apex using openapi-generator](https://lekkimworld.com/2019/01/03/calling-a-swagger-service-from-apex-using-openapi-generator/) by [Mikkel Flindt Heisterberg](https://lekkimworld.com)
|
- 2019/01/03 - [Calling a Swagger service from Apex using openapi-generator](https://lekkimworld.com/2019/01/03/calling-a-swagger-service-from-apex-using-openapi-generator/) by [Mikkel Flindt Heisterberg](https://lekkimworld.com)
|
||||||
- 2019/01/13 - [OpenAPI GeneratorでRESTful APIの定義書から色々自動生成する](https://ky-yk-d.hatenablog.com/entry/2019/01/13/234108) by [@ky_yk_d](https://twitter.com/ky_yk_d)
|
- 2019/01/13 - [OpenAPI GeneratorでRESTful APIの定義書から色々自動生成する](https://ky-yk-d.hatenablog.com/entry/2019/01/13/234108) by [@ky_yk_d](https://twitter.com/ky_yk_d)
|
||||||
- 2019/01/20 - [Contract-First API Development with OpenAPI Generator and Connexion](https://medium.com/commencis/contract-first-api-development-with-openapi-generator-and-connexion-b21bbf2f9244) by [Anil Can Aydin](https://github.com/anlcnydn)
|
- 2019/01/20 - [Contract-First API Development with OpenAPI Generator and Connexion](https://medium.com/commencis/contract-first-api-development-with-openapi-generator-and-connexion-b21bbf2f9244) by [Anil Can Aydin](https://github.com/anlcnydn)
|
||||||
- 2019/01/30 - [Rapid Application Development With API First Approach Using Open-API Generator](https://dzone.com/articles/rapid-api-development-using-open-api-generator) by [Milan Sonkar](https://dzone.com/users/828329/milan_sonkar.html)
|
- 2019/01/30 - [Rapid Application Development With API First Approach Using Open-API Generator](https://dzone.com/articles/rapid-api-development-using-open-api-generator) by [Milan Sonkar](https://dzone.com/users/828329/milan_sonkar.html)
|
||||||
- 2019/02/02 - [平静を保ち、コードを生成せよ 〜 OpenAPI Generator誕生の背景と軌跡 〜](https://speakerdeck.com/akihito_nakano/gunmaweb34) by [中野暁人](https://github.com/ackintosh) at [Gunma.web #34 スキーマ駆動開発](https://gunmaweb.connpass.com/event/113974/)
|
- 2019/02/02 - [平静を保ち、コードを生成せよ 〜 OpenAPI Generator誕生の背景と軌跡 〜](https://speakerdeck.com/akihito_nakano/gunmaweb34) by [中野暁人](https://github.com/ackintosh) at [Gunma.web #34 スキーマ駆動開発](https://gunmaweb.connpass.com/event/113974/)
|
||||||
- 2019/02/20 - [An adventure in OpenAPI V3 code generation](https://mux.com/blog/an-adventure-in-openapi-v3-api-code-generation/) by [Phil Cluff](https://mux.com/blog/author/philc/)
|
- 2019/02/20 - [An adventure in OpenAPI V3 code generation](https://mux.com/blog/an-adventure-in-openapi-v3-api-code-generation/) by [Phil Cluff](https://mux.com/blog/author/philc/)
|
||||||
- 2019/02/26 - [Building API Services: A Beginner’s Guide](https://medium.com/google-cloud/building-api-services-a-beginners-guide-7274ae4c547f) by [Ratros Y.](https://medium.com/@ratrosy) in [Google Cloud Platofrm Blog](https://medium.com/google-cloud)
|
- 2019/02/26 - [Building API Services: A Beginner’s Guide](https://medium.com/google-cloud/building-api-services-a-beginners-guide-7274ae4c547f) by [Ratros Y.](https://medium.com/@ratrosy) in [Google Cloud Platofrm Blog](https://medium.com/google-cloud)
|
||||||
@@ -767,6 +775,16 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
|
|||||||
- 2020-07-20 - [Datadog API client libraries now available for Java and Go](https://www.datadoghq.com/blog/java-go-libraries/) by Jordan Obey at [Datadog Blog](https://www.datadoghq.com/blog)
|
- 2020-07-20 - [Datadog API client libraries now available for Java and Go](https://www.datadoghq.com/blog/java-go-libraries/) by Jordan Obey at [Datadog Blog](https://www.datadoghq.com/blog)
|
||||||
- 2020-07-23 - [Generate Client SDK for .NET Core using Open Api](https://dev.to/no0law1/generate-client-sdk-for-net-core-using-open-api-2dgh) by [Nuno Reis](https://dev.to/no0law1)
|
- 2020-07-23 - [Generate Client SDK for .NET Core using Open Api](https://dev.to/no0law1/generate-client-sdk-for-net-core-using-open-api-2dgh) by [Nuno Reis](https://dev.to/no0law1)
|
||||||
- 2020-07-26 - [Dartのhttp_interceptorライブラリを使うと配列のクエリパラメータが消えてしまう件の応急処置](https://qiita.com/gyamoto/items/eeeff81b6770487319ed) by [@gyamoto](https://qiita.com/gyamoto)
|
- 2020-07-26 - [Dartのhttp_interceptorライブラリを使うと配列のクエリパラメータが消えてしまう件の応急処置](https://qiita.com/gyamoto/items/eeeff81b6770487319ed) by [@gyamoto](https://qiita.com/gyamoto)
|
||||||
|
- 2020-08-01 - [Generate Angular ReactiveForms from Swagger/OpenAPI](https://dev.to/martinmcwhorter/generate-angular-reactiveforms-from-swagger-openapi-35h9) by [Martin McWhorter](https://dev.to/martinmcwhorter)
|
||||||
|
- 2020-08-03 - [Criando Bibliotecas para APIs RESTful com OpenAPI, Swagger Editor e OpenAPI Generator](https://medium.com/@everisBrasil/criando-bibliotecas-para-apis-restful-com-openapi-swagger-editor-e-openapi-generator-75349a6420fd) by [everis Brasil (an NTT DATA Company)](https://medium.com/@everisBrasil)
|
||||||
|
- 2020-08-19 - [マイクロサービスを連携してみよう](https://thinkit.co.jp/article/17704) by [岡井 裕矢(おかい ゆうや)](https://thinkit.co.jp/author/17588), [泉 勝(いずみ まさる)](https://thinkit.co.jp/author/17705) at [Think IT(シンクイット)](https://thinkit.co.jp/)
|
||||||
|
- 2020-08-25 - [OpenAPI Generator と TypeScript で型安全にフロントエンド開発をしている話](https://tech.smarthr.jp/entry/2020/08/25/135631) at [SmartHR Tech Blog](https://tech.smarthr.jp/)
|
||||||
|
- 2020-09-10 - [Introduction to OpenAPI with Instana](https://www.instana.com/blog/introduction-to-openapi-with-instana/) by [Cedric Ziel](https://www.instana.com/blog/author/cedricziel/) at [Instana Blog](https://www.instana.com/blog/)
|
||||||
|
- 2020-09-17 - [Generate PowerShellSDK using openapi-generator](https://medium.com/@ghufz.learn/generate-powershellsdk-using-openapi-generator-33b700891e33) by [Ghufran Zahidi](https://medium.com/@ghufz.learn)
|
||||||
|
- 2020-09-24 - [How to automate API code generation (OpenAPI/Swagger) and boost productivity - Tutorial with React Native featuring TypeScript](https://medium.com/@sceleski/how-to-automate-api-code-generation-openapi-swagger-and-boost-productivity-1176a0056d8a) by [Sanjin Celeski](https://medium.com/@sceleski)
|
||||||
|
- 2020-09-25 - [Generate OpenAPI Angular Client](https://medium.com/@pguso/generate-openapi-angular-client-8c9288e8bbd4) by [Patric](https://medium.com/@pguso)
|
||||||
|
- 2020-10-24 - [Working with Microsoft Identity - React Native Client](https://www.josephguadagno.net/2020/10/24/working-with-microsoft-identity-react-native-client) by [Joseph Guadagno](https://www.josephguadagno.net/)
|
||||||
|
- 2020-10-31 - [[B2] OpenAPI Specification으로 타입-세이프하게 API 개발하기: 희망편 VS 절망편](https://www.youtube.com/watch?v=J4JHLESAiFk) by 최태건 at [FEConf 2020](https://2020.feconf.kr/)
|
||||||
|
|
||||||
## [6 - About Us](#table-of-contents)
|
## [6 - About Us](#table-of-contents)
|
||||||
|
|
||||||
@@ -1052,7 +1070,7 @@ OpenAPI Generator is a fork of [Swagger Codegen](https://github.com/swagger-api/
|
|||||||
## [7 - License](#table-of-contents)
|
## [7 - License](#table-of-contents)
|
||||||
-------
|
-------
|
||||||
|
|
||||||
Copyright 2018 OpenAPI-Generator Contributors (https://openapi-generator.tech)
|
Copyright 2018 OpenAPI-Generator Contributors (https://openapi-generator.tech)
|
||||||
Copyright 2018 SmartBear Software
|
Copyright 2018 SmartBear Software
|
||||||
|
|
||||||
Licensed under the Apache License, Version 2.0 (the "License");
|
Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
|||||||
18
appveyor.yml
18
appveyor.yml
@@ -1,5 +1,5 @@
|
|||||||
version: '{branch}-{build}'
|
version: '{branch}-{build}'
|
||||||
image: Visual Studio 2017
|
image: Visual Studio 2019
|
||||||
hosts:
|
hosts:
|
||||||
petstore.swagger.io: 127.0.0.1
|
petstore.swagger.io: 127.0.0.1
|
||||||
install:
|
install:
|
||||||
@@ -15,14 +15,14 @@ install:
|
|||||||
# install gradle
|
# install gradle
|
||||||
- ps: |
|
- ps: |
|
||||||
Add-Type -AssemblyName System.IO.Compression.FileSystem
|
Add-Type -AssemblyName System.IO.Compression.FileSystem
|
||||||
if (!(Test-Path -Path "C:\gradle" )) {
|
if (!(Test-Path -Path "C:\gradle\gradle-5.6.4" )) {
|
||||||
(new-object System.Net.WebClient).DownloadFile(
|
(new-object System.Net.WebClient).DownloadFile(
|
||||||
'https://services.gradle.org/distributions/gradle-5.3.1-bin.zip',
|
'https://services.gradle.org/distributions/gradle-5.6.4-bin.zip',
|
||||||
'C:\gradle-bin.zip'
|
'C:\gradle-bin.zip'
|
||||||
)
|
)
|
||||||
[System.IO.Compression.ZipFile]::ExtractToDirectory("C:\gradle-bin.zip", "C:\gradle")
|
[System.IO.Compression.ZipFile]::ExtractToDirectory("C:\gradle-bin.zip", "C:\gradle")
|
||||||
}
|
}
|
||||||
- cmd: SET PATH=C:\maven\apache-maven-3.2.5\bin;C:\gradle\gradle-5.3.1\bin;%JAVA_HOME%\bin;%PATH%
|
- cmd: SET PATH=C:\maven\apache-maven-3.2.5\bin;C:\gradle\gradle-5.6.4\bin;%JAVA_HOME%\bin;%PATH%
|
||||||
- cmd: SET MAVEN_OPTS=-Xmx4g
|
- cmd: SET MAVEN_OPTS=-Xmx4g
|
||||||
- cmd: SET JAVA_OPTS=-Xmx4g
|
- cmd: SET JAVA_OPTS=-Xmx4g
|
||||||
- cmd: SET M2_HOME=C:\maven\apache-maven-3.2.5
|
- cmd: SET M2_HOME=C:\maven\apache-maven-3.2.5
|
||||||
@@ -38,6 +38,8 @@ build_script:
|
|||||||
# build C# API client (netcore)
|
# build C# API client (netcore)
|
||||||
- dotnet build samples\client\petstore\csharp-netcore\OpenAPIClient\Org.OpenAPITools.sln
|
- dotnet build samples\client\petstore\csharp-netcore\OpenAPIClient\Org.OpenAPITools.sln
|
||||||
- dotnet build samples\client\petstore\csharp-netcore\OpenAPIClientCore\Org.OpenAPITools.sln
|
- dotnet build samples\client\petstore\csharp-netcore\OpenAPIClientCore\Org.OpenAPITools.sln
|
||||||
|
# build C# API client (.net framework 4.7)
|
||||||
|
- dotnet build samples\client\petstore\csharp-netcore\OpenAPIClient-net47\Org.OpenAPITools.sln
|
||||||
# build C# API client
|
# build C# API client
|
||||||
- nuget restore samples\client\petstore\csharp\OpenAPIClient\Org.OpenAPITools.sln
|
- nuget restore samples\client\petstore\csharp\OpenAPIClient\Org.OpenAPITools.sln
|
||||||
- msbuild samples\client\petstore\csharp\OpenAPIClient\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
|
- msbuild samples\client\petstore\csharp\OpenAPIClient\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
|
||||||
@@ -45,16 +47,18 @@ build_script:
|
|||||||
- nuget restore samples\client\petstore\csharp\OpenAPIClientWithPropertyChanged\Org.OpenAPITools.sln
|
- nuget restore samples\client\petstore\csharp\OpenAPIClientWithPropertyChanged\Org.OpenAPITools.sln
|
||||||
- msbuild samples\client\petstore\csharp\OpenAPIClientWithPropertyChanged\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
|
- msbuild samples\client\petstore\csharp\OpenAPIClientWithPropertyChanged\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
|
||||||
# build C# .net standard 1.3+ API client
|
# build C# .net standard 1.3+ API client
|
||||||
- nuget restore samples\client\petstore\csharp\OpenAPIClientNetStandard\Org.OpenAPITools.sln
|
#- nuget restore samples\client\petstore\csharp\OpenAPIClientNetStandard\Org.OpenAPITools.sln
|
||||||
- msbuild samples\client\petstore\csharp\OpenAPIClientNetStandard\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
|
#- msbuild samples\client\petstore\csharp\OpenAPIClientNetStandard\Org.OpenAPITools.sln /logger:"C:\Program Files\AppVeyor\BuildAgent\Appveyor.MSBuildLogger.dll"
|
||||||
# install openapi-generator locally
|
# install openapi-generator locally
|
||||||
- mvn --no-snapshot-updates --quiet clean install -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
- mvn --no-snapshot-updates --quiet clean install -Dorg.slf4j.simpleLogger.defaultLogLevel=error
|
||||||
# run the locally installed openapi-generator-gradle-plugin
|
# run the locally installed openapi-generator-gradle-plugin
|
||||||
- gradle -b modules\openapi-generator-gradle-plugin\samples\local-spec\build.gradle buildGoSdk --stacktrace
|
- gradle -b modules\openapi-generator-gradle-plugin\samples\local-spec\build.gradle buildGoSdk --stacktrace
|
||||||
test_script:
|
test_script:
|
||||||
# test c# API client (netcore)
|
# test c# API client (netcore)
|
||||||
- dotnet test samples\client\petstore\csharp-netcore\OpenAPIClient\src\Org.OpenAPITools.Test\Org.OpenAPITools.Test.csproj
|
|
||||||
- dotnet test samples\client\petstore\csharp-netcore\OpenAPIClientCore\src\Org.OpenAPITools.Test\Org.OpenAPITools.Test.csproj
|
- dotnet test samples\client\petstore\csharp-netcore\OpenAPIClientCore\src\Org.OpenAPITools.Test\Org.OpenAPITools.Test.csproj
|
||||||
|
- dotnet test samples\client\petstore\csharp-netcore\OpenAPIClient\src\Org.OpenAPITools.Test\Org.OpenAPITools.Test.csproj
|
||||||
|
# test C# API client (.net framework 4.7)
|
||||||
|
- dotnet test samples\client\petstore\csharp-netcore\OpenAPIClient-net47\src\Org.OpenAPITools.Test\Org.OpenAPITools.Test.csproj
|
||||||
# test c# API client
|
# test c# API client
|
||||||
- nunit3-console samples\client\petstore\csharp\OpenAPIClient\src\Org.OpenAPITools.Test\bin\Debug\Org.OpenAPITools.Test.dll --result=myresults.xml;format=AppVeyor
|
- nunit3-console samples\client\petstore\csharp\OpenAPIClient\src\Org.OpenAPITools.Test\bin\Debug\Org.OpenAPITools.Test.dll --result=myresults.xml;format=AppVeyor
|
||||||
# test c# API client (with PropertyChanged)
|
# test c# API client (with PropertyChanged)
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
generatorName: csharp
|
generatorName: csharp
|
||||||
outputDir: samples/client/petstore/csharp/OpenAPIClient
|
outputDir: samples/client/petstore/csharp/OpenAPIClient
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
packageGuid: '{321C8C3F-0156-40C1-AE42-D59761FB9B6C}'
|
packageGuid: '{321C8C3F-0156-40C1-AE42-D59761FB9B6C}'
|
||||||
|
|||||||
11
bin/configs/csharp-netcore-OpenAPIClient-net47.yaml
Normal file
11
bin/configs/csharp-netcore-OpenAPIClient-net47.yaml
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
# for .net standard
|
||||||
|
generatorName: csharp-netcore
|
||||||
|
outputDir: samples/client/petstore/csharp-netcore/OpenAPIClient-net47
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/csharp-netcore
|
||||||
|
additionalProperties:
|
||||||
|
packageGuid: '{321C8C3F-0156-40C1-AE42-D59761FB9B6C}'
|
||||||
|
useCompareNetObjects: true
|
||||||
|
disallowAdditionalPropertiesIfNotPresent: false
|
||||||
|
useOneOfDiscriminatorLookup: true
|
||||||
|
targetFramework: net47
|
||||||
@@ -1,7 +1,10 @@
|
|||||||
|
# for .net standard
|
||||||
generatorName: csharp-netcore
|
generatorName: csharp-netcore
|
||||||
outputDir: samples/client/petstore/csharp-netcore/OpenAPIClient
|
outputDir: samples/client/petstore/csharp-netcore/OpenAPIClient
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml
|
||||||
templateDir: modules/openapi-generator/src/main/resources/csharp-netcore
|
templateDir: modules/openapi-generator/src/main/resources/csharp-netcore
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
packageGuid: '{321C8C3F-0156-40C1-AE42-D59761FB9B6C}'
|
packageGuid: '{321C8C3F-0156-40C1-AE42-D59761FB9B6C}'
|
||||||
useCompareNetObjects: "true"
|
useCompareNetObjects: true
|
||||||
|
disallowAdditionalPropertiesIfNotPresent: false
|
||||||
|
useOneOfDiscriminatorLookup: true
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
generatorName: csharp-netcore
|
generatorName: csharp-netcore
|
||||||
outputDir: samples/client/petstore/csharp-netcore/OpenAPIClientCore
|
outputDir: samples/client/petstore/csharp-netcore/OpenAPIClientCore
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml
|
||||||
templateDir: modules/openapi-generator/src/main/resources/csharp-netcore
|
templateDir: modules/openapi-generator/src/main/resources/csharp-netcore
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
packageGuid: '{321C8C3F-0156-40C1-AE42-D59761FB9B6C}'
|
packageGuid: '{321C8C3F-0156-40C1-AE42-D59761FB9B6C}'
|
||||||
|
|||||||
@@ -1,8 +0,0 @@
|
|||||||
generatorName: dart
|
|
||||||
outputDir: samples/client/petstore/dart/openapi-browser-client
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/dart
|
|
||||||
additionalProperties:
|
|
||||||
supportDart2: "false"
|
|
||||||
hideGenerationTimestamp: "true"
|
|
||||||
browserClient: "true"
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
generatorName: dart
|
|
||||||
outputDir: samples/client/petstore/dart/flutter_petstore/openapi
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/dart
|
|
||||||
additionalProperties:
|
|
||||||
supportDart2: "false"
|
|
||||||
hideGenerationTimestamp: "true"
|
|
||||||
browserClient: "false"
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
generatorName: dart
|
|
||||||
outputDir: samples/client/petstore/dart/openapi
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/dart
|
|
||||||
additionalProperties:
|
|
||||||
supportDart2: "false"
|
|
||||||
hideGenerationTimestamp: "true"
|
|
||||||
browserClient: "false"
|
|
||||||
@@ -1,6 +0,0 @@
|
|||||||
generatorName: go-experimental
|
|
||||||
outputDir: samples/client/petstore/go-experimental/go-petstore
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/go-experimental
|
|
||||||
additionalProperties:
|
|
||||||
packageName: petstore
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
generatorName: go-experimental
|
|
||||||
outputDir: samples/openapi3/client/petstore/go-experimental/go-petstore
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/go-experimental
|
|
||||||
additionalProperties:
|
|
||||||
enumClassPrefix: "true"
|
|
||||||
packageName: petstore
|
|
||||||
disallowAdditionalPropertiesIfNotPresent: false
|
|
||||||
6
bin/configs/go-extensions-x-auth-id-alias.yaml
Normal file
6
bin/configs/go-extensions-x-auth-id-alias.yaml
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
generatorName: go
|
||||||
|
outputDir: samples/openapi3/client/extensions/x-auth-id-alias/go-experimental
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/extensions/x-auth-id-alias.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/go
|
||||||
|
additionalProperties:
|
||||||
|
packageName: x_auth_id_alias
|
||||||
@@ -4,3 +4,4 @@ inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-e
|
|||||||
templateDir: modules/openapi-generator/src/main/resources/go
|
templateDir: modules/openapi-generator/src/main/resources/go
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
packageName: petstore
|
packageName: petstore
|
||||||
|
generateInterfaces: true
|
||||||
|
|||||||
@@ -1,8 +0,0 @@
|
|||||||
generatorName: go
|
|
||||||
outputDir: samples/client/petstore/go/go-petstore-withXml
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/go
|
|
||||||
additionalProperties:
|
|
||||||
packageName: petstore
|
|
||||||
withXml: "true"
|
|
||||||
withGoCodegenComment: "true"
|
|
||||||
@@ -1,7 +1,9 @@
|
|||||||
generatorName: go
|
generatorName: go
|
||||||
outputDir: samples/openapi3/client/petstore/go/go-petstore
|
outputDir: samples/openapi3/client/petstore/go/go-petstore
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml
|
||||||
templateDir: modules/openapi-generator/src/main/resources/go
|
templateDir: modules/openapi-generator/src/main/resources/go
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
enumClassPrefix: "true"
|
enumClassPrefix: "true"
|
||||||
packageName: petstore
|
packageName: petstore
|
||||||
|
disallowAdditionalPropertiesIfNotPresent: false
|
||||||
|
generateInterfaces: true
|
||||||
|
|||||||
11
bin/configs/java-feign-no-nullable.yaml
Normal file
11
bin/configs/java-feign-no-nullable.yaml
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
generatorName: java
|
||||||
|
outputDir: samples/client/petstore/java/feign-no-nullable
|
||||||
|
library: feign
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/Java
|
||||||
|
additionalProperties:
|
||||||
|
booleanGetterPrefix: is
|
||||||
|
artifactId: petstore-feign-no-nullable
|
||||||
|
hideGenerationTimestamp: "true"
|
||||||
|
additionalModelTypeAnnotations: '@javax.annotation.concurrent.Immutable'
|
||||||
|
openApiNullable: "false"
|
||||||
7
bin/configs/java-jersey2-extensions-x-auth-id-alias.yaml
Normal file
7
bin/configs/java-jersey2-extensions-x-auth-id-alias.yaml
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
generatorName: java
|
||||||
|
outputDir: samples/openapi3/client/extensions/x-auth-id-alias/java/jersey2-java8
|
||||||
|
library: jersey2
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/extensions/x-auth-id-alias.yaml
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: openapi3-extensions-x-auth-id-alias-jersey2-java8
|
||||||
|
hideGenerationTimestamp: true
|
||||||
11
bin/configs/java-native-openapi3.yaml
Normal file
11
bin/configs/java-native-openapi3.yaml
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
generatorName: java
|
||||||
|
outputDir: samples/openapi3/client/petstore/java/native
|
||||||
|
library: native
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/Java
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: petstore-openapi3-native
|
||||||
|
hideGenerationTimestamp: true
|
||||||
|
serverPort: "8082"
|
||||||
|
useOneOfDiscriminatorLookup: true
|
||||||
|
disallowAdditionalPropertiesIfNotPresent: false
|
||||||
7
bin/configs/java-play-framework-no-nullable.yaml
Normal file
7
bin/configs/java-play-framework-no-nullable.yaml
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
generatorName: java-play-framework
|
||||||
|
outputDir: samples/server/petstore/java-play-framework-no-nullable
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaPlayFramework
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: "true"
|
||||||
|
openApiNullable: "false"
|
||||||
9
bin/configs/java-vertx-no-nullable.yaml
Normal file
9
bin/configs/java-vertx-no-nullable.yaml
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
generatorName: java
|
||||||
|
outputDir: samples/client/petstore/java/vertx-no-nullable
|
||||||
|
library: vertx
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/Java
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: petstore-vertx-no-nullable
|
||||||
|
hideGenerationTimestamp: "true"
|
||||||
|
openApiNullable: "false"
|
||||||
8
bin/configs/kotlin-jvm-retrofit2-rx3.yaml
Normal file
8
bin/configs/kotlin-jvm-retrofit2-rx3.yaml
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
generatorName: kotlin
|
||||||
|
outputDir: samples/client/petstore/kotlin-retrofit2-rx3
|
||||||
|
library: jvm-retrofit2
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/kotlin-client
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: kotlin-petstore-retrofit2-rx3
|
||||||
|
useRxJava3: "true"
|
||||||
@@ -5,3 +5,4 @@ templateDir: modules/openapi-generator/src/main/resources/aspnetcore/3.0
|
|||||||
additionalProperties:
|
additionalProperties:
|
||||||
packageGuid: '{3C799344-F285-4669-8FD5-7ED9B795D5C5}'
|
packageGuid: '{3C799344-F285-4669-8FD5-7ED9B795D5C5}'
|
||||||
aspnetCoreVersion: "3.1"
|
aspnetCoreVersion: "3.1"
|
||||||
|
userSecretsGuid: "76e9e993-9159-441c-9c5b-fe95e7f4f020"
|
||||||
|
|||||||
4
bin/configs/other/cpp-oatpp-server.yaml
Normal file
4
bin/configs/other/cpp-oatpp-server.yaml
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
generatorName: cpp-oatpp-server
|
||||||
|
outputDir: samples/server/petstore/cpp-oatpp
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/cpp-oatpp-server
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
generatorName: flash
|
|
||||||
outputDir: samples/client/petstore/flash
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/flash
|
|
||||||
additionalProperties:
|
|
||||||
invokerPackage: org.openapitools
|
|
||||||
packageName: org.openapitools
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
generatorName: java-vertx-web
|
|
||||||
outputDir: samples/server/petstore/java-vertx-web/rx
|
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
|
|
||||||
templateDir: modules/openapi-generator/src/main/resources/JavaVertXWebServer
|
|
||||||
additionalProperties:
|
|
||||||
hideGenerationTimestamp: "true"
|
|
||||||
artifactId: java-vertx-web-rx-server
|
|
||||||
7
bin/configs/other/java-vertx-web.yaml
Normal file
7
bin/configs/other/java-vertx-web.yaml
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
generatorName: java-vertx-web
|
||||||
|
outputDir: samples/server/petstore/java-vertx-web
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaVertXWebServer
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: "true"
|
||||||
|
artifactId: java-vertx-web-server
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
generatorName: php-lumen
|
generatorName: php-lumen
|
||||||
outputDir: samples/server/petstore/php-lumen
|
outputDir: samples/server/petstore/php-lumen
|
||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
templateDir: modules/openapi-generator/src/main/resources/php-lumen
|
templateDir: modules/openapi-generator/src/main/resources/php-lumen
|
||||||
|
|||||||
@@ -4,3 +4,4 @@ inputSpec: modules/openapi-generator/src/test/resources/3_0/python-experimental/
|
|||||||
templateDir: modules/openapi-generator/src/main/resources/python
|
templateDir: modules/openapi-generator/src/main/resources/python
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
packageName: petstore_api
|
packageName: petstore_api
|
||||||
|
recursionLimit: "1234"
|
||||||
|
|||||||
9
bin/configs/ruby-features-dynamic-servers.yaml
Normal file
9
bin/configs/ruby-features-dynamic-servers.yaml
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
generatorName: ruby
|
||||||
|
outputDir: samples/openapi3/client/features/dynamic-servers/ruby/
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/features/dynamic-servers.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/ruby-client
|
||||||
|
additionalProperties:
|
||||||
|
gemVersion: 1.0.0
|
||||||
|
moduleName: DynamicServers
|
||||||
|
gemName: dynamic_servers
|
||||||
|
skipFormModel: "true"
|
||||||
12
bin/configs/ruby-generate-alias-as-model.yaml
Normal file
12
bin/configs/ruby-generate-alias-as-model.yaml
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
generatorName: ruby
|
||||||
|
outputDir: samples/openapi3/client/features/generate-alias-as-model/ruby-client/
|
||||||
|
library: typhoeus
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/3_0/features/generate-alias-as-model.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/ruby-client
|
||||||
|
additionalProperties:
|
||||||
|
gemVersion: 1.0.0
|
||||||
|
moduleName: Petstore
|
||||||
|
gemName: petstore
|
||||||
|
skipFormModel: "true"
|
||||||
|
strictSpecBehavior: false
|
||||||
|
generateAliasAsModel: true
|
||||||
@@ -4,5 +4,5 @@ library: reqwest
|
|||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
||||||
templateDir: modules/openapi-generator/src/main/resources/rust
|
templateDir: modules/openapi-generator/src/main/resources/rust
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
supportAsync: "false"
|
supportAsync: false
|
||||||
packageName: petstore-reqwest
|
packageName: petstore-reqwest
|
||||||
|
|||||||
11
bin/configs/spring-boot-beanvalidation-no-nullable.yaml
Normal file
11
bin/configs/spring-boot-beanvalidation-no-nullable.yaml
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
generatorName: spring
|
||||||
|
outputDir: samples/server/petstore/springboot-beanvalidation-no-nullable
|
||||||
|
library: spring-boot
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
additionalProperties:
|
||||||
|
java8: "false"
|
||||||
|
useBeanValidation: true
|
||||||
|
artifactId: spring-boot-beanvalidation-no-nullable
|
||||||
|
hideGenerationTimestamp: "true"
|
||||||
|
openApiNullable: "false"
|
||||||
@@ -4,7 +4,7 @@ library: spring-boot
|
|||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
java8: "false"
|
java8: true
|
||||||
useBeanValidation: true
|
useBeanValidation: true
|
||||||
artifactId: spring-boot-beanvalidation
|
artifactId: spring-boot-beanvalidation
|
||||||
hideGenerationTimestamp: "true"
|
hideGenerationTimestamp: "true"
|
||||||
|
|||||||
@@ -5,5 +5,5 @@ templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
|||||||
additionalProperties:
|
additionalProperties:
|
||||||
artifactId: springboot-delegate
|
artifactId: springboot-delegate
|
||||||
hideGenerationTimestamp: "true"
|
hideGenerationTimestamp: "true"
|
||||||
java8: "false"
|
java8: true
|
||||||
delegatePattern: "true"
|
delegatePattern: "true"
|
||||||
|
|||||||
10
bin/configs/spring-cloud-no-nullable.yaml
Normal file
10
bin/configs/spring-cloud-no-nullable.yaml
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
generatorName: spring
|
||||||
|
outputDir: samples/client/petstore/spring-cloud-no-nullable
|
||||||
|
library: spring-cloud
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring/libraries/spring-cloud
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: petstore-spring-cloud-no-nullable
|
||||||
|
responseWrapper: HystrixCommand
|
||||||
|
hideGenerationTimestamp: "true"
|
||||||
|
openApiNullable: "false"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
generatorName: spring
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-spring-pageable.yaml
|
||||||
|
outputDir: samples/client/petstore/spring-cloud-spring-pageable
|
||||||
|
artifactId: spring-cloud-spring-pageable
|
||||||
|
library: spring-cloud
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: 'true'
|
||||||
10
bin/configs/spring-mvc-no-nullable.yaml
Normal file
10
bin/configs/spring-mvc-no-nullable.yaml
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
generatorName: spring
|
||||||
|
outputDir: samples/server/petstore/spring-mvc-no-nullable
|
||||||
|
library: spring-mvc
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: spring-mvc-server-no-nullable
|
||||||
|
openApiNullable: "false"
|
||||||
|
serverPort: "8002"
|
||||||
|
hideGenerationTimestamp: "true"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
generatorName: spring
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing-with-spring-pageable.yaml
|
||||||
|
outputDir: samples/server/petstore/spring-mvc-spring-pageable
|
||||||
|
artifactId: spring-mvc-spring-pageable
|
||||||
|
library: spring-mvc
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: 'true'
|
||||||
@@ -4,8 +4,9 @@ library: spring-mvc
|
|||||||
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml
|
||||||
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
additionalProperties:
|
additionalProperties:
|
||||||
java8: "false"
|
java8: true
|
||||||
booleanGetterPrefix: get
|
booleanGetterPrefix: get
|
||||||
artifactId: spring-mvc-server
|
artifactId: spring-mvc-server
|
||||||
hideGenerationTimestamp: "true"
|
hideGenerationTimestamp: "true"
|
||||||
serverPort: "8002"
|
serverPort: "8002"
|
||||||
|
additionalModelTypeAnnotations: '@com.fasterxml.jackson.annotation.JsonFilter(value = "filter-name");@com.fasterxml.jackson.annotation.JsonIgnoreProperties(value = "id")'
|
||||||
|
|||||||
@@ -0,0 +1,10 @@
|
|||||||
|
generatorName: spring
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing-with-spring-pageable.yaml
|
||||||
|
outputDir: samples/server/petstore/springboot-spring-pageable-delegatePattern-without-j8
|
||||||
|
artifactId: springboot-spring-pageable-delegatePattern-without-j8
|
||||||
|
library: spring-boot
|
||||||
|
delegatePattern: true
|
||||||
|
java8: false
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: 'true'
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
generatorName: spring
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing-with-spring-pageable.yaml
|
||||||
|
outputDir: samples/server/petstore/springboot-spring-pageable-delegatePattern
|
||||||
|
artifactId: springboot-spring-pageable-delegatePattern
|
||||||
|
library: spring-boot
|
||||||
|
delegatePattern: true
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: 'true'
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
generatorName: spring
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing-with-spring-pageable.yaml
|
||||||
|
outputDir: samples/server/petstore/springboot-spring-pageable-without-j8
|
||||||
|
artifactId: springboot-spring-pageable-withoutj8
|
||||||
|
library: spring-boot
|
||||||
|
java8: false
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: 'true'
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
generatorName: spring
|
||||||
|
templateDir: modules/openapi-generator/src/main/resources/JavaSpring
|
||||||
|
inputSpec: modules/openapi-generator/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing-with-spring-pageable.yaml
|
||||||
|
outputDir: samples/server/petstore/springboot-spring-pageable
|
||||||
|
artifactId: springboot-spring-pageable
|
||||||
|
library: spring-boot
|
||||||
|
additionalProperties:
|
||||||
|
hideGenerationTimestamp: 'true'
|
||||||
@@ -8,3 +8,4 @@ additionalProperties:
|
|||||||
npmRepository: https://skimdb.npmjs.com/registry
|
npmRepository: https://skimdb.npmjs.com/registry
|
||||||
snapshot: false
|
snapshot: false
|
||||||
apiModulePrefix: PetStore
|
apiModulePrefix: PetStore
|
||||||
|
configurationPrefix: PetStore
|
||||||
|
|||||||
@@ -11,6 +11,7 @@ if [ ! -f "$executable" ]; then
|
|||||||
fi
|
fi
|
||||||
|
|
||||||
export JAVA_OPTS="${JAVA_OPTS} -ea -server -Duser.timezone=UTC"
|
export JAVA_OPTS="${JAVA_OPTS} -ea -server -Duser.timezone=UTC"
|
||||||
|
export BATCH_OPTS="${BATCH_OPTS:-}"
|
||||||
|
|
||||||
files=()
|
files=()
|
||||||
args=()
|
args=()
|
||||||
@@ -61,6 +62,6 @@ else
|
|||||||
|
|
||||||
# shellcheck disable=SC2086
|
# shellcheck disable=SC2086
|
||||||
# shellcheck disable=SC2068
|
# shellcheck disable=SC2068
|
||||||
java ${JAVA_OPTS} -jar "$executable" batch --includes-base-dir "${root}" --fail-fast -- ${files[@]}
|
java ${JAVA_OPTS} -jar "$executable" batch ${BATCH_OPTS} --includes-base-dir "${root}" --fail-fast -- ${files[@]}
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
|||||||
@@ -19,6 +19,13 @@ if [ $status -ne 0 ]; then
|
|||||||
exit $status
|
exit $status
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
if [[ "--skip-docs" == "${1}" ]]; then
|
||||||
|
# We export here rather than modify our iterable so that:
|
||||||
|
# - the scripts can show they ran and echo meaningfully
|
||||||
|
# - the scripts can do cleanup (if necessary) when skipped
|
||||||
|
export SKIP_EXPORT_DOCS=true
|
||||||
|
fi
|
||||||
|
|
||||||
# Some special case generators may expect to be run as a stanalone process (e.g. modifying classpath)
|
# Some special case generators may expect to be run as a stanalone process (e.g. modifying classpath)
|
||||||
# Docs should always be run, regardless of batch or operation.
|
# Docs should always be run, regardless of batch or operation.
|
||||||
declare -a always_iterate=(
|
declare -a always_iterate=(
|
||||||
@@ -46,6 +53,9 @@ if [ -n "$(git status --porcelain)" ]; then
|
|||||||
git --no-pager diff
|
git --no-pager diff
|
||||||
echo "Perform git status"
|
echo "Perform git status"
|
||||||
git status
|
git status
|
||||||
|
echo -e "\nThis script runs in pull requests against the anticipated merge commit (as if the PR was merged now)."
|
||||||
|
echo "When you see unexpected files here, it likely means that there are newer commits in master that you need to "
|
||||||
|
echo -e "rebase or merge into your branch.\n"
|
||||||
echo "Please run 'bin/utils/ensure-up-to-date' locally and commit changes (UNCOMMITTED CHANGES ERROR)"
|
echo "Please run 'bin/utils/ensure-up-to-date' locally and commit changes (UNCOMMITTED CHANGES ERROR)"
|
||||||
exit 1
|
exit 1
|
||||||
else
|
else
|
||||||
|
|||||||
@@ -5,7 +5,16 @@ echo "# START SCRIPT: ${SCRIPT}"
|
|||||||
|
|
||||||
executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
|
executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
|
||||||
|
|
||||||
|
if [[ "true" == "${SKIP_EXPORT_DOCS}" ]]; then
|
||||||
|
echo "Skipping doc exports. Note that docs generated by Windows may break paths as they have not yet been normalized to OS-specific paths."
|
||||||
|
exit 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
N=4
|
||||||
|
(
|
||||||
for GENERATOR in $(java -jar ${executable} list --short --include all | sed -e 's/,/\'$'\n''/g')
|
for GENERATOR in $(java -jar ${executable} list --short --include all | sed -e 's/,/\'$'\n''/g')
|
||||||
do
|
do
|
||||||
./bin/utils/export_generator.sh ${GENERATOR}
|
((i=i%N)); ((i++==0)) && wait
|
||||||
|
./bin/utils/export_generator.sh ${GENERATOR} &
|
||||||
done
|
done
|
||||||
|
)
|
||||||
@@ -12,7 +12,7 @@ codegen="${cli}/target/openapi-generator-cli.jar"
|
|||||||
# We code in a list of commands here as source processing is potentially buggy (requires undocumented conventional use of annotations).
|
# We code in a list of commands here as source processing is potentially buggy (requires undocumented conventional use of annotations).
|
||||||
# A list of known commands helps us determine if we should compile CLI. There's an edge-case where a new command not added to this
|
# A list of known commands helps us determine if we should compile CLI. There's an edge-case where a new command not added to this
|
||||||
# list won't be considered a "real" command. We can get around that a bit by checking CLI completions beforehand if it exists.
|
# list won't be considered a "real" command. We can get around that a bit by checking CLI completions beforehand if it exists.
|
||||||
commands="config-help,generate,help,list,meta,validate,version"
|
commands="config-help,generate,batch,help,list,meta,validate,version"
|
||||||
|
|
||||||
if [ $# == 0 ]; then
|
if [ $# == 0 ]; then
|
||||||
echo "No command specified. Available commands:"
|
echo "No command specified. Available commands:"
|
||||||
|
|||||||
@@ -44,7 +44,7 @@ Once built, `run-in-docker.sh` will act as an executable for openapi-generator-c
|
|||||||
./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli
|
./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli
|
||||||
./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli
|
./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli
|
||||||
./run-in-docker.sh /gen/bin/generate-samples.sh /gen/bin/configs/go-petstore.yaml # Builds the Go client
|
./run-in-docker.sh /gen/bin/generate-samples.sh /gen/bin/configs/go-petstore.yaml # Builds the Go client
|
||||||
./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-g go -o /gen/out/go-petstore --packageName=petstore # generates go client, outputs locally to ./out/go-petstore
|
-g go -o /gen/out/go-petstore --packageName=petstore # generates go client, outputs locally to ./out/go-petstore
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
118
docs/configuration.md
Normal file
118
docs/configuration.md
Normal file
@@ -0,0 +1,118 @@
|
|||||||
|
---
|
||||||
|
id: configuration
|
||||||
|
title: Configuration Options
|
||||||
|
---
|
||||||
|
|
||||||
|
Our tooling supports the following types of configuration:
|
||||||
|
|
||||||
|
* [global properties](./global-properties.md)
|
||||||
|
- properties with cross-cutting concerns which control generation, but _don't_ belong to individual generators
|
||||||
|
- Example: `debugSupportingFiles` prints the contents of template data bound to supporting files
|
||||||
|
* config options
|
||||||
|
- configuration specific to each individual [generator](./generators/README.md)
|
||||||
|
- 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
|
||||||
|
- NOTE: The CLI accepts config options as "additional properties"
|
||||||
|
* additional properties
|
||||||
|
- these are the properties which will be passed to templates
|
||||||
|
- generally used to pass user-defined properties to custom templates
|
||||||
|
- many config options may also be passed as additional properties, however generators will read/modify/rewrite config options
|
||||||
|
- users may pass custom additional properties and use these within templates (e.g. a custom `generatedBy` key with a value of `Jim Schubert` for inclusion in a custom CVS-like header)
|
||||||
|
* top-level properties specific to individual tools/plugins used to bootstrap our tooling
|
||||||
|
|
||||||
|
## Tool-specific Declarations
|
||||||
|
|
||||||
|
The READMEs for the [CLI](https://openapi-generator.tech/docs/usage#generate), [Gradle Plugin](https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin), [Maven Plugin](https://github.com/OpenAPITools/openapi-generator/tree/master/modules/openapi-generator-maven-plugin), and [SBT Plugin](https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md) 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:
|
||||||
|
|
||||||
|
* Conventions used by the underlying tooling
|
||||||
|
* Limitations in underlying frameworks which define how properties must be declared
|
||||||
|
* Continuation of support for "legacy" invocation patterns
|
||||||
|
* Mistakes in documentation and/or contributions (please do [file a bug](https://github.com/OpenAPITools/openapi-generator/issues/new?assignees=&labels=Issue%3A+Bug&template=bug_report.md&title=%5BBUG%5D+Issue+with+options))
|
||||||
|
|
||||||
|
Take, for example, the CLI option of `--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 `skipValidateSpec` to have a value of true or false. The SBT plugin, on the other hand, follows community convention and this property is `openApiSkipValidateSpec`.
|
||||||
|
|
||||||
|
_How_ you provide values to options also depends on the tool. OpenAPI Generator supports global properties for [selective generation](https://openapi-generator.tech/docs/customization/#selective-generation) -- such as `apis` -- to have either a blank value or a comma-separated list of selected values. We would define this in CLI as `--global-property apis` or `--global-property apis=Equipment`. In the Gradle Plugin, these properties are set directly as strings:
|
||||||
|
|
||||||
|
```
|
||||||
|
openApiGenerate {
|
||||||
|
globalProperties = [
|
||||||
|
apis: "",
|
||||||
|
models: "User,Pet"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
In the Maven plugin, we're limited by XML syntax where `<apis/>` and `<apis></apis>` are treated the same as if the `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 `generateApis` which accepts a boolean and `apisToGenerate` which accepts a comma-separated selection list.
|
||||||
|
|
||||||
|
## Discovering Options
|
||||||
|
|
||||||
|
Refer to [global properties](./global-properties.md) for a list of available global properties and their usage.
|
||||||
|
|
||||||
|
Top-level tooling options are defined in [CLI usage](https://openapi-generator.tech/docs/usage/#generate). Many of these options directly map to camel case options in other tools, but do refer to [plugin documentation](https://openapi-generator.tech/docs/plugins) for full details or plugin-specific differences.
|
||||||
|
|
||||||
|
Config options for generators are available in [documentation online](https://openapi-generator.tech/docs/generators). You may also use the CLI to query config options for a target generator using `openapi-generator config-help -g <generator-name>`. For example:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ openapi-generator config-help -g mysql-schema
|
||||||
|
|
||||||
|
CONFIG OPTIONS
|
||||||
|
|
||||||
|
defaultDatabaseName
|
||||||
|
Default database name for all MySQL queries (Default: )
|
||||||
|
|
||||||
|
identifierNamingConvention
|
||||||
|
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)
|
||||||
|
original - Do not transform original names
|
||||||
|
snake_case - Use snake_case names
|
||||||
|
|
||||||
|
jsonDataTypeEnabled
|
||||||
|
Use special JSON MySQL data type for complex model properties. Requires MySQL version 5.7.8. Generates TEXT data type when disabled (Default: true)
|
||||||
|
|
||||||
|
namedParametersEnabled
|
||||||
|
Generates model prepared SQLs with named parameters, eg. :petName. Question mark placeholder used when option disabled. (Default: false)
|
||||||
|
```
|
||||||
|
|
||||||
|
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. `identifierNamingConvention` above).
|
||||||
|
|
||||||
|
Suppose you want to apply snake case naming to mysql schema outputs. Your configuration might resemble the following examples.
|
||||||
|
|
||||||
|
**CLI**
|
||||||
|
|
||||||
|
```
|
||||||
|
openapi-generator -g mysql-schema -o out -i spec.yaml --additional-properties=identifierNamingConvention=snake_case
|
||||||
|
```
|
||||||
|
|
||||||
|
It may seem like a typo but there are two `=` signs in the above example.
|
||||||
|
|
||||||
|
**Maven Plugin**
|
||||||
|
|
||||||
|
```
|
||||||
|
<execution>
|
||||||
|
<id>mysql-schema</id>
|
||||||
|
<phase>generate-sources</phase>
|
||||||
|
<goals>
|
||||||
|
<goal>generate</goal>
|
||||||
|
</goals>
|
||||||
|
<configuration>
|
||||||
|
<inputSpec>spec.yaml</inputSpec>
|
||||||
|
<generatorName>mysql-schema</generatorName>
|
||||||
|
<configOptions>
|
||||||
|
<identifierNamingConvention>snake_case</identifierNamingConvention>
|
||||||
|
</configOptions>
|
||||||
|
<output>${project.build.directory}/generated-sources/mysql</output>
|
||||||
|
</configuration>
|
||||||
|
</execution>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Gradle Plugin**
|
||||||
|
|
||||||
|
```
|
||||||
|
openApiGenerate {
|
||||||
|
generatorName = "mysql-schema"
|
||||||
|
inputSpec = "$rootDir/spec.yaml".toString()
|
||||||
|
outputDir = "$buildDir/mysql".toString()
|
||||||
|
configOptions = [
|
||||||
|
identifierNamingConvention: "snake_case"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
@@ -8,7 +8,7 @@ sidebar_label: Guidelines
|
|||||||
|
|
||||||
- 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: [Getting Started](https://github.com/openapitools/openapi-generator#getting-started)
|
- 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: [Getting Started](https://github.com/openapitools/openapi-generator#getting-started)
|
||||||
- Search the [open issue](https://github.com/openapitools/openapi-generator/issues) and [closed issue](https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed) to ensure no one else has reported something similar before.
|
- Search the [open issue](https://github.com/openapitools/openapi-generator/issues) and [closed issue](https://github.com/openapitools/openapi-generator/issues?q=is%3Aissue+is%3Aclosed) to ensure no one else has reported something similar before.
|
||||||
- File an [issue ticket](https://github.com/openapitools/openapi-generator/issues/new) by providing all the required information.
|
- File an [issue ticket](https://github.com/openapitools/openapi-generator/issues/new) by providing all the required information. Failure to provide enough detail may result in slow response from the community.
|
||||||
- Test with the latest master by building the JAR locally to see if the issue has already been addressed.
|
- Test with the latest master by building the JAR locally to see if the issue has already been addressed.
|
||||||
- You can also make a suggestion or ask a question by opening an "issue".
|
- You can also make a suggestion or ask a question by opening an "issue".
|
||||||
|
|
||||||
@@ -91,10 +91,7 @@ To add test cases (optional) covering the change in the code generator, please r
|
|||||||
To test the templates, please perform the following:
|
To test the templates, please perform the following:
|
||||||
|
|
||||||
- Update the Petstore sample by running the shell scripts under the `bin` folder. For example, run `./bin/generate-samples.sh .
|
- Update the Petstore sample by running the shell scripts under the `bin` folder. For example, run `./bin/generate-samples.sh .
|
||||||
/bin/configs/python*` to update the Python-related samples under [`samples`](https://github.com/openapitools/openapi-generator/t
|
/bin/configs/python*` to update the Python-related samples under [`samples`](https://github.com/openapitools/openapi-generator/tree/master/samples). For Windows, please install [GIT bash](https://gitforwindows.org/). (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)
|
||||||
ree/master/samples). For Windows, please install [GIT bash](https://gitforwindows.org/). (If you find that there are new files g
|
|
||||||
enerated or unexpected changes as a result of the update, that's not unusual as the test cases are added to the OpenAPI spec fro
|
|
||||||
m time to time. If you've questions or concerns, please open a ticket to start a discussion)
|
|
||||||
- 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 `-t` parameter: `-t modules/openapi-generator/src/main/resources/python`.
|
- 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 `-t` parameter: `-t modules/openapi-generator/src/main/resources/python`.
|
||||||
- Run the tests in the sample folder using maven `mvn integration-test -f /path/to/pom.xml`, e.g. `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)
|
- Run the tests in the sample folder using maven `mvn integration-test -f /path/to/pom.xml`, e.g. `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)
|
||||||
- Finally, git commit the updated samples files: `git commit -a`
|
- Finally, git commit the updated samples files: `git commit -a`
|
||||||
|
|||||||
@@ -3,6 +3,77 @@ id: customization
|
|||||||
title: Customization
|
title: Customization
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## User-defined Templates
|
||||||
|
|
||||||
|
The most common scenario for user customization is to override the built-in templates with small modifications. That scenario's documentation is in our [templating](./templating.md) page, and differs from user-defined templates.
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
Consider that you might want to add some static documentation such as `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.
|
||||||
|
|
||||||
|
You might have an external configuration file named `config.yaml` which defines additional properties like this for a `kotlin` client generator:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: kotlin-petstore-client
|
||||||
|
serializableModel: "true"
|
||||||
|
dateLibrary: java8
|
||||||
|
```
|
||||||
|
|
||||||
|
You would generate via CLI with the command:
|
||||||
|
|
||||||
|
```shell script
|
||||||
|
openapi-generator generate -g kotlin -i spec.yaml -o outdir -c config.yaml
|
||||||
|
```
|
||||||
|
|
||||||
|
To support the above scenario with custom templates, ensure that you're pointing to your custom template directory and add a `files` node with template file definitions to your config:
|
||||||
|
|
||||||
|
```
|
||||||
|
templateDir: my_custom_templates
|
||||||
|
additionalProperties:
|
||||||
|
artifactId: kotlin-petstore-client
|
||||||
|
serializableModel: "true"
|
||||||
|
dateLibrary: java8
|
||||||
|
files:
|
||||||
|
AUTHORS.md: {}
|
||||||
|
api_interfaces.mustache:
|
||||||
|
templateType: API
|
||||||
|
destinationFilename: Interface.kt
|
||||||
|
api.mustache:
|
||||||
|
templateType: API
|
||||||
|
destinationFilename: Impl.kt
|
||||||
|
other/check.mustache:
|
||||||
|
folder: scripts
|
||||||
|
destinationFilename: check.sh
|
||||||
|
templateType: SupportingFiles
|
||||||
|
```
|
||||||
|
|
||||||
|
The keys under the `files` node are your template filenames. These honor the same resolution order as all other templates.
|
||||||
|
|
||||||
|
The above configuration will do the following:
|
||||||
|
|
||||||
|
* Copy `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 `AUTHORS.md` allows the tool to infer the target output filename in the root of the output directory.
|
||||||
|
* Compile a user-provided `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 `Interface.kt` will act as a suffix for the filename. So, a tag of `Equipment` will output a corresponding `EquipmentInterface.kt`.
|
||||||
|
* Because `api.mustache` is the same mustache filename as used in your target generator (`kotlin` in this example), we support the following:
|
||||||
|
- The destination filename provides a suffix for the generated output. APIs generate per tag in your specification. So, a tag of `Equipment` will output a corresponding `EquipmentImpl.kt`. This option will be used whether `api.mustache` targets a user customized template or a built-in template.
|
||||||
|
- The built-in template will be used if you haven't provided an customized template. The kotlin generator defines the suffix as simply `.kt`, so this scenario would modify only the generated file suffixes according to the previous bullet point.
|
||||||
|
- Your `api.mustache` will be used if it exists in your custom template directory. For generators with library options, such as `jvm-okhttp3` in the kotlin generator, your file must exist in the same relative location as the embedded template. For kotlin using the `jvm-okhttp3` library option, this file would need to be located at `my_custom_templates/libraries/jvm-okhttp/api.mustache`. See [templating](./templating.md) for more details.
|
||||||
|
* Compile `my_custom_templates/other/check.mustache` with the supporting files bundle, and output to `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).
|
||||||
|
|
||||||
|
The `templateType` option will default to `SupportingFiles`, so the option for `other/check.mustache` is redundant and provided to demonstrate the full template file configuration options. The available template types are:
|
||||||
|
|
||||||
|
* API
|
||||||
|
* APIDocs
|
||||||
|
* APITests
|
||||||
|
* Model
|
||||||
|
* ModelDocs
|
||||||
|
* ModelTests
|
||||||
|
* SupportingFiles
|
||||||
|
|
||||||
|
Excluding `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.
|
||||||
|
|
||||||
|
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 `model_docs.mustache` and you define `model-docs.mustache`, this will result in duplicated model docs (if `destinationFilename` differs) or undefined behavior as whichever template compiles last will overwrite the previous model docs (if `destinationFilename` matches the extension or suffix in the generator's code).
|
||||||
|
|
||||||
## Custom Generator (and Template)
|
## Custom Generator (and Template)
|
||||||
|
|
||||||
<a id="creating-a-new-template"></a> 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:
|
<a id="creating-a-new-template"></a> 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:
|
||||||
@@ -20,7 +91,12 @@ These names can be anything you like. If you are building a client for the white
|
|||||||
|
|
||||||
### Use your new generator with the CLI
|
### Use your new generator with the CLI
|
||||||
|
|
||||||
To compile your library, enter the `out/generators/my-codegen` directory, run `mvn package` and execute the generator:
|
To compile your library, enter the `out/generators/my-codegen` directory, run `mvn package`.
|
||||||
|
|
||||||
|
**NOTE** Running your custom generator requires adding it to the classpath. This differs on [Windows](https://docs.oracle.com/javase/8/docs/technotes/tools/windows/classpath.html) slightly from [unix](https://docs.oracle.com/javase/8/docs/technotes/tools/unix/classpath.html).
|
||||||
|
If 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.
|
||||||
|
|
||||||
|
Now, execute the generator:
|
||||||
|
|
||||||
```sh
|
```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
|
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
|
||||||
@@ -28,7 +104,7 @@ java -cp out/generators/my-codegen/target/my-codegen-openapi-generator-1.0.0.jar
|
|||||||
|
|
||||||
For Windows users, you will need to use `;` instead of `:` in the classpath, e.g.
|
For Windows users, you will need to use `;` instead of `:` in the classpath, e.g.
|
||||||
```
|
```
|
||||||
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
|
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
|
||||||
```
|
```
|
||||||
|
|
||||||
Note the `my-codegen` is an option for `-g` now, and you can use the usual arguments for generating your code:
|
Note the `my-codegen` is an option for `-g` now, and you can use the usual arguments for generating your code:
|
||||||
@@ -36,15 +112,15 @@ Note the `my-codegen` is an option for `-g` now, and you can use the usual argum
|
|||||||
```sh
|
```sh
|
||||||
java -cp out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \
|
java -cp out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar:modules/openapi-generator-cli/target/openapi-generator-cli.jar \
|
||||||
org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \
|
org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \
|
||||||
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-o ./out/myClient
|
-o ./out/myClient
|
||||||
```
|
```
|
||||||
|
|
||||||
For Windows users:
|
For Windows users:
|
||||||
```
|
```
|
||||||
java -cp out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar;modules/openapi-generator-cli/target/openapi-generator-cli.jar \
|
java -cp "out/codegens/customCodegen/target/my-codegen-openapi-generator-1.0.0.jar;modules/openapi-generator-cli/target/openapi-generator-cli.jar" \
|
||||||
org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \
|
org.openapitools.codegen.OpenAPIGenerator generate -g my-codegen \
|
||||||
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-o ./out/myClient
|
-o ./out/myClient
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -207,7 +283,7 @@ Each of these files creates reasonable defaults so you can get running quickly.
|
|||||||
|
|
||||||
```sh
|
```sh
|
||||||
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
||||||
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
|
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml \
|
||||||
-g java \
|
-g java \
|
||||||
-o samples/client/petstore/java \
|
-o samples/client/petstore/java \
|
||||||
-c path/to/config.json
|
-c path/to/config.json
|
||||||
|
|||||||
@@ -39,7 +39,7 @@ config.templateDir = 'src/openapi-generator-templates/Java/libraries/feign
|
|||||||
```
|
```
|
||||||
mvn clean package
|
mvn clean package
|
||||||
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
||||||
-i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.json \
|
-i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json \
|
||||||
-l java --library=okhttp-gson \
|
-l java --library=okhttp-gson \
|
||||||
--additional-properties hideGenerationTimestamp=true \
|
--additional-properties hideGenerationTimestamp=true \
|
||||||
-o /var/tmp/java/okhttp-gson/
|
-o /var/tmp/java/okhttp-gson/
|
||||||
@@ -55,7 +55,7 @@ To generate the Android SDK with [`volley`](https://github.com/mcxiaoke/android-
|
|||||||
```
|
```
|
||||||
mvn clean package
|
mvn clean package
|
||||||
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate \
|
||||||
-i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.json \
|
-i https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.json \
|
||||||
-l android --library=volley \
|
-l android --library=volley \
|
||||||
-o /var/tmp/android/volley/
|
-o /var/tmp/android/volley/
|
||||||
```
|
```
|
||||||
|
|||||||
70
docs/file-post-processing.md
Normal file
70
docs/file-post-processing.md
Normal file
@@ -0,0 +1,70 @@
|
|||||||
|
---
|
||||||
|
id: file-post-processing
|
||||||
|
title: File post-processing
|
||||||
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
Note that:
|
||||||
|
|
||||||
|
* this option is `--enable-post-process-file` in the CLI and `enablePostProcessFile` in plugins
|
||||||
|
* we require _both_ specifying the environment variable _and_ enabling the option at the tooling level; this feature is opt-in for security
|
||||||
|
* file processing occurs one at a time
|
||||||
|
* the external tool may be a custom script which invokes multiple tools
|
||||||
|
|
||||||
|
Also refer to the relevant documentation for [CLI](./usage.md), [Maven Plugin](https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-maven-plugin/README.md), [Gradle Plugin](https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/README.adoc), or [SBT Plugin](https://github.com/OpenAPITools/sbt-openapi-generator/blob/master/README.md).
|
||||||
|
|
||||||
|
## Supported Environment Variables
|
||||||
|
|
||||||
|
The following environment variables are supported by their respective generators:
|
||||||
|
<!-- query with: grep -Rn '_POST_PROCESS_FILE"' modules | grep -Eo '[^"]+_POST_PROCESS_FILE' | sort -u -->
|
||||||
|
|
||||||
|
* `CPP_POST_PROCESS_FILE`
|
||||||
|
* `CSHARP_POST_PROCESS_FILE`
|
||||||
|
* `C_POST_PROCESS_FILE`
|
||||||
|
* `DART_POST_PROCESS_FILE`
|
||||||
|
* `FSHARP_POST_PROCESS_FILE`
|
||||||
|
* `GO_POST_PROCESS_FILE`
|
||||||
|
* `HASKELL_POST_PROCESS_FILE`
|
||||||
|
* `JAVA_POST_PROCESS_FILE`
|
||||||
|
* `JS_POST_PROCESS_FILE`
|
||||||
|
* `KOTLIN_POST_PROCESS_FILE`
|
||||||
|
* `OCAML_POST_PROCESS_FILE`
|
||||||
|
* `PERL_POST_PROCESS_FILE`
|
||||||
|
* `PHP_POST_PROCESS_FILE`
|
||||||
|
* `POWERSHELL_POST_PROCESS_FILE`
|
||||||
|
* `PYTHON_POST_PROCESS_FILE`
|
||||||
|
* `RUBY_POST_PROCESS_FILE`
|
||||||
|
* `RUST_POST_PROCESS_FILE`
|
||||||
|
* `SCALA_POST_PROCESS_FILE`
|
||||||
|
* `SWIFT_POST_PROCESS_FILE`
|
||||||
|
* `TS_POST_PROCESS_FILE`
|
||||||
|
|
||||||
|
## Example
|
||||||
|
|
||||||
|
Let's see how to pass Ruby generated files to Rubocop, a static code analysis/linter/formatter tool.
|
||||||
|
|
||||||
|
```
|
||||||
|
# First, export the required environment variable
|
||||||
|
export RUBY_POST_PROCESS_FILE="/usr/local/bin/rubocop -a"
|
||||||
|
|
||||||
|
export OPENAPI_DOC="https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"
|
||||||
|
|
||||||
|
# Invoke the generator with --enable-post-process-file
|
||||||
|
openapi-generator generate --enable-post-process-file -i $OPENAPI_DOC -g ruby -o .out-ruby/
|
||||||
|
```
|
||||||
|
|
||||||
|
You will now see messages logged about which files have been processed:
|
||||||
|
|
||||||
|
```
|
||||||
|
[main] INFO o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.rspec
|
||||||
|
[main] INFO o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/spec_helper.rb
|
||||||
|
[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
|
||||||
|
[main] INFO o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/configuration_spec.rb
|
||||||
|
[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
|
||||||
|
[main] INFO o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/spec/api_client_spec.rb
|
||||||
|
[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
|
||||||
|
[main] INFO o.o.codegen.TemplateManager - Skipped /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator-ignore (Skipped by supportingFiles options supplied by user.)
|
||||||
|
[main] INFO o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/VERSION
|
||||||
|
[main] INFO o.o.codegen.TemplateManager - writing file /Users/jim/projects/openapi-generator/.out-ruby/.openapi-generator/FILES
|
||||||
|
```
|
||||||
@@ -27,9 +27,9 @@ The following generators are available:
|
|||||||
* [elm](generators/elm.md)
|
* [elm](generators/elm.md)
|
||||||
* [erlang-client](generators/erlang-client.md)
|
* [erlang-client](generators/erlang-client.md)
|
||||||
* [erlang-proper](generators/erlang-proper.md)
|
* [erlang-proper](generators/erlang-proper.md)
|
||||||
* [flash](generators/flash.md)
|
* [flash-deprecated (deprecated)](generators/flash-deprecated.md)
|
||||||
* [go](generators/go.md)
|
* [go](generators/go.md)
|
||||||
* [go-experimental (experimental)](generators/go-experimental.md)
|
* [go-deprecated (deprecated)](generators/go-deprecated.md)
|
||||||
* [groovy](generators/groovy.md)
|
* [groovy](generators/groovy.md)
|
||||||
* [haskell-http-client](generators/haskell-http-client.md)
|
* [haskell-http-client](generators/haskell-http-client.md)
|
||||||
* [java](generators/java.md)
|
* [java](generators/java.md)
|
||||||
@@ -140,13 +140,13 @@ The following generators are available:
|
|||||||
|
|
||||||
## SCHEMA generators
|
## SCHEMA generators
|
||||||
* [avro-schema (beta)](generators/avro-schema.md)
|
* [avro-schema (beta)](generators/avro-schema.md)
|
||||||
|
* [graphql-schema](generators/graphql-schema.md)
|
||||||
* [mysql-schema](generators/mysql-schema.md)
|
* [mysql-schema](generators/mysql-schema.md)
|
||||||
|
* [protobuf-schema (beta)](generators/protobuf-schema.md)
|
||||||
|
|
||||||
|
|
||||||
## CONFIG generators
|
## CONFIG generators
|
||||||
* [apache2](generators/apache2.md)
|
* [apache2](generators/apache2.md)
|
||||||
* [graphql-schema](generators/graphql-schema.md)
|
|
||||||
* [protobuf-schema (beta)](generators/protobuf-schema.md)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for ada-server
|
|||||||
sidebar_label: ada-server
|
sidebar_label: ada-server
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -29,14 +31,17 @@ sidebar_label: ada-server
|
|||||||
## LANGUAGE PRIMITIVES
|
## LANGUAGE PRIMITIVES
|
||||||
|
|
||||||
<ul class="column-ul">
|
<ul class="column-ul">
|
||||||
<li>Boolean</li>
|
<li>DateTime</li>
|
||||||
<li>Character</li>
|
<li>binary</li>
|
||||||
<li>Integer</li>
|
|
||||||
<li>boolean</li>
|
<li>boolean</li>
|
||||||
|
<li>date</li>
|
||||||
<li>double</li>
|
<li>double</li>
|
||||||
<li>float</li>
|
<li>float</li>
|
||||||
<li>integer</li>
|
<li>integer</li>
|
||||||
<li>long</li>
|
<li>long</li>
|
||||||
|
<li>number</li>
|
||||||
|
<li>object</li>
|
||||||
|
<li>string</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
## RESERVED WORDS
|
## RESERVED WORDS
|
||||||
@@ -208,8 +213,8 @@ sidebar_label: ada-server
|
|||||||
### Security Feature
|
### Security Feature
|
||||||
| Name | Supported | Defined By |
|
| Name | Supported | Defined By |
|
||||||
| ---- | --------- | ---------- |
|
| ---- | --------- | ---------- |
|
||||||
|BasicAuth|✓|OAS2,OAS3
|
|BasicAuth|✗|OAS2,OAS3
|
||||||
|ApiKey|✓|OAS2,OAS3
|
|ApiKey|✗|OAS2,OAS3
|
||||||
|OpenIDConnect|✗|OAS3
|
|OpenIDConnect|✗|OAS3
|
||||||
|BearerToken|✗|OAS3
|
|BearerToken|✗|OAS3
|
||||||
|OAuth2_Implicit|✗|OAS2,OAS3
|
|OAuth2_Implicit|✗|OAS2,OAS3
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for ada
|
|||||||
sidebar_label: ada
|
sidebar_label: ada
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -29,14 +31,17 @@ sidebar_label: ada
|
|||||||
## LANGUAGE PRIMITIVES
|
## LANGUAGE PRIMITIVES
|
||||||
|
|
||||||
<ul class="column-ul">
|
<ul class="column-ul">
|
||||||
<li>Boolean</li>
|
<li>DateTime</li>
|
||||||
<li>Character</li>
|
<li>binary</li>
|
||||||
<li>Integer</li>
|
|
||||||
<li>boolean</li>
|
<li>boolean</li>
|
||||||
|
<li>date</li>
|
||||||
<li>double</li>
|
<li>double</li>
|
||||||
<li>float</li>
|
<li>float</li>
|
||||||
<li>integer</li>
|
<li>integer</li>
|
||||||
<li>long</li>
|
<li>long</li>
|
||||||
|
<li>number</li>
|
||||||
|
<li>object</li>
|
||||||
|
<li>string</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
## RESERVED WORDS
|
## RESERVED WORDS
|
||||||
@@ -122,7 +127,7 @@ sidebar_label: ada
|
|||||||
### Client Modification Feature
|
### Client Modification Feature
|
||||||
| Name | Supported | Defined By |
|
| Name | Supported | Defined By |
|
||||||
| ---- | --------- | ---------- |
|
| ---- | --------- | ---------- |
|
||||||
|BasePath|✗|ToolingExtension
|
|BasePath|✓|ToolingExtension
|
||||||
|Authorizations|✗|ToolingExtension
|
|Authorizations|✗|ToolingExtension
|
||||||
|UserAgent|✗|ToolingExtension
|
|UserAgent|✗|ToolingExtension
|
||||||
|MockServer|✗|ToolingExtension
|
|MockServer|✗|ToolingExtension
|
||||||
@@ -163,7 +168,7 @@ sidebar_label: ada
|
|||||||
### Documentation Feature
|
### Documentation Feature
|
||||||
| Name | Supported | Defined By |
|
| Name | Supported | Defined By |
|
||||||
| ---- | --------- | ---------- |
|
| ---- | --------- | ---------- |
|
||||||
|Readme|✗|ToolingExtension
|
|Readme|✓|ToolingExtension
|
||||||
|Model|✓|ToolingExtension
|
|Model|✓|ToolingExtension
|
||||||
|Api|✓|ToolingExtension
|
|Api|✓|ToolingExtension
|
||||||
|
|
||||||
@@ -183,7 +188,7 @@ sidebar_label: ada
|
|||||||
|MultiServer|✗|OAS3
|
|MultiServer|✗|OAS3
|
||||||
|ParameterizedServer|✗|OAS3
|
|ParameterizedServer|✗|OAS3
|
||||||
|ParameterStyling|✗|OAS3
|
|ParameterStyling|✗|OAS3
|
||||||
|Callbacks|✓|OAS3
|
|Callbacks|✗|OAS3
|
||||||
|LinkObjects|✗|OAS3
|
|LinkObjects|✗|OAS3
|
||||||
|
|
||||||
### Parameter Feature
|
### Parameter Feature
|
||||||
@@ -202,20 +207,20 @@ sidebar_label: ada
|
|||||||
| ---- | --------- | ---------- |
|
| ---- | --------- | ---------- |
|
||||||
|Simple|✓|OAS2,OAS3
|
|Simple|✓|OAS2,OAS3
|
||||||
|Composite|✓|OAS2,OAS3
|
|Composite|✓|OAS2,OAS3
|
||||||
|Polymorphism|✓|OAS2,OAS3
|
|Polymorphism|✗|OAS2,OAS3
|
||||||
|Union|✗|OAS3
|
|Union|✗|OAS3
|
||||||
|
|
||||||
### Security Feature
|
### Security Feature
|
||||||
| Name | Supported | Defined By |
|
| Name | Supported | Defined By |
|
||||||
| ---- | --------- | ---------- |
|
| ---- | --------- | ---------- |
|
||||||
|BasicAuth|✓|OAS2,OAS3
|
|BasicAuth|✗|OAS2,OAS3
|
||||||
|ApiKey|✓|OAS2,OAS3
|
|ApiKey|✗|OAS2,OAS3
|
||||||
|OpenIDConnect|✗|OAS3
|
|OpenIDConnect|✗|OAS3
|
||||||
|BearerToken|✓|OAS3
|
|BearerToken|✗|OAS3
|
||||||
|OAuth2_Implicit|✓|OAS2,OAS3
|
|OAuth2_Implicit|✗|OAS2,OAS3
|
||||||
|OAuth2_Password|✓|OAS2,OAS3
|
|OAuth2_Password|✗|OAS2,OAS3
|
||||||
|OAuth2_ClientCredentials|✓|OAS2,OAS3
|
|OAuth2_ClientCredentials|✗|OAS2,OAS3
|
||||||
|OAuth2_AuthorizationCode|✓|OAS2,OAS3
|
|OAuth2_AuthorizationCode|✗|OAS2,OAS3
|
||||||
|
|
||||||
### Wire Format Feature
|
### Wire Format Feature
|
||||||
| Name | Supported | Defined By |
|
| Name | Supported | Defined By |
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for android
|
|||||||
sidebar_label: android
|
sidebar_label: android
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -34,17 +36,11 @@ sidebar_label: android
|
|||||||
|ArrayList|java.util.ArrayList|
|
|ArrayList|java.util.ArrayList|
|
||||||
|BigDecimal|java.math.BigDecimal|
|
|BigDecimal|java.math.BigDecimal|
|
||||||
|Date|java.util.Date|
|
|Date|java.util.Date|
|
||||||
|DateTime|org.joda.time.*|
|
|
||||||
|File|java.io.File|
|
|File|java.io.File|
|
||||||
|HashMap|java.util.HashMap|
|
|HashMap|java.util.HashMap|
|
||||||
|LinkedHashSet|java.util.LinkedHashSet|
|
|
||||||
|List|java.util.*|
|
|List|java.util.*|
|
||||||
|LocalDate|org.joda.time.*|
|
|
||||||
|LocalDateTime|org.joda.time.*|
|
|
||||||
|LocalTime|org.joda.time.*|
|
|
||||||
|Map|java.util.Map|
|
|Map|java.util.Map|
|
||||||
|Set|java.util.*|
|
|Set|java.util.*|
|
||||||
|Timestamp|java.sql.Timestamp|
|
|
||||||
|URI|java.net.URI|
|
|URI|java.net.URI|
|
||||||
|UUID|java.util.UUID|
|
|UUID|java.util.UUID|
|
||||||
|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for apache2
|
|||||||
sidebar_label: apache2
|
sidebar_label: apache2
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -18,23 +20,6 @@ sidebar_label: apache2
|
|||||||
|
|
||||||
| Type/Alias | Imports |
|
| Type/Alias | Imports |
|
||||||
| ---------- | ------- |
|
| ---------- | ------- |
|
||||||
|Array|java.util.List|
|
|
||||||
|ArrayList|java.util.ArrayList|
|
|
||||||
|BigDecimal|java.math.BigDecimal|
|
|
||||||
|Date|java.util.Date|
|
|
||||||
|DateTime|org.joda.time.*|
|
|
||||||
|File|java.io.File|
|
|
||||||
|HashMap|java.util.HashMap|
|
|
||||||
|LinkedHashSet|java.util.LinkedHashSet|
|
|
||||||
|List|java.util.*|
|
|
||||||
|LocalDate|org.joda.time.*|
|
|
||||||
|LocalDateTime|org.joda.time.*|
|
|
||||||
|LocalTime|org.joda.time.*|
|
|
||||||
|Map|java.util.Map|
|
|
||||||
|Set|java.util.*|
|
|
||||||
|Timestamp|java.sql.Timestamp|
|
|
||||||
|URI|java.net.URI|
|
|
||||||
|UUID|java.util.UUID|
|
|
||||||
|
|
||||||
|
|
||||||
## INSTANTIATION TYPES
|
## INSTANTIATION TYPES
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for apex
|
|||||||
sidebar_label: apex
|
sidebar_label: apex
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -62,6 +64,7 @@ sidebar_label: apex
|
|||||||
<li>begin</li>
|
<li>begin</li>
|
||||||
<li>bigdecimal</li>
|
<li>bigdecimal</li>
|
||||||
<li>blob</li>
|
<li>blob</li>
|
||||||
|
<li>boolean</li>
|
||||||
<li>break</li>
|
<li>break</li>
|
||||||
<li>bulk</li>
|
<li>bulk</li>
|
||||||
<li>by</li>
|
<li>by</li>
|
||||||
@@ -75,7 +78,6 @@ sidebar_label: apex
|
|||||||
<li>commit</li>
|
<li>commit</li>
|
||||||
<li>const</li>
|
<li>const</li>
|
||||||
<li>continue</li>
|
<li>continue</li>
|
||||||
<li>convertcurrency</li>
|
|
||||||
<li>currency</li>
|
<li>currency</li>
|
||||||
<li>date</li>
|
<li>date</li>
|
||||||
<li>datetime</li>
|
<li>datetime</li>
|
||||||
@@ -84,6 +86,7 @@ sidebar_label: apex
|
|||||||
<li>delete</li>
|
<li>delete</li>
|
||||||
<li>desc</li>
|
<li>desc</li>
|
||||||
<li>do</li>
|
<li>do</li>
|
||||||
|
<li>double</li>
|
||||||
<li>else</li>
|
<li>else</li>
|
||||||
<li>end</li>
|
<li>end</li>
|
||||||
<li>enum</li>
|
<li>enum</li>
|
||||||
@@ -97,7 +100,6 @@ sidebar_label: apex
|
|||||||
<li>float</li>
|
<li>float</li>
|
||||||
<li>for</li>
|
<li>for</li>
|
||||||
<li>from</li>
|
<li>from</li>
|
||||||
<li>future</li>
|
|
||||||
<li>global</li>
|
<li>global</li>
|
||||||
<li>goto</li>
|
<li>goto</li>
|
||||||
<li>group</li>
|
<li>group</li>
|
||||||
@@ -111,13 +113,10 @@ sidebar_label: apex
|
|||||||
<li>insert</li>
|
<li>insert</li>
|
||||||
<li>instanceof</li>
|
<li>instanceof</li>
|
||||||
<li>int</li>
|
<li>int</li>
|
||||||
|
<li>integer</li>
|
||||||
<li>interface</li>
|
<li>interface</li>
|
||||||
<li>into</li>
|
<li>into</li>
|
||||||
<li>join</li>
|
<li>join</li>
|
||||||
<li>last_90_days</li>
|
|
||||||
<li>last_month</li>
|
|
||||||
<li>last_n_days</li>
|
|
||||||
<li>last_week</li>
|
|
||||||
<li>like</li>
|
<li>like</li>
|
||||||
<li>limit</li>
|
<li>limit</li>
|
||||||
<li>list</li>
|
<li>list</li>
|
||||||
@@ -126,10 +125,6 @@ sidebar_label: apex
|
|||||||
<li>map</li>
|
<li>map</li>
|
||||||
<li>merge</li>
|
<li>merge</li>
|
||||||
<li>new</li>
|
<li>new</li>
|
||||||
<li>next_90_days</li>
|
|
||||||
<li>next_month</li>
|
|
||||||
<li>next_n_days</li>
|
|
||||||
<li>next_week</li>
|
|
||||||
<li>not</li>
|
<li>not</li>
|
||||||
<li>null</li>
|
<li>null</li>
|
||||||
<li>nulls</li>
|
<li>nulls</li>
|
||||||
@@ -148,16 +143,14 @@ sidebar_label: apex
|
|||||||
<li>public</li>
|
<li>public</li>
|
||||||
<li>retrieve</li>
|
<li>retrieve</li>
|
||||||
<li>return</li>
|
<li>return</li>
|
||||||
<li>returning</li>
|
|
||||||
<li>rollback</li>
|
<li>rollback</li>
|
||||||
<li>savepoint</li>
|
|
||||||
<li>search</li>
|
|
||||||
<li>select</li>
|
<li>select</li>
|
||||||
<li>set</li>
|
<li>set</li>
|
||||||
<li>short</li>
|
<li>short</li>
|
||||||
|
<li>sobject</li>
|
||||||
<li>sort</li>
|
<li>sort</li>
|
||||||
<li>stat</li>
|
|
||||||
<li>static</li>
|
<li>static</li>
|
||||||
|
<li>string</li>
|
||||||
<li>super</li>
|
<li>super</li>
|
||||||
<li>switch</li>
|
<li>switch</li>
|
||||||
<li>synchronized</li>
|
<li>synchronized</li>
|
||||||
@@ -165,28 +158,22 @@ sidebar_label: apex
|
|||||||
<li>testmethod</li>
|
<li>testmethod</li>
|
||||||
<li>then</li>
|
<li>then</li>
|
||||||
<li>this</li>
|
<li>this</li>
|
||||||
<li>this_month</li>
|
|
||||||
<li>this_week</li>
|
|
||||||
<li>throw</li>
|
<li>throw</li>
|
||||||
<li>time</li>
|
<li>time</li>
|
||||||
<li>today</li>
|
|
||||||
<li>tolabel</li>
|
|
||||||
<li>tomorrow</li>
|
|
||||||
<li>transaction</li>
|
<li>transaction</li>
|
||||||
<li>trigger</li>
|
<li>trigger</li>
|
||||||
<li>true</li>
|
<li>true</li>
|
||||||
<li>try</li>
|
<li>try</li>
|
||||||
<li>type</li>
|
|
||||||
<li>undelete</li>
|
<li>undelete</li>
|
||||||
<li>update</li>
|
<li>update</li>
|
||||||
<li>upsert</li>
|
<li>upsert</li>
|
||||||
<li>using</li>
|
<li>using</li>
|
||||||
<li>virtual</li>
|
<li>virtual</li>
|
||||||
|
<li>void</li>
|
||||||
<li>webservice</li>
|
<li>webservice</li>
|
||||||
<li>when</li>
|
<li>when</li>
|
||||||
<li>where</li>
|
<li>where</li>
|
||||||
<li>while</li>
|
<li>while</li>
|
||||||
<li>yesterday</li>
|
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
## FEATURE SET
|
## FEATURE SET
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for asciidoc
|
|||||||
sidebar_label: asciidoc
|
sidebar_label: asciidoc
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,11 +3,13 @@ title: Config Options for aspnetcore
|
|||||||
sidebar_label: aspnetcore
|
sidebar_label: aspnetcore
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|aspnetCoreVersion|ASP.NET Core version: 3.1, 3.0, 2.2, 2.1, 2.0 (deprecated)| |2.2|
|
|aspnetCoreVersion|ASP.NET Core version: 3.1, 3.0, 2.2, 2.1, 2.0 (deprecated)| |2.2|
|
||||||
|buildTarget|Target to build an application or library| |program|
|
|buildTarget|Target to build an application or library| |program|
|
||||||
|classModifier|Class Modifier can be empty, abstract| ||
|
|classModifier|Class Modifier for controller classes: Empty string or abstract.| ||
|
||||||
|compatibilityVersion|ASP.Net Core CompatibilityVersion| |Version_2_2|
|
|compatibilityVersion|ASP.Net Core CompatibilityVersion| |Version_2_2|
|
||||||
|enumNameSuffix|Suffix that will be appended to all enum names.| |Enum|
|
|enumNameSuffix|Suffix that will be appended to all enum names.| |Enum|
|
||||||
|enumValueSuffix|Suffix that will be appended to all enum values.| |Enum|
|
|enumValueSuffix|Suffix that will be appended to all enum values.| |Enum|
|
||||||
@@ -18,7 +20,7 @@ sidebar_label: aspnetcore
|
|||||||
|modelClassModifier|Model Class Modifier can be nothing or partial| |partial|
|
|modelClassModifier|Model Class Modifier can be nothing or partial| |partial|
|
||||||
|newtonsoftVersion|Version for Microsoft.AspNetCore.Mvc.NewtonsoftJson for ASP.NET Core 3.0+| |3.0.0|
|
|newtonsoftVersion|Version for Microsoft.AspNetCore.Mvc.NewtonsoftJson for ASP.NET Core 3.0+| |3.0.0|
|
||||||
|operationIsAsync|Set methods to async or sync (default).| |false|
|
|operationIsAsync|Set methods to async or sync (default).| |false|
|
||||||
|operationModifier|Operation Modifier can be virtual, abstract or partial| |virtual|
|
|operationModifier|Operation Modifier can be virtual or abstract| |virtual|
|
||||||
|operationResultTask|Set methods result to Task<>.| |false|
|
|operationResultTask|Set methods result to Task<>.| |false|
|
||||||
|packageAuthors|Specifies Authors property in the .NET Core project file.| |OpenAPI|
|
|packageAuthors|Specifies Authors property in the .NET Core project file.| |OpenAPI|
|
||||||
|packageCopyright|Specifies an AssemblyCopyright for the .NET Framework global assembly attributes stored in the AssemblyInfo file.| |No Copyright|
|
|packageCopyright|Specifies an AssemblyCopyright for the .NET Framework global assembly attributes stored in the AssemblyInfo file.| |No Copyright|
|
||||||
@@ -61,6 +63,7 @@ sidebar_label: aspnetcore
|
|||||||
<li>DateTime?</li>
|
<li>DateTime?</li>
|
||||||
<li>DateTimeOffset</li>
|
<li>DateTimeOffset</li>
|
||||||
<li>DateTimeOffset?</li>
|
<li>DateTimeOffset?</li>
|
||||||
|
<li>Decimal</li>
|
||||||
<li>Dictionary</li>
|
<li>Dictionary</li>
|
||||||
<li>Double</li>
|
<li>Double</li>
|
||||||
<li>Float</li>
|
<li>Float</li>
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for avro-schema
|
|||||||
sidebar_label: avro-schema
|
sidebar_label: avro-schema
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for bash
|
|||||||
sidebar_label: bash
|
sidebar_label: bash
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -25,23 +27,6 @@ sidebar_label: bash
|
|||||||
|
|
||||||
| Type/Alias | Imports |
|
| Type/Alias | Imports |
|
||||||
| ---------- | ------- |
|
| ---------- | ------- |
|
||||||
|Array|java.util.List|
|
|
||||||
|ArrayList|java.util.ArrayList|
|
|
||||||
|BigDecimal|java.math.BigDecimal|
|
|
||||||
|Date|java.util.Date|
|
|
||||||
|DateTime|org.joda.time.*|
|
|
||||||
|File|java.io.File|
|
|
||||||
|HashMap|java.util.HashMap|
|
|
||||||
|LinkedHashSet|java.util.LinkedHashSet|
|
|
||||||
|List|java.util.*|
|
|
||||||
|LocalDate|org.joda.time.*|
|
|
||||||
|LocalDateTime|org.joda.time.*|
|
|
||||||
|LocalTime|org.joda.time.*|
|
|
||||||
|Map|java.util.Map|
|
|
||||||
|Set|java.util.*|
|
|
||||||
|Timestamp|java.sql.Timestamp|
|
|
||||||
|URI|java.net.URI|
|
|
||||||
|UUID|java.util.UUID|
|
|
||||||
|
|
||||||
|
|
||||||
## INSTANTIATION TYPES
|
## INSTANTIATION TYPES
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for c
|
|||||||
sidebar_label: c
|
sidebar_label: c
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for clojure
|
|||||||
sidebar_label: clojure
|
sidebar_label: clojure
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -24,23 +26,6 @@ sidebar_label: clojure
|
|||||||
|
|
||||||
| Type/Alias | Imports |
|
| Type/Alias | Imports |
|
||||||
| ---------- | ------- |
|
| ---------- | ------- |
|
||||||
|Array|java.util.List|
|
|
||||||
|ArrayList|java.util.ArrayList|
|
|
||||||
|BigDecimal|java.math.BigDecimal|
|
|
||||||
|Date|java.util.Date|
|
|
||||||
|DateTime|org.joda.time.*|
|
|
||||||
|File|java.io.File|
|
|
||||||
|HashMap|java.util.HashMap|
|
|
||||||
|LinkedHashSet|java.util.LinkedHashSet|
|
|
||||||
|List|java.util.*|
|
|
||||||
|LocalDate|org.joda.time.*|
|
|
||||||
|LocalDateTime|org.joda.time.*|
|
|
||||||
|LocalTime|org.joda.time.*|
|
|
||||||
|Map|java.util.Map|
|
|
||||||
|Set|java.util.*|
|
|
||||||
|Timestamp|java.sql.Timestamp|
|
|
||||||
|URI|java.net.URI|
|
|
||||||
|UUID|java.util.UUID|
|
|
||||||
|
|
||||||
|
|
||||||
## INSTANTIATION TYPES
|
## INSTANTIATION TYPES
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cpp-pistache-server
|
|||||||
sidebar_label: cpp-pistache-server
|
sidebar_label: cpp-pistache-server
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|addExternalLibs|Add the Possibility to fetch and compile external Libraries needed by this Framework.| |true|
|
|addExternalLibs|Add the Possibility to fetch and compile external Libraries needed by this Framework.| |true|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cpp-qt5-client
|
|||||||
sidebar_label: cpp-qt5-client
|
sidebar_label: cpp-qt5-client
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cpp-qt5-qhttpengine-server
|
|||||||
sidebar_label: cpp-qt5-qhttpengine-server
|
sidebar_label: cpp-qt5-qhttpengine-server
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cpp-restbed-server
|
|||||||
sidebar_label: cpp-restbed-server
|
sidebar_label: cpp-restbed-server
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|apiPackage|C++ namespace for apis (convention: name.space.api).| |org.openapitools.server.api|
|
|apiPackage|C++ namespace for apis (convention: name.space.api).| |org.openapitools.server.api|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cpp-restsdk
|
|||||||
sidebar_label: cpp-restsdk
|
sidebar_label: cpp-restsdk
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|apiPackage|C++ namespace for apis (convention: name.space.api).| |org.openapitools.client.api|
|
|apiPackage|C++ namespace for apis (convention: name.space.api).| |org.openapitools.client.api|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cpp-tizen
|
|||||||
sidebar_label: cpp-tizen
|
sidebar_label: cpp-tizen
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cpp-ue4
|
|||||||
sidebar_label: cpp-ue4
|
sidebar_label: cpp-ue4
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for csharp-dotnet2
|
|||||||
sidebar_label: csharp-dotnet2
|
sidebar_label: csharp-dotnet2
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|clientPackage|C# client package name (convention: Camel.Case).| |Org.OpenAPITools.Client|
|
|clientPackage|C# client package name (convention: Camel.Case).| |Org.OpenAPITools.Client|
|
||||||
@@ -33,6 +35,7 @@ sidebar_label: csharp-dotnet2
|
|||||||
<li>DateTime?</li>
|
<li>DateTime?</li>
|
||||||
<li>DateTimeOffset</li>
|
<li>DateTimeOffset</li>
|
||||||
<li>DateTimeOffset?</li>
|
<li>DateTimeOffset?</li>
|
||||||
|
<li>Decimal</li>
|
||||||
<li>Dictionary</li>
|
<li>Dictionary</li>
|
||||||
<li>Double</li>
|
<li>Double</li>
|
||||||
<li>Float</li>
|
<li>Float</li>
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for csharp-nancyfx
|
|||||||
sidebar_label: csharp-nancyfx
|
sidebar_label: csharp-nancyfx
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|asyncServer|Set to true to enable the generation of async routes/endpoints.| |false|
|
|asyncServer|Set to true to enable the generation of async routes/endpoints.| |false|
|
||||||
@@ -44,6 +46,7 @@ sidebar_label: csharp-nancyfx
|
|||||||
<li>DateTime?</li>
|
<li>DateTime?</li>
|
||||||
<li>DateTimeOffset</li>
|
<li>DateTimeOffset</li>
|
||||||
<li>DateTimeOffset?</li>
|
<li>DateTimeOffset?</li>
|
||||||
|
<li>Decimal</li>
|
||||||
<li>Dictionary</li>
|
<li>Dictionary</li>
|
||||||
<li>Double</li>
|
<li>Double</li>
|
||||||
<li>Float</li>
|
<li>Float</li>
|
||||||
|
|||||||
@@ -3,10 +3,13 @@ title: Config Options for csharp-netcore
|
|||||||
sidebar_label: csharp-netcore
|
sidebar_label: csharp-netcore
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|caseInsensitiveResponseHeaders|Make API response's headers case-insensitive| |false|
|
|caseInsensitiveResponseHeaders|Make API response's headers case-insensitive| |false|
|
||||||
|
|disallowAdditionalPropertiesIfNotPresent|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.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>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.</dd></dl>|true|
|
||||||
|hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|
|
|hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|
|
||||||
|interfacePrefix|Prefix interfaces with a community standard or widely accepted prefix.| |I|
|
|interfacePrefix|Prefix interfaces with a community standard or widely accepted prefix.| |I|
|
||||||
|licenseId|The identifier of the license| |null|
|
|licenseId|The identifier of the license| |null|
|
||||||
@@ -25,9 +28,10 @@ sidebar_label: csharp-netcore
|
|||||||
|returnICollection|Return ICollection<T> instead of the concrete type.| |false|
|
|returnICollection|Return ICollection<T> instead of the concrete type.| |false|
|
||||||
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
||||||
|sourceFolder|source folder for generated code| |src|
|
|sourceFolder|source folder for generated code| |src|
|
||||||
|targetFramework|The target .NET framework version.|<dl><dt>**netstandard1.3**</dt><dd>.NET Standard 1.3 compatible</dd><dt>**netstandard1.4**</dt><dd>.NET Standard 1.4 compatible</dd><dt>**netstandard1.5**</dt><dd>.NET Standard 1.5 compatible</dd><dt>**netstandard1.6**</dt><dd>.NET Standard 1.6 compatible</dd><dt>**netstandard2.0**</dt><dd>.NET Standard 2.0 compatible</dd><dt>**netstandard2.1**</dt><dd>.NET Standard 2.1 compatible</dd><dt>**netcoreapp2.0**</dt><dd>.NET Core 2.0 compatible</dd><dt>**netcoreapp2.1**</dt><dd>.NET Core 2.1 compatible</dd><dt>**netcoreapp3.0**</dt><dd>.NET Core 3.0 compatible</dd><dt>**netcoreapp3.1**</dt><dd>.NET Core 3.1 compatible</dd></dl>|netstandard2.0|
|
|targetFramework|The target .NET framework version.|<dl><dt>**netstandard1.3**</dt><dd>.NET Standard 1.3 compatible</dd><dt>**netstandard1.4**</dt><dd>.NET Standard 1.4 compatible</dd><dt>**netstandard1.5**</dt><dd>.NET Standard 1.5 compatible</dd><dt>**netstandard1.6**</dt><dd>.NET Standard 1.6 compatible</dd><dt>**netstandard2.0**</dt><dd>.NET Standard 2.0 compatible</dd><dt>**netstandard2.1**</dt><dd>.NET Standard 2.1 compatible</dd><dt>**netcoreapp2.0**</dt><dd>.NET Core 2.0 compatible</dd><dt>**netcoreapp2.1**</dt><dd>.NET Core 2.1 compatible</dd><dt>**netcoreapp3.0**</dt><dd>.NET Core 3.0 compatible</dd><dt>**netcoreapp3.1**</dt><dd>.NET Core 3.1 compatible</dd><dt>**net47**</dt><dd>.NET Framework 4.7 compatible</dd></dl>|netstandard2.0|
|
||||||
|useCollection|Deserialize array types to Collection<T> instead of List<T>.| |false|
|
|useCollection|Deserialize array types to Collection<T> instead of List<T>.| |false|
|
||||||
|useDateTimeOffset|Use DateTimeOffset to model date-time properties| |false|
|
|useDateTimeOffset|Use DateTimeOffset to model date-time properties| |false|
|
||||||
|
|useOneOfDiscriminatorLookup|Use the discriminator's mapping in oneOf to speed up the model lookup. IMPORTANT: Validation (e.g. one and onlye one match in oneOf's schemas) will be skipped.| |false|
|
||||||
|validatable|Generates self-validatable models.| |true|
|
|validatable|Generates self-validatable models.| |true|
|
||||||
|
|
||||||
## IMPORT MAPPING
|
## IMPORT MAPPING
|
||||||
@@ -54,6 +58,7 @@ sidebar_label: csharp-netcore
|
|||||||
<li>DateTime?</li>
|
<li>DateTime?</li>
|
||||||
<li>DateTimeOffset</li>
|
<li>DateTimeOffset</li>
|
||||||
<li>DateTimeOffset?</li>
|
<li>DateTimeOffset?</li>
|
||||||
|
<li>Decimal</li>
|
||||||
<li>Dictionary</li>
|
<li>Dictionary</li>
|
||||||
<li>Double</li>
|
<li>Double</li>
|
||||||
<li>Float</li>
|
<li>Float</li>
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for csharp
|
|||||||
sidebar_label: csharp
|
sidebar_label: csharp
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -53,6 +55,7 @@ sidebar_label: csharp
|
|||||||
<li>DateTime?</li>
|
<li>DateTime?</li>
|
||||||
<li>DateTimeOffset</li>
|
<li>DateTimeOffset</li>
|
||||||
<li>DateTimeOffset?</li>
|
<li>DateTimeOffset?</li>
|
||||||
|
<li>Decimal</li>
|
||||||
<li>Dictionary</li>
|
<li>Dictionary</li>
|
||||||
<li>Double</li>
|
<li>Double</li>
|
||||||
<li>Float</li>
|
<li>Float</li>
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for cwiki
|
|||||||
sidebar_label: cwiki
|
sidebar_label: cwiki
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,10 +3,11 @@ title: Config Options for dart-dio
|
|||||||
sidebar_label: dart-dio
|
sidebar_label: dart-dio
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|browserClient|Is the client browser based (for Dart 1.x only)| |null|
|
|
||||||
|dateLibrary|Option. Date library to use|<dl><dt>**core**</dt><dd>Dart core library (DateTime)</dd><dt>**timemachine**</dt><dd>Time Machine is date and time library for Flutter, Web, and Server with support for timezones, calendars, cultures, formatting and parsing.</dd></dl>|core|
|
|dateLibrary|Option. Date library to use|<dl><dt>**core**</dt><dd>Dart core library (DateTime)</dd><dt>**timemachine**</dt><dd>Time Machine is date and time library for Flutter, Web, and Server with support for timezones, calendars, cultures, formatting and parsing.</dd></dl>|core|
|
||||||
|disallowAdditionalPropertiesIfNotPresent|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.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>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.</dd></dl>|true|
|
|disallowAdditionalPropertiesIfNotPresent|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.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>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.</dd></dl>|true|
|
||||||
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|
||||||
@@ -17,12 +18,12 @@ sidebar_label: dart-dio
|
|||||||
|pubAuthorEmail|Email address of the author in generated pubspec| |null|
|
|pubAuthorEmail|Email address of the author in generated pubspec| |null|
|
||||||
|pubDescription|Description in generated pubspec| |null|
|
|pubDescription|Description in generated pubspec| |null|
|
||||||
|pubHomepage|Homepage in generated pubspec| |null|
|
|pubHomepage|Homepage in generated pubspec| |null|
|
||||||
|
|pubLibrary|Library name in generated code| |null|
|
||||||
|pubName|Name in generated pubspec| |null|
|
|pubName|Name in generated pubspec| |null|
|
||||||
|pubVersion|Version in generated pubspec| |null|
|
|pubVersion|Version in generated pubspec| |null|
|
||||||
|sortModelPropertiesByRequiredFlag|Sort model properties to place required parameters before optional parameters.| |true|
|
|sortModelPropertiesByRequiredFlag|Sort model properties to place required parameters before optional parameters.| |true|
|
||||||
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
||||||
|sourceFolder|Source folder for generated code| |null|
|
|sourceFolder|Source folder for generated code| |null|
|
||||||
|supportDart2|Support Dart 2.x (Dart 1.x support has been deprecated)| |true|
|
|
||||||
|useEnumExtension|Allow the 'x-enum-values' extension for enums| |null|
|
|useEnumExtension|Allow the 'x-enum-values' extension for enums| |null|
|
||||||
|
|
||||||
## IMPORT MAPPING
|
## IMPORT MAPPING
|
||||||
|
|||||||
@@ -3,10 +3,11 @@ title: Config Options for dart-jaguar
|
|||||||
sidebar_label: dart-jaguar
|
sidebar_label: dart-jaguar
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|browserClient|Is the client browser based (for Dart 1.x only)| |null|
|
|
||||||
|disallowAdditionalPropertiesIfNotPresent|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.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>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.</dd></dl>|true|
|
|disallowAdditionalPropertiesIfNotPresent|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.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>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.</dd></dl>|true|
|
||||||
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|
||||||
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</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>**false**</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>|true|
|
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</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>**false**</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>|true|
|
||||||
@@ -16,13 +17,13 @@ sidebar_label: dart-jaguar
|
|||||||
|pubAuthorEmail|Email address of the author in generated pubspec| |null|
|
|pubAuthorEmail|Email address of the author in generated pubspec| |null|
|
||||||
|pubDescription|Description in generated pubspec| |null|
|
|pubDescription|Description in generated pubspec| |null|
|
||||||
|pubHomepage|Homepage in generated pubspec| |null|
|
|pubHomepage|Homepage in generated pubspec| |null|
|
||||||
|
|pubLibrary|Library name in generated code| |null|
|
||||||
|pubName|Name in generated pubspec| |null|
|
|pubName|Name in generated pubspec| |null|
|
||||||
|pubVersion|Version in generated pubspec| |null|
|
|pubVersion|Version in generated pubspec| |null|
|
||||||
|serialization|Choose serialization format JSON or PROTO is supported| |null|
|
|serialization|Choose serialization format JSON or PROTO is supported| |null|
|
||||||
|sortModelPropertiesByRequiredFlag|Sort model properties to place required parameters before optional parameters.| |true|
|
|sortModelPropertiesByRequiredFlag|Sort model properties to place required parameters before optional parameters.| |true|
|
||||||
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
||||||
|sourceFolder|Source folder for generated code| |null|
|
|sourceFolder|Source folder for generated code| |null|
|
||||||
|supportDart2|Support Dart 2.x (Dart 1.x support has been deprecated)| |true|
|
|
||||||
|useEnumExtension|Allow the 'x-enum-values' extension for enums| |null|
|
|useEnumExtension|Allow the 'x-enum-values' extension for enums| |null|
|
||||||
|
|
||||||
## IMPORT MAPPING
|
## IMPORT MAPPING
|
||||||
|
|||||||
@@ -3,10 +3,11 @@ title: Config Options for dart
|
|||||||
sidebar_label: dart
|
sidebar_label: dart
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|browserClient|Is the client browser based (for Dart 1.x only)| |null|
|
|
||||||
|disallowAdditionalPropertiesIfNotPresent|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.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>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.</dd></dl>|true|
|
|disallowAdditionalPropertiesIfNotPresent|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.|<dl><dt>**false**</dt><dd>The 'additionalProperties' implementation is compliant with the OAS and JSON schema specifications.</dd><dt>**true**</dt><dd>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.</dd></dl>|true|
|
||||||
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
|
||||||
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</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>**false**</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>|true|
|
|legacyDiscriminatorBehavior|This flag is used by OpenAPITools codegen to influence the processing of the discriminator attribute in OpenAPI documents. This flag has no impact if the OAS document does not use the discriminator attribute. The default value of this flag is set in each language-specific code generator (e.g. Python, Java, go...)using the method toModelName. Note to developers supporting a language generator in OpenAPITools; to fully support the discriminator attribute as defined in the OAS specification 3.x, language generators should set this flag to true by default; however this requires updating the mustache templates to generate a language-specific discriminator lookup function that iterates over {{#mappedModels}} and does not iterate over {{children}}, {{#anyOf}}, or {{#oneOf}}.|<dl><dt>**true**</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>**false**</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>|true|
|
||||||
@@ -15,12 +16,12 @@ sidebar_label: dart
|
|||||||
|pubAuthorEmail|Email address of the author in generated pubspec| |null|
|
|pubAuthorEmail|Email address of the author in generated pubspec| |null|
|
||||||
|pubDescription|Description in generated pubspec| |null|
|
|pubDescription|Description in generated pubspec| |null|
|
||||||
|pubHomepage|Homepage in generated pubspec| |null|
|
|pubHomepage|Homepage in generated pubspec| |null|
|
||||||
|
|pubLibrary|Library name in generated code| |null|
|
||||||
|pubName|Name in generated pubspec| |null|
|
|pubName|Name in generated pubspec| |null|
|
||||||
|pubVersion|Version in generated pubspec| |null|
|
|pubVersion|Version in generated pubspec| |null|
|
||||||
|sortModelPropertiesByRequiredFlag|Sort model properties to place required parameters before optional parameters.| |true|
|
|sortModelPropertiesByRequiredFlag|Sort model properties to place required parameters before optional parameters.| |true|
|
||||||
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
|
||||||
|sourceFolder|Source folder for generated code| |null|
|
|sourceFolder|Source folder for generated code| |null|
|
||||||
|supportDart2|Support Dart 2.x (Dart 1.x support has been deprecated)| |true|
|
|
||||||
|useEnumExtension|Allow the 'x-enum-values' extension for enums| |null|
|
|useEnumExtension|Allow the 'x-enum-values' extension for enums| |null|
|
||||||
|
|
||||||
## IMPORT MAPPING
|
## IMPORT MAPPING
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for dynamic-html
|
|||||||
sidebar_label: dynamic-html
|
sidebar_label: dynamic-html
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for eiffel
|
|||||||
sidebar_label: eiffel
|
sidebar_label: eiffel
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|
|
|hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|
|
||||||
@@ -13,23 +15,6 @@ sidebar_label: eiffel
|
|||||||
|
|
||||||
| Type/Alias | Imports |
|
| Type/Alias | Imports |
|
||||||
| ---------- | ------- |
|
| ---------- | ------- |
|
||||||
|Array|java.util.List|
|
|
||||||
|ArrayList|java.util.ArrayList|
|
|
||||||
|BigDecimal|java.math.BigDecimal|
|
|
||||||
|Date|java.util.Date|
|
|
||||||
|DateTime|org.joda.time.*|
|
|
||||||
|File|java.io.File|
|
|
||||||
|HashMap|java.util.HashMap|
|
|
||||||
|LinkedHashSet|java.util.LinkedHashSet|
|
|
||||||
|List|java.util.*|
|
|
||||||
|LocalDate|org.joda.time.*|
|
|
||||||
|LocalDateTime|org.joda.time.*|
|
|
||||||
|LocalTime|org.joda.time.*|
|
|
||||||
|Map|java.util.Map|
|
|
||||||
|Set|java.util.*|
|
|
||||||
|Timestamp|java.sql.Timestamp|
|
|
||||||
|URI|java.net.URI|
|
|
||||||
|UUID|java.util.UUID|
|
|
||||||
|
|
||||||
|
|
||||||
## INSTANTIATION TYPES
|
## INSTANTIATION TYPES
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for elixir
|
|||||||
sidebar_label: elixir
|
sidebar_label: elixir
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
|
||||||
@@ -20,23 +22,6 @@ sidebar_label: elixir
|
|||||||
|
|
||||||
| Type/Alias | Imports |
|
| Type/Alias | Imports |
|
||||||
| ---------- | ------- |
|
| ---------- | ------- |
|
||||||
|Array|java.util.List|
|
|
||||||
|ArrayList|java.util.ArrayList|
|
|
||||||
|BigDecimal|java.math.BigDecimal|
|
|
||||||
|Date|java.util.Date|
|
|
||||||
|DateTime|org.joda.time.*|
|
|
||||||
|File|java.io.File|
|
|
||||||
|HashMap|java.util.HashMap|
|
|
||||||
|LinkedHashSet|java.util.LinkedHashSet|
|
|
||||||
|List|java.util.*|
|
|
||||||
|LocalDate|org.joda.time.*|
|
|
||||||
|LocalDateTime|org.joda.time.*|
|
|
||||||
|LocalTime|org.joda.time.*|
|
|
||||||
|Map|java.util.Map|
|
|
||||||
|Set|java.util.*|
|
|
||||||
|Timestamp|java.sql.Timestamp|
|
|
||||||
|URI|java.net.URI|
|
|
||||||
|UUID|java.util.UUID|
|
|
||||||
|
|
||||||
|
|
||||||
## INSTANTIATION TYPES
|
## INSTANTIATION TYPES
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for elm
|
|||||||
sidebar_label: elm
|
sidebar_label: elm
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ title: Config Options for erlang-client
|
|||||||
sidebar_label: erlang-client
|
sidebar_label: erlang-client
|
||||||
---
|
---
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
| Option | Description | Values | Default |
|
| Option | Description | Values | Default |
|
||||||
| ------ | ----------- | ------ | ------- |
|
| ------ | ----------- | ------ | ------- |
|
||||||
|packageName|Erlang application name (convention: lowercase).| |openapi|
|
|packageName|Erlang application name (convention: lowercase).| |openapi|
|
||||||
@@ -12,23 +14,6 @@ sidebar_label: erlang-client
|
|||||||
|
|
||||||
| Type/Alias | Imports |
|
| Type/Alias | Imports |
|
||||||
| ---------- | ------- |
|
| ---------- | ------- |
|
||||||
|Array|java.util.List|
|
|
||||||
|ArrayList|java.util.ArrayList|
|
|
||||||
|BigDecimal|java.math.BigDecimal|
|
|
||||||
|Date|java.util.Date|
|
|
||||||
|DateTime|org.joda.time.*|
|
|
||||||
|File|java.io.File|
|
|
||||||
|HashMap|java.util.HashMap|
|
|
||||||
|LinkedHashSet|java.util.LinkedHashSet|
|
|
||||||
|List|java.util.*|
|
|
||||||
|LocalDate|org.joda.time.*|
|
|
||||||
|LocalDateTime|org.joda.time.*|
|
|
||||||
|LocalTime|org.joda.time.*|
|
|
||||||
|Map|java.util.Map|
|
|
||||||
|Set|java.util.*|
|
|
||||||
|Timestamp|java.sql.Timestamp|
|
|
||||||
|URI|java.net.URI|
|
|
||||||
|UUID|java.util.UUID|
|
|
||||||
|
|
||||||
|
|
||||||
## INSTANTIATION TYPES
|
## INSTANTIATION TYPES
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user