Replace coreapi by drf-spectacular for API docs (#107)

Author: browniebroke

requirements.txt

@@ -2,14 +2,10 @@ djangorestframework==3.16.1
 Django==5.2.12
 Pygments==2.19.1
 Markdown==3.10.2
-coreapi==2.3.3
 inflection==0.5.1
 psycopg[binary]==3.3.3
 dj-database-url==3.1.2
 gunicorn==25.1.0
 whitenoise==6.12.0
 PyYAML==6.0.3
-# Needed by copreapi on Python 3.13+
-legacy-cgi; python_version>='3.13'
-# coreapi depends on pkg_resources which was part of setuptools until v82
-setuptools<82
+drf-spectacular==0.29.0

tutorial/settings.py

@@ -38,6 +38,7 @@
     'whitenoise.runserver_nostatic',
     'django.contrib.staticfiles',
     'rest_framework',
+    'drf_spectacular',
     'snippets.apps.SnippetsConfig',
 ]
 
@@ -127,7 +128,15 @@
     'PAGE_SIZE': 10,
     'DEFAULT_PAGINATION_CLASS':
     'rest_framework.pagination.PageNumberPagination',
-    'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.coreapi.AutoSchema'
+    'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
+}
+
+# DRF Spectacular settings
+SPECTACULAR_SETTINGS = {
+    'TITLE': 'Pastebin API',
+    'DESCRIPTION': 'A Web API for creating and viewing highlighted code snippets.',
+    'VERSION': '1.0.0',
+    'SERVE_INCLUDE_SCHEMA': False,
 }
 
 if ENVIRONMENT == 'production':

tutorial/urls.py

@@ -1,14 +1,9 @@
 from django.urls import include, path
-from rest_framework.schemas import get_schema_view
-from rest_framework.documentation import include_docs_urls
-
-API_TITLE = 'Pastebin API'
-API_DESCRIPTION = 'A Web API for creating and viewing highlighted code snippets.'
-schema_view = get_schema_view(title=API_TITLE)
+from drf_spectacular.views import SpectacularAPIView, SpectacularSwaggerView
 
 urlpatterns = [
     path('', include('snippets.urls')),
     path('api-auth/', include('rest_framework.urls', namespace='rest_framework')),
-    path('schema/', schema_view),
-    path('docs/', include_docs_urls(title=API_TITLE, description=API_DESCRIPTION))
+    path('schema/', SpectacularAPIView.as_view(), name='schema'),
+    path('docs/', SpectacularSwaggerView.as_view(url_name='schema'))
 ]