JoelLefkowitz / drf-yasg

Automated generation of real Swagger/OpenAPI 2.0 schemas from Django REST Framework code.
https://drf-yasg2.readthedocs.io/en/stable/
BSD 3-Clause "New" or "Revised" License
65 stars 2 forks source link

OpenAPI3 support #73

Open esseti opened 4 years ago

esseti commented 4 years ago

As per this issue in the father project, is anything planned to finally support OpenAPI3 standards in this package?

https://github.com/axnsan12/drf-yasg/issues/33

johnthagen commented 4 years ago

It's worth mentioning that drf-spectacular exists to support this exact use case. I haven't used it personally, but from the DRF docs:

drf-spectacular is a OpenAPI 3 schema generation tool with explicit focus on extensibility, customizability and client generation. It's usage patterns are very similar to drf-yasg.

tfranzel commented 4 years ago

@johnthagen thanks for mentioning it. we exclusively do OpenAPI 3. initially, we also used yasg and thus tried staying close to yasg in terms of look and feel. some things are nearly the same, other deviate considerably. worth noting that the underlying implementation is not based on yasg, as it was initially planned to be upstreamed into DRF (which didn't pan out).

anyways, kind of sad that Christi disappeared. big thumbs up to @JoelLefkowitz for picking up yasg and maintaining it. it's still an awesome lib.

JoelLefkowitz commented 4 years ago

@johnthagen thanks for mentioning it. we exclusively do OpenAPI 3. initially, we also used yasg and thus tried staying close to yasg in terms of look and feel. some things are nearly the same, other deviate considerably. worth noting that the underlying implementation is not based on yasg, as it was initially planned to be upstreamed into DRF (which didn't pan out).

anyways, kind of sad that Christi disappeared. big thumbs up to @JoelLefkowitz for picking up yasg and maintaining it. it's still an awesome lib.

Cristsi is back and we're working on the original repo again. It is worthwhile continuing to track this issue there axnsan12#33