Struct EventFactory

pub struct EventFactory { /* private fields */ }

Implementations

impl EventFactory

pub fn new() -> Self

pub fn room(self, room_id: &RoomId) -> Self

pub fn sender(self, sender: &UserId) -> Self

pub fn event<E: EventContent>(&self, content: E) -> EventBuilder<E>

Create an event from any event content.

pub fn text_msg( &self, content: impl Into<String>, ) -> EventBuilder<RoomMessageEventContent>

Create a new plain text m.room.message.

pub fn member(&self, member: &UserId) -> EventBuilder<RoomMemberEventContent>

Create a new m.room.member event for the given member.

The given member will be used as the sender as well as the state_key of the m.room.member event, unless the sender was already using EventFactory::sender(), in that case only the state key will be set to the given member.

The membership field of the content is set to MembershipState::Join.

use matrix_sdk_test::event_factory::EventFactory;
use ruma::{
    events::{
        room::member::{MembershipState, RoomMemberEventContent},
        SyncStateEvent,
    },
    room_id,
    serde::Raw,
    user_id,
};

let factory = EventFactory::new().room(room_id!("!test:localhost"));

let event: Raw<SyncStateEvent<RoomMemberEventContent>> = factory
    .member(user_id!("@alice:localhost"))
    .display_name("Alice")
    .into_raw();

pub fn member_hints( &self, service_members: BTreeSet<OwnedUserId>, ) -> EventBuilder<MemberHintsEventContent>

Create a new m.member_hints event with the given service members.

use std::collections::BTreeSet;

use matrix_sdk_test::event_factory::EventFactory;
use ruma::{
    events::{member_hints::MemberHintsEventContent, SyncStateEvent},
    owned_user_id, room_id,
    serde::Raw,
    user_id,
};

let factory = EventFactory::new().room(room_id!("!test:localhost"));

let event: Raw<SyncStateEvent<MemberHintsEventContent>> = factory
    .member_hints(BTreeSet::from([owned_user_id!("@alice:localhost")]))
    .sender(user_id!("@alice:localhost"))
    .into_raw();

pub fn text_html( &self, plain: impl Into<String>, html: impl Into<String>, ) -> EventBuilder<RoomMessageEventContent>

Create a new plain/html m.room.message.

pub fn notice( &self, content: impl Into<String>, ) -> EventBuilder<RoomMessageEventContent>

Create a new plain notice m.room.message.

pub fn reaction( &self, event_id: &EventId, annotation: String, ) -> EventBuilder<ReactionEventContent>

Add a reaction to an event.

pub fn redaction( &self, event_id: &EventId, ) -> EventBuilder<RoomRedactionEventContent>

Create a redaction for the given event id.

pub fn poll_start( &self, content: impl Into<String>, poll_question: impl Into<String>, answers: Vec<impl Into<String>>, ) -> EventBuilder<UnstablePollStartEventContent>

Create a poll start event given a text, the question and the possible answers.

pub fn poll_edit( &self, edited_event_id: &EventId, poll_question: impl Into<String>, answers: Vec<impl Into<String>>, ) -> EventBuilder<ReplacementUnstablePollStartEventContent>

Create a poll edit event given the new question and possible answers.

pub fn poll_response( &self, answer_id: impl Into<String>, poll_start_id: &EventId, ) -> EventBuilder<PollResponseEventContent>

Create a poll response with the given answer id and the associated poll start event id.

pub fn poll_end( &self, content: impl Into<String>, poll_start_id: &EventId, ) -> EventBuilder<PollEndEventContent>

Create a poll response with the given text and the associated poll start event id.

pub fn image( &self, filename: String, url: OwnedMxcUri, ) -> EventBuilder<RoomMessageEventContent>

Creates a plain (unencrypted) image event content referencing the given MXC ID.

pub fn set_next_ts(&self, value: u64)

Set the next server timestamp.

Timestamps will continue to increase by 1 (millisecond) from that value.

Trait Implementations

impl Debug for EventFactory

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EventFactory

fn default() -> EventFactory

Returns the “default value” for a type.