update: swagger (drf-spectacular) 추가

Author: golony6449

pyconkr/settings.py

@@ -44,6 +44,8 @@
     "constance.backends.database",
     # apps
     "sponsor",
+    # swagger
+    "drf_spectacular",
 ]
 
 MIDDLEWARE = [
@@ -145,3 +147,25 @@
         "후원사 변동사항에 대한 알림을 보낼 채널",
     ),
 }
+
+# drf-spectacular
+REST_FRAMEWORK = {
+    # YOUR SETTINGS
+    "DEFAULT_SCHEMA_CLASS": "drf_spectacular.openapi.AutoSchema",
+}
+
+SPECTACULAR_SETTINGS = {
+    "TITLE": "pyconkr-api-v2",
+    "DESCRIPTION": "파이콘 한국 웹서비스용 API (2023 ~ )",
+    "VERSION": "1.0.0",
+    "SERVE_INCLUDE_SCHEMA": True,
+    # available SwaggerUI configuration parameters
+    # https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/
+    "SWAGGER_UI_SETTINGS": {
+        "deepLinking": True,
+        "persistAuthorization": True,
+        "displayOperationId": True,
+    },
+    # available SwaggerUI versions: https://github.com/swagger-api/swagger-ui/releases
+    "SWAGGER_UI_DIST": "//unpkg.com/[email protected]",
+}

pyconkr/urls.py

@@ -16,11 +16,34 @@
 from django.contrib import admin
 from django.urls import include, path
 
+from drf_spectacular.views import (
+    SpectacularAPIView,
+    SpectacularRedocView,
+    SpectacularSwaggerView,
+)
+
 import sponsor.routers
+import pyconkr.settings as settings
 
 urlpatterns = [
     path("api-auth/", include("rest_framework.urls")),
     path("summernote/", include("django_summernote.urls")),
     path("admin/", admin.site.urls),
     path("sponsors/", include(sponsor.routers.get_router().urls)),
 ]
+
+if settings.DEBUG is True:
+    urlpatterns += [
+        path("api/schema/", SpectacularAPIView.as_view(), name="schema"),
+        # Optional UI:
+        path(
+            "api/schema/swagger-ui/",
+            SpectacularSwaggerView.as_view(url_name="schema"),
+            name="swagger-ui",
+        ),
+        path(
+            "api/schema/redoc/",
+            SpectacularRedocView.as_view(url_name="schema"),
+            name="redoc",
+        ),
+    ]

requirements.txt

@@ -14,3 +14,4 @@ django-summernote==0.8.20.0
 Pillow==9.4.0
 django-constance==2.9.1
 django-picklefield==3.1
+drf-spectacular==0.25.1