api: add route to reverse search files by hash

Author: avivace

hhub/urls.py

@@ -37,6 +37,7 @@
                     name="swagger-ui",
                 ),
                 path("entry/<slug:pk>.json", views.entry_manifest),
+                path("hash/<slug:hash>", views.search_hash),
                 path("stats", views.stats),
                 path("search", views.search_entries),
             ]

hhub/views.py

@@ -2,13 +2,12 @@
 
 from django.core.paginator import EmptyPage, PageNotAnInteger, Paginator
 from django.db.models import F, Q
-from django.http import JsonResponse
+from django.http import JsonResponse, Http404
 
-from hhub.models import Entry
+from hhub.models import Entry, File
 from hhub.serializers import EntrySerializer
 
-from drf_spectacular.utils import extend_schema
-from drf_spectacular.types import OpenApiTypes
+from drf_spectacular.utils import extend_schema, OpenApiTypes
 
 from rest_framework.decorators import api_view
 
@@ -34,6 +33,34 @@ def entry_manifest(request, pk):
     return JsonResponse(merged_json_data)
 
 
+def search_hash(request, hash):
+    """
+    GET /search/<hash>/
+    -------------------
+    • 404  if no File rows match *hash*
+    • JSON list of File rows otherwise (length ≥ 1)
+
+    The response body is **always** a list.
+    Use `safe=False` so `JsonResponse` can emit a top-level JSON array.
+    """
+    qs = File.objects.filter(file_hash=hash).select_related("entry")
+
+    if not qs.exists():
+        raise Http404("No file found with given hash")
+
+    payload = [_file_payload(f) for f in qs]
+
+    return JsonResponse(payload, safe=False)
+
+
+def _file_payload(f):
+    """Serialize a File instance into a plain-dict."""
+    return {
+        "entry_id": f.entry_id,
+        "name": f.name,
+    }
+
+
 def search_entries(request):
     """
     Returns every entry matching the conditions given in the query