Struct matrix_sdk_test::EventBuilder

pub struct EventBuilder { /* fields omitted */ }

The EventBuilder struct can be used to easily generate valid sync responses for testing. These can be then fed into either Client or Room.

It supports generated a number of canned events, such as a member entering a room, his power level and display name changing and similar. It also supports insertion of custom events in the form of EventsJson values.

Important You must use the same builder when sending multiple sync responses to a single client. Otherwise, the subsequent responses will be ignored by the client because the next_batch sync token will not be rotated properly.

Example usage

use matrix_sdk_test::{EventBuilder, EventsJson};

let mut builder = EventBuilder::new();

// response1 now contains events that add an example member to the room and change their power
// level
let response1 = builder
    .add_room_event(EventsJson::Member)
    .add_room_event(EventsJson::PowerLevels)
    .build_sync_response();

// response2 is now empty (nothing changed)
let response2 = builder.build_sync_response();

// response3 contains a display name change for member example
let response3 = builder
    .add_room_event(EventsJson::MemberNameChange)
    .build_sync_response();

Implementations

impl EventBuilder

pub fn new() -> Self

pub fn add_ephemeral(&mut self, json: EventsJson) -> &mut Self

Add an event to the room events Vec.

pub fn add_account(&mut self, json: EventsJson) -> &mut Self

Add an event to the room events Vec.

pub fn add_room_event(&mut self, json: EventsJson) -> &mut Self

Add an event to the room events Vec.

pub fn add_custom_joined_event(
    &mut self,
    room_id: &RoomId,
    event: Value
) -> &mut Self

pub fn add_custom_invited_event(
    &mut self,
    room_id: &RoomId,
    event: Value
) -> &mut Self

pub fn add_custom_left_event(
    &mut self,
    room_id: &RoomId,
    event: Value
) -> &mut Self

pub fn add_state_event(&mut self, json: EventsJson) -> &mut Self

Add a state event to the state events Vec.

pub fn add_presence_event(&mut self, json: EventsJson) -> &mut Self

Add an presence event to the presence events Vec.

pub fn build_json_sync_response(&mut self) -> JsonValue

Builds a sync response as a JSON Value containing the events we queued so far.

The next response returned by build_sync_response will then be empty if no further events were queued.

This method is raw JSON equivalent to build_sync_response(), use build_sync_response() if you need a typed response.

pub fn build_sync_response(&mut self) -> SyncResponse

Builds a SyncResponse containing the events we queued so far.

The next response returned by build_sync_response will then be empty if no further events were queued.

This method is high level and typed equivalent to build_json_sync_response(), use build_json_sync_response() if you need an untyped response.

pub fn clear(&mut self)

Trait Implementations

impl Default for EventBuilder

fn default() -> EventBuilder

Returns the “default value” for a type.