* Probe content type for multipart form uploads since many servers require each part to correctly identify its type.
* Update samples
* Add explanatory comment
* Update samples with comment
* Make TypeScriptClientCodegen extend AbstractTypeScriptClientCodegen
* Regenerate samples
* Update docs
* Clean up
* Remove updated toEnumName
* Fix: SUPPORTS_ES6
* Fix: `setSupportsES6` should not be set directly in unit tests
* Set modelPropertyNaming to camelCase
* [cpp-ue4] Removed warning related to wrong casing of HTTP module
* [cpp-ue4] Fixed compilation error when using file parameters in json body generation
* [cpp-ue4] Do not write the form param json body generation unless there actually are form params
* [cpp-ue4] Added support for enum values in path params
* Added ability to configure the AuthorizationFilter pattern
* Added configuration for the Client annotation
* Generated samples
* Remove extra newline from template
* Updated samples
* Declarative client annotation path attribute only supported when id attribute is set
* Cleaned up style of generated file
---------
Co-authored-by: Shane Perry <shane.perry@acimacredit.com>
* integers parameters in URL did not work as expected
* so now, if the parameter is an integer, we convert it to binary before
passing to `hackney_url:make_url/3`
* 5705: Move JsonProperty annotation to the getters
* Regenerate samples
* Add jackson check
* Add test
* Minor fix
* Fix test
* Fix version
* [Java][Spring] update test & samples; add serialization/deserialization test
---------
Co-authored-by: Oleh Kurpiak <oleh.kurpiak@gmail.com>
* Added the useResponseEntity additional parameter for Spring generator
* Changed the mustache templates using the new useResponseEntity property
* Added the new property to the documentation
* Merging with remote master
* #11537 Added missing configuration for the delegate pattern case
* #11537 Added autogenerated @ResponseStatus on Spring methods
* #11537 Fixed borsch comments
* #11537 Added the default 200 HTTP Status for empty response HTTP code
* [Java][Spring] useResponseEntity sample + remove blank line
* [Java][Spring] useResponseEntity sample + remove blank line
* [Java][Spring] useResponseEntity sample + remove blank line
---------
Co-authored-by: Oleh Kurpiak <oleh.kurpiak@gmail.com>
* [PHP-Symfony] fixes validation of date-time parameter
This fixes parts of #14930.
Without this patch a parameter declared as date-time
is validated against Symfony's "DateTime" constraint,
which always fails. Because this constraint expects
a string with format "Y-m-d H:i:s".
It fails because the generated code performs the check
after the deserialization, so the variable checked is not
a string anymore.
Besides this, even if we performed that validation on the
string, that would not work well because OpenApi
specification expects date-time to conform to RFC 3339
and that "Y-m-d H:i:s" would reject RFC 3339 compliant dates.
With this change we ensure that the string provided by the
web user could be parsed by PHP to DateTime, which solves both issues.
(Note however that it means that it now accepts more formats than just
RFC 3339 compliant ones for those parameters (it would accept all formats
accepted by PHP DateTime). That being said it's compliant with the guideline
""be conservative in what you send, be liberal in what you accept")
* [PHP-Symfony] Fix handling of null date-time parameter
This fixes one of the issue described on #14930, namely that
the deserializeString method of the generated class JsmSerializer returns null
for other types of string, but not for date-time. Instead it returns a DateTime
which represents "now" (because that what `new DateTime(null)` does).
Consequently when an API declares a date-time parameter as non-required and
when that endpoint is called without that parameters, then the user code
would end up having "now" instead of "null" for this parameter.
* Implement WARN messages for ineffective schema validation constraints
* Implement tests String, Number, Object schema validations
* Implement HashSet to store Validations for different types
* Revert Validation Helper functions; Add Test cases for Any and Boolean
* Implement Unit Test for Array with inffective schema validations
* Reformat Code; Optimize Imports
* Add assertions to ineffective validation tests
* Add Test case for Null Schema Validations
* Adjust log level and message
* Merge commit ... into issue-6491
---------
Co-authored-by: Chidu Nadig <chidu.nadig@gmail.com>
Expose `isPassword` codegen property. This property can be used in the
mustache templates to handle specific generation use case. _e.g._:
* hiding the string value of password fields in generated toString()
methods
* use more specific types like `char[]` instead of `String` in
[Java](https://stackoverflow.com/a/8881376)
Closes https://github.com/OpenAPITools/openapi-generator/issues/9124
* only add suffix or prefix if type is not a primitive or from dependency
* add tests
* add sample
* add second API with prefix and suffix
* add primitives
* add missing pom
* add missing shell script
* fix cycle dependency
* generate samples
* Remove double brace initialization
* Use diamond operator
* Less clutter in generated api classes
* Optimize isJsonMime
* Revert change in escapeString
Skip toString() on string parameters.
* Fix edge-cases
A ServerVariable without enumValues and/or operationServers
with any ServerVariables would lead to invalid code.
Use a single InputStream instead of "File".
This allows the generated code to build in case of a definition like:
requestBody:
content:
text/plain:
schema:
type: string
format: binary
This fixes#9372
* add unsigned integer/long support to c# netcore client
* moved formats to separate file
* moved formats to cli options
* moved formats to cli options
* reverted unintended changes
* reverted unintended changes
---------
Co-authored-by: William Cheng <wing328hk@gmail.com>
* Base impl
* Improve Unity support
* update samples
* Sync bool property
* Update samples
* Set support file property
* Address comments
* Fix test asmdef
* Fixes for WebGL support
* Add note about Unity version
* Add Unity Sample
---------
Co-authored-by: William Cheng <wing328hk@gmail.com>
* Add constructor with required parameter for spring
Fix#9789
* [Java][Spring] constructor with required args
---------
Co-authored-by: Oleh Kurpiak <oleh.kurpiak@gmail.com>
This utility class has been marked as deprecated for future removal since Spring 6.0.5. All Java generators, except WebClient and RestTemplate, are already using Base64 directly.
* add github work for erlang projects
* trigger build
* use setup-bean instead
* add rebar3 version
* update otp version
* fix otp version
* fix otp version
* use 22.2
* fix
* fix
* fix ubuntu version
* use 22.2
* comment out erlang server test
* add from_dict to model_anyof template in python-nextgen, fixes#14767
* add space before from_dict in model.anyof in python-nextgen
* update samples, add tests
---------
Co-authored-by: Tomas Karasek <tom.to.the.k@gmail.com>
* Fix serialization when there is a discriminator with mapping
* Update samples
* Update samples
* upgrade samples
* Revert "Update samples"
This reverts commit d6affde263.
* [dart] Cleanup unused/redundant stuff
* [dart] Bump Dio to 5.0.0
* Fix description
* Get tests to run based with git dependency
* Fix test generation
* Update docs
* Update test dependencies
* Use released version of http_mock_adapter
* [Kotlin-Spring] Support multiline descriptions
This commit adds support for multiline descriptions for operations in
the Kotlin-Spring generator, for both regular API generation (i.e.
Controller), as well as interface-only API generation.
Multiline descriptions allow us to use rich text representations, e.g.
with Markdown. Note that Markdown-formatted descriptions are rendered
nicely in Swagger-UI. I imagine that most openapi consumers will be able
(or will want to) support Markdown (at some point).
The solution for Kotlin-Spring is rather simple, using Raw Strings to
contain the `unescapedNotes`.
See: https://kotlinlang.org/docs/strings.html#raw-strings
Note that specific unescaped strings could cause problems. For example,
the string containing three double quotes `"""` would result in compile
errors for the generated code. I think this is acceptable.
Note that an improvement is possible to use `.trimMargin()` in
combination with the pipe symbol `|`, to allow specific margin
prefixing.
Note that the description is used in escaped form in the JavaDoc. This
could be resolved by prefixing every line of the unescapedNotes with a
star `*`.
For now, I've chosen to implement this the simplest way I could think
off.
Signed-off-by: Nico Korthout <nico.korthout@camunda.com>
* [Kotlin-Spring] Update samples
Signed-off-by: Nico Korthout <nico.korthout@camunda.com>
---------
Signed-off-by: Nico Korthout <nico.korthout@camunda.com>
* Remove dead code
* Refactor containsKey before get
* Minor refactor
* Use JsonMapper.builder() to build ObjectMapper
Fix a bug where ALLOW_COERCION_OF_SCALARS wasn't set properly.
* Update samples
* Oops, fix a typo
* io/ioutil has been deprecated ass of Go 1.16, the same functionality is now provided by package io or package os
* run pr checklist
* Bump go version to 1.16.
* Run pr checklist
* Bump version to 1.18
* Run pr check list
* allow general purpose faraday connection configuration
* add spec for Configuration#configure_faraday_connection
* run generators
* limit changes to ruby client generated using faraday library
* [Kotlin] add spring boot 3 & jakarta extension support
* [kotlin-spring] readme update & modified imports
* use latest Spring Boot starter parent
* use same options as in [Java] generator
* new config kotlin-spring-boot-3
---------
Co-authored-by: jayandran sampath <jayandran.sampath@opencastsoftware.com>
* Dummy client generated
* Adding dummy versions, my IDE crashed
* Making my first actual requests
* Creates first version of API Generator for Jetbrains Client
* Adds generated API files
* Adds more complex API definition
* Adds basic supporting files
* Adds empty environment file for variables
* Adds basic README
* Adds minimal set of values in env file`
* Adds minimal support for API Key header
* Adds Adyen API sample
* Add null checks on code
* Simplifies the generator, cleans output
* Improves README
* Fix minor issues with README
* Removes API file and config used for local testing
* Remove leftover logging file
* Disables tests as I find how to write them
* Sets generator as experimental
* Add new generator language enum value
* Adds generator doc file
* Adds generators main file
* Removes unused method. Adds my name
* Adding Jetbrains HTTP Client to the README
* Added a Julia client and server
This PR adds two new generators for the [Julia language](https://julialang.org/)
- `julia-client` to generate a client from specifications
- `julia-server` to generate a server with stubs that can be used to host a server conforming to the specifications
The generated code uses the Julia [OpenAPI.jl](https://github.com/JuliaComputing/OpenAPI.jl) package that includes support functions for both client and server.
* fix javadoc generation
* add changes after ensure-up-to-date run
* [python-nextgen] fix template to make auto-generated example runnable when spec has no auth methods
* update samples with ./bin/generate-samples.sh
* add unit test code
* [REQ] Add equals and hashcode to java-cxf pojo #12519
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* [Java] Use abstraction for files for jaxrs-cxf #8792
* fix sample
* fix sample
---------
Co-authored-by: FWermelskirchen <fwermelskirchen@eitco.de>
* [java] Fix template logic related to supportUrlQuery
Generated models for arrays marked with uniqueItems: true (which end up as a Set<> in java) won't
compile because the templates are in some places using .get(i) on the sets.
Also, when the supportUrlQuery property is present in the additionalProperties map the
resulting value will be read using the key SUPPORT_STREAMING instead of 'supportUrlQuery'.
* fix NPE
Co-authored-by: Björgvin <bjorgvino@gmail.com>
* Currently, if a Model is an allOf the time and os imports are not correctly added to the generated file. This was introduced recently with a fix to not include those imports when the model is a composedSchema #13833. The logic in that fix was just slightly off as an allOf should be treated the same as a standard model.
If a model is an AllOf or does not have any composed schemas at all, the sub-models are in-lined defined in the struct. In this case, the standard logic of including the time and os imports apply.
If a model is a OneOf or AnyOf, the sub-models are included as pointers to the defined model. In this case, do not include those items in the logic of including time and os imports.
* Update example to include a time in an allOf
* Add back the accidentally removed nil check
* Use correct Pascal case for java enum
* Uniquely name @Bean annotations
* Use existing mustache var instead, run generate files
* rebase, re-run generators
* try to undo botched rebase/merge
* Attempt to manually undo whatever is going on w/ build, oops
* Attempt to manually undo whatever is going on w/ build, oops
* Change the return type of a file back to a pointer
* Change the api template to handle not double pointer-ing return types of os.File
* Fix unit tests
* Couple more unit test fixes
* fix depricated @Schema(required) since swagger 2.2.5
* use same swagger-annotations version which is used by swagger-core which is a dependency of springdoc
* generated java sampes
* If the collection type is csv, that means 'dont explode the query params'.
* Simplify the logic just a tad
* url.Values -> Has was added in go1.17 but there are CI tests running at 1.16
* [kotlin][client] add info if endpoints requires authentication or not
* [kotlin][client] update sample projects
* [kotlin][client] add info if endpoints requires authentication or not
* [kotlin][client] update sample projects
* add workflow to test java apache client with jdk8
* fix url encode issue with jdk8
* update samples
* minor improvements in java native client
* minor fix
* Added additional documentation for configuration object
* Regenerate samples
* Added exemplary usage of API to README.md
* Updated README, refined wording
* Added example for calling the API
* Regenerated samples
* Updated samples
* Add async `execute` interface
* Update samples
Run `./bin/generate-samples.sh`
* Add an explicit `self`
I forgot to add it
* Add an availability condition
* Add support of AWSV4 Signature in Java
* Add Petstore sample for AWSV4 Signature
* Update other sample examples
* Sync Documentation and sample
* Specify only available for okhttp-gson in doc
* #14141 Add externalDocs to @Operation to the JavaSpring generator
* #14141 Add externalDocs to @Operation to the JavaSpring generator : fix mustache template with #hasExternalDocs
* #14141 Add externalDocs to @Operation to the JavaSpring generator: fix indentation
* #14141 Add externalDocs to @Operation to the JavaSpring generator: fix carriage return
* #14141 Add externalDocs to @Operation to the JavaSpring generator: regenerate the spring-boot-oas3.yaml sample
* #14141 Add externalDocs to @Operation to the JavaSpring generator: generate-samples.sh
* #14141 Add externalDocs to @Operation to the JavaSpring generator: remove hasExternalDocs
* Fix ExternalDocumentation import generation and order
* #14141 Add externalDocs to @Operation to the JavaSpring generator: generate-samples.sh
* Fix#14276 Java Templates uses jakarta or javax package if useJakartaEe
is true
* generated samples after useJakartaEe changes
* generated docs after useJakartaEe changes
* Fix swapped operators
Signed-off-by: Tom Hörberg <tom@hoerberg.de>
* add conversion to support non-string params
Signed-off-by: Tom Hörberg <tom@hoerberg.de>
* Provide better fix for nonstring url param values
Signed-off-by: Tom Hörberg <tom@hoerberg.de>
* Updated python-nextgen sample files
Signed-off-by: Tom Hörberg <tom@hoerberg.de>
Signed-off-by: Tom Hörberg <tom@hoerberg.de>
* update openapi-generator dep
* update dep, fix tests with new spec
* update kotlin version
* revert cafferine version
* add back testng version and scope
* [rust] Fix declaration for arrays with object and array references
For arrays with an item defined by reference to an array or an object,
the generated type declaration was `Vec<core::models::Array>` or
`Vec<core::models::Map>` without defining a `Array` or `Map` so that the
code didn't compile.
* [rust] Fix trailing whitespace in petstore definition
When sending a request with a client generated by typescript-nestjs, the
default headers are modified. This occurs when headers such as "Accept"
are appended by the client.
The root of the issue is that a reference to the default headers is
stored instead of a clone.
* Enable the ruby client to support refreshing access tokens
- The client can now be configured with an access token getter proc
- The proc overrides the the static access token if it is set
* Run generators
* Update Java/Feign api.mustache to accept convinience Map
Hi, I just saw, that the generated Map Class is never used outside of tests, but it would be the perfect fit for the changed mehods, as its use-case is exactly the same.
Also a useful change to prevent problems with Collection types and their generics parameters (f.e. Map<x, y>). See: https://stackoverflow.com/questions/62823341/openapi-generator-maven-plugin-breaks-old-feign-with-querymap
* PR checklist
Steps as requested per checklist: done.
* Supporting Gson decoder in Feign
* Supporting Gson decoder in Feign
* Fixing test failures - and ensuring Jackson is used as the default if nothing selected (back compatible)
* Adding in sample files
* Updating docs
* Switching to echo server version
* Adding feign-gson to the github workflow
* Empty-Commit
* Add support for Angular v15
Support for:
- rxjs 7.5.5
- ngPackagr 15.0.2
- zonejs 0.11.5
- typescript >=4.8.2 and <4.10.0
Note that tsTickle is not added to the dependencies when generating for
Angular 15, as:
- it is not a real dependency
- tsTickle is compatible with any of the TypeScript versions that
Angular 15 supports.
* Generate samples for Angular v15
- typescript-angular-v15-provided-in-root
- typescript-angular-v15-query-param-object-format
* Drop sample typescript-angular-v15-query-param-object-format
* Fix typo
* Add tests for sample
Use credentials instead of api_key to avoid deprecation warnings when
initialising ConfigurationParameters.
* Update samples/client/petstore/typescript-angular-v15-provided-in-root/package.json
* Fix tests by removing context initialisation
Also updated the test dependencies.
Co-authored-by: Esteban Gehring <esteban.gehring@gmail.com>
* Changes manually cherry-picked (for the most part) from https://github.com/OpenAPITools/openapi-generator/pull/12685/files
* Examples updated post changes
* Missed a change in the mustache template
* Update examples after last fix
* Missed dereference for required files
* Update unit tests
* Missed another test case update
* `f := *f` isn't quite the same as `*f, err = ...`
* Fix response type to be Response or undefined
Current generated code produces a `response` variable set to undefined, and TS does not like you changing the type of the variable later. Therefore, set the type of the variable to be `Response` or `undefined`
Solves OpenAPITools/openapi-generator#12007
* Update samples
* clean up shippable ci related config and files
* comment out closeAndReleaseRepository
* Revert "comment out closeAndReleaseRepository"
This reverts commit 5a76e403b1.
* remove closeAndReleaseRepository
* Upgrade Gradle plugin Gradle build to Gradle 7.5.1
* Update Travis workflow file to support new tasks
* Update Maven POM with Gradle 7.5.1
* Capitalize many occurrences of "Gradle" in the Gradle plugin README
* Update Gradle version in appveyor.yml and shippable.yml
* Update comments
* Update Gradle wrapper to 7.5.1
* Capitalize Gradle in shippable.yml
* Leave Open API
* Upgrade Gradle plugin build to Gradle 7.6
* Upgrade wrapper to Gradle 7.6
* multiple use of parameters in deepobjects
* fix java native
* support camelCase
* revert modifying baseName because it is not used anymore
* remove commented line
When fromOperation(...) was called before fromModel, the aliases were uninitialized.
(cherry picked from commit 44ea23168362cfacf8a61ff944701990cf3fea76)
Co-authored-by: Clemens Heppner <ch@wps.de>
* fix documentation
* improve build.gradle.mustache and pom.xml.mustache to assume different serialization libs jackson or micronaut-serde-jackson
* improve pojo.mustache to skip generating @JsonDeserialize as for micronaut-serde-jackson
* improve model generating by removing visible flag from @JsonTypeInfo as it is not supported by micronaut-serde-jackson
Co-authored-by: dmitry.kubakhov <dmitry.kubakhov@check24.de>
This change has no functional impact. In my view, `pathlib` has a more
pleasant API than `os.path`. Incidentally, this slightly reduces line
count.
cc @spacether
* modify Alamofire version in podspec
* modify Alamofire version in Package.swift
* also pin optimistically in Cartfile
* optimistically resolve all other dependencies to next major version
* Add args to reserved words
* arg and args to _arg and _args in templates
* Corrections
* Test added
* Corrections
* Use arg and args as defined properties
* Removed unnecessary assertion
* Suggested change
* add isEnumRef to codegen property
* better format
* update R template to use isEnumOrRef
* update powershell template to use isEnumOrRef
* update samples
The if not passed the models create a new configuration object which
configures logging and determines cpu count every time.
This causes extreme performance issues when deserializing larger sets of
items.
See also
https://github.com/kubernetes-client/python/issues/1921
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` (6.1.0) (minor release - breaking changes with fallbacks), `7.0.x` (breaking changes without fallbacks)
- [ ] In case you are adding a new generator, run the following additional script :
```
./bin/utils/ensure-up-to-date.sh
```
Commit all changed files.
- [ ] File the PR against the [correct branch](https://github.com/OpenAPITools/openapi-generator/wiki/Git-Branches): `master` (6.3.0) (minor release - breaking changes with fallbacks), `7.0.x` (breaking changes without fallbacks)
- [ ] If your PR is targeting a particular programming language, @mention the [technical committee](https://github.com/openapitools/openapi-generator/#62---openapi-generator-technical-committee) members, so they are more likely to review the pull request.
[](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.openapitools%22%20AND%20a%3A%22openapi-generator%22) [](./LICENSE) [](https://opencollective.com/openapi_generator) [](https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g) [](https://twitter.com/oas_generator) [](https://gitpod.io/#https://github.com/OpenAPITools/openapi-generator)
[](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.openapitools%22%20AND%20a%3A%22openapi-generator%22)
[](https://join.slack.com/t/openapi-generator/shared_invite/zt-12jxxd7p2-XUeQM~4pzsU9x~eGLQqX2g)
[](https://twitter.com/oas_generator)
[](https://gitpod.io/#https://github.com/OpenAPITools/openapi-generator)
[](https://github.com/OpenAPITools/openapi-generator/actions?query=workflow%3A%22Check+Supported+Java+Versions%22)
#### Thank you GoDaddy for sponsoring the domain names, Linode for sponsoring the VPS and Checkly for sponsoring the API monitoring
@@ -70,13 +76,13 @@ If you find OpenAPI Generator useful for work, please consider asking your compa
## Overview
OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an [OpenAPI Spec](https://github.com/OAI/OpenAPI-Specification) (both 2.0 and 3.0 are supported). Currently, the following languages/frameworks are supported:
| 7.0.0 (upcoming major release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/7.0.0-SNAPSHOT/) | Feb/Mar 2023 | Major release with breaking changes (no fallback) |
| 6.3.0 (upcoming minor release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/6.3.0-SNAPSHOT/) | 24.11.2022 | Minor release with breaking changes (with fallback) |
| [6.2.0](https://github.com/OpenAPITools/openapi-generator/releases/tag/v6.2.0) (latest stable release) | 24.09.2022 | Minor release with breaking changes (with fallback) |
| 7.0.0 (upcoming major release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/7.0.0-SNAPSHOT/) | May/Jun 2023 | Major release with breaking changes (no fallback) |
| 6.6.0 (upcoming minor release) [SNAPSHOT](https://oss.sonatype.org/content/repositories/snapshots/org/openapitools/openapi-generator-cli/6.5.0-SNAPSHOT/) | 28.04.2023 | Minor release with breaking changes (with fallback) |
| [6.5.0](https://github.com/OpenAPITools/openapi-generator/releases/tag/v6.5.0) (latest stable release) | 01.04.2023 | Minor release with breaking changes (with fallback) |
| [5.4.0](https://github.com/OpenAPITools/openapi-generator/releases/tag/v5.4.0) | 31.01.2022 | Minor release with breaking changes (with fallback) |
For old releases, please refer to the [**Release**](https://github.com/OpenAPITools/openapi-generator/releases) page.
For decomissioned generators/libraries/frameworks, please refer to [the "Decommission" label](https://github.com/OpenAPITools/openapi-generator/issues?q=label%3ADecommission+is%3Amerged+) in the pull request page.
## [1.2 - Artifacts on Maven Central](#table-of-contents)
You can find our released artifacts on maven central:
@@ -175,16 +182,16 @@ See the different versions of the [openapi-generator-cli](https://search.maven.o
<!-- 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):
JAR location: `https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/6.2.0/openapi-generator-cli-6.2.0.jar`
JAR location: `https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/6.5.0/openapi-generator-cli-6.5.0.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.
(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 -->
You can also download the JAR (latest release) directly from [maven.org](https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/6.2.0/openapi-generator-cli-6.2.0.jar)
You can also download the JAR (latest release) directly from [maven.org](https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/6.5.0/openapi-generator-cli-6.5.0.jar)
<!-- /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`
@@ -581,8 +602,9 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
- [Angular.Schule](https://angular.schule/)
- [Aqovia](https://aqovia.com/)
- [Australia and New Zealand Banking Group (ANZ)](http://www.anz.com/)
- [ASKUL](https://www.askul.co.jp)
- [Arduino](https://www.arduino.cc/)
- [ASKUL](https://www.askul.co.jp)
- [Amazon Web Services (AWS)](https://aws.amazon.com/)
- [b<>com](https://b-com.com/en)
- [百度营销](https://e.baidu.com)
- [Bandwidth](https://dev.bandwidth.com)
@@ -606,6 +628,7 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
- [DB Systel](https://www.dbsystel.de)
- [Deeporute.ai](https://www.deeproute.ai/)
- [Devsupply](https://www.devsupply.com/)
- [dmTECH GmbH](https://www.dmTECH.de)
- [DocSpring](https://docspring.com/)
- [dwango](https://dwango.co.jp/)
- [Edge Impulse](https://www.edgeimpulse.com/)
@@ -870,6 +893,7 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
- 2022-04-06 - [Effective Software Development using OpenAPI Generator](https://apexlabs.ai/post/openapi-generator) by Ajil Oommen (Senior Flutter Developer)
- 2022-05-13 - [A Path From an API To Client Libraries](https://www.youtube.com/watch?v=XC8oVn_efTw) by [Filip Srnec](https://www.devoxx.co.uk/talk/?id=11211) at Infobip
- 2022-06-01 - [API First, using OpenAPI and Spring Boot](https://medium.com/xgeeks/api-first-using-openapi-and-spring-boot-2602c04bb0d3) by [Micael Estrázulas Vianna](https://estrazulas.medium.com/)
- 2022-06-12 - [Mustache templates with OpenAPI specs](https://medium.com/geekculture/mustache-templates-with-openapi-specs-f24711c67dec) by [Beppe Catanese](https://github.com/gcatanese)
- 2022-07-01 - [Generate API contract using OpenAPI Generator Maven plugin](https://huongdanjava.com/generate-api-contract-using-openapi-generator-maven-plugin.html) by [Khanh Nguyen](https://huongdanjava.com/)
- 2022-07-22 - [使用OpenAPI Generator Maven plugin开发api优先的java客户端和服务端代码](https://blog.roccoshi.top/2022/java/openapi-generator%E7%9A%84%E4%BD%BF%E7%94%A8/) by [Lincest](https://github.com/Lincest)
- 2022-08-01 - [Tutorial: Etsy Open API v3 (ruby)](https://blog.tjoyal.dev/etsy-open-api-v3/) by [Thierry Joyal](https://github.com/tjoyal)
@@ -877,6 +901,14 @@ Here are some companies/projects (alphabetical order) using OpenAPI Generator in
- 2022-10-01 - [OpenAPI Generatorをカスタマイズしたコードを生成する（Swagger Codegenとほぼ同じ）](https://nainaistar.hatenablog.com/entry/2022/10/03/120000) by [きり丸](https://twitter.com/nainaistar)
- 2022-10-21 - [Kotlin（Spring Boot）の API を OpenAPI Generator で自動生成](https://zenn.dev/msksgm/articles/20221021-kotlin-spring-openapi-generator) by [msksgm](https://zenn.dev/msksgm)
- 2022-11-28 - [The REST API implementation flow](https://tmsvr.com/openapi-code-generation-for-rest-apis/) by [Imre Tömösvári](https://tmsvr.com/author/imre/)
- 2022-12-13 - [API-First with Spring WebFlux and OpenAPI Generator](https://boottechnologies-ci.medium.com/api-first-with-spring-webflux-and-openapi-generator-38b7804c4ed4) by [Eric Anicet](https://boottechnologies-ci.medium.com/)
- 2023-01-06 - [Major Improvements with Helidon and OpenAPI](https://medium.com/helidon/major-improvements-with-helidon-and-openapi-f76a0951508e) by [Tim Quinn](https://medium.com/@tquinno600)
- 2023-02-02 - [Replacing Postman with the Jetbrains HTTP Client](https://lengrand.fr/replacing-postman-in-seconds-with-the-jetbrains-http-client/) by [julien Lengrand-Lambert](https://github.com/jlengrand)
- 2023-03-15 - [OpenAPI Generatorに適したOpenAPIの書き方](https://techblog.zozo.com/entry/how-to-write-openapi-for-openapi-generator) by [ZOZO Tech Blog](https://techblog.zozo.com/)
- 2023-03-19 - [EXOGEM: Extending OpenAPI Generator for Monitoring of RESTful APIs](https://link.springer.com/chapter/10.1007/978-3-031-26507-5_10) by Daniel Friis Holtebo, Jannik Lucas Sommer, Magnus Mølgaard Lund, Alessandro Tibo, Junior Dongo & Michele Albano at "ICSOC 2022: Service-Oriented Computing – ICSOC 2022 Workshops"
- 2023-03-28 - [API-First Design with OpenAPI Generator](https://www.linkedin.com/pulse/api-first-design-openapi-generator-jonathan-manera/) by [Jonathan Manera](https://www.linkedin.com/in/manerajona/)
- 2023-03-28 - [ハンズオンで学ぶサーバーサイド Kotlin（Spring Boot&Arrow&OpenAPI Generator）v1.0.1](https://zenn.dev/msksgm/books/implementing-server-side-kotlin-development) by [msk](https://zenn.dev/msksgm)
## [6 - About Us](#table-of-contents)
@@ -946,13 +978,15 @@ Here is a list of template creators:
gradleProperties:"\n# JVM arguments\norg.gradle.jvmargs=-Xmx2024m -XX:MaxPermSize=512m\n# set timeout\norg.gradle.daemon.idletimeout=3600000\n# show all warnings\norg.gradle.warning.mode=all"
Some files were not shown because too many files have changed in this diff
Show More
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
