django-3.2版本使用-swagger

1. 安装

   pip install django-rest-swagger
   

2. 接入

   在settings.py 的 INSTALLED_APPS 添加

   'rest_framework_swagger',
   

   在主 urls.py 文件中增加

   from rest_framework_swagger.views import get_swagger_view
   schema_view = get_swagger_view(title="Notes API")
   
   urlpatterns = [
       #    path('admin/', admin.site.urls),
       path("cmdb/", include("cmdb.urls")),
       path('api/jwtauth/', include('user.urls'), name='jwtauth'),     
       path('api/docs/', schema_view),  # 增加的内容
   ]
   

3. 解决兼容性问题

   rest_framework_swagger 目前只支持 django 2+ ,django 3.2 版本是不支持的。

   报错内容：

   django.template.exceptions.TemplateSyntaxError: 'staticfiles' is not a registered tag library. Must be one of:
   

   解决办法

   找到我们安装包的位置，一般都在 site-packages/rest_framework_swagger/templates/rest_framework_swagger

   该目录下有一个index.html文件，把文件中第二行的{% load staticfiles %}修改为{% load static %}。修改完重新刷新文档页面。