[RFE] Create OpenAPI Spec

[StykMartin]

Is your feature request related to a problem? Please describe. The Beaker Server and Beaker Labcontroller API are not properly documented.

Describe the solution you'd like Create OpenAPI Spec for Beaker Server and Beaker Labcontroller. This will be the source of truth for implementation.

Endpoints currently exposed via XMLRPC and/or TurboGears will be removed as part of the transition to Python 3. There is no need to document them at all. They will be reintroduced as REST (we will need them to paint the UI, communicate with client, etc..)

Describe alternatives you've considered Avoid writing documentation, but I felt like people might not like it.

[StykMartin]

Based on the discussion we had, I think you might want to take a look at this @p3ck

[mdujava]

Some generated documentation can be accessed on http://lab-controller-fqdn:8000/server. It would be ideal to get openapi spec generated from xmlrpc/turbogears directly, but few minutes searching on web did not reveal any out-of-the-box tool for it.

[StykMartin]

The goal is to get rid of XMLRPC and Turbogears, so tooling is not necessary in this case.

[StykMartin]

But good point @mdujava, I updated the description to make that clear.

[mdujava]

Yeah, I would say when creating new REST api that would preserve functionality, would be easier and less problems would be introduced when existing API would be somehow defined (eg. list of all methods/endpoints).