Fork me on GitHub

django-3.2版本使用-swagger

  1. 安装

    pip install django-rest-swagger
    
  2. 接入

    settings.pyINSTALLED_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 %}。修改完重新刷新文档页面。

posted @ 2021-10-31 10:08  自由早晚乱余生  阅读(741)  评论(0编辑  收藏  举报