[change] Added CSV batch download endpoint visibility on Swagger

openwisp_radius/private_storage/urls.py

@@ -16,5 +16,13 @@ def get_private_store_urls():
             urljoin(app_settings.CSV_URL_PATH, "<path:path>"),
             views.rad_batch_csv_download_view,
             name="serve_private_file",
-        )
+        ),
+        path(
+            urljoin(
+                app_settings.CSV_URL_PATH,
+                "<slug:slug>/batch/<uuid:pk>/csv/<str:filename>/",
+            ),
+            views.RadiusBatchCsvDownloadAPIView.as_view(),
+            name="radius_organization_batch_csv_read",
+        ),
     ]

openwisp_radius/private_storage/views.py

@@ -1,4 +1,7 @@
+from drf_spectacular.types import OpenApiTypes
+from drf_spectacular.utils import OpenApiParameter, OpenApiResponse, extend_schema
 from private_storage.views import PrivateStorageDetailView
+from rest_framework.views import APIView
 
 from ..settings import PRIVATE_STORAGE_INSTANCE
 from ..utils import load_model
@@ -19,3 +22,38 @@ def can_access_file(self, private_file):
 
 
 rad_batch_csv_download_view = RadiusBatchCsvDownloadView.as_view()
+
+
+# this is a drf wrapper view
+@extend_schema(
+    operation_id="radius_organization_batch_csv_read",
+    description="Download the CSV export file for a specific RADIUS batch.",
+    parameters=[
+        OpenApiParameter(
+            name="slug",
+            type=str,
+            location=OpenApiParameter.PATH,
+            description="Organization slug",
+        ),
+        OpenApiParameter(
+            name="pk",
+            type=str,
+            location=OpenApiParameter.PATH,
+            description="Batch UUID",
+        ),
+        OpenApiParameter(
+            name="filename",
+            type=str,
+            location=OpenApiParameter.PATH,
+            description="CSV filename",
+        ),
+    ],
+    responses={
+        200: OpenApiResponse(description="CSV file", response=OpenApiTypes.BINARY)
+    },
+    tags=["radius"],
+)
+class RadiusBatchCsvDownloadAPIView(APIView):
+    def get(self, request, pk, filename):
+        view = RadiusBatchCsvDownloadView.as_view()
+        return view(request, pk=pk, filename=filename)

requirements-test.txt

@@ -12,3 +12,4 @@ cssselect~=1.3.0
 openwisp-monitoring @ https://github.com/openwisp/openwisp-monitoring/tarball/1.2
 django-redis~=6.0.0
 mock-ssh-server~=0.9.1
+drf-spectacular