Auto-generate swagger.json

[jvmlet]

Would you please provide the sample of how to auto-generate swagger.json during build to use it for clients/dtos bindings generation for different languages later.
I see Microsoft.Azure.WebJobs.Extensions.OpenApi.CLI project that looks like doing exactly this, but it's not published as nuget package.
Thanks

[wis3guy]

I second that request, as we need the static file to be present for NSwag to generate our clients during CI/CD.

[jvmlet]

@wis3guy I bypass this limitation by running the function locally (during CI build) with docker compose and azurite container. Then I provide http://myapp/api/swagger.json to NSwag.

[StefanSchoof]

This sound very similar to #58

[justinyoo]

@jvmlet Thanks for the issue! Yes, we're aware of that, but it's de-priotised over other issues. Let's keep this open for further discussion.

[justinyoo]

Related: #343

[justinyoo]

As the PR, #489, has been merged, you can generate the OpenAPI doc on-the-fly, within the GitHub Actions workflow.