Add aiohttp-apispec auto generation of OpenAPI docs & specs

Author: MHHukiewitz

pyproject.toml

@@ -25,6 +25,7 @@ dependencies = [
   "aiocache==0.12.3",
   "aiofiles==24.1.0",
   "aiohttp==3.12.15",
+  "aiohttp-apigami==0.5.6",
   "aiohttp-cors==0.8.0",
   "aiohttp-jinja2==1.6",
   "aioipfs~=0.7.1",

src/aleph/web/__init__.py

@@ -7,6 +7,9 @@
 import jinja2
 import pkg_resources
 from aiohttp import web
+from aiohttp_apispec import (
+    setup_aiohttp_apispec,
+)
 
 from aleph.web.controllers.routes import register_routes
 
@@ -60,4 +63,13 @@ def create_aiohttp_app() -> web.Application:
 
     init_cors(app)
 
+    setup_aiohttp_apispec(
+        app=app,
+        title="Aleph",
+        version="v0",
+        url="/api/docs/json",
+        swagger_path="/api/docs",
+        swagger_ui_static_path="/api/docs/ui",
+    )
+
     return app