# See https://zulip.readthedocs.io/en/latest/subsystems/events-system.html for # high-level documentation on how this system works. # # This module is closely integrated with zerver/lib/event_schema.py # and zerver/lib/data_types.py systems for validating the schemas of # events; it also uses the OpenAPI tools to validate our documentation. import copy import sys import time from io import StringIO from typing import Any, Callable, Dict, List, Optional, Set from unittest import mock import orjson from django.utils.timezone import now as timezone_now from zerver.lib.actions import ( bulk_add_members_to_user_group, bulk_add_subscriptions, bulk_remove_subscriptions, check_add_realm_emoji, check_add_user_group, check_delete_user_group, check_send_typing_notification, do_add_alert_words, do_add_default_stream, do_add_reaction, do_add_realm_domain, do_add_realm_filter, do_add_streams_to_default_stream_group, do_add_submessage, do_change_avatar_fields, do_change_bot_owner, do_change_default_all_public_streams, do_change_default_events_register_stream, do_change_default_sending_stream, do_change_default_stream_group_description, do_change_default_stream_group_name, do_change_full_name, do_change_icon_source, do_change_logo_source, do_change_notification_settings, do_change_plan_type, do_change_realm_domain, do_change_stream_description, do_change_stream_invite_only, do_change_stream_message_retention_days, do_change_stream_post_policy, do_change_subscription_property, do_change_user_delivery_email, do_change_user_role, do_create_default_stream_group, do_create_multiuse_invite_link, do_create_user, do_deactivate_realm, do_deactivate_stream, do_deactivate_user, do_delete_messages, do_invite_users, do_mark_hotspot_as_read, do_mute_topic, do_reactivate_user, do_regenerate_api_key, do_remove_alert_words, do_remove_default_stream, do_remove_default_stream_group, do_remove_reaction, do_remove_realm_custom_profile_field, do_remove_realm_domain, do_remove_realm_emoji, do_remove_realm_filter, do_remove_streams_from_default_stream_group, do_rename_stream, do_revoke_multi_use_invite, do_revoke_user_invite, do_set_realm_authentication_methods, do_set_realm_message_editing, do_set_realm_notifications_stream, do_set_realm_property, do_set_realm_signup_notifications_stream, do_set_user_display_setting, do_set_zoom_token, do_unmute_topic, do_update_embedded_data, do_update_message, do_update_message_flags, do_update_outgoing_webhook_service, do_update_user_custom_profile_data_if_changed, do_update_user_group_description, do_update_user_group_name, do_update_user_presence, do_update_user_status, lookup_default_stream_groups, remove_members_from_user_group, try_add_realm_custom_profile_field, try_update_realm_custom_profile_field, ) from zerver.lib.event_schema import ( check_alert_words, check_attachment_add, check_attachment_remove, check_attachment_update, check_custom_profile_fields, check_default_stream_groups, check_default_streams, check_delete_message, check_has_zoom_token, check_hotspots, check_invites_changed, check_message, check_muted_topics, check_presence, check_reaction_add, check_reaction_remove, check_realm_bot_add, check_realm_bot_delete, check_realm_bot_remove, check_realm_bot_update, check_realm_deactivated, check_realm_domains_add, check_realm_domains_change, check_realm_domains_remove, check_realm_emoji_update, check_realm_export, check_realm_filters, check_realm_update, check_realm_update_dict, check_realm_user_add, check_realm_user_remove, check_realm_user_update, check_stream_create, check_stream_delete, check_stream_update, check_submessage, check_subscription_add, check_subscription_peer_add, check_subscription_peer_remove, check_subscription_remove, check_subscription_update, check_typing_start, check_typing_stop, check_update_display_settings, check_update_global_notifications, check_update_message, check_update_message_embedded, check_update_message_flags_add, check_update_message_flags_remove, check_user_group_add, check_user_group_add_members, check_user_group_remove, check_user_group_remove_members, check_user_group_update, check_user_status, ) from zerver.lib.events import apply_events, fetch_initial_state_data, post_process_state from zerver.lib.markdown import MentionData from zerver.lib.message import render_markdown from zerver.lib.test_classes import ZulipTestCase from zerver.lib.test_helpers import ( create_dummy_file, get_subscription, get_test_image_file, reset_emails_in_zulip_realm, stdout_suppressed, ) from zerver.lib.topic import TOPIC_NAME from zerver.models import ( Attachment, CustomProfileField, Message, MultiuseInvite, PreregistrationUser, Realm, RealmAuditLog, RealmDomain, Service, Stream, UserGroup, UserMessage, UserPresence, UserProfile, get_client, get_stream, get_user_by_delivery_email, ) from zerver.openapi.openapi import validate_against_openapi_schema from zerver.tornado.event_queue import ( allocate_client_descriptor, clear_client_event_queues_for_testing, ) class BaseAction(ZulipTestCase): """Core class for verifying the apply_event race handling logic as well as the event formatting logic of any function using send_event. See https://zulip.readthedocs.io/en/latest/subsystems/events-system.html#testing for extensive design details for this testing system. """ def setUp(self) -> None: super().setUp() self.user_profile = self.example_user("hamlet") def verify_action( self, action: Callable[[], object], *, event_types: Optional[List[str]] = None, include_subscribers: bool = True, state_change_expected: bool = True, notification_settings_null: bool = False, client_gravatar: bool = True, user_avatar_url_field_optional: bool = False, slim_presence: bool = False, include_streams: bool = True, num_events: int = 1, bulk_message_deletion: bool = True, ) -> List[Dict[str, Any]]: """ Make sure we have a clean slate of client descriptors for these tests. If we don't do this, then certain failures will only manifest when you run multiple tests within a single test function. See also https://zulip.readthedocs.io/en/latest/subsystems/events-system.html#testing for details on the design of this test system. """ clear_client_event_queues_for_testing() client = allocate_client_descriptor( dict( user_profile_id=self.user_profile.id, realm_id=self.user_profile.realm_id, event_types=event_types, client_type_name="website", apply_markdown=True, client_gravatar=client_gravatar, slim_presence=slim_presence, all_public_streams=False, queue_timeout=600, last_connection_time=time.time(), narrow=[], bulk_message_deletion=bulk_message_deletion, ) ) # hybrid_state = initial fetch state + re-applying events triggered by our action # normal_state = do action then fetch at the end (the "normal" code path) hybrid_state = fetch_initial_state_data( self.user_profile, event_types=event_types, client_gravatar=client_gravatar, user_avatar_url_field_optional=user_avatar_url_field_optional, slim_presence=slim_presence, include_subscribers=include_subscribers, include_streams=include_streams, ) action() events = client.event_queue.contents() content = { "queue_id": "123.12", # The JSON wrapper helps in converting tuples to lists # as tuples aren't valid JSON structure. "events": orjson.loads(orjson.dumps(events)), "msg": "", "result": "success", } validate_against_openapi_schema(content, "/events", "get", "200", display_brief_error=True) self.assertEqual(len(events), num_events) initial_state = copy.deepcopy(hybrid_state) post_process_state(self.user_profile, initial_state, notification_settings_null) before = orjson.dumps(initial_state) apply_events( self.user_profile, state=hybrid_state, events=events, fetch_event_types=None, client_gravatar=client_gravatar, slim_presence=slim_presence, include_subscribers=include_subscribers, ) post_process_state(self.user_profile, hybrid_state, notification_settings_null) after = orjson.dumps(hybrid_state) if state_change_expected: if before == after: # nocoverage print(orjson.dumps(initial_state, option=orjson.OPT_INDENT_2).decode()) print(events) raise AssertionError( "Test does not exercise enough code -- events do not change state." ) else: try: self.match_states(initial_state, copy.deepcopy(hybrid_state), events) except AssertionError: # nocoverage raise AssertionError("Test is invalid--state actually does change here.") normal_state = fetch_initial_state_data( self.user_profile, event_types=event_types, client_gravatar=client_gravatar, user_avatar_url_field_optional=user_avatar_url_field_optional, slim_presence=slim_presence, include_subscribers=include_subscribers, include_streams=include_streams, ) post_process_state(self.user_profile, normal_state, notification_settings_null) self.match_states(hybrid_state, normal_state, events) return events def match_states( self, state1: Dict[str, Any], state2: Dict[str, Any], events: List[Dict[str, Any]] ) -> None: def normalize(state: Dict[str, Any]) -> None: for u in state["never_subscribed"]: if "subscribers" in u: u["subscribers"].sort() for u in state["subscriptions"]: if "subscribers" in u: u["subscribers"].sort() state["subscriptions"] = {u["name"]: u for u in state["subscriptions"]} state["unsubscribed"] = {u["name"]: u for u in state["unsubscribed"]} if "realm_bots" in state: state["realm_bots"] = {u["email"]: u for u in state["realm_bots"]} normalize(state1) normalize(state2) # If this assertions fails, we have unusual problems. self.assertEqual(state1.keys(), state2.keys()) # The far more likely scenario is that some section of # our enormous payload does not get updated properly. We # want the diff here to be developer-friendly, hence # the somewhat tedious code to provide useful output. if state1 != state2: # nocoverage print("\n---States DO NOT MATCH---") print("\nEVENTS:\n") # Printing out the events is a big help to # developers. import json for event in events: print(json.dumps(event, indent=4)) print("\nMISMATCHES:\n") for k in state1: if state1[k] != state2[k]: print("\nkey = " + k) try: self.assertEqual({k: state1[k]}, {k: state2[k]}) except AssertionError as e: print(e) print( """ NOTE: This is an advanced test that verifies how we apply events after fetching data. If you do not know how to debug it, you can ask for help on chat. """ ) sys.stdout.flush() raise AssertionError("Mismatching states") class NormalActionsTest(BaseAction): def create_bot(self, email: str, **extras: Any) -> UserProfile: return self.create_test_bot(email, self.user_profile, **extras) def test_mentioned_send_message_events(self) -> None: user = self.example_user("hamlet") for i in range(3): content = "mentioning... @**" + user.full_name + "** hello " + str(i) self.verify_action( lambda: self.send_stream_message(self.example_user("cordelia"), "Verona", content), ) def test_wildcard_mentioned_send_message_events(self) -> None: for i in range(3): content = "mentioning... @**all** hello " + str(i) self.verify_action( lambda: self.send_stream_message(self.example_user("cordelia"), "Verona", content), ) def test_pm_send_message_events(self) -> None: self.verify_action( lambda: self.send_personal_message( self.example_user("cordelia"), self.example_user("hamlet"), "hola" ), ) def test_huddle_send_message_events(self) -> None: huddle = [ self.example_user("hamlet"), self.example_user("othello"), ] self.verify_action( lambda: self.send_huddle_message(self.example_user("cordelia"), huddle, "hola"), ) def test_stream_send_message_events(self) -> None: events = self.verify_action( lambda: self.send_stream_message(self.example_user("hamlet"), "Verona", "hello"), client_gravatar=False, ) check_message("events[0]", events[0]) assert isinstance(events[0]["message"]["avatar_url"], str) events = self.verify_action( lambda: self.send_stream_message(self.example_user("hamlet"), "Verona", "hello"), client_gravatar=True, ) check_message("events[0]", events[0]) assert events[0]["message"]["avatar_url"] is None # Verify message editing message = Message.objects.order_by("-id")[0] topic = "new_topic" propagate_mode = "change_all" content = "new content" rendered_content = render_markdown(message, content) prior_mention_user_ids: Set[int] = set() mentioned_user_ids: Set[int] = set() mention_data = MentionData( realm_id=self.user_profile.realm_id, content=content, ) events = self.verify_action( lambda: do_update_message( self.user_profile, message, None, topic, propagate_mode, False, False, content, rendered_content, prior_mention_user_ids, mentioned_user_ids, mention_data, ), state_change_expected=True, ) check_update_message( "events[0]", events[0], has_content=True, has_topic=True, has_new_stream_id=False, ) events = self.verify_action( lambda: do_update_embedded_data( self.user_profile, message, "embed_content", "
embed_content
" ), state_change_expected=False, ) check_update_message_embedded("events[0]", events[0]) # Verify move topic to different stream. # Send 2 messages in "test" topic. self.send_stream_message(self.user_profile, "Verona") message_id = self.send_stream_message(self.user_profile, "Verona") message = Message.objects.get(id=message_id) topic = "new_topic" stream = get_stream("Denmark", self.user_profile.realm) propagate_mode = "change_all" prior_mention_user_ids = set() events = self.verify_action( lambda: do_update_message( self.user_profile, message, stream, topic, propagate_mode, True, True, None, None, set(), set(), None, ), state_change_expected=True, # There are 3 events generated for this action # * update_message: For updating existing messages # * 2 new message events: Breadcrumb messages in the new and old topics. num_events=3, ) check_update_message( "events[0]", events[0], has_content=False, has_topic=True, has_new_stream_id=True, ) def test_update_message_flags(self) -> None: # Test message flag update events message = self.send_personal_message( self.example_user("cordelia"), self.example_user("hamlet"), "hello", ) user_profile = self.example_user("hamlet") events = self.verify_action( lambda: do_update_message_flags( user_profile, get_client("website"), "add", "starred", [message] ), state_change_expected=True, ) check_update_message_flags_add("events[0]", events[0]) events = self.verify_action( lambda: do_update_message_flags( user_profile, get_client("website"), "remove", "starred", [message] ), state_change_expected=True, ) check_update_message_flags_remove("events[0]", events[0]) def test_update_read_flag_removes_unread_msg_ids(self) -> None: user_profile = self.example_user("hamlet") mention = "@**" + user_profile.full_name + "**" for content in ["hello", mention]: message = self.send_stream_message( self.example_user("cordelia"), "Verona", content, ) self.verify_action( lambda: do_update_message_flags( user_profile, get_client("website"), "add", "read", [message] ), state_change_expected=True, ) def test_send_message_to_existing_recipient(self) -> None: sender = self.example_user("cordelia") self.send_stream_message( sender, "Verona", "hello 1", ) self.verify_action( lambda: self.send_stream_message(sender, "Verona", "hello 2"), state_change_expected=True, ) def test_add_reaction(self) -> None: message_id = self.send_stream_message(self.example_user("hamlet"), "Verona", "hello") message = Message.objects.get(id=message_id) events = self.verify_action( lambda: do_add_reaction(self.user_profile, message, "tada", "1f389", "unicode_emoji"), state_change_expected=False, ) check_reaction_add("events[0]", events[0]) def test_add_submessage(self) -> None: cordelia = self.example_user("cordelia") stream_name = "Verona" message_id = self.send_stream_message( sender=cordelia, stream_name=stream_name, ) events = self.verify_action( lambda: do_add_submessage( realm=cordelia.realm, sender_id=cordelia.id, message_id=message_id, msg_type="whatever", content='"stuff"', ), state_change_expected=False, ) check_submessage("events[0]", events[0]) def test_remove_reaction(self) -> None: message_id = self.send_stream_message(self.example_user("hamlet"), "Verona", "hello") message = Message.objects.get(id=message_id) do_add_reaction(self.user_profile, message, "tada", "1f389", "unicode_emoji") events = self.verify_action( lambda: do_remove_reaction(self.user_profile, message, "1f389", "unicode_emoji"), state_change_expected=False, ) check_reaction_remove("events[0]", events[0]) def test_invite_user_event(self) -> None: self.user_profile = self.example_user("iago") streams = [] for stream_name in ["Denmark", "Scotland"]: streams.append(get_stream(stream_name, self.user_profile.realm)) events = self.verify_action( lambda: do_invite_users(self.user_profile, ["foo@zulip.com"], streams, False), state_change_expected=False, ) check_invites_changed("events[0]", events[0]) def test_create_multiuse_invite_event(self) -> None: self.user_profile = self.example_user("iago") streams = [] for stream_name in ["Denmark", "Verona"]: streams.append(get_stream(stream_name, self.user_profile.realm)) events = self.verify_action( lambda: do_create_multiuse_invite_link( self.user_profile, PreregistrationUser.INVITE_AS["MEMBER"], streams ), state_change_expected=False, ) check_invites_changed("events[0]", events[0]) def test_revoke_user_invite_event(self) -> None: self.user_profile = self.example_user("iago") streams = [] for stream_name in ["Denmark", "Verona"]: streams.append(get_stream(stream_name, self.user_profile.realm)) do_invite_users(self.user_profile, ["foo@zulip.com"], streams, False) prereg_users = PreregistrationUser.objects.filter( referred_by__realm=self.user_profile.realm ) events = self.verify_action( lambda: do_revoke_user_invite(prereg_users[0]), state_change_expected=False, ) check_invites_changed("events[0]", events[0]) def test_revoke_multiuse_invite_event(self) -> None: self.user_profile = self.example_user("iago") streams = [] for stream_name in ["Denmark", "Verona"]: streams.append(get_stream(stream_name, self.user_profile.realm)) do_create_multiuse_invite_link( self.user_profile, PreregistrationUser.INVITE_AS["MEMBER"], streams ) multiuse_object = MultiuseInvite.objects.get() events = self.verify_action( lambda: do_revoke_multi_use_invite(multiuse_object), state_change_expected=False, ) check_invites_changed("events[0]", events[0]) def test_invitation_accept_invite_event(self) -> None: reset_emails_in_zulip_realm() self.user_profile = self.example_user("iago") streams = [] for stream_name in ["Denmark", "Scotland"]: streams.append(get_stream(stream_name, self.user_profile.realm)) do_invite_users(self.user_profile, ["foo@zulip.com"], streams, False) prereg_user = PreregistrationUser.objects.get(email="foo@zulip.com") events = self.verify_action( lambda: do_create_user( "foo@zulip.com", "password", self.user_profile.realm, "full name", prereg_user=prereg_user, acting_user=None, ), state_change_expected=True, num_events=4, ) check_invites_changed("events[3]", events[3]) def test_typing_events(self) -> None: events = self.verify_action( lambda: check_send_typing_notification( self.user_profile, [self.example_user("cordelia").id], "start" ), state_change_expected=False, ) check_typing_start("events[0]", events[0]) events = self.verify_action( lambda: check_send_typing_notification( self.user_profile, [self.example_user("cordelia").id], "stop" ), state_change_expected=False, ) check_typing_stop("events[0]", events[0]) def test_custom_profile_fields_events(self) -> None: realm = self.user_profile.realm events = self.verify_action( lambda: try_add_realm_custom_profile_field( realm=realm, name="Expertise", field_type=CustomProfileField.LONG_TEXT ) ) check_custom_profile_fields("events[0]", events[0]) field = realm.customprofilefield_set.get(realm=realm, name="Biography") name = field.name hint = "Biography of the user" events = self.verify_action( lambda: try_update_realm_custom_profile_field(realm, field, name, hint=hint) ) check_custom_profile_fields("events[0]", events[0]) events = self.verify_action(lambda: do_remove_realm_custom_profile_field(realm, field)) check_custom_profile_fields("events[0]", events[0]) def test_custom_profile_field_data_events(self) -> None: field_id = self.user_profile.realm.customprofilefield_set.get( realm=self.user_profile.realm, name="Biography" ).id field = { "id": field_id, "value": "New value", } events = self.verify_action( lambda: do_update_user_custom_profile_data_if_changed(self.user_profile, [field]) ) check_realm_user_update("events[0]", events[0], "custom_profile_field") self.assertEqual( events[0]["person"]["custom_profile_field"].keys(), {"id", "value", "rendered_value"} ) # Test we pass correct stringify value in custom-user-field data event field_id = self.user_profile.realm.customprofilefield_set.get( realm=self.user_profile.realm, name="Mentor" ).id field = { "id": field_id, "value": [self.example_user("ZOE").id], } events = self.verify_action( lambda: do_update_user_custom_profile_data_if_changed(self.user_profile, [field]) ) check_realm_user_update("events[0]", events[0], "custom_profile_field") self.assertEqual(events[0]["person"]["custom_profile_field"].keys(), {"id", "value"}) def test_presence_events(self) -> None: events = self.verify_action( lambda: do_update_user_presence( self.user_profile, get_client("website"), timezone_now(), UserPresence.ACTIVE ), slim_presence=False, ) check_presence( "events[0]", events[0], has_email=True, presence_key="website", status="active", ) events = self.verify_action( lambda: do_update_user_presence( self.example_user("cordelia"), get_client("website"), timezone_now(), UserPresence.ACTIVE, ), slim_presence=True, ) check_presence( "events[0]", events[0], has_email=False, presence_key="website", status="active", ) def test_presence_events_multiple_clients(self) -> None: self.api_post( self.user_profile, "/api/v1/users/me/presence", {"status": "idle"}, HTTP_USER_AGENT="ZulipAndroid/1.0", ) self.verify_action( lambda: do_update_user_presence( self.user_profile, get_client("website"), timezone_now(), UserPresence.ACTIVE ) ) events = self.verify_action( lambda: do_update_user_presence( self.user_profile, get_client("ZulipAndroid/1.0"), timezone_now(), UserPresence.IDLE ) ) check_presence( "events[0]", events[0], has_email=True, presence_key="ZulipAndroid/1.0", status="idle", ) def test_register_events(self) -> None: events = self.verify_action(lambda: self.register("test1@zulip.com", "test1")) self.assert_length(events, 1) check_realm_user_add("events[0]", events[0]) new_user_profile = get_user_by_delivery_email("test1@zulip.com", self.user_profile.realm) self.assertEqual(new_user_profile.delivery_email, "test1@zulip.com") def test_register_events_email_address_visibility(self) -> None: do_set_realm_property( self.user_profile.realm, "email_address_visibility", Realm.EMAIL_ADDRESS_VISIBILITY_ADMINS, acting_user=None, ) events = self.verify_action(lambda: self.register("test1@zulip.com", "test1")) self.assert_length(events, 1) check_realm_user_add("events[0]", events[0]) new_user_profile = get_user_by_delivery_email("test1@zulip.com", self.user_profile.realm) self.assertEqual(new_user_profile.email, f"user{new_user_profile.id}@zulip.testserver") def test_alert_words_events(self) -> None: events = self.verify_action(lambda: do_add_alert_words(self.user_profile, ["alert_word"])) check_alert_words("events[0]", events[0]) events = self.verify_action( lambda: do_remove_alert_words(self.user_profile, ["alert_word"]) ) check_alert_words("events[0]", events[0]) def test_away_events(self) -> None: client = get_client("website") events = self.verify_action( lambda: do_update_user_status( user_profile=self.user_profile, away=True, status_text="out to lunch", client_id=client.id, ) ) check_user_status("events[0]", events[0], {"away", "status_text"}) events = self.verify_action( lambda: do_update_user_status( user_profile=self.user_profile, away=False, status_text="", client_id=client.id ) ) check_user_status("events[0]", events[0], {"away", "status_text"}) events = self.verify_action( lambda: do_update_user_status( user_profile=self.user_profile, away=True, status_text=None, client_id=client.id ) ) check_user_status("events[0]", events[0], {"away"}) events = self.verify_action( lambda: do_update_user_status( user_profile=self.user_profile, away=None, status_text="at the beach", client_id=client.id, ) ) check_user_status("events[0]", events[0], {"status_text"}) def test_user_group_events(self) -> None: othello = self.example_user("othello") events = self.verify_action( lambda: check_add_user_group( self.user_profile.realm, "backend", [othello], "Backend team" ) ) check_user_group_add("events[0]", events[0]) # Test name update backend = UserGroup.objects.get(name="backend") events = self.verify_action(lambda: do_update_user_group_name(backend, "backendteam")) check_user_group_update("events[0]", events[0], "name") # Test description update description = "Backend team to deal with backend code." events = self.verify_action(lambda: do_update_user_group_description(backend, description)) check_user_group_update("events[0]", events[0], "description") # Test add members hamlet = self.example_user("hamlet") events = self.verify_action(lambda: bulk_add_members_to_user_group(backend, [hamlet])) check_user_group_add_members("events[0]", events[0]) # Test remove members hamlet = self.example_user("hamlet") events = self.verify_action(lambda: remove_members_from_user_group(backend, [hamlet])) check_user_group_remove_members("events[0]", events[0]) # Test remove event events = self.verify_action(lambda: check_delete_user_group(backend.id, othello)) check_user_group_remove("events[0]", events[0]) def test_default_stream_groups_events(self) -> None: streams = [] for stream_name in ["Scotland", "Verona", "Denmark"]: streams.append(get_stream(stream_name, self.user_profile.realm)) events = self.verify_action( lambda: do_create_default_stream_group( self.user_profile.realm, "group1", "This is group1", streams ) ) check_default_stream_groups("events[0]", events[0]) group = lookup_default_stream_groups(["group1"], self.user_profile.realm)[0] venice_stream = get_stream("Venice", self.user_profile.realm) events = self.verify_action( lambda: do_add_streams_to_default_stream_group( self.user_profile.realm, group, [venice_stream] ) ) check_default_stream_groups("events[0]", events[0]) events = self.verify_action( lambda: do_remove_streams_from_default_stream_group( self.user_profile.realm, group, [venice_stream] ) ) check_default_stream_groups("events[0]", events[0]) events = self.verify_action( lambda: do_change_default_stream_group_description( self.user_profile.realm, group, "New description" ) ) check_default_stream_groups("events[0]", events[0]) events = self.verify_action( lambda: do_change_default_stream_group_name( self.user_profile.realm, group, "New Group Name" ) ) check_default_stream_groups("events[0]", events[0]) events = self.verify_action( lambda: do_remove_default_stream_group(self.user_profile.realm, group) ) check_default_stream_groups("events[0]", events[0]) def test_default_stream_group_events_guest(self) -> None: streams = [] for stream_name in ["Scotland", "Verona", "Denmark"]: streams.append(get_stream(stream_name, self.user_profile.realm)) do_create_default_stream_group(self.user_profile.realm, "group1", "This is group1", streams) group = lookup_default_stream_groups(["group1"], self.user_profile.realm)[0] do_change_user_role(self.user_profile, UserProfile.ROLE_GUEST, acting_user=None) venice_stream = get_stream("Venice", self.user_profile.realm) self.verify_action( lambda: do_add_streams_to_default_stream_group( self.user_profile.realm, group, [venice_stream] ), state_change_expected=False, num_events=0, ) def test_default_streams_events(self) -> None: stream = get_stream("Scotland", self.user_profile.realm) events = self.verify_action(lambda: do_add_default_stream(stream)) check_default_streams("events[0]", events[0]) events = self.verify_action(lambda: do_remove_default_stream(stream)) check_default_streams("events[0]", events[0]) def test_default_streams_events_guest(self) -> None: do_change_user_role(self.user_profile, UserProfile.ROLE_GUEST, acting_user=None) stream = get_stream("Scotland", self.user_profile.realm) self.verify_action( lambda: do_add_default_stream(stream), state_change_expected=False, num_events=0 ) self.verify_action( lambda: do_remove_default_stream(stream), state_change_expected=False, num_events=0 ) def test_muted_topics_events(self) -> None: stream = get_stream("Denmark", self.user_profile.realm) events = self.verify_action(lambda: do_mute_topic(self.user_profile, stream, "topic")) check_muted_topics("events[0]", events[0]) events = self.verify_action(lambda: do_unmute_topic(self.user_profile, stream, "topic")) check_muted_topics("events[0]", events[0]) def test_change_avatar_fields(self) -> None: events = self.verify_action( lambda: do_change_avatar_fields( self.user_profile, UserProfile.AVATAR_FROM_USER, acting_user=self.user_profile ), ) check_realm_user_update("events[0]", events[0], "avatar_fields") assert isinstance(events[0]["person"]["avatar_url"], str) assert isinstance(events[0]["person"]["avatar_url_medium"], str) events = self.verify_action( lambda: do_change_avatar_fields( self.user_profile, UserProfile.AVATAR_FROM_GRAVATAR, acting_user=self.user_profile ), ) check_realm_user_update("events[0]", events[0], "avatar_fields") self.assertEqual(events[0]["person"]["avatar_url"], None) self.assertEqual(events[0]["person"]["avatar_url_medium"], None) def test_change_full_name(self) -> None: events = self.verify_action( lambda: do_change_full_name(self.user_profile, "Sir Hamlet", self.user_profile) ) check_realm_user_update("events[0]", events[0], "full_name") def test_change_user_delivery_email_email_address_visibilty_admins(self) -> None: do_set_realm_property( self.user_profile.realm, "email_address_visibility", Realm.EMAIL_ADDRESS_VISIBILITY_ADMINS, acting_user=None, ) # Important: We need to refresh from the database here so that # we don't have a stale UserProfile object with an old value # for email being passed into this next function. self.user_profile.refresh_from_db() action = lambda: do_change_user_delivery_email(self.user_profile, "newhamlet@zulip.com") events = self.verify_action(action, num_events=2, client_gravatar=False) check_realm_user_update("events[0]", events[0], "delivery_email") check_realm_user_update("events[1]", events[1], "avatar_fields") assert isinstance(events[1]["person"]["avatar_url"], str) assert isinstance(events[1]["person"]["avatar_url_medium"], str) def test_change_realm_authentication_methods(self) -> None: def fake_backends() -> Any: backends = ( "zproject.backends.DevAuthBackend", "zproject.backends.EmailAuthBackend", "zproject.backends.GitHubAuthBackend", "zproject.backends.GoogleAuthBackend", "zproject.backends.ZulipLDAPAuthBackend", ) return self.settings(AUTHENTICATION_BACKENDS=backends) # Test transitions; any new backends should be tested with T/T/T/F/T for auth_method_dict in ( {"Google": True, "Email": True, "GitHub": True, "LDAP": False, "Dev": False}, {"Google": True, "Email": True, "GitHub": False, "LDAP": False, "Dev": False}, {"Google": True, "Email": False, "GitHub": False, "LDAP": False, "Dev": False}, {"Google": True, "Email": False, "GitHub": True, "LDAP": False, "Dev": False}, {"Google": False, "Email": False, "GitHub": False, "LDAP": False, "Dev": True}, {"Google": False, "Email": False, "GitHub": True, "LDAP": False, "Dev": True}, {"Google": False, "Email": True, "GitHub": True, "LDAP": True, "Dev": False}, ): with fake_backends(): events = self.verify_action( lambda: do_set_realm_authentication_methods( self.user_profile.realm, auth_method_dict ) ) check_realm_update_dict("events[0]", events[0]) def test_change_pin_stream(self) -> None: stream = get_stream("Denmark", self.user_profile.realm) sub = get_subscription(stream.name, self.user_profile) do_change_subscription_property(self.user_profile, sub, stream, "pin_to_top", False) for pinned in (True, False): events = self.verify_action( lambda: do_change_subscription_property( self.user_profile, sub, stream, "pin_to_top", pinned ) ) check_subscription_update( "events[0]", events[0], property="pin_to_top", value=pinned, ) def test_change_stream_notification_settings(self) -> None: for setting_name in ["email_notifications"]: stream = get_stream("Denmark", self.user_profile.realm) sub = get_subscription(stream.name, self.user_profile) # First test with notification_settings_null enabled for value in (True, False): events = self.verify_action( lambda: do_change_subscription_property( self.user_profile, sub, stream, setting_name, value ), notification_settings_null=True, ) check_subscription_update( "events[0]", events[0], property=setting_name, value=value, ) for value in (True, False): events = self.verify_action( lambda: do_change_subscription_property( self.user_profile, sub, stream, setting_name, value ) ) check_subscription_update( "events[0]", events[0], property=setting_name, value=value, ) def test_change_realm_message_edit_settings(self) -> None: # Test every transition among the four possibilities {T,F} x {0, non-0} for (allow_message_editing, message_content_edit_limit_seconds) in ( (True, 0), (False, 0), (False, 1234), (True, 600), (False, 0), (True, 1234), ): events = self.verify_action( lambda: do_set_realm_message_editing( self.user_profile.realm, allow_message_editing, message_content_edit_limit_seconds, False, ) ) check_realm_update_dict("events[0]", events[0]) def test_change_realm_notifications_stream(self) -> None: stream = get_stream("Rome", self.user_profile.realm) for notifications_stream, notifications_stream_id in ((stream, stream.id), (None, -1)): events = self.verify_action( lambda: do_set_realm_notifications_stream( self.user_profile.realm, notifications_stream, notifications_stream_id ) ) check_realm_update("events[0]", events[0], "notifications_stream_id") def test_change_realm_signup_notifications_stream(self) -> None: stream = get_stream("Rome", self.user_profile.realm) for signup_notifications_stream, signup_notifications_stream_id in ( (stream, stream.id), (None, -1), ): events = self.verify_action( lambda: do_set_realm_signup_notifications_stream( self.user_profile.realm, signup_notifications_stream, signup_notifications_stream_id, ) ) check_realm_update("events[0]", events[0], "signup_notifications_stream_id") def test_change_is_admin(self) -> None: reset_emails_in_zulip_realm() # Important: We need to refresh from the database here so that # we don't have a stale UserProfile object with an old value # for email being passed into this next function. self.user_profile.refresh_from_db() do_change_user_role(self.user_profile, UserProfile.ROLE_MEMBER, acting_user=None) for role in [UserProfile.ROLE_REALM_ADMINISTRATOR, UserProfile.ROLE_MEMBER]: events = self.verify_action( lambda: do_change_user_role(self.user_profile, role, acting_user=None) ) check_realm_user_update("events[0]", events[0], "role") self.assertEqual(events[0]["person"]["role"], role) def test_change_is_owner(self) -> None: reset_emails_in_zulip_realm() # Important: We need to refresh from the database here so that # we don't have a stale UserProfile object with an old value # for email being passed into this next function. self.user_profile.refresh_from_db() do_change_user_role(self.user_profile, UserProfile.ROLE_MEMBER, acting_user=None) for role in [UserProfile.ROLE_REALM_OWNER, UserProfile.ROLE_MEMBER]: events = self.verify_action( lambda: do_change_user_role(self.user_profile, role, acting_user=None) ) check_realm_user_update("events[0]", events[0], "role") self.assertEqual(events[0]["person"]["role"], role) def test_change_is_guest(self) -> None: reset_emails_in_zulip_realm() # Important: We need to refresh from the database here so that # we don't have a stale UserProfile object with an old value # for email being passed into this next function. self.user_profile.refresh_from_db() do_change_user_role(self.user_profile, UserProfile.ROLE_MEMBER, acting_user=None) for role in [UserProfile.ROLE_GUEST, UserProfile.ROLE_MEMBER]: events = self.verify_action( lambda: do_change_user_role(self.user_profile, role, acting_user=None) ) check_realm_user_update("events[0]", events[0], "role") self.assertEqual(events[0]["person"]["role"], role) def test_change_notification_settings(self) -> None: for notification_setting, v in self.user_profile.notification_setting_types.items(): if notification_setting in ["notification_sound", "desktop_icon_count_display"]: # These settings are tested in their own tests. continue do_change_notification_settings( self.user_profile, notification_setting, False, acting_user=self.user_profile ) for setting_value in [True, False]: events = self.verify_action( lambda: do_change_notification_settings( self.user_profile, notification_setting, setting_value, acting_user=self.user_profile, ) ) check_update_global_notifications("events[0]", events[0], setting_value) # Also test with notification_settings_null=True events = self.verify_action( lambda: do_change_notification_settings( self.user_profile, notification_setting, setting_value, acting_user=self.user_profile, ), notification_settings_null=True, state_change_expected=False, ) check_update_global_notifications("events[0]", events[0], setting_value) def test_change_notification_sound(self) -> None: notification_setting = "notification_sound" events = self.verify_action( lambda: do_change_notification_settings(self.user_profile, notification_setting, "ding") ) check_update_global_notifications("events[0]", events[0], "ding") def test_change_desktop_icon_count_display(self) -> None: notification_setting = "desktop_icon_count_display" events = self.verify_action( lambda: do_change_notification_settings( self.user_profile, notification_setting, 2, acting_user=self.user_profile ) ) check_update_global_notifications("events[0]", events[0], 2) events = self.verify_action( lambda: do_change_notification_settings( self.user_profile, notification_setting, 1, acting_user=self.user_profile ) ) check_update_global_notifications("events[0]", events[0], 1) def test_realm_update_plan_type(self) -> None: realm = self.user_profile.realm state_data = fetch_initial_state_data(self.user_profile) self.assertEqual(state_data["realm_plan_type"], Realm.SELF_HOSTED) self.assertEqual(state_data["zulip_plan_is_not_limited"], True) events = self.verify_action(lambda: do_change_plan_type(realm, Realm.LIMITED)) check_realm_update("events[0]", events[0], "plan_type") state_data = fetch_initial_state_data(self.user_profile) self.assertEqual(state_data["realm_plan_type"], Realm.LIMITED) self.assertEqual(state_data["zulip_plan_is_not_limited"], False) def test_realm_emoji_events(self) -> None: author = self.example_user("iago") with get_test_image_file("img.png") as img_file: events = self.verify_action( lambda: check_add_realm_emoji(self.user_profile.realm, "my_emoji", author, img_file) ) check_realm_emoji_update("events[0]", events[0]) events = self.verify_action( lambda: do_remove_realm_emoji(self.user_profile.realm, "my_emoji") ) check_realm_emoji_update("events[0]", events[0]) def test_realm_filter_events(self) -> None: regex = "#(?P