Coverage for app/backend/src/tests/fixtures/api/conversations.py: 97%
87 statements
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-20 12:21 +0000
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-20 12:21 +0000
1from collections.abc import Sequence
2from contextlib import contextmanager
3from datetime import timedelta
4from typing import cast
6import grpc
7from google.protobuf import duration_pb2, wrappers_pb2
9from couchers.proto import conversations_pb2, conversations_pb2_grpc
10from couchers.servicers.conversations import Conversations
11from tests.fixtures.misc import Moderator
12from tests.fixtures.sessions import FakeChannel
15@contextmanager
16def _conversations_session(token: str):
17 channel = FakeChannel(token)
18 conversations_pb2_grpc.add_ConversationsServicer_to_server(Conversations(), cast(grpc.Server, channel))
19 yield conversations_pb2_grpc.ConversationsStub(cast(grpc.Channel, channel))
22def list_group_chats(
23 *,
24 token: str,
25 last_message_id: int | None = None,
26 number: int | None = None,
27 only_archived: bool | None = None,
28) -> conversations_pb2.ListGroupChatsRes:
29 with _conversations_session(token) as session:
30 res: conversations_pb2.ListGroupChatsRes = session.ListGroupChats(
31 conversations_pb2.ListGroupChatsReq(
32 last_message_id=last_message_id, number=number, only_archived=only_archived
33 )
34 )
35 return res
38def list_message_threads(
39 *,
40 token: str,
41 page_size: int | None = None,
42 page_token: str | None = None,
43 categories: Sequence[conversations_pb2.MessageThreadCategory.ValueType] | None = None,
44 only_archived: bool | None = None,
45 only_unread: bool = False,
46) -> conversations_pb2.ListMessageThreadsRes:
47 with _conversations_session(token) as session:
48 res: conversations_pb2.ListMessageThreadsRes = session.ListMessageThreads(
49 conversations_pb2.ListMessageThreadsReq(
50 page_size=page_size,
51 page_token=page_token,
52 categories=categories,
53 only_archived=only_archived,
54 only_unread=only_unread,
55 )
56 )
57 return res
60def mark_all_threads_seen(
61 *,
62 token: str,
63 categories: Sequence[conversations_pb2.MessageThreadCategory.ValueType] | None = None,
64 only_archived: bool | None = None,
65 only_unread: bool = False,
66) -> None:
67 with _conversations_session(token) as session:
68 session.MarkAllThreadsSeen(
69 conversations_pb2.MarkAllThreadsSeenReq(
70 categories=categories, only_archived=only_archived, only_unread=only_unread
71 )
72 )
75def get_group_chat(*, token: str, group_chat_id: int) -> conversations_pb2.GroupChat:
76 with _conversations_session(token) as session:
77 group_chat: conversations_pb2.GroupChat = session.GetGroupChat(
78 conversations_pb2.GetGroupChatReq(group_chat_id=group_chat_id)
79 )
80 return group_chat
83def get_direct_message(*, token: str, user_id: int) -> conversations_pb2.GroupChat:
84 with _conversations_session(token) as session:
85 group_chat: conversations_pb2.GroupChat = session.GetDirectMessage(
86 conversations_pb2.GetDirectMessageReq(user_id=user_id)
87 )
88 return group_chat
91def get_updates(*, token: str, newest_message_id: int = 0) -> conversations_pb2.GetUpdatesRes:
92 with _conversations_session(token) as session:
93 res: conversations_pb2.GetUpdatesRes = session.GetUpdates(
94 conversations_pb2.GetUpdatesReq(newest_message_id=newest_message_id)
95 )
96 return res
99def get_group_chat_messages(
100 *,
101 token: str,
102 group_chat_id: int,
103 last_message_id: int | None = None,
104 number: int | None = None,
105 only_unseen: bool = False,
106) -> conversations_pb2.GetGroupChatMessagesRes:
107 with _conversations_session(token) as session:
108 res: conversations_pb2.GetGroupChatMessagesRes = session.GetGroupChatMessages(
109 conversations_pb2.GetGroupChatMessagesReq(
110 group_chat_id=group_chat_id, last_message_id=last_message_id, number=number, only_unseen=only_unseen
111 )
112 )
113 return res
116def mark_last_seen_group_chat(*, token: str, group_chat_id: int, last_seen_message_id: int) -> None:
117 with _conversations_session(token) as session:
118 session.MarkLastSeenGroupChat(
119 conversations_pb2.MarkLastSeenGroupChatReq(
120 group_chat_id=group_chat_id, last_seen_message_id=last_seen_message_id
121 )
122 )
125def mute_group_chat(
126 *,
127 token: str,
128 group_chat_id: int,
129 # Exactly one of these should be set, mirroring the request's oneof.
130 unmute: bool | None = None,
131 forever: bool | None = None,
132 for_duration: timedelta | None = None,
133) -> None:
134 with _conversations_session(token) as session:
135 session.MuteGroupChat(
136 conversations_pb2.MuteGroupChatReq(
137 group_chat_id=group_chat_id,
138 unmute=unmute,
139 forever=forever,
140 for_duration=duration_pb2.Duration(seconds=int(for_duration.total_seconds()))
141 if for_duration is not None
142 else None,
143 )
144 )
147def set_group_chat_archive_status(
148 *, token: str, group_chat_id: int, is_archived: bool
149) -> conversations_pb2.SetGroupChatArchiveStatusRes:
150 with _conversations_session(token) as session:
151 res: conversations_pb2.SetGroupChatArchiveStatusRes = session.SetGroupChatArchiveStatus(
152 conversations_pb2.SetGroupChatArchiveStatusReq(group_chat_id=group_chat_id, is_archived=is_archived)
153 )
154 return res
157def create_group_chat(
158 *,
159 token: str,
160 recipient_user_ids: Sequence[int],
161 title: str | None = None,
162 approve_by: Moderator | None = None,
163) -> conversations_pb2.GroupChat:
164 with _conversations_session(token) as session:
165 group_chat: conversations_pb2.GroupChat = session.CreateGroupChat(
166 conversations_pb2.CreateGroupChatReq(
167 title=wrappers_pb2.StringValue(value=title) if title is not None else None,
168 recipient_user_ids=recipient_user_ids,
169 )
170 )
172 if approve_by is not None:
173 approve_by.approve_group_chat(group_chat.group_chat_id)
175 return group_chat
178def edit_group_chat(
179 *,
180 token: str,
181 group_chat_id: int,
182 # None leaves the field unchanged.
183 title: str | None = None,
184 only_admins_invite: bool | None = None,
185) -> None:
186 with _conversations_session(token) as session:
187 session.EditGroupChat(
188 conversations_pb2.EditGroupChatReq(
189 group_chat_id=group_chat_id,
190 title=wrappers_pb2.StringValue(value=title) if title is not None else None,
191 only_admins_invite=wrappers_pb2.BoolValue(value=only_admins_invite)
192 if only_admins_invite is not None
193 else None,
194 )
195 )
198def invite_to_group_chat(*, token: str, group_chat_id: int, user_id: int) -> None:
199 with _conversations_session(token) as session:
200 session.InviteToGroupChat(conversations_pb2.InviteToGroupChatReq(group_chat_id=group_chat_id, user_id=user_id))
203def make_group_chat_admin(*, token: str, group_chat_id: int, user_id: int) -> None:
204 with _conversations_session(token) as session:
205 session.MakeGroupChatAdmin(
206 conversations_pb2.MakeGroupChatAdminReq(group_chat_id=group_chat_id, user_id=user_id)
207 )
210def remove_group_chat_user(*, token: str, group_chat_id: int, user_id: int) -> None:
211 with _conversations_session(token) as session:
212 session.RemoveGroupChatUser(
213 conversations_pb2.RemoveGroupChatUserReq(group_chat_id=group_chat_id, user_id=user_id)
214 )
217def remove_group_chat_admin(*, token: str, group_chat_id: int, user_id: int) -> None:
218 with _conversations_session(token) as session:
219 session.RemoveGroupChatAdmin(
220 conversations_pb2.RemoveGroupChatAdminReq(group_chat_id=group_chat_id, user_id=user_id)
221 )
224def send_message(*, token: str, group_chat_id: int, text: str = "Dummy message.") -> None:
225 with _conversations_session(token) as session:
226 session.SendMessage(conversations_pb2.SendMessageReq(group_chat_id=group_chat_id, text=text))
229def send_direct_message(*, token: str, recipient_user_id: int, text: str = "Dummy message.") -> int:
230 with _conversations_session(token) as session:
231 res: conversations_pb2.SendDirectMessageRes = session.SendDirectMessage(
232 conversations_pb2.SendDirectMessageReq(recipient_user_id=recipient_user_id, text=text)
233 )
234 return res.group_chat_id
237def leave_group_chat(*, token: str, group_chat_id: int) -> None:
238 with _conversations_session(token) as session:
239 session.LeaveGroupChat(conversations_pb2.LeaveGroupChatReq(group_chat_id=group_chat_id))
242def search_messages(
243 *, token: str, query: str, last_message_id: int | None = None, number: int | None = None
244) -> conversations_pb2.SearchMessagesRes:
245 with _conversations_session(token) as session:
246 res: conversations_pb2.SearchMessagesRes = session.SearchMessages(
247 conversations_pb2.SearchMessagesReq(query=query, last_message_id=last_message_id, number=number)
248 )
249 return res