temando/serverless-openapi-documentation

Support $ref: {{model: Foo}} as in Swagger 2 plugin

Opened this issue · 6 comments

denis-sokolov commented

In Swagger 2 plugin I can reference models in other models. Most commonly, when an endpoint response model is an array containing item models. See the issue at the serverless-aws-documentation.

When I run serverless openapi generate on such configuration, I get this error:

could not dereference value as a json pointer or uri: {{model: Foo}}

Feel free to close this issue if this is not going to be added soon, but I want something to refer to and to maybe have someone explain to me why I’m wrong. :-)

whisller commented

Any news about this issue? Is there a plan to implement it?

seth9874 commented

Also wondering about news on this feature.

martinsson commented

Does anyone know of a work-around for this?

Currently we're deploying the service to amazon, then we're exporting the openapi doc from the deployed version. While this works it is very slow. Additionaly we use the openapi doc for generating the DTOs that our frontend needs. This workflow forces us to deploy the backend before we compile and test the front...

martinsson commented

This is now supported in a forked version

https://www.npmjs.com/package/@martinsson/serverless-openapi-documentation

There are some other additions too, fixing a bug where the requestModels property was ignored.
It also has tests for those features

  • 👍1
gus-tavo01 commented

Hi @martinsson would you accept any PR on your repo?

martinsson commented
  • ❤️1