【问题标题】:Openapi 3 with Django drfOpenapi 3 与 Django drf
【发布时间】:2020-05-16 09:32:27
【问题描述】:

我正在使用 Django 和 Django-Drf 来编写一个宁静的 BE。

我也在使用 drf-yasg 为我的服务生成 swagger 方案。

不幸的是,drf-yasg 还不支持 OpenApi3,而且在可预见的将来似乎也不会支持。

是否有替代 drf-yasg,它支持 Openapi 3,我可以与 Django-Drf 一起使用?

【问题讨论】:

    标签: django django-rest-framework swagger openapi drf-yasg


    【解决方案1】:

    Django DRF 最近添加了 OpenAPI3 支持(我认为是 3.10),但它缺少 drf-yasg 的很多功能。即将发布的版本 (3.12) 将添加组件支持,但仍然缺少许多功能,例如方便的自定义选项。

    我们发现自己完全处于同样的境地。经过一番认真的搜索,我们一无所获,因此创建了 DRF OpenAPI3 实现的一个经过大量修改的分支,它正在慢慢接近 drf-yasg 的功能。

    https://github.com/tfranzel/drf-spectacular

    试一试。它仍在形成中,但已经涵盖了很多案例。欢迎反馈!

    【讨论】:

    • drf-yasg 有哪些 drf-spectacular 没有的功能?我刚刚阅读了 drf-spectacular 文档,在“从 drf-yasg 迁移”部分中,它说它们几乎是等价的。
    • @DanielGonzálezFernández 我的回答已经过去了一段时间。 drf-spectacular 有了重大改进,并且 yasg 还没有 OpenAPI3 支持。比较功能集并不容易。您必须自己比较是否满足您的要求。 (仅供参考:现在有一个维护的 yasg 分支:drf-yasg2)
    猜你喜欢
    • 1970-01-01
    • 2021-04-15
    • 2021-11-09
    • 2015-08-31
    • 1970-01-01
    • 1970-01-01
    • 2016-08-05
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多