Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
175 commits
Select commit Hold shift + click to select a range
0e1460f
show travis master status
wing328 Feb 11, 2017
1d52c62
Added Fotition as a company using swagger-codegen (#4773)
Feb 11, 2017
a956966
Update gitignore (#4767)
BastiOfBerlin Feb 13, 2017
74da89c
Fix issue when the swagger model contains an 'Object' class (#4695)
Feb 13, 2017
8f2e9bc
remove trailing whitespaces in java api client (#4784)
wing328 Feb 13, 2017
9cf147f
[Java] Change Boolean fields of CodegenParameter and CodegenResponse …
sreeshas Feb 13, 2017
7df1f8e
Update DefaultGenerator.java (#4760)
soulfly Feb 13, 2017
56251bf
added QuickBlox to 'Companies/Projects using Swagger Codegen' section…
soulfly Feb 13, 2017
ee23f8e
Fix finch package name. (#4755)
clasnake Feb 13, 2017
2447412
Issue 4742 (#4763)
abaruni Feb 14, 2017
26b1aa2
update ts fetch petstore samples
wing328 Feb 15, 2017
a4e96b3
Merge branch 'update_ts_fetch_sample'
wing328 Feb 15, 2017
accd176
Ensure that `ApiInvoker.scala` can support `UUID` types (#4807)
paul-english Feb 16, 2017
bb81fc1
remove unused files for nodejs gcf (#4808)
wing328 Feb 16, 2017
23d114e
Fix minor spelling mistake in readme (#4818)
tristansokol Feb 20, 2017
6746632
Fix for #1940 - Show response headers (#4825)
sonallux Feb 20, 2017
d11d0f8
fix warning in swagger json/yaml generator (#4827)
wing328 Feb 20, 2017
4715983
Added include to qt5cpp to fix library compile
fortiumant Feb 22, 2017
de727d7
[JaxrsResteasy] Improvements for Resteasy for Jboss EAP 4512 (#4712)
jfiala Feb 28, 2017
77c5b90
add creator of JAX-RS RestEasy (JBoss EAP)
wing328 Mar 1, 2017
35be2bc
updated parser version
fehguy Mar 1, 2017
894f272
updated core versions
fehguy Mar 1, 2017
b8caead
Merge pull request #4880 from swagger-api/update-parser
fehguy Mar 1, 2017
3b65515
Merge branch 'master' into swagger-lib-versions
fehguy Mar 1, 2017
041da89
rebuilt
fehguy Mar 1, 2017
af27493
rebuilt
fehguy Mar 1, 2017
2cec619
rebuilt
fehguy Mar 1, 2017
c9c9d9a
rebuilt
fehguy Mar 1, 2017
9aeedca
rebuilt
fehguy Mar 1, 2017
89168d5
rebuilt
fehguy Mar 1, 2017
40da476
rebuilt
fehguy Mar 1, 2017
4499a3c
rebuilt
fehguy Mar 1, 2017
655ba95
rebuilt
fehguy Mar 1, 2017
d9fb6f8
trigger a build
fehguy Mar 1, 2017
f15267c
add missing dependency to jaxrs pom
wing328 Mar 1, 2017
9e40700
update jackson dependency and fix closing xml tag in jaxrs pom
wing328 Mar 1, 2017
a27a76a
fixed missing dep
fehguy Mar 1, 2017
60f0dcb
Merge branch 'swagger-lib-versions' of github.com:swagger-api/swagger…
fehguy Mar 1, 2017
01f5c1b
Merge pull request #4881 from swagger-api/swagger-lib-versions
fehguy Mar 1, 2017
b941fcf
remove timestamp
fehguy Mar 1, 2017
b43b377
rebuilt
fehguy Mar 1, 2017
021e6cd
Merge pull request #4888 from swagger-api/remove-inflector-timestamp
fehguy Mar 1, 2017
8504c12
update to release versions
fehguy Mar 1, 2017
ff209ad
Merge pull request #4889 from swagger-api/release-prepare
fehguy Mar 1, 2017
1029b69
update url to 2.2.2 release
wing328 Mar 2, 2017
26257da
fixed ApiException's methods return types (#4845)
baartosz Mar 2, 2017
775f108
update version to 2.2.3-SNAPSHOT (#4894)
wing328 Mar 2, 2017
167b2f5
add 2.2.3 to the table
wing328 Mar 2, 2017
1b1767e
[Bash] Bugfix default curl options fix (#4832)
bkryza Mar 2, 2017
55b64fc
Remove maven-api dependencies on swagger-codegen module (#4840)
otrosien Mar 2, 2017
195ff25
fixes progress for file upload with alamofire / swift3
Daxten Mar 2, 2017
0dab200
Update spring samples with current code. (#4874)
ePaul Mar 3, 2017
88c9b60
Fix for #1219 (#4875)
ePaul Mar 3, 2017
6c63558
better python flask readme (#4844)
wing328 Mar 3, 2017
b894dc3
Encode form paramerers properly\n (#4836)
hamedrnik Mar 3, 2017
835c7c0
[PHP][Silex] use original path name for path variable naming (#4817)
wing328 Mar 3, 2017
fa803d5
Adjust Date ISO Dateformat for Query Parameters: ISSUE 4745 (#4812)
gigo1980 Mar 3, 2017
dbe99c3
fix path variable in ts angular2 (#4756)
wing328 Mar 3, 2017
39a42d0
Feature/issue 4698 rxjava2 support (#4743)
ber4444 Mar 3, 2017
e23a24c
replaced SWG by classPrefix and ran tests (#4871)
patulacci Mar 3, 2017
9516c81
[JavaScript] Added *WithHttpInfo methods in 'usePromises' mode to pro…
frol Mar 3, 2017
30c2b6f
Improved ExampleGenerator (#4797)
Mar 3, 2017
82090c2
add product hunt page
wing328 Mar 3, 2017
061f4d0
fix issue with pom dep in jaxrs jersey1 (#4904)
wing328 Mar 3, 2017
66a510c
Make the CodegenConfigurator serializable (#4890)
JLLeitschuh Mar 3, 2017
165076a
add jackson dependencies to pom #4924
jfiala Mar 5, 2017
a91cbbe
Update samples after 2.2.2 (#4901)
ePaul Mar 5, 2017
35d3fb8
[Ruby] Can only use content-type application/json with ruby-client #4…
Mar 5, 2017
7b559b4
Update samples for MSF4J after 2.2.2. (#4915)
ePaul Mar 5, 2017
7800641
Fixes #4913 (#4914)
sonallux Mar 5, 2017
f72340f
change jackson jaxrs version to 2.8.4 #4924
jfiala Mar 5, 2017
b9d9629
Merge pull request #4925 from jfiala/cxf_swagger-core_4924
fehguy Mar 5, 2017
6c9b0ce
Update samples for Scalatra after 2.2.2. (#4910)
ePaul Mar 6, 2017
899ef8f
[JAXRS-CXF] [bug #4422] use java.util.Date when selecting dateLibrary…
MatanRubin Mar 6, 2017
e477ac9
Fix #4898 for spring-cloud. (#4919)
ePaul Mar 6, 2017
5d327e6
Port the optional/enum template logic from async-scala to the regular…
paul-english Mar 6, 2017
10950db
[JavaScript] Do not parse null and undefined as type. (#4933)
wangzw Mar 6, 2017
7782c32
Merge branch 'fixqt5cppstaticlib' of https://github.com/fortiumant/sw…
wing328 Mar 6, 2017
643aa5a
Merge branch 'fortiumant-fixqt5cppstaticlib'
wing328 Mar 6, 2017
4b7a50c
Add hashdata to user list (#4935)
wangzw Mar 6, 2017
f7b5eb8
[Swift] add batch files for swift 2,3 to generate petstore samples (#…
wing328 Mar 6, 2017
0838c1a
Merge branch 'topic/swagger_fix' of https://github.com/Daxten/swagger…
wing328 Mar 6, 2017
2dee838
update petstore sample for swift3
wing328 Mar 6, 2017
273079b
Merge branch 'Daxten-topic/swagger_fix'
wing328 Mar 6, 2017
f12554f
Merge branch 'master' of https://github.com/swagger-api/swagger-codegen
wing328 Mar 6, 2017
a710149
Fix #4898 for jaxrs (#4918)
ePaul Mar 6, 2017
722b96b
In case if basePath equals to / we should not append it to url, behav…
yehor-masalitin Mar 6, 2017
ab4c5f2
Updated readme with latest maven URL (#4945)
josiahpeters Mar 6, 2017
122194c
Fix typo (#4956)
vpolouchkine Mar 7, 2017
7de1eeb
[python] Triple quote strings with new lines in default values (#4941)
jdevera Mar 7, 2017
6ea3315
Implicit headers for SpringCodegen (#4858)
huningd Mar 7, 2017
913d05c
[Python][Flask] Fix inconsistency between model name and file name (#…
wing328 Mar 7, 2017
0f88e4a
fix (partially) #4898 for MSF4J. (#4917)
ePaul Mar 7, 2017
404a999
Fix (partially) #4898 for swift3 (#4916)
ePaul Mar 7, 2017
290cb7c
fix path/query parameters (#4959)
stevecookform3 Mar 7, 2017
f236b08
minor formatting fix
wing328 Mar 7, 2017
6383872
update beanvalidation templates and sample for jersey2 #4719 (#4735)
jfiala Mar 7, 2017
c447586
update beanvalidation templates #4719 (#4734)
jfiala Mar 7, 2017
1e83127
[Jaxrs-spec] Merge beanValidation/beanValidationParams.mustache (#4731)
jfiala Mar 7, 2017
6a73403
update beanvalidation templates + samples #4719 (#4733)
jfiala Mar 7, 2017
2f43f98
update beanvalidation templates and samples jersey2 #4719 (#4732)
jfiala Mar 7, 2017
871b3ce
update templates and samples for spring-boot #4719 (#4736)
jfiala Mar 7, 2017
3e3d360
Add proxy support to fix #4639 (#4946)
krmaxwell Mar 8, 2017
5935e2e
Add support for saving/returning cookies (#4192)
delenius Mar 8, 2017
5dbcf6e
[JavaScript] fix issues with boolean CLI options (#4974)
wing328 Mar 8, 2017
89ad5e5
use convertPropertyToBooleanAndWriteBack in some generators (#4975)
wing328 Mar 8, 2017
2bb7626
[Java] Fix for issue #3365: Support for gzip compression (#4967)
michaelkourlas Mar 8, 2017
d21e156
[PHP] error when deserializing enums #4032 (#4886)
baartosz Mar 8, 2017
b6d6356
remove default format (json) from c# api (#4980)
wing328 Mar 8, 2017
4fe79f0
Remove default format (JSON) from API operations (#4987)
wing328 Mar 9, 2017
cffaaa0
minor improvements to Configuration php template (#4989)
baartosz Mar 9, 2017
bfb4390
[TypeScript][Angular2] better code indentation, update Petstore sampl…
wing328 Mar 9, 2017
fb75996
Make java spring controller constructor public. (#4972)
pablograna Mar 9, 2017
bfa8d35
JS files were replaced in the lib folder; include new (#4985)
bardware Mar 9, 2017
dc8d04e
updated parser
fehguy Mar 10, 2017
ec3b338
Improve HTML output for model titles, default responses (#4991)
Mar 10, 2017
20c8f9a
Java Play Framework Server Generator (#4943)
JFCote Mar 10, 2017
d9ee34e
Update travis.yml to cover Java-related server stubs (#4992)
wing328 Mar 10, 2017
3da8654
Change build call visibility
Mar 10, 2017
db4945f
added type check
fehguy Mar 10, 2017
f9835a4
matched key to actual value
fehguy Mar 10, 2017
3ff4c98
Merge pull request #4999 from swagger-api/issue-4998
fehguy Mar 10, 2017
a29c8c9
Update exception message to use operationId
ravinikam Mar 10, 2017
0dcd91a
null out the string `null` in examples. Rebuilt java clients and mad…
fehguy Mar 10, 2017
429c211
Merge pull request #5017 from swagger-api/issue-5016
fehguy Mar 10, 2017
dfc0b7e
Updated parser to release version
fehguy Mar 11, 2017
8fb71b4
cache module directory to improve CI performance (#5025)
wing328 Mar 11, 2017
3c1a8da
fix handleResponse to not leak okhttp connections (#4997)
xuxinkun Mar 11, 2017
2b9b0f3
remove indentation of the comment (#5011)
ePaul Mar 11, 2017
0ce6c7e
do not map UUID as model in java (#5026)
wing328 Mar 11, 2017
3dfa423
Merge branch 'patch-2' of https://github.com/ravinikam/swagger-codege…
wing328 Mar 11, 2017
82ccbc0
update cpprest petstore sample
wing328 Mar 11, 2017
4bf0fd6
Merge branch 'ravinikam-patch-2'
wing328 Mar 11, 2017
c4bd4c9
Add missing number type mapping (#5013)
ravinikam Mar 11, 2017
a201b01
Ultra minor spelling fix (#5029)
krmaxwell Mar 12, 2017
16adc7b
Fix (partially) #4898 for flash (#5022)
ePaul Mar 12, 2017
39eba39
[Jaxrs-cxf] add ApiResponse/s to operation #4718 (#4920)
jfiala Mar 12, 2017
c76f006
fix (partially) #4898 for dart. (#5019)
ePaul Mar 12, 2017
0b9aaad
Build and upload Swagger Codegen CLI Docker image on release (#4912)
arnested Mar 12, 2017
366f66d
Update link to maven jar
wing328 Mar 12, 2017
7733dba
Merge branch '2-call-visibility' of https://github.com/jdupouy/swagge…
wing328 Mar 12, 2017
01eba18
update java okhttp petstore sample
wing328 Mar 12, 2017
9f5da50
Merge branch 'jdupouy-2-call-visibility2'
wing328 Mar 12, 2017
a73c735
Merge branch 'master' of https://github.com/swagger-api/swagger-codegen
wing328 Mar 12, 2017
9d64e79
add ivy2 to cache sbt install
wing328 Mar 12, 2017
6308613
fix shippable config due to JAVA_HOME issue in openjdk8 (#5031)
wing328 Mar 12, 2017
79e21d9
Fix wrong Docker Hub repo in README (#5033)
arnested Mar 13, 2017
ba380c9
Issue 4759: Import complex type for body parameters (#4775)
Mar 13, 2017
722bbb8
update clojure test cases after restoring to petstore.json (#5043)
wing328 Mar 13, 2017
a2d1edc
Fix (partially) #4898 for groovy (#5030)
ePaul Mar 13, 2017
ebfc39e
use oracle jdk instead in shippable config (#5045)
wing328 Mar 13, 2017
9b281b2
make bin/java-play-framework-petstore-server.sh executable
wing328 Mar 13, 2017
b5be3f4
Merge branch 'master' of https://github.com/swagger-api/swagger-codegen
wing328 Mar 13, 2017
02f2fde
Fixes ListBuffer import-mapping for scala
Mar 13, 2017
9be178b
Merge branch 'master' into new-sync-master-to-2.3.0
Mar 13, 2017
eea58c5
Add support for typescript-jquery (typescript-based API calls using j…
bherila Mar 14, 2017
bbe3fd4
add jquery template creator
wing328 Mar 14, 2017
e1b1edf
Merge branch 'merge-2.3.0' into new-sync-master-to-2.3.0
Mar 14, 2017
b2aa877
Allow for UUID types in akka-scala (#5069)
rmalleman Mar 15, 2017
31f29be
Use deterministic randomness in ExampleGenerator. (#5068)
ePaul Mar 15, 2017
c651aac
add ci for ts jquery petstore (#5070)
wing328 Mar 15, 2017
f0cd13a
Updated companies/projects using swagger codegen
sebastianhaas Mar 15, 2017
2770d00
Merge pull request #5076 from sebastianhaas/patch-1
wing328 Mar 15, 2017
2da2a26
add ci for akka-scala client (#5073)
wing328 Mar 15, 2017
878b390
Merge pull request #5049 from jostick/fix-scala-listbuffer
wing328 Mar 15, 2017
08ea36b
Merge remote-tracking branch 'upstream/2.3.0' into new-sync-master-to…
ePaul Mar 15, 2017
784169b
Merge branch 'master' into new-sync-master-to-2.3.0
ePaul Mar 15, 2017
917306a
override escape quotation mark in async scala generator (#5078)
wing328 Mar 15, 2017
5bb0f7a
Update all samples.
ePaul Mar 15, 2017
1c160df
Fix Issue #5063 (deleting wrong sample files) (#5064)
ePaul Mar 15, 2017
f907af6
Merge branch 'master' into new-sync-master-to-2.3.0
ePaul Mar 15, 2017
21b70a2
Fix broken okhttp-gson merge.
ePaul Mar 16, 2017
60e80b7
Update petstore samples for scala client.
ePaul Mar 16, 2017
2ecb495
Fix missing dependency problem.
ePaul Mar 16, 2017
c74eec2
Merge branch 'update-scala-client-samples' into new-sync-master-to-2.3.0
ePaul Mar 16, 2017
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
22 changes: 11 additions & 11 deletions .github/ISSUE_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,17 +14,17 @@ Also please indicate in the issue title which language/library is concerned. Eg:
##### Swagger declaration file content or url

<!-- if it is a bug, a json or yaml that produces it.
If you post the code inline, please wrap it with
```yaml
(here your code)
```
(for YAML code) or
```json
(here your code)
```
(for JSON code), so it becomes more readable. If it is longer than about ten lines,
please create a Gist (https://gist.github.com) or upload it somewhere else and
link it here.
If you post the code inline, please wrap it with
```yaml
(here your code)
```
(for YAML code) or
```json
(here your code)
```
(for JSON code), so it becomes more readable. If it is longer than about ten lines,
please create a Gist (https://gist.github.com) or upload it somewhere else and
link it here.
-->

##### Command line used for generation
Expand Down
2 changes: 1 addition & 1 deletion .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
### PR checklist

- [ ] Read the [contribution guildelines](https://github.com/swagger-api/swagger-codegen/blob/master/CONTRIBUTING.md).
- [ ] Read the [contribution guidelines](https://github.com/swagger-api/swagger-codegen/blob/master/CONTRIBUTING.md).
- [ ] Ran the shell/batch script under `./bin/` to update Petstore sample so that CIs can verify the change. (For instance, only need to run `./bin/{LANG}-petstore.sh` and `./bin/security/{LANG}-petstore.sh` if updating the {LANG} (e.g. php, ruby, python, etc) code generator or {LANG} client's mustache templates)
- [ ] Filed the PR against the correct branch: master for non-breaking changes and `2.3.0` branch for breaking (non-backward compatible) changes.

Expand Down
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,8 @@ samples/client/petstore/typescript-node/**/typings
samples/client/petstore/typescript-angular/**/typings
samples/client/petstore/typescript-fetch/**/dist/
samples/client/petstore/typescript-fetch/**/typings
samples/client/petstore/typescript-angular2/npm/npm-debug.log
samples/client/petstore/typescript-node/npm/npm-debug.log

# aspnetcore
samples/server/petstore/aspnetcore/.vs/
Expand Down
26 changes: 22 additions & 4 deletions .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,22 @@ jdk:
cache:
directories:
- $HOME/.m2
- $HOME/.ivy2
- $HOME/samples/client/petstore/php/SwaggerClient-php/vendor
- $HOME/samples/client/petstore/ruby/venodr/bundle
- $HOME/samples/client/petstore/python/.venv/
- $HOME/samples/client/petstore/typescript-node/npm/node_modules
- $HOME/samples/client/petstore/typescript-node/npm/typings/
- $HOME/samples/client/petstore/typescript-fetch/tests/default/node_modules
- $HOME/samples/client/petstore/typescript-fetch/tests/default/typings
- $HOME/samples/client/petstore/typescript-fetch/builds/default/node_modules
- $HOME/samples/client/petstore/typescript-fetch/builds/default/typings
- $HOME/samples/client/petstore/typescript-fetch/builds/es6-target/node_modules
- $HOME/samples/client/petstore/typescript-fetch/builds/es6-target/typings
- $HOME/samples/client/petstore/typescript-fetch/builds/with-npm-version/node_modules
- $HOME/samples/client/petstore/typescript-fetch/npm/with-npm-version/typings
- $HOME/samples/client/petstore/typescript-angular/node_modules
- $HOME/samples/client/petstore/typescript-angular/typings

services:
- docker
Expand Down Expand Up @@ -47,9 +63,11 @@ script:
# fail if generators contain tab '\t'
- /bin/bash ./bin/utils/detect_tab_in_java_class.sh
# run integration tests defined in maven pom.xml
- mvn verify -Psamples
# docker test
- if [ $DOCKER_HUB_USERNAME ]; then docker login --email=$DOCKER_HUB_EMAIL --username=$DOCKER_HUB_USERNAME --password=$DOCKER_HUB_PASSWORD && docker build -t $DOCKER_IMAGE_NAME ./modules/swagger-generator && if [ ! -z "$TRAVIS_TAG" ]; then docker tag $DOCKER_IMAGE_NAME:latest $DOCKER_IMAGE_NAME:$TRAVIS_TAG; fi && docker push $DOCKER_IMAGE_NAME; fi
- mvn --batch-mode verify -Psamples
# docker: build generator image and push to Docker Hub
- if [ $DOCKER_HUB_USERNAME ]; then docker login --email=$DOCKER_HUB_EMAIL --username=$DOCKER_HUB_USERNAME --password=$DOCKER_HUB_PASSWORD && docker build -t $DOCKER_GENERATOR_IMAGE_NAME ./modules/swagger-generator && if [ ! -z "$TRAVIS_TAG" ]; then docker tag $DOCKER_GENERATOR_IMAGE_NAME:latest $DOCKER_GENERATOR_IMAGE_NAME:$TRAVIS_TAG; fi && if [ ! -z "$TRAVIS_TAG" ] || [ "$TRAVIS_BRANCH" = "master" ]; then docker push $DOCKER_GENERATOR_IMAGE_NAME; fi; fi
# docker: build cli image and push to Docker Hub
- if [ $DOCKER_HUB_USERNAME ]; then docker login --email=$DOCKER_HUB_EMAIL --username=$DOCKER_HUB_USERNAME --password=$DOCKER_HUB_PASSWORD && docker build -t $DOCKER_CODEGEN_CLI_IMAGE_NAME ./modules/swagger-codegen-cli && if [ ! -z "$TRAVIS_TAG" ]; then docker tag $DOCKER_CODEGEN_CLI_IMAGE_NAME:latest $DOCKER_CODEGEN_CLI_IMAGE_NAME:$TRAVIS_TAG; fi && if [ ! -z "$TRAVIS_TAG" ] || [ "$TRAVIS_BRANCH" = "master" ]; then docker push $DOCKER_CODEGEN_CLI_IMAGE_NAME; fi; fi

env:
- DOCKER_IMAGE_NAME=swaggerapi/swagger-generator
- DOCKER_GENERATOR_IMAGE_NAME=swaggerapi/swagger-generator DOCKER_CODEGEN_CLI_IMAGE_NAME=swaggerapi/swagger-codegen-cli
35 changes: 24 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Swagger Code Generator

[![Build Status](https://img.shields.io/travis/swagger-api/swagger-codegen.svg?label=Petstore%20Integration%20Test)](https://travis-ci.org/swagger-api/swagger-codegen)
[![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)
[![Run Status](https://img.shields.io/shippable/5782588a3be4f4faa56c5bea.svg?label=Mustache%20Template%20Test)](https://app.shippable.com/projects/5782588a3be4f4faa56c5bea)
[![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/WilliamCheng/swagger-codegen-wh2wu)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.swagger/swagger-codegen-project/badge.svg?style=plastic)](https://maven-badges.herokuapp.com/maven-central/io.swagger/swagger-codegen-project)
Expand All @@ -12,10 +12,12 @@

:warning: If the OpenAPI/Swagger spec is obtained from an untrusted source, please make sure you've reviewed the spec before using Swagger Codegen to generate the API client, server stub or documentation as [code injection](https://en.wikipedia.org/wiki/Code_injection) may occur :warning:

:rocket: ProductHunt: https://producthunt.com/posts/swagger-codegen :rocket:

## Overview
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:

- **API clients**: **ActionScript**, **Bash**, **C#** (.net 2.0, 4.0 or later), **C++** (cpprest, Qt5, Tizen), **Clojure**, **Dart**, **Elixir**, **Go**, **Groovy**, **Haskell**, **Java** (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign), **Node.js** (ES5, ES6, AngularJS with Google Closure Compiler annotations) **Objective-C**, **Perl**, **PHP**, **Python**, **Ruby**, **Scala**, **Swift** (2.x, 3.x), **Typescript** (Angular1.x, Angular2.x, Fetch, Node)
- **API clients**: **ActionScript**, **Bash**, **C#** (.net 2.0, 4.0 or later), **C++** (cpprest, Qt5, Tizen), **Clojure**, **Dart**, **Elixir**, **Go**, **Groovy**, **Haskell**, **Java** (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign), **Node.js** (ES5, ES6, AngularJS with Google Closure Compiler annotations) **Objective-C**, **Perl**, **PHP**, **Python**, **Ruby**, **Scala**, **Swift** (2.x, 3.x), **Typescript** (Angular1.x, Angular2.x, Fetch, jQuery, Node)
- **Server stubs**: **C#** (ASP.NET Core, NancyFx), **Erlang**, **Go**, **Haskell**, **Java** (MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, RestEasy), **PHP** (Lumen, Slim, Silex, [Zend Expressive](https://github.com/zendframework/zend-expressive)), **Python** (Flask), **NodeJS**, **Ruby** (Sinatra, Rails5), **Scala** ([Finch](https://github.com/finagle/finch), Scalatra)
- **API documentation generators**: **HTML**, **Confluence Wiki**
- **Others**: **JMeter**
Expand Down Expand Up @@ -66,19 +68,20 @@ The OpenAPI Specification has undergone 3 revisions since initial creation in 20

Swagger Codegen Version | Release Date | OpenAPI Spec compatibility | Notes
-------------------------- | ------------ | -------------------------- | -----
2.3.0 (upcoming minor release) | TBD | 1.0, 1.1, 1.2, 2.0 | Minor release with breaking changes
2.2.2 (upcoming patch release) | TBD | 1.0, 1.1, 1.2, 2.0 | Patch release (without breaking changes)
2.2.1 (**current stable**) | 2016-08-07 | 1.0, 1.1, 1.2, 2.0 | [tag v2.2.1](https://github.com/swagger-api/swagger-codegen/tree/v2.2.1)
2.3.0 (upcoming minor release) | Apr/May 2017 | 1.0, 1.1, 1.2, 2.0 | Minor release with breaking changes
2.2.3 (upcoming patch release) | TBD | 1.0, 1.1, 1.2, 2.0 | Patch release without breaking changes
2.2.2 (**current stable**) | 2017-03-01 | 1.0, 1.1, 1.2, 2.0 | [tag v2.2.2](https://github.com/swagger-api/swagger-codegen/tree/v2.2.2)
2.2.1 | 2016-08-07 | 1.0, 1.1, 1.2, 2.0 | [tag v2.2.1](https://github.com/swagger-api/swagger-codegen/tree/v2.2.1)
2.1.6 | 2016-04-06 | 1.0, 1.1, 1.2, 2.0 | [tag v2.1.6](https://github.com/swagger-api/swagger-codegen/tree/v2.1.6)
2.0.17 | 2014-08-22 | 1.1, 1.2 | [tag v2.0.17](https://github.com/swagger-api/swagger-codegen/tree/v2.0.17)
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)


### Prerequisites
If you're looking for the latest stable version, you can grab it directly from maven central (you'll need java 7 runtime at a minimum):
If you're looking for the latest stable version, you can grab it directly from Maven.org (Java 7 runtime at a minimum):

```
wget http://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.2.1/swagger-codegen-cli-2.2.1.jar -O swagger-codegen-cli.jar
wget http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.2.2/swagger-codegen-cli-2.2.2.jar -O swagger-codegen-cli.jar

java -jar swagger-codegen-cli.jar help
```
Expand Down Expand Up @@ -161,7 +164,7 @@ cd /vagrant

- https://hub.docker.com/r/swaggerapi/swagger-generator/ (official web service)
- https://hub.docker.com/r/swaggerapi/swagger-codegen-cli/ (official CLI)
=======


##### Swagger Generator Docker Image

Expand All @@ -188,7 +191,7 @@ docker stop $CID && docker rm $CID

In the example above, `result.zip` will contain the generated client.

##### Swagger Codegen Docker Image
##### Swagger Codegen CLI Docker Image

The Swagger Codegen image acts as a standalone executable. It can be used as an alternative to installing via homebrew, or for developers who are unable to install Java or upgrade the installed version.

Expand All @@ -197,7 +200,7 @@ To generate code with this image, you'll need to mount a local location as a vol
Example:

```
docker run --rm -v ${PWD}:/local swagger-api/swagger-codegen generate \
docker run --rm -v ${PWD}:/local swaggerapi/swagger-codegen-cli generate \
-i http://petstore.swagger.io/v2/swagger.json \
-l go \
-o /local/out/go
Expand All @@ -219,7 +222,7 @@ java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate \
```
(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`)

You can also download the JAR (latest release) directly from [maven.org](http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.2.1/swagger-codegen-cli-2.2.1.jar )
You can also download the JAR (latest release) directly from [maven.org](http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.2.2/swagger-codegen-cli-2.2.2.jar)

To get a list of **general** options available, please run `java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar help generate`

Expand Down Expand Up @@ -849,11 +852,13 @@ Here are some companies/projects using Swagger Codegen in production. To add you
- [Flat](https://flat.io)
- [Finder](http://en.finder.pl/)
- [FH Münster - University of Applied Sciences](http://www.fh-muenster.de)
- [Fotition](https://www.fotition.com/)
- [Gear Zero Network](https://www.gearzero.ca)
- [Germin8](http://www.germin8.com)
- [goTransverse](http://www.gotransverse.com/api)
- [GraphHopper](https://graphhopper.com/)
- [Gravitate Solutions](http://gravitatesolutions.com/)
- [HashData](http://www.hashdata.cn/)
- [Hewlett Packard Enterprise](https://hpe.com)
- [High Technologies Center](http://htc-cs.com)
- [IMS Health](http://www.imshealth.com/en/solution-areas/technology-and-applications)
Expand Down Expand Up @@ -884,9 +889,11 @@ Here are some companies/projects using Swagger Codegen in production. To add you
- [Plexxi](http://www.plexxi.com)
- [Pixoneye](http://www.pixoneye.com/)
- [PostAffiliatePro](https://www.postaffiliatepro.com/)
- [PracticeBird](https://www.practicebird.com/)
- [Prill Tecnologia](http://www.prill.com.br)
- [QAdept](http://qadept.com/)
- [QuantiModo](https://quantimo.do/)
- [QuickBlox](https://quickblox.com/)
- [Rapid7](https://rapid7.com/)
- [Reload! A/S](https://reload.dk/)
- [REstore](https://www.restore.eu)
Expand All @@ -903,6 +910,7 @@ Here are some companies/projects using Swagger Codegen in production. To add you
- [snapCX](https://snapcx.io)
- [SPINEN](http://www.spinen.com)
- [SRC](https://www.src.si/)
- [Stingray](http://www.stingray.com)
- [StyleRecipe](http://stylerecipe.co.jp)
- [Svenska Spel AB](https://www.svenskaspel.se/)
- [TaskData](http://www.taskdata.com/)
Expand Down Expand Up @@ -955,6 +963,7 @@ Swagger Codegen core team members are contributors who have been making signific
| Java Spring Boot | @cbornet (2016/07/19) |
| Java Spring MVC | @kolyjjj (2016/05/01) @cbornet (2016/07/19) |
| Java JAX-RS | |
| Java Play Framework | |
| NancyFX | |
| NodeJS | @kolyjjj (2016/05/01) |
| PHP Lumen | @abcsum (2016/05/01) |
Expand Down Expand Up @@ -993,6 +1002,7 @@ Here is a list of template creators:
* TypeScript (Angular1): @mhardorf
* TypeScript (Fetch): @leonyu
* TypeScript (Angular2): @roni-frantchi
* TypeScript (jQuery): @bherila
* Server Stubs
* C# ASP.NET5: @jimschubert
* C# NancyFX: @mstefaniuk
Expand All @@ -1002,9 +1012,11 @@ Here is a list of template creators:
* Java MSF4J: @sanjeewa-malalgoda
* Java Spring Boot: @diyfr
* Java Undertow: @stevehu
* Java Play Framework: @JFCote
* JAX-RS RestEasy: @chameleon82
* JAX-RS CXF: @hiveship
* JAX-RS CXF (CDI): @nickcmaynard
* JAX-RS RestEasy (JBoss EAP): @jfiala
* PHP Lumen: @abcsum
* PHP Slim: @jfastnacht
* PHP Zend Expressive (with Path Handler): @Articus
Expand Down Expand Up @@ -1073,3 +1085,4 @@ limitations under the License.

---
<img src="http://swagger.io/wp-content/uploads/2016/02/logo.jpg"/>

2 changes: 1 addition & 1 deletion bin/dart-petstore.sh
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ fi
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"

ags="$@ generate -t modules/swagger-codegen/src/main/resources/dart -i modules/swagger-codegen/src/test/resources/2_0/petstore.yaml -l dart -o samples/client/petstore/dart/swagger"
ags="$@ generate -t modules/swagger-codegen/src/main/resources/dart -i modules/swagger-codegen/src/test/resources/2_0/petstore.yaml -l dart -o samples/client/petstore/dart/swagger -DhideGenerationTimestamp=true"

# then options to generate the library for vm would be:
#ags="$@ generate -i modules/swagger-codegen/src/test/resources/2_0/petstore.yaml -l dart -o samples/client/petstore/dart/swagger_vm -DbrowserClient=false -DpubName=swagger_vm"
Expand Down
2 changes: 1 addition & 1 deletion bin/java-inflector-petstore-server.sh
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,6 @@ fi

# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
ags="$@ generate -t modules/swagger-codegen/src/main/resources/JavaInflector -i modules/swagger-codegen/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml -l inflector -o samples/server/petstore/java-inflector"
ags="$@ generate -t modules/swagger-codegen/src/main/resources/JavaInflector -i modules/swagger-codegen/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml -l inflector -o samples/server/petstore/java-inflector -DhideGenerationTimestamp=true"

java $JAVA_OPTS -jar $executable $ags
31 changes: 31 additions & 0 deletions bin/java-play-framework-petstore-server.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
#!/bin/sh

SCRIPT="$0"

while [ -h "$SCRIPT" ] ; do
ls=`ls -ld "$SCRIPT"`
link=`expr "$ls" : '.*-> \(.*\)$'`
if expr "$link" : '/.*' > /dev/null; then
SCRIPT="$link"
else
SCRIPT=`dirname "$SCRIPT"`/"$link"
fi
done

if [ ! -d "${APP_DIR}" ]; then
APP_DIR=`dirname "$SCRIPT"`/..
APP_DIR=`cd "${APP_DIR}"; pwd`
fi

executable="./modules/swagger-codegen-cli/target/swagger-codegen-cli.jar"

if [ ! -f "$executable" ]
then
mvn clean package
fi

# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
ags="$@ generate -t modules/swagger-codegen/src/main/resources/JavaPlayFramework -i modules/swagger-codegen/src/test/resources/2_0/petstore.json -l java-play-framework -o samples/server/petstore/java-play-framework -DhideGenerationTimestamp=true"

java $JAVA_OPTS -jar $executable $ags
2 changes: 1 addition & 1 deletion bin/spring-delegate-j8.sh
Original file line number Diff line number Diff line change
Expand Up @@ -30,5 +30,5 @@ ags="$@ generate -t modules/swagger-codegen/src/main/resources/JavaSpring -i mod

echo "Removing files and folders under samples/server/petstore/springboot-delegate-j8/src/main"
rm -rf samples/server/petstore/springboot-delegate-j8/src/main
find samples/server/petstore/springboot -maxdepth 1 -type f ! -name "README.md" -exec rm {} +
find samples/server/petstore/springboot-delegate-j8/ -maxdepth 1 -type f ! -name "README.md" -exec rm {} +
java $JAVA_OPTS -jar $executable $ags
2 changes: 1 addition & 1 deletion bin/spring-delegate.sh
Original file line number Diff line number Diff line change
Expand Up @@ -30,5 +30,5 @@ ags="$@ generate -t modules/swagger-codegen/src/main/resources/JavaSpring -i mod

echo "Removing files and folders under samples/server/petstore/springboot-delegate/src/main"
rm -rf samples/server/petstore/springboot-delegate/src/main
find samples/server/petstore/springboot -maxdepth 1 -type f ! -name "README.md" -exec rm {} +
find samples/server/petstore/springboot-delegate/ -maxdepth 1 -type f ! -name "README.md" -exec rm {} +
java $JAVA_OPTS -jar $executable $ags
3 changes: 3 additions & 0 deletions bin/springboot-petstore-server-implicitHeaders.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"implicitHeaders": true
}
34 changes: 34 additions & 0 deletions bin/springboot-petstore-server-implicitHeaders.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
#!/bin/sh

SCRIPT="$0"

while [ -h "$SCRIPT" ] ; do
ls=`ls -ld "$SCRIPT"`
link=`expr "$ls" : '.*-> \(.*\)$'`
if expr "$link" : '/.*' > /dev/null; then
SCRIPT="$link"
else
SCRIPT=`dirname "$SCRIPT"`/"$link"
fi
done

if [ ! -d "${APP_DIR}" ]; then
APP_DIR=`dirname "$SCRIPT"`/..
APP_DIR=`cd "${APP_DIR}"; pwd`
fi

executable="./modules/swagger-codegen-cli/target/swagger-codegen-cli.jar"

if [ ! -f "$executable" ]
then
mvn clean package
fi

# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -XX:MaxPermSize=256M -Xmx1024M -DloggerPath=conf/log4j.properties"
ags="$@ generate -t modules/swagger-codegen/src/main/resources/JavaSpring -i modules/swagger-codegen/src/test/resources/2_0/petstore-with-fake-endpoints-models-for-testing.yaml -l spring -c bin/springboot-petstore-server-implicitHeaders.json -o samples/server/petstore/springboot-implicitHeaders -DhideGenerationTimestamp=true"

echo "Removing files and folders under samples/server/petstore/springboot-implicitHeaders/src/main"
rm -rf samples/server/petstore/springboot-implicitHeaders/src/main
find samples/server/petstore/springboot-implicitHeaders -maxdepth 1 -type f ! -name "README.md" -exec rm {} +
java $JAVA_OPTS -jar $executable $ags
Loading