search

axnsan12 / drf-yasg

Automated generation of real Swagger/OpenAPI 2.0 schemas from Django REST Framework code.
https://drf-yasg.readthedocs.io/en/stable/
Other
3.41k stars 438 forks source link

Support django-rest-swagger style YAML docstrings #41

Open axnsan12 opened 6 years ago

axnsan12 commented 6 years ago

See http://django-rest-swagger.readthedocs.io/en/stable-0.3.x/yaml.html

Sometimes it can be easier to specify overrides in docstrings rather than code - for example, complex Schema, Parameter or Response objects. It could be worth looking into also being able to supply swagger_auto_schema overrides as YAML in view docstrings.

Opa- commented 6 years ago

This would be cool to handle extra headers parameters type 😃