search

OpenAPITools / openapi-generator

OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
https://openapi-generator.tech
Apache License 2.0
21.77k stars 6.57k forks source link

Can't get Templates to work #7450

Open AndyMedtronic opened 4 years ago

AndyMedtronic commented 4 years ago

I think this is more of a problem with documentation or my stupidity, and I apologize if this has been answered before, (but my search didn't reveal an easy answer) but I can't get Templates noticed with my AspNetCore project

I installed OpenApi-generator with NPM and I can see the openapi-generator jar file in C:\Users\robera22\AppData\Roaming\npm\node_modules\@openapitools\openapi-generator-cli\bin.

If I make changes to this (WinZip, don't unpack, change e.g. aspnetcore/3.0/Controller.mustache, save mustache, save zip) then generation works with my command line and I can see the changes I have made.

openapi-generator generate ^ -i Planning\OpenApi\ToolboxV3\MmtBatchWizard.v1.yaml ^ -g aspnetcore ^ -o Servers\v30Local4 ^ -t Servers\Templates ^ --additional-properties=^ aspnetCoreVersion=3.0,^ operationIsAsync=true,^ packageName=Medtronic.Toolbox.MmtBatchWizard,^ packageTitle=MedtronicToolboxSandbox,^ packageVersion=3.0

However this is horribly cumbersome, and takes forever to re-jar the large openapi-generator file

The documentation suggests that I should be able to specify single templates so I set up a Template folder.

First I placed a single amended Mustache File in there (Controller.mustache), no effect Then I copied the whole aspnetcore/3.0 folder there Then the aspnetcore Then the openapi-generator folder Then the openapi-generator.jar file

None of these had any effect. Still picking up the amendments in the npm/@openapitools

What am I doing wrong in what should be a very simple use case

auto-labeler[bot] commented 4 years ago

👍 Thanks for opening this issue! 🏷 I have applied any labels matching special text in your issue.

The team will review the labels and make any necessary changes.

jimschubert commented 4 years ago

@AndyMedtronic you're likely being bitten by case-sensitivity issues. If you create a directory called Templates and you're using aspnetcore 3.0, you'd create Templates\3.0\controller.mustache. When you run, you point to Templates as you've shown in your example.

We do sometimes have issues with Windows paths. If possible, please try in gitbash or other terminal with Linux style file separators. I've recently fixed an issue with Windows file separators in master which will be included in the 5.0.0 release.