Ravenport: python-flask-swagger

Port variant	v12
Summary	Extract swagger specs from flask project (3.12)
BROKEN
Package version	0.2.14
Homepage	https://github.com/gangverk/flask-swagger
Keywords	python
Maintainer	Python Automaton
License	Not yet specified
Other variants	v13
Ravenports	Buildsheet \| History
Ravensource	Port Directory \| History
Last modified	11 NOV 2024, 23:28:05 UTC
Port created	08 JUN 2018, 12:20:15 UTC

Subpackage Descriptions

single

flask-swagger ============= A Swagger 2.0 spec extractor for Flask Install: :: pip install flask-swagger Flask-swagger provides a method (swagger) that inspects the Flask app for endpoints that contain YAML docstrings with Swagger 2.0 [Operation] objects. :: class UserAPI(MethodView): def post(self): """ Create a new user --- tags: - users definitions: - schema: id: Group properties: name: type: string description: the group's name parameters: - in: body name: body schema: id: User required: - email - name properties: email: type: string description: email for user name: type: string description: name for user address: description: address for user schema: id: Address properties: street: type: string state: type: string country: type: string postalcode: type: string groups: type: array description: list of groups items: $ref: "#/definitions/Group" responses: 201: description: User created """ return {} Flask-swagger supports docstrings in methods of MethodView classes and regular Flask view functions. Following YAML conventions, flask-swagger searches for ``---``, everything preceding is provided as summary (first line) and description (following lines) for the endpoint while everything after is parsed as a swagger [Operation] object. In order to support inline definition of [Schema] objects in [Parameter] and [Response] objects, flask-swagger veers a little off from the standard. We require an id field for the inline Schema which is then used to correctly place the [Schema] object in the [Definitions] object. [Schema] objects can be defined in a definitions section within the docstrings (see group object above) or within responses or parameters (see user object above). We alo support schema objects nested within the properties of other

Build (only)	python312:dev:std python-setuptools:single:v12 autoselect-python:single:std
Build and Runtime	python-Flask:single:v12 python-PyYAML:single:v12 python312:primary:std