Improved caching and utils structure

modules/utils/autocomplete_utils.py

@@ -0,0 +1,62 @@
+from datetime import datetime
+from typing import Any, Dict, List
+from zoneinfo import ZoneInfo, available_timezones
+
+from bson import ObjectId
+from discord import AutocompleteContext, OptionChoice
+from pymongo import ASCENDING
+
+from modules.database import col_events, col_stages
+
+
+async def autocomplete_timezones(ctx: AutocompleteContext) -> List[str]:
+    """Return available timezones"""
+
+    return sorted(list(available_timezones()))
+
+
+async def autocomplete_languages(ctx: AutocompleteContext) -> List[str]:
+    """Return locales supported by the bot"""
+
+    # TODO Discord normally uses a different set of locales.
+    #  For example, "en" being "en-US", etc. This will require changes to locale handling later.
+    return ctx.bot.locales.keys()
+
+
+async def autocomplete_active_events(ctx: AutocompleteContext) -> List[OptionChoice]:
+    """Return list of active events"""
+
+    query: Dict[str, Any] = {
+        "ended": None,
+        "ends": {"$gt": datetime.now(tz=ZoneInfo("UTC"))},
+        "cancelled": {"$ne": True},
+    }
+
+    event_names: List[OptionChoice] = []
+
+    async for result in col_events.find(query):
+        event_names.append(OptionChoice(result["name"], str(result["_id"])))
+
+    return event_names
+
+
+async def autocomplete_event_stages(ctx: AutocompleteContext) -> List[OptionChoice]:
+    """Return list of stages of the event"""
+
+    event_id: str | None = ctx.options["event"]
+
+    if event_id is None:
+        return []
+
+    query: Dict[str, Any] = {
+        "event_id": ObjectId(event_id),
+    }
+
+    event_stages: List[OptionChoice] = []
+
+    async for result in col_stages.find(query).sort([("sequence", ASCENDING)]):
+        event_stages.append(
+            OptionChoice(f"{result['sequence']+1} ({result['question']})", str(result["_id"]))
+        )
+
+    return event_stages