swagger working v1

Author: PRITAM CHAKRABORTY

blogapp/views.py

@@ -21,6 +21,10 @@
 
 
 class BloggerViewSet(ModelViewSet):
+    """ Blogger can retrive own details as well as others detail, but can only perform update,delete for own
+        list:
+            to get all bloggers
+    """
     http_method_names = ["get", "patch", "delete", "head", "options"]
     filter_backends = [
         DjangoFilterBackend,

core/settings/common.py

@@ -31,6 +31,8 @@
     'django.contrib.messages',
     'django.contrib.staticfiles',
     # 3rd party apps
+    # 'django.contrib.staticfiles',  # required for serving swagger ui's css/js files
+    'drf_yasg',
     # "debug_toolbar",
     'rest_framework',
     'djoser',

core/urls.py

@@ -13,21 +13,44 @@
     1. Import the include() function: from django.urls import include, path
     2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
 """
-from django.conf import settings ,urls
+from django.conf import settings, urls
 from django.contrib import admin
 from django.urls import path, include
 from django.conf.urls.static import static
 
+# DRF_YASG
+from rest_framework import permissions
+from drf_yasg.views import get_schema_view
+from drf_yasg import openapi
+
+
+schema_view = get_schema_view(
+    openapi.Info(
+        title="Blogapp API",
+        default_version='v1',
+        description="Test description",
+        # terms_of_service="https://www.google.com/policies/terms/",
+        # contact=openapi.Contact(email="pritam.chk98@gmail.com"),
+        # license=openapi.License(name="BSD License"),
+    ),
+    public=True,
+    permission_classes=[permissions.AllowAny],
+)
+# DRF_YASG
+
+
 urlpatterns = [
     path('admin/', admin.site.urls),
     path('auth/', include('djoser.urls')),
     path('auth/', include('djoser.urls.jwt')),
     # path('api-auth/', include('rest_framework.urls', namespace='rest_framework')),
     # own app routes
     path('blogapp/', include("blogapp.urls")),
+    #FIXME: drf_yasg url
+    path('', schema_view.with_ui('swagger', cache_timeout=0), name='schema-swagger-ui'),
 ]
 # urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
 
 if settings.DEBUG:
     import debug_toolbar
-    urlpatterns+=path("__debug__/", include(debug_toolbar.urls)),
+    urlpatterns += path("__debug__/", include(debug_toolbar.urls)),