Add swagger api docs to the scaffold (#25)

* Feature: Swagger API Docs

- Installs drf_yasg
- Adds /api-docs url to view swaggerui

* Add packaging to Pipfile

`drf_yasg` needs `packaging` as per open issue:
axnsan12/drf-yasg#412

* Remove commented config

{{cookiecutter.project_slug}}/Pipfile

@@ -19,6 +19,8 @@ django-bootstrap4 = "~=0.0.8"
 django-allauth = "~=0.39.1"
 django-rest-auth = "~=0.9.5"
 django-extensions = "~=2.1.9"
+packaging = "*"
+drf-yasg = "~=1.16.1"
 {% if cookiecutter.is_mobile == "y" %}
 fcm-django = "~=0.2.21"
 {% endif %}

{{cookiecutter.project_slug}}/{{cookiecutter.project_slug}}/settings.py

@@ -61,6 +61,7 @@
     'allauth.socialaccount',
     'allauth.socialaccount.providers.google',
     'django_extensions',
+    'drf_yasg',
 {% if cookiecutter.is_mobile == "y" %}
     # start fcm_django push notifications
     'fcm_django',

{{cookiecutter.project_slug}}/{{cookiecutter.project_slug}}/urls.py

@@ -16,6 +16,9 @@
 from django.contrib import admin
 from django.urls import path, include
 from allauth.account.views import confirm_email
+from rest_framework import permissions
+from drf_yasg.views import get_schema_view
+from drf_yasg import openapi
 
 urlpatterns = [
     path('', include('home.urls')),
@@ -32,3 +35,18 @@
 admin.site.site_header = '{{cookiecutter.project_name}}'
 admin.site.site_title = '{{cookiecutter.project_name}} Admin Portal'
 admin.site.index_title = '{{cookiecutter.project_name}} Admin'
+
+# swagger
+schema_view = get_schema_view(
+    openapi.Info(
+        title="{{cookiecutter.project_name}} API",
+        default_version="v1",
+        description="API documentation for {{cookiecutter.project_name}} App",
+    ),
+    public=True,
+    permission_classes=(permissions.IsAuthenticated,),
+)
+
+urlpatterns += [
+    path("api-docs/", schema_view.with_ui("swagger", cache_timeout=0), name="api_docs")
+]