Add support for m.mentions in send_text_to_room (spec v1.9).

Author: svierne

matrix_reminder_bot/functions.py

@@ -17,6 +17,8 @@ async def send_text_to_room(
     notice: bool = True,
     markdown_convert: bool = True,
     reply_to_event_id: Optional[str] = None,
+    mentions_room: bool = False,
+    mentions_user_ids: Optional[list[str]] = None,
 ):
     """Send text to a matrix room.
 
@@ -35,14 +37,21 @@ async def send_text_to_room(
 
         reply_to_event_id: Whether this message is a reply to another event. The event
             ID this is message is a reply to.
+
+        mentions_room: Whether or not this message mentions the whole room.
+            Defaults to false.
+
+        mentions_user_ids: An optional list of MXIDs this message mentions.
     """
+
     # Determine whether to ping room members or not
     msgtype = "m.notice" if notice else "m.text"
 
     content = {
         "msgtype": msgtype,
         "format": "org.matrix.custom.html",
         "body": message,
+        "m.mentions": {},
     }
 
     if markdown_convert:
@@ -51,6 +60,12 @@ async def send_text_to_room(
     if reply_to_event_id:
         content["m.relates_to"] = {"m.in_reply_to": {"event_id": reply_to_event_id}}
 
+    if mentions_room:
+        content["m.mentions"]["room"] = True
+
+    if mentions_user_ids is not None:
+        content["m.mentions"]["user_ids"] = mentions_user_ids
+
     try:
         await client.room_send(
             room_id,