controller icon indicating copy to clipboard operation
controller copied to clipboard

Published 20 hours ago • verified publisher icon deis

Specify the API using swagger

Open arschles opened this issue 8 years ago • 5 comments

This issue is for investigating swagger server stub code generators for Python & Django Rest Framework, and then if there is a suitable one that won't require a large refactor of this codebase, doing the following:

  1. Writing a swagger specification for the controller's full API
  2. Generating server stubs and refactoring this codebase into the stubs
  3. Generate the Go client bindings in deis/builder and deis/workflow-cli (each to be done in a separate issue in the respective repository)
    1. The changes in deis/workflow-cli may move to a new repo if https://github.com/deis/workflow-cli/issues/18 is completed first

arschles avatar Jun 10 '16 22:06 arschles

You are duplicating yourself, up to you which one you keep open

https://github.com/deis/controller/issues/289

helgi avatar Jun 10 '16 22:06 helgi

Ugh sorry. Closing the other one since this one is more specific

arschles avatar Jun 10 '16 22:06 arschles

https://github.com/marcgibbons/django-rest-swagger may be helpful for this

jgmize avatar Jun 11 '16 04:06 jgmize

Already tried it - doesn't work and isn't maintained :(

Our best bet is Marshmallow (a schema / serializer like project) and the DRF integration for that. Marshmallow has swagger and json API support as well.

Looks like DRF 3.0 is going to have Core API support (sponsored by Mozilla) but it may not be ready anytime soon

helgi avatar Jun 11 '16 04:06 helgi

Just leaving this here for now https://github.com/civisanalytics/swagger-diff, https://github.com/keis/swagger-markup and http://swagger.io/using-swagger-to-detect-breaking-api-changes/

helgi avatar Sep 15 '16 20:09 helgi