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.9 ): [ ![ 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.11-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/s/https/jenkins.swagger.io/view/OSS%20-%20Java/job/oss-swagger-codegen-master.svg )] ( 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
- - 3.0.13 : [ ![ 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 )
12
+ - 3.0.15-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
13
[ ![ Java Test] ( https://img.shields.io/jenkins/s/https/jenkins.swagger.io/view/OSS%20-%20Java/job/oss-swagger-codegen-3.svg )] ( https://jenkins.swagger.io/view/OSS%20-%20Java/job/oss-swagger-codegen-3 )
14
14
[ ![ 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 )
15
15
@@ -51,7 +51,7 @@ dependency example:
51
51
<dependency>
52
52
<groupId>io.swagger</groupId>
53
53
<artifactId>swagger-codegen-maven-plugin</artifactId>
54
- <version>2.4.9 </version>
54
+ <version>2.4.10 </version>
55
55
</dependency>
56
56
```
57
57
@@ -69,7 +69,7 @@ dependency example:
69
69
<dependency>
70
70
<groupId>io.swagger.codegen.v3</groupId>
71
71
<artifactId>swagger-codegen-maven-plugin</artifactId>
72
- <version>3.0.13 </version>
72
+ <version>3.0.14 </version>
73
73
</dependency>
74
74
```
75
75
@@ -78,7 +78,7 @@ dependency example:
78
78
## Overview
79
79
This is the Swagger Codegen project, which allows generation of API client libraries (SDK generation), server stubs and documentation automatically given an [ OpenAPI Spec] ( https://github.com/OAI/OpenAPI-Specification ) . Currently, the following languages/frameworks are supported:
80
80
81
- - ** API clients** : ** ActionScript** , ** Ada** , ** Apex** , ** Bash** , ** C#** (.net 2.0, 3.5 or later), ** C++** (cpprest, 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), ** Kotlin** , ** Lua** , ** Node.js** (ES5, ES6, AngularJS with Google Closure Compiler annotations) ** Objective-C** , ** Perl** , ** PHP** , ** PowerShell** , ** Python** , ** R** , ** Ruby** , ** Rust** (rust, rust-server), ** Scala** (akka, http4s, swagger-async-httpclient), ** Swift** (2.x, 3.x, 4.x), ** Typescript** (Angular1.x, Angular2.x, Fetch, jQuery, Node)
81
+ - ** API clients** : ** ActionScript** , ** Ada** , ** Apex** , ** Bash** , ** C#** (.net 2.0, 3.5 or later), ** C++** (cpprest, 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), ** Kotlin** , ** Lua** , ** Node.js** (ES5, ES6, AngularJS with Google Closure Compiler annotations) ** Objective-C** , ** Perl** , ** PHP** , ** PowerShell** , ** Python** , ** R** , ** Ruby** , ** Rust** (rust, rust-server), ** Scala** (akka, http4s, swagger-async-httpclient), ** Swift** (2.x, 3.x, 4.x, 5.x ), ** Typescript** (Angular1.x, Angular2.x, Fetch, jQuery, Node)
82
82
- ** Server stubs** : ** Ada** , ** C#** (ASP.NET Core, NancyFx), ** C++** (Pistache, Restbed), ** Erlang** , ** Go** , ** 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** , ** PHP** (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 ) , Scalatra)
83
83
- ** API documentation generators** : ** HTML** , ** Confluence Wiki**
84
84
- ** Configuration files** : [ ** Apache2** ] ( https://httpd.apache.org/ )
@@ -133,8 +133,9 @@ The OpenAPI Specification has undergone 3 revisions since initial creation in 20
133
133
134
134
Swagger Codegen Version | Release Date | OpenAPI Spec compatibility | Notes
135
135
-------------------------- | ------------ | -------------------------- | -----
136
- 3.0.14-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.14-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0, 3.0 | Minor release
137
- [ 3.0.13] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.13 ) (** current stable** ) | 2019-16-14 | 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 )
136
+ 3.0.15-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.15-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0, 3.0 | Minor release
137
+ [ 3.0.14] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.14 ) (** current stable** ) | 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 )
138
+ [ 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 )
138
139
[ 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 )
139
140
[ 3.0.11] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.11 ) | 2019-08-24 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.11] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.11 )
140
141
[ 3.0.10] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v3.0.10 ) | 2019-07-11 | 1.0, 1.1, 1.2, 2.0, 3.0 | [ tag v3.0.10] ( https://github.com/swagger-api/swagger-codegen/tree/v3.0.10 )
@@ -147,8 +148,9 @@ Swagger Codegen Version | Release Date | OpenAPI Spec compatibility | Notes
147
148
[ 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
148
149
[ 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
149
150
[ 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
150
- 2.4.10-SNAPSHOT (current master, upcoming minor release) [ SNAPSHOT] ( https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/2.4.10-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0 | Minor release
151
- [ 2.4.9] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.9 ) (** current stable** ) | 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 )
151
+ 2.4.11-SNAPSHOT (current master, upcoming minor release) [ SNAPSHOT] ( https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/2.4.11-SNAPSHOT/ ) | TBD | 1.0, 1.1, 1.2, 2.0 | Minor release
152
+ [ 2.4.10] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.10 ) (** current stable** ) | 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 )
153
+ [ 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 )
152
154
[ 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 )
153
155
[ 2.4.7] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.7 ) | 2019-07-11 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.7] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.7 )
154
156
[ 2.4.6] ( https://github.com/swagger-api/swagger-codegen/releases/tag/v2.4.6 ) | 2019-06-28 | 1.0, 1.1, 1.2, 2.0 | [ tag v2.4.6] ( https://github.com/swagger-api/swagger-codegen/tree/v2.4.6 )
@@ -169,15 +171,15 @@ Swagger Codegen Version | Release Date | OpenAPI Spec compatibility | Notes
169
171
170
172
171
173
### Prerequisites
172
- If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 7 runtime at a minimum):
174
+ If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 8 runtime at a minimum):
173
175
174
176
``` sh
175
- wget http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.9 /swagger-codegen-cli-2.4.9 .jar -O swagger-codegen-cli.jar
177
+ wget http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.10 /swagger-codegen-cli-2.4.10 .jar -O swagger-codegen-cli.jar
176
178
177
179
java -jar swagger-codegen-cli.jar help
178
180
```
179
181
180
- 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 http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.9 /swagger-codegen-cli-2.4.9 .jar `
182
+ 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 http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.10 /swagger-codegen-cli-2.4.10 .jar `
181
183
182
184
On a mac, it's even easier with ` brew ` :
183
185
``` sh
@@ -186,12 +188,12 @@ brew install swagger-codegen
186
188
187
189
To build from source, you need the following installed and available in your ` $PATH: `
188
190
189
- * [ Java 7 or 8 ] ( http://java.oracle.com )
191
+ * [ Java 8+ ] ( http://java.oracle.com )
190
192
191
193
* [ Apache maven 3.3.3 or greater] ( http://maven.apache.org/ )
192
194
193
195
#### OS X Users
194
- Don't forget to install Java 7 or 8. You probably have 1.6.
196
+ Don't forget to install Java 8+.
195
197
196
198
Export ` JAVA_HOME ` in order to use the supported Java version:
197
199
``` sh
@@ -322,7 +324,7 @@ java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate \
322
324
```
323
325
(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 ` )
324
326
325
- You can also download the JAR (latest release) directly from [ maven.org] ( http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.9 /swagger-codegen-cli-2.4.9 .jar )
327
+ You can also download the JAR (latest release) directly from [ maven.org] ( http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.10 /swagger-codegen-cli-2.4.10 .jar )
326
328
327
329
To get a list of ** general** options available, please run ` java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar help generate `
328
330
0 commit comments