From 25a9a0b4f70d4ab1141fe03bfa109f046e7462a4 Mon Sep 17 00:00:00 2001
From: sushichan044 <mail@sushichan.live>
Date: Fri, 25 Oct 2024 21:33:37 +0900
Subject: [PATCH] docs: /v1/data/topics

---
 api/birdxplorer_api/routers/data.py        | 4 ++--
 api/birdxplorer_api/routers/openapi_doc.py | 6 ++++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/api/birdxplorer_api/routers/data.py b/api/birdxplorer_api/routers/data.py
index 20a8d9f..bc4139d 100644
--- a/api/birdxplorer_api/routers/data.py
+++ b/api/birdxplorer_api/routers/data.py
@@ -21,7 +21,7 @@
 )
 from birdxplorer_common.storage import Storage
 
-from .openapi_doc import V1DataNotesDocs, V1DataPostsDocs
+from .openapi_doc import V1DataNotesDocs, V1DataPostsDocs, V1DataTopicsDocs
 
 
 class TopicListResponse(BaseModel):
@@ -67,7 +67,7 @@ def get_user_enrollment_by_participant_id(
             raise ValueError(f"participant_id={participant_id} not found")
         return res
 
-    @router.get("/topics", response_model=TopicListResponse)
+    @router.get("/topics", description=V1DataTopicsDocs.description, response_model=TopicListResponse)
     def get_topics() -> TopicListResponse:
         return TopicListResponse(data=list(storage.get_topics()))
 
diff --git a/api/birdxplorer_api/routers/openapi_doc.py b/api/birdxplorer_api/routers/openapi_doc.py
index 9beb9fd..498cea8 100644
--- a/api/birdxplorer_api/routers/openapi_doc.py
+++ b/api/birdxplorer_api/routers/openapi_doc.py
@@ -348,3 +348,9 @@ class FastAPIEndpointDocs(Generic[_KEY]):
     },
 )
 
+# 第2引数を空の辞書にすると mypy に怒られる
+# が、第2引数が空の辞書でも怒られない実装にすると param 辞書の補完が効かなくなるので、エラーを無視する
+V1DataTopicsDocs = FastAPIEndpointDocs(
+    "自動分類されたコミュニティノートのトピックを取得するエンドポイント",
+    {},  # type: ignore[var-annotated]
+)