wekan

Commit Graph

Author	SHA1	Message	Date
Benjamin Tissoires	8be7eec2ca	openapi: make the code python 3.5 compatible It is common to use Ubuntu 16.04 to build snaps. For example, the official docker container to build snaps is using this old distribution. However, Ubuntu 16.04 ships Python 3.5.X which is not compatible with the f-strings in generate_openapi.py. This is sad, because we need to use the `.format()` syntax to make it compatible.	7 years ago
Benjamin Tissoires	49d3eb5a3f	Add OpenAPI description of the REST API The API is generated by a custom script that parses the models directory. Once the API is generated, tools like https://editor.swagger.io/ or Python bravado can parse the file and generate a language friendly API. Note that the tool generate an OpenAPI 2.0 version because bravado doesn't handle OpenAPI 3.0. The script also parses the JSDoc with a custom parser to allow customization of the description of the fields.	7 years ago

Author

SHA1

Message

Date

Benjamin Tissoires

8be7eec2ca

openapi: make the code python 3.5 compatible

It is common to use Ubuntu 16.04 to build snaps. For example,
the official docker container to build snaps is using this old
distribution.

However, Ubuntu 16.04 ships Python 3.5.X which is not compatible
with the f-strings in generate_openapi.py. This is sad, because
we need to use the `.format()` syntax to make it compatible.

7 years ago

Benjamin Tissoires

49d3eb5a3f

Add OpenAPI description of the REST API

The API is generated by a custom script that parses the models directory.
Once the API is generated, tools like https://editor.swagger.io/ or
Python bravado can parse the file and generate a language friendly API.

Note that the tool generate an OpenAPI 2.0 version because bravado
doesn't handle OpenAPI 3.0.

The script also parses the JSDoc with a custom parser to allow
customization of the description of the fields.

7 years ago

2 Commits (c42f2a05d2be5a8ef2f1c6799b7e70ef5397195c)