6
6
7
7
[ ![ Build Status] ( https://jenkins.swagger.io/view/OSS%20-%20Java/job/oss-swagger-codegen-master-java7/badge/icon?subject=jenkins%20build%20-%20java%207 )] ( https://jenkins.swagger.io/view/OSS%20-%20Java/job/oss-swagger-codegen-master-java7/ )
8
8
9
- - Master (2.4.13 -SNAPSHOT): [ ![ Build Status] ( https://img.shields.io/travis/swagger-api/swagger-codegen/master.svg?label=Petstore%20Integration%20Test )] ( https://travis-ci.org/swagger-api/swagger-codegen )
9
+ - Master (2.4.15 -SNAPSHOT): [ ![ Build Status] ( https://img.shields.io/travis/swagger-api/swagger-codegen/master.svg?label=Petstore%20Integration%20Test )] ( https://travis-ci.org/swagger-api/swagger-codegen )
10
10
[ ![ Java Test] ( https://img.shields.io/jenkins/build.svg?jobUrl=https://jenkins.swagger.io/job/oss-swagger-codegen-master )] ( https://jenkins.swagger.io/view/OSS%20-%20Java/job/oss-swagger-codegen-master )
11
11
[ ![ Windows Test] ( https://ci.appveyor.com/api/projects/status/github/swagger-api/swagger-codegen?branch=master&svg=true&passingText=Windows%20Test%20-%20OK&failingText=Windows%20Test%20-%20Fails )] ( https://ci.appveyor.com/project/swaggerhub-bot/swagger-codegen )
12
12
13
- - 3.0.19 -SNAPSHOT: [ ![ Build Status] ( https://img.shields.io/travis/swagger-api/swagger-codegen/3.0.0.svg?label=Petstore%20Integration%20Test )] ( https://travis-ci.org/swagger-api/swagger-codegen )
13
+ - 3.0.21 -SNAPSHOT: [ ![ Build Status] ( https://img.shields.io/travis/swagger-api/swagger-codegen/3.0.0.svg?label=Petstore%20Integration%20Test )] ( https://travis-ci.org/swagger-api/swagger-codegen )
14
14
[ ![ Java Test] ( https://img.shields.io/jenkins/build.svg?jobUrl=https://jenkins.swagger.io/job/oss-swagger-codegen-3 )] ( https://jenkins.swagger.io/view/OSS%20-%20Java/job/oss-swagger-codegen-3 )
15
15
[ ![ Windows Test] ( https://ci.appveyor.com/api/projects/status/github/swagger-api/swagger-codegen?branch=3.0.0&svg=true&passingText=Windows%20Test%20-%20OK&failingText=Windows%20Test%20-%20Fails )] ( https://ci.appveyor.com/project/swaggerhub-bot/swagger-codegen )
16
16
@@ -52,7 +52,7 @@ dependency example:
52
52
<dependency>
53
53
<groupId>io.swagger</groupId>
54
54
<artifactId>swagger-codegen-maven-plugin</artifactId>
55
- <version>2.4.12 </version>
55
+ <version>2.4.14 </version>
56
56
</dependency>
57
57
```
58
58
@@ -70,7 +70,7 @@ dependency example:
70
70
<dependency>
71
71
<groupId>io.swagger.codegen.v3</groupId>
72
72
<artifactId>swagger-codegen-maven-plugin</artifactId>
73
- <version>3.0.18 </version>
73
+ <version>3.0.20 </version>
74
74
</dependency>
75
75
```
76
76
@@ -134,11 +134,13 @@ The OpenAPI Specification has undergone 3 revisions since initial creation in 20
134
134
135
135
Swagger Codegen Version | Release Date | OpenAPI Spec compatibility | Notes
136
136
-------------------------- | ------------ | -------------------------- | -----
137
- 3.0.19-SNAPSHOT (current 3.0.0, upcoming minor release) [ SNAPSHOT] ( https://oss.sonatype.org/content/repositories/snapshots/io/swagger/codegen/v3/swagger-codegen-cli/3.0.19-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0, 3.0 | Minor release
138
- [ 3.0.18] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.18 ) (** current stable** ) | 2020-02-26 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.18] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.18 )
139
- [ 3.0.17] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.17 ) (** current stable** ) | 2020-02-23 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.17] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.17 )
140
- [ 3.0.17] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.16 ) (** current stable** ) | 2020-01-15 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.16] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.16 )
141
- [ 3.0.15] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.15 ) (** current stable** ) | 2020-01-03 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.15] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.15 )
137
+ 3.0.21-SNAPSHOT (current 3.0.0, upcoming minor release) [ SNAPSHOT] ( https://oss.sonatype.org/content/repositories/snapshots/io/swagger/codegen/v3/swagger-codegen-cli/3.0.21-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0, 3.0 | Minor release
138
+ [ 3.0.20] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.20 ) (** current stable** ) | 2020-05-18 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.20] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.20 )
139
+ [ 3.0.19] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.19 ) | 2020-04-02 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.19] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.19 )
140
+ [ 3.0.18] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.18 ) | 2020-02-26 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.18] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.18 )
141
+ [ 3.0.17] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.17 ) | 2020-02-23 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.17] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.17 )
142
+ [ 3.0.17] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.16 ) | 2020-01-15 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.16] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.16 )
143
+ [ 3.0.15] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.15 ) | 2020-01-03 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.15] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.15 )
142
144
[ 3.0.14] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.14 ) | 2019-11-16 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.14] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.14 )
143
145
[ 3.0.13] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.13 ) | 2019-10-16 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.13] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.13 )
144
146
[ 3.0.12] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.12 ) | 2019-10-14 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.12] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.12 )
@@ -153,9 +155,11 @@ Swagger Codegen Version | Release Date | OpenAPI Spec compatibility | Notes
153
155
[ 3.0.2] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.2 ) | 2018-10-19 | 1.0, 1.1, 1.2, 2.0, 3.0 | Minor release
154
156
[ 3.0.1] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.1 ) | 2018-10-05 | 1.0, 1.1, 1.2, 2.0, 3.0 | Major release with breaking changes
155
157
[ 3.0.0] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.0 ) | 2018-09-06 | 1.0, 1.1, 1.2, 2.0, 3.0 | Major release with breaking changes
156
- 2.4.13-SNAPSHOT (current master, upcoming minor release) [ SNAPSHOT] ( https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/2.4.13-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0 | Minor release
157
- [ 2.4.12] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.12 ) (** current stable** ) | 2020-01-15 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.12] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.12 )
158
- [ 2.4.11] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.11 ) (** current stable** ) | 2020-01-03 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.11] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.11 )
158
+ 2.4.15-SNAPSHOT (current master, upcoming minor release) [ SNAPSHOT] ( https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/2.4.15-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0 | Minor release
159
+ [ 2.4.14] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.14 ) (** current stable** ) | 2020-05-18 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.14] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.14 )
160
+ [ 2.4.13] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.13 ) | 2020-04-02 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.13] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.13 )
161
+ [ 2.4.12] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.12 ) | 2020-01-15 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.12] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.12 )
162
+ [ 2.4.11] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.11 ) | 2020-01-03 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.11] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.11 )
159
163
[ 2.4.10] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.10 ) | 2019-11-16 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.10] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.10 )
160
164
[ 2.4.9] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.9 ) | 2019-10-14 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.9] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.9 )
161
165
[ 2.4.8] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.8 ) | 2019-08-24 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.8] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.8 )
@@ -175,22 +179,20 @@ Swagger Codegen Version | Release Date | OpenAPI Spec compatibility | Notes
175
179
2.0.17 | 2014-08-22 | 1.1, 1.2 | [ tag v2.0.17] ( https://github.com/swagger-api/swagger-codegen/tree/2.0.17 )
176
180
1.0.4 | 2012-04-12 | 1.0, 1.1 | [ tag v1.0.4] ( https://github.com/swagger-api/swagger-codegen/tree/swagger-codegen_2.9.1-1.1 )
177
181
178
-
179
-
180
182
### Prerequisites
181
183
If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):
182
184
183
185
``` sh
184
186
# Download current stable 2.x.x branch (Swagger and OpenAPI version 2)
185
- wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.12 /swagger-codegen-cli-2.4.12 .jar -O swagger-codegen-cli.jar
187
+ wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.14 /swagger-codegen-cli-2.4.14 .jar -O swagger-codegen-cli.jar
186
188
187
189
# Download current stable 3.x.x branch (OpenAPI version 3)
188
- wget https://repo1.maven.org/maven2/io/swagger/codegen/v3/swagger-codegen-cli/3.0.18 /swagger-codegen-cli-3.0.18 .jar -O swagger-codegen-cli.jar
190
+ wget https://repo1.maven.org/maven2/io/swagger/codegen/v3/swagger-codegen-cli/3.0.20 /swagger-codegen-cli-3.0.20 .jar -O swagger-codegen-cli.jar
189
191
190
192
java -jar swagger-codegen-cli.jar help
191
193
```
192
194
193
- 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 swagger-codegen-cli.jar https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.12 /swagger-codegen-cli-2.4.12 .jar `
195
+ 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 swagger-codegen-cli.jar https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.14 /swagger-codegen-cli-2.4.14 .jar `
194
196
195
197
On a mac, it's even easier with ` brew ` :
196
198
``` sh
@@ -204,7 +206,7 @@ To build from source, you need the following installed and available in your `$P
204
206
* [ Apache maven 3.3.3 or greater] ( http://maven.apache.org/ )
205
207
206
208
#### OS X Users
207
- Don't forget to install Java 8+.
209
+ Don't forget to install Java 8+.
208
210
209
211
Export ` JAVA_HOME ` in order to use the supported Java version:
210
212
``` sh
@@ -259,6 +261,9 @@ Once built, `run-in-docker.sh` will act as an executable for swagger-codegen-cli
259
261
./run-in-docker.sh generate -i modules/swagger-codegen/src/test/resources/2_0/petstore.yaml \
260
262
-l go -o /gen/out/go-petstore -DpackageName=petstore # generates go client, outputs locally to ./out/go-petstore
261
263
```
264
+ #### Standalone generator Development in docker
265
+
266
+ See [ standalone generator development] ( https://github.com/swagger-api/swagger-codegen/blob/master/standalone-gen-dev/standalone-generator-development.md )
262
267
263
268
#### Run Docker in Vagrant
264
269
Prerequisite: install [ Vagrant] ( https://www.vagrantup.com/downloads.html ) and [ VirtualBox] ( https://www.virtualbox.org/wiki/Downloads ) .
@@ -335,7 +340,7 @@ java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate \
335
340
```
336
341
(if you're on Windows, replace the last command with ` java -jar modules\swagger-codegen-cli\target\swagger-codegen-cli.jar generate -i http://petstore.swagger.io/v2/swagger.json -l php -o c:\temp\php_api_client ` )
337
342
338
- You can also download the JAR (latest release) directly from [ maven.org] ( https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.12 /swagger-codegen-cli-2.4.12 .jar )
343
+ You can also download the JAR (latest release) directly from [ maven.org] ( https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.14 /swagger-codegen-cli-2.4.14 .jar )
339
344
340
345
To get a list of ** general** options available, please run ` java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar help generate `
341
346
@@ -458,6 +463,8 @@ java -cp output/myLibrary/target/myClientCodegen-swagger-codegen-1.0.0.jar:modul
458
463
-o myClient
459
464
```
460
465
466
+ See also [ standalone generator development] ( https://github.com/swagger-api/swagger-codegen/blob/master/standalone-gen-dev/standalone-generator-development.md )
467
+
461
468
### Where is Javascript???
462
469
See our [ javascript library] ( http://github.com/swagger-api/swagger-js ) --it's completely dynamic and doesn't require
463
470
static code generation.
@@ -917,9 +924,11 @@ Here are some companies/projects using Swagger Codegen in production. To add you
917
924
- [ MailMojo] ( https://mailmojo.no/ )
918
925
- [ Metaswitch] ( https://www.metaswitch.com/ )
919
926
- [ Mindera] ( http://mindera.com/ )
927
+ - [ ModuleQ] ( https://moduleq.com )
920
928
- [ Mporium] ( http://mporium.com/ )
921
929
- [ Neverfail] ( https://neverfail.com/ )
922
930
- [ NexCap] ( http://www.nexess-solutions.com/fr/plateforme-iot/ )
931
+ - [ Norwegian Air Shuttle] ( https://www.norwegian.com/ )
923
932
- [ NTT DATA] ( http://www.nttdata.com/ )
924
933
- [ nViso] ( http://www.nviso.ch/ )
925
934
- [ Okiok] ( https://www.okiok.com )
@@ -1169,7 +1178,7 @@ Who is eligible? Those who want to join must have at least 3 PRs merged into a g
1169
1178
| Android | |
1170
1179
| Apex | |
1171
1180
| Bash | @kenjones-cisco (2017/09) |
1172
- | C++ | @ fvarose (2017/11) |
1181
+ | C++ | |
1173
1182
| C# | @mandrean (2017/08) |
1174
1183
| Clojure | |
1175
1184
| Dart | @ircecho (2017/07) |
0 commit comments