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

1from collections.abc import Sequence 

2from contextlib import contextmanager 

3from datetime import timedelta 

4from typing import cast 

5 

6import grpc 

7from google.protobuf import duration_pb2, wrappers_pb2 

8 

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 

13 

14 

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)) 

20 

21 

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 

36 

37 

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 

58 

59 

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 ) 

73 

74 

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 

81 

82 

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 

89 

90 

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 

97 

98 

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 

114 

115 

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 ) 

123 

124 

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 ) 

145 

146 

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 

155 

156 

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 ) 

171 

172 if approve_by is not None: 

173 approve_by.approve_group_chat(group_chat.group_chat_id) 

174 

175 return group_chat 

176 

177 

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 ) 

196 

197 

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)) 

201 

202 

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 ) 

208 

209 

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 ) 

215 

216 

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 ) 

222 

223 

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)) 

227 

228 

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 

235 

236 

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)) 

240 

241 

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