带有 Django drf 的 OpenAPI 3

Openapi 3 with Django drf

我正在使用 Django 和 Django-Drf 编写 restful BE。

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

遗憾的是,drf-yasg 尚不支持 OpenApi3,而且在可预见的未来也不会支持。

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

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

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

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

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