Plumber: Improved swagger (Docstrings?)

[EDiLD]

I have the impresseion the swagger/openapi funtionality is not fully implemented.
E.g. parameter for POST body defintion, as in http://petstore.swagger.io/#/pet/addPet.

#* @param body:body*

will give an error.

The approach in RRestserve http://restrserve.org/quick-start.html#swagger_ui_and_openapi via docstrings seems more flexible, but more ugly to write/ maintain.

Any ideas how to improve this in plumber? I like the roxygen style, but it needs much more functionality. If you point me in the correct direction, I could try to prepare a PR...

[schloerke]

plumber needs a new body type and how to handle it for swagger.

• type: https://github.com/trestletech/plumber/blob/1332047d57242404c6ccb2ba5a28bd1255b8d2bd/R/swagger.R#L12
• handle by setting location to 'body': https://github.com/trestletech/plumber/blob/1332047d57242404c6ccb2ba5a28bd1255b8d2bd/R/swagger.R#L77

When reading the type, it should throw an error if the route is not a POST.

[EDiLD]

It's not only about body, but also about full implementation of swagger & openapi specification.

[schloerke]

Have talked with a team member. Updates are in the works. 😃

[schloerke]

Closing as arrays are now supported and the router object can also set the openapi yaml information using pr_set_api_spec()