Skip to content

[gradle-plugin] better README notes on multiple specs#847

Merged
jimschubert merged 1 commit intomasterfrom
gradle-plugin-readme-update
Aug 19, 2018
Merged

[gradle-plugin] better README notes on multiple specs#847
jimschubert merged 1 commit intomasterfrom
gradle-plugin-readme-update

Conversation

@jimschubert
Copy link
Member

@jimschubert jimschubert commented Aug 19, 2018

A user asked about how one would approach generating code from multiple
specifications. Adding this information to the README, as it seems
others would find the information helpful. Also explaining how to use
tasks from this plugin as this may not be commonly known or intuitive
beahvior.

PR checklist

  • Read the contribution guidelines.
  • Ran the shell 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). Windows batch files can be found in .\bin\windows\.
  • Filed the PR against the correct branch: master, 3.3.x, 4.0.x. Default: master.
  • Copied the technical committee to review the pull request if your PR is targeting a particular programming language.

A user asked about how one would approach generating code from multiple
specifications. Adding this information to the README, as it seems
others would find the information helpful. Also explaining how to use
tasks from this plugin as this may not be commonly known or intuitive
beahvior.
@jimschubert jimschubert added this to the 3.2.2 milestone Aug 19, 2018
@jimschubert jimschubert merged commit 62dfb74 into master Aug 19, 2018
@jimschubert jimschubert deleted the gradle-plugin-readme-update branch August 19, 2018 20:17
@jmini jmini mentioned this pull request Aug 20, 2018
4 tasks
jimschubert added a commit that referenced this pull request Aug 21, 2018
* master:
  Fix problems in typescript jquery generator (#801)
  [PHP] Add gitignore to AbstractPhpCodegen (#765)
  Improve documentation for usage of a generator in an other jar (#817)
  Improve Symfony 4.1 compatibility (#830)
  📝 Updating 'help generate' switches in README
  [cli] Don't log to STDOUT if debug flags are set (#474)
  [gradle-plugin] README notes on multiple specs (#847)
  Added server variable support (#816)
  fix erlang optiona/required parameters (#829)
  [Java][Rest-assured] Fix generated javadoc and "swagger-annotations" improvement (#831)
@FatCash
Copy link

FatCash commented Aug 21, 2018

Superclean and pedagogical! ✅

If you want to perform multiple generation tasks, you'd want to create a task that inherits from the `GenerateTask`.
Examples can be found in https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator-gradle-plugin/samples/local-spec/build.gradle[samples/local-spec/build.gradle].

To match the example you are using for that old swagger based plugin:
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oops. I copied this from am explanation in another issue. This line needs to be removed. :x

@wing328 wing328 changed the title [gradle-plugin] README notes on multiple specs [gradle-plugin] better README notes on multiple specs Aug 22, 2018
A-Joshi pushed a commit to ihsmarkitoss/openapi-generator that referenced this pull request Feb 27, 2019
A user asked about how one would approach generating code from multiple
specifications. Adding this information to the README, as it seems
others would find the information helpful. Also explaining how to use
tasks from this plugin as this may not be commonly known or intuitive
beahvior.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants