Consider using flask-restplus in favour of flask-restful+flask-restful-swagger
kbevers opened this issue · comments
flask-restplus
is a fork of flask-restful
which includes support for Swagger, alleviating the need for the flask-restful-swagger
package which isn't properly available via Conda (and generally not maintained it would seem).
Switching to flask-restplus
is just a matter of changing the imports in webproj\api.py
and removing the flask-restful-swagger
import. Once the change is made the root entry-point display a nice documentation web page like this:
The documentation can be tweaked from the Python code. A quick guide to flask-restplus
can be found here: https://towardsdatascience.com/working-with-apis-using-flask-flask-restplus-and-swagger-ui-7cf447deda7f
Nice. I did not know this.
sweet - mange tak
@larsnaesbye Remember to update the Conda environment files too, otherwise Travis will fail
Oh, right. I don't use conda myself - I'll fix it.