Skip to content

Commit a54ff02

Browse files
jimschubertjimschubert
committed
Merge branch 'master' into nullpointer-settings-fixes
* master: (45 commits) update python samples Two tiny fixes for Java Vertx client (#3683) Exclude "test" from packages so that it is not installed as top-level package when "pip installing" the generated sdk (#3731) [java-client] add unit test for JDK 11 HttpClient (#3735) [R] feat(r): handling error response for 3xx cases (#3571) [Dart] Avoid redundant null checking in fromJson (#3632) [core] Set isMultipart=true for multipart operations, fix possible NPE (#3750) reenable kotlin client tests in shippable ci (#3751) Fix null assignation to header/query param map (#3749) Mockito 3.0.0 (#3732) Update to swagger-parser to 2.0.14-OpenAPITools.org-1 (#3737) Add a link to a Qiita blog post (#3747) update csharp samples Simple spelling error in dotnet core comments (#3746) better support for multipart (#3736) [typescript-fetch] fix #1998: prefix req ifaces. (#3740) cpp-qt5-client: add valgrind memory test (#3663) [typescript-angular] Encode objects for multipart/form-data with json - fixes #2733 (#3738) [BUG] Https protocol schema is not handled correctly in java 11 native code #3729 (#3730) comment out kotlin client tests ...
2 parents 376f6e6 + cba2d3b commit a54ff02

File tree

345 files changed

+6330
-2935
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

345 files changed

+6330
-2935
lines changed

‎.travis.yml

+2
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,8 @@ before_install:
9494
# - Rely on `kerl` for [pre-compiled versions available](https://docs.travis-ci.com/user/languages/erlang#Choosing-OTP-releases-to-test-against). Rely on installation path chosen by [`travis-erlang-builder`](https://github.com/travis-ci/travis-erlang-builder/blob/e6d016b1a91ca7ecac5a5a46395bde917ea13d36/bin/compile#L18).
9595
# - . ~/otp/18.2.1/activate && erl -version
9696
#- curl -f -L -o ./rebar3 https://s3.amazonaws.com/rebar3/rebar3 && chmod +x ./rebar3 && ./rebar3 version && export PATH="${TRAVIS_BUILD_DIR}:$PATH"
97+
# install valgrind for C++ memory test
98+
- sudo apt-get install valgrind
9799
# install Qt 5.10
98100
- sudo add-apt-repository --yes ppa:beineri/opt-qt-5.10.1-trusty
99101
- sudo apt-get update -qq

‎CI/.drone.yml

+7
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,13 @@ kind: pipeline
22
name: default
33

44
steps:
5+
# test Dart 2.x petstore client
6+
- name: dart2x-test
7+
image: google/dart
8+
commands:
9+
- (cd samples/client/petstore/dart-jaguar/openapi && pub get && pub run build_runner build --delete-conflicting-outputs)
10+
- (cd samples/client/petstore/dart-jaguar/flutter_petstore/openapi && pub get && pub run build_runner build --delete-conflicting-outputs)
11+
- (cd samples/client/petstore/dart2/openapi && pub get && pub run test)
512
# test Java 11 HTTP client
613
- name: java11-test
714
image: hirokimatsumoto/alpine-openjdk-11

‎CI/samples.ci/client/petstore/typescript-fetch/builds/prefix-parameter-interfaces/pom.xml

+73
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
<project>
2+
<modelVersion>4.0.0</modelVersion>
3+
<groupId>org.openapitools</groupId>
4+
<artifactId>TypeScriptFetchBuildPrefixParameterInterfacesPestoreClientTests</artifactId>
5+
<packaging>pom</packaging>
6+
<version>1.0-SNAPSHOT</version>
7+
<name>TS Fetch Petstore Client (with namespacing for parameter interfaces)</name>
8+
<build>
9+
<plugins>
10+
<plugin>
11+
<artifactId>maven-dependency-plugin</artifactId>
12+
<executions>
13+
<execution>
14+
<phase>package</phase>
15+
<goals>
16+
<goal>copy-dependencies</goal>
17+
</goals>
18+
<configuration>
19+
<outputDirectory>${project.build.directory}</outputDirectory>
20+
</configuration>
21+
</execution>
22+
</executions>
23+
</plugin>
24+
<plugin>
25+
<groupId>org.codehaus.mojo</groupId>
26+
<artifactId>exec-maven-plugin</artifactId>
27+
<version>1.2.1</version>
28+
<executions>
29+
<execution>
30+
<id>npm-install</id>
31+
<phase>integration-test</phase>
32+
<goals>
33+
<goal>exec</goal>
34+
</goals>
35+
<configuration>
36+
<executable>npm</executable>
37+
<arguments>
38+
<argument>install</argument>
39+
</arguments>
40+
</configuration>
41+
</execution>
42+
<execution>
43+
<id>npm-build</id>
44+
<phase>integration-test</phase>
45+
<goals>
46+
<goal>exec</goal>
47+
</goals>
48+
<configuration>
49+
<executable>npm</executable>
50+
<arguments>
51+
<argument>run</argument>
52+
<argument>build</argument>
53+
</arguments>
54+
</configuration>
55+
</execution>
56+
<execution>
57+
<id>npm-test</id>
58+
<phase>integration-test</phase>
59+
<goals>
60+
<goal>exec</goal>
61+
</goals>
62+
<configuration>
63+
<executable>npm</executable>
64+
<arguments>
65+
<argument>test</argument>
66+
</arguments>
67+
</configuration>
68+
</execution>
69+
</executions>
70+
</plugin>
71+
</plugins>
72+
</build>
73+
</project>

‎README.md

+4-1
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ OpenAPI Generator allows generation of API client libraries (SDK generation), se
6666
| | Languages/Frameworks |
6767
|-|-|
6868
**API clients** | **ActionScript**, **Ada**, **Apex**, **Bash**, **C**, **C#** (.net 2.0, 3.5 or later), **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), **Kotlin**, **Lua**, **Node.js/JavaScript** (ES5, ES6, AngularJS with Google Closure Compiler annotations, Flow types), **Objective-C**, **OCaml**, **Perl**, **PHP**, **PowerShell**, **Python**, **R**, **Ruby**, **Rust** (rust, rust-server), **Scala** (akka, http4s, scalaz, swagger-async-httpclient), **Swift** (2.x, 3.x, 4.x), **Typescript** (AngularJS, Angular (2.x - 8.x), Aurelia, Axios, Fetch, Inversify, jQuery, Node, Rxjs)
69-
**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, RestEasy, Play Framework, [PKMST](https://github.com/ProKarma-Inc/pkmst-getting-started-examples)), **Kotlin** (Spring Boot, Ktor), **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** ([Finch](https://github.com/finagle/finch), [Lagom](https://github.com/lagom/lagom), [Play](https://www.playframework.com/), Scalatra)
69+
**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)), **Kotlin** (Spring Boot, Ktor), **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** ([Finch](https://github.com/finagle/finch), [Lagom](https://github.com/lagom/lagom), [Play](https://www.playframework.com/), Scalatra)
7070
**API documentation generators** | **HTML**, **Confluence Wiki**
7171
**Configuration files** | [**Apache2**](https://httpd.apache.org/)
7272
**Others** | **GraphQL**, **JMeter**, **MySQL Schema**
@@ -569,6 +569,7 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
569569
- [Klarna](https://www.klarna.com/)
570570
- [Metaswitch](https://www.metaswitch.com/)
571571
- [Myworkout](https://myworkout.com)
572+
- [Paxos](https://www.paxos.com)
572573
- [Prometheus/Alertmanager](https://github.com/prometheus/alertmanager)
573574
- [Raiffeisen Schweiz Genossenschaft](https://www.raiffeisen.ch)
574575
- [RepreZen API Studio](https://www.reprezen.com/swagger-openapi-code-generation-api-first-microservices-enterprise-development)
@@ -626,6 +627,7 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
626627
- 2019-07-08 - [OpenAPI Generator にコントリビュートしたら社名が載った話。(CAM) - CAM TECH BLOG](https://tech.cam-inc.co.jp/entry/2019/07/08/140000) by [CAM, Inc.](https://www.cam-inc.co.jp/)
627628
- 2019-07-14 - [OpenAPI GeneratorでPythonのクライアントライブラリを作成した](https://qiita.com/yuji38kwmt/items/dfb929316a1335a161c0) by [yuji38kwmt](https://qiita.com/yuji38kwmt)
628629
- 2019-07-19 - [Developer Experience (DX) for Open-Source Projects: How to Engage Developers and Build a Growing Developer Community](https://speakerdeck.com/wing328/developer-experience-dx-for-open-source-projects-english-japanese) by [William Cheng](https://twitter.com/wing328), [中野暁人](https://github.com/ackintosh) at [Open Source Summit Japan 2019](https://events.linuxfoundation.org/events/open-source-summit-japan-2019/)
630+
- 2019-08-24 - [SwaggerドキュメントからOpenAPI Generatorを使ってモックサーバー作成](https://qiita.com/masayoshi0222/items/4845e4c715d04587c104) by [坂本正義](https://qiita.com/masayoshi0222)
629631

630632
## [6 - About Us](#table-of-contents)
631633

@@ -755,6 +757,7 @@ Here is a list of template creators:
755757
* Configuration
756758
* Apache2: @stkrwork
757759
* Schema
760+
* Avro: @sgadouar
758761
* GraphQL: @wing328 [:heart:](https://www.patreon.com/wing328)
759762
* MySQL: @ybelenko
760763

‎bin/openapi3/avro-petstore.sh

+32
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
#!/bin/sh
2+
3+
SCRIPT="$0"
4+
echo "# START SCRIPT: $SCRIPT"
5+
6+
while [ -h "$SCRIPT" ] ; do
7+
ls=`ls -ld "$SCRIPT"`
8+
link=`expr "$ls" : '.*-> \(.*\)$'`
9+
if expr "$link" : '/.*' > /dev/null; then
10+
SCRIPT="$link"
11+
else
12+
SCRIPT=`dirname "$SCRIPT"`/"$link"
13+
fi
14+
done
15+
16+
if [ ! -d "${APP_DIR}" ]; then
17+
APP_DIR=`dirname "$SCRIPT"`/..
18+
APP_DIR=`cd "${APP_DIR}"; pwd`
19+
fi
20+
21+
executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
22+
23+
if [ ! -f "$executable" ]
24+
then
25+
mvn clean package
26+
fi
27+
28+
# if you've executed sbt assembly previously it will use that instead.
29+
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
30+
ags="generate -t modules/openapi-generator/src/main/resources/avro-schema -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g avro-schema -o samples/openapi3/schema/petstore/avro-schema $@"
31+
32+
java $JAVA_OPTS -jar $executable $ags

‎bin/openapi3/typescript-fetch-petstore-all.sh

+1
Original file line numberDiff line numberDiff line change
@@ -4,3 +4,4 @@
44
./bin/openapi3/typescript-fetch-petstore-with-npm-version.sh
55
./bin/openapi3/typescript-fetch-petstore-interfaces.sh
66
./bin/openapi3/typescript-fetch-petstore.sh
7+
./bin/openapi3/typescript-fetch-petstore-prefix-parameter-interfaces.sh

‎bin/openapi3/typescript-fetch-petstore-prefix-parameter-interfaces.sh

+32
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
#!/bin/sh
2+
3+
SCRIPT="$0"
4+
echo "# START SCRIPT: $SCRIPT"
5+
6+
while [ -h "$SCRIPT" ] ; do
7+
ls=`ls -ld "$SCRIPT"`
8+
link=`expr "$ls" : '.*-> \(.*\)$'`
9+
if expr "$link" : '/.*' > /dev/null; then
10+
SCRIPT="$link"
11+
else
12+
SCRIPT=`dirname "$SCRIPT"`/"$link"
13+
fi
14+
done
15+
16+
if [ ! -d "${APP_DIR}" ]; then
17+
APP_DIR=`dirname "$SCRIPT"`/..
18+
APP_DIR=`cd "${APP_DIR}"; pwd`
19+
fi
20+
21+
executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
22+
23+
if [ ! -f "$executable" ]
24+
then
25+
mvn clean package
26+
fi
27+
28+
# if you've executed sbt assembly previously it will use that instead.
29+
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
30+
ags="generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g typescript-fetch -o samples/client/petstore/typescript-fetch/builds/prefix-parameter-interfaces --additional-properties prefixParameterInterfaces=true $@"
31+
32+
java $JAVA_OPTS -jar $executable $ags

‎bin/typescript-fetch-petstore-all.sh

+2-1
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,5 @@
44
./bin/typescript-fetch-petstore-with-npm-version.sh
55
./bin/typescript-fetch-petstore-interfaces.sh
66
./bin/typescript-fetch-petstore.sh
7-
./bin/typescript-fetch-petstore-multiple-parameters.sh
7+
./bin/typescript-fetch-petstore-multiple-parameters.sh
8+
./bin/typescript-fetch-petstore-prefix-parameter-interfaces.sh

‎bin/typescript-fetch-petstore-prefix-parameter-interfaces.json

+7
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"npmName": "@openapitools/typescript-fetch-petstore",
3+
"npmVersion": "1.0.0",
4+
"npmRepository" : "https://skimdb.npmjs.com/registry",
5+
"snapshot" : false,
6+
"prefixParameterInterfaces": true
7+
}

‎bin/typescript-fetch-petstore-prefix-parameter-interfaces.sh

+34
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
#!/bin/sh
2+
3+
SCRIPT="$0"
4+
echo "# START SCRIPT: $SCRIPT"
5+
6+
while [ -h "$SCRIPT" ] ; do
7+
ls=`ls -ld "$SCRIPT"`
8+
link=`expr "$ls" : '.*-> \(.*\)$'`
9+
if expr "$link" : '/.*' > /dev/null; then
10+
SCRIPT="$link"
11+
else
12+
SCRIPT=`dirname "$SCRIPT"`/"$link"
13+
fi
14+
done
15+
16+
if [ ! -d "${APP_DIR}" ]; then
17+
APP_DIR=`dirname "$SCRIPT"`/..
18+
APP_DIR=`cd "${APP_DIR}"; pwd`
19+
fi
20+
21+
executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
22+
23+
if [ ! -f "$executable" ]
24+
then
25+
mvn -B clean package
26+
fi
27+
28+
# if you've executed sbt assembly previously it will use that instead.
29+
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
30+
ags="generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g typescript-fetch -c bin/typescript-fetch-petstore-prefix-parameter-interfaces.json -o samples/client/petstore/typescript-fetch/builds/prefix-parameter-interfaces $@"
31+
32+
java $JAVA_OPTS -jar $executable $ags
33+
34+
cp CI/samples.ci/client/petstore/typescript-fetch/builds/prefix-parameter-interfaces/pom.xml samples/client/petstore/typescript-fetch/builds/prefix-parameter-interfaces/pom.xml

‎bin/utils/ensure-up-to-date

+3
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,9 @@ declare -a scripts=(
5959
"./bin/apex-petstore.sh"
6060
"./bin/perl-petstore-all.sh"
6161
"./bin/dart-jaguar-petstore.sh"
62+
"./bin/dart-flutter-petstore.sh"
63+
"./bin/dart-petstore.sh"
64+
"./bin/dart2-petstore.sh"
6265
#"./bin/elm-petstore-all.sh"
6366
"./bin/meta-codegen.sh"
6467
# OTHERS

‎bin/windows/typescript-fetch-petstore-all.bat

+1
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,4 @@ call bin\windows\typescript-fetch-petstore-target-es6.bat
55
call bin\windows\typescript-fetch-petstore-with-npm-version.bat
66
call bin\windows\typescript-fetch-petstore-interfaces.bat
77
call bin\windows\typescript-fetch-petstore-multiple-parameters.bat
8+
call bin\windows\typescript-fetch-petstore-prefix-parameter-interfaces.bat

‎bin/windows/typescript-fetch-petstore-prefix-parameter-interfaces.bat

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
@ECHO OFF
2+
3+
set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
4+
5+
If Not Exist %executable% (
6+
mvn clean package
7+
)
8+
9+
REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M
10+
set ags=generate -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g typescript-fetch -o samples\client\petstore\typescript-fetch\builds\prefix-parameter-interfaces --additional-properties prefixParameterInterfaces=true
11+
12+
java %JAVA_OPTS% -jar %executable% %ags%

‎docs/generators.md

+1
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,7 @@ The following generators are available:
125125

126126

127127
## SCHEMA generators
128+
* [avro-schema (beta)](generators/avro-schema)
128129
* [mysql-schema](generators/mysql-schema)
129130

130131

‎docs/generators/avro-schema.md

+14
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
2+
---
3+
id: generator-opts-schema-avro-schema
4+
title: Config Options for avro-schema
5+
sidebar_label: avro-schema
6+
---
7+
8+
| Option | Description | Values | Default |
9+
| ------ | ----------- | ------ | ------- |
10+
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
11+
|ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true|
12+
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
13+
|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|
14+
|packageName|package for generated classes (where supported)| |null|

‎docs/generators/csharp-netcore.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ sidebar_label: csharp-netcore
1212
|sourceFolder|source folder for generated code| |src|
1313
|packageGuid|The GUID that will be associated with the C# project| |null|
1414
|interfacePrefix|Prefix interfaces with a community standard or widely accepted prefix.| |I|
15-
|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>**netcoreapp2.0**</dt><dd>.NET Core 2.0 compatible</dd><dl>|v4.6.1|
15+
|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>**netcoreapp2.0**</dt><dd>.NET Core 2.0 compatible</dd><dl>|netstandard2.0|
1616
|modelPropertyNaming|Naming convention for the property: 'camelCase', 'PascalCase', 'snake_case' and 'original', which keeps the original name| |PascalCase|
1717
|hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|
1818
|sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true|
@@ -26,3 +26,4 @@ sidebar_label: csharp-netcore
2626
|allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false|
2727
|netCoreProjectFile|Use the new format (.NET Core) for .NET project files (.csproj).| |false|
2828
|validatable|Generates self-validatable models.| |true|
29+
|caseInsensitiveResponseHeaders|Make API response's headers case-insensitive| |false|

‎docs/generators/go-experimental.md

+1
Original file line numberDiff line numberDiff line change
@@ -13,4 +13,5 @@ sidebar_label: go-experimental
1313
|isGoSubmodule|whether the generated Go module is a submodule| |false|
1414
|withGoCodegenComment|whether to include Go codegen comment to disable Go Lint and collapse by default GitHub in PRs and diffs| |false|
1515
|withXml|whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)| |false|
16+
|enumClassPrefix|Prefix enum with class name| |false|
1617
|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|

‎docs/generators/go.md

+1
Original file line numberDiff line numberDiff line change
@@ -13,4 +13,5 @@ sidebar_label: go
1313
|isGoSubmodule|whether the generated Go module is a submodule| |false|
1414
|withGoCodegenComment|whether to include Go codegen comment to disable Go Lint and collapse by default GitHub in PRs and diffs| |false|
1515
|withXml|whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML)| |false|
16+
|enumClassPrefix|Prefix enum with class name| |false|
1617
|prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false|

‎docs/generators/typescript-fetch.md

+1
Original file line numberDiff line numberDiff line change
@@ -19,3 +19,4 @@ sidebar_label: typescript-fetch
1919
|npmRepository|Use this property to set an url your private npmRepo in the package.json| |null|
2020
|withInterfaces|Setting this property to true will generate interfaces next to the default class implementations.| |false|
2121
|useSingleRequestParameter|Setting this property to true will generate functions with a single argument containing all API endpoint parameters instead of one argument per parameter.| |true|
22+
|prefixParameterInterfaces|Setting this property to true will generate parameter interface declarations prefixed with API class name to avoid name conflicts.| |false|

‎docs/migration-from-swagger-codegen.md

+6-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ id: swagger-codegen-migration
33
title: Migrating from Swagger Codegen
44
---
55

6-
OpenAPI Generator is a fork of `swagger-codegen` between version `2.3.1` and `2.4.0`.
6+
OpenAPI Generator is a fork of `swagger-codegen` between version `2.3.1` and `2.4.0`. For the reasons behind the fork, please refer to the [Q&A](https://github.com/OpenAPITools/openapi-generator/blob/master/docs/qna.md).
77
This community-driven version called "OpenAPI Generator" provides similar functionalities and can be used as drop-in replacement.
88
This guide explains the major differences in order to help you with the migration.
99

@@ -22,6 +22,7 @@ This guide explains the major differences in order to help you with the migratio
2222
- [New fully qualified name for the classes](#new-fully-qualified-name-for-the-classes)
2323
- [Body parameter name](#body-parameter-name)
2424
- [Default basePath](#default-basepath)
25+
- [Nullable](#nullable)
2526

2627
## New docker images
2728

@@ -250,3 +251,7 @@ If your API client is using named parameters in the function call (e.g. Perl req
250251
## Default basePath
251252

252253
The default `basePath` has been changed from `https://localhost` to `http://localhost` (http without s)
254+
255+
## Nullable
256+
257+
OpenAPI spec v3 has better support for `nullable`. If you're still using OpenAPI/Swagger spec v2, please use `x-nullable: true` instead.

0 commit comments

Comments
 (0)