Struct ConditionalPushRule 

#[non_exhaustive]
pub struct ConditionalPushRule {
    pub actions: Vec<Action>,
    pub default: bool,
    pub enabled: bool,
    pub rule_id: String,
    pub conditions: Vec<PushCondition>,
}

Like SimplePushRule, but with an additional conditions field.

Only applicable to underride and override rules.

To create an instance of this type, first create a ConditionalPushRuleInit and convert it via ConditionalPushRule::from / .into().

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

actions: Vec<Action>

Actions to determine if and how a notification is delivered for events matching this rule.

default: bool

Whether this is a default rule, or has been set explicitly.

enabled: bool

Whether the push rule is enabled or not.

rule_id: String

The ID of this rule.

conditions: Vec<PushCondition>

The conditions that must hold true for an event in order for a rule to be applied to an event.

A rule with no conditions always matches.

Implementations

impl ConditionalPushRule

Default override push rules

pub fn master() -> ConditionalPushRule

Available on crate feature events only.

Matches all events, this can be enabled to turn off all push notifications other than those generated by override rules set by the user.

pub fn suppress_notices() -> ConditionalPushRule

Available on crate feature events only.

Matches messages with a msgtype of notice.

pub fn invite_for_me(user_id: &UserId) -> ConditionalPushRule

Available on crate feature events only.

Matches any invites to a new room for this user.

pub fn member_event() -> ConditionalPushRule

Available on crate feature events only.

Matches any m.room.member_event.

pub fn is_user_mention(user_id: &UserId) -> ConditionalPushRule

Available on crate feature events only.

Matches any message which contains the user’s Matrix ID in the list of user_ids under the m.mentions property.

pub fn tombstone() -> ConditionalPushRule

Available on crate feature events only.

Matches any state event whose type is m.room.tombstone. This is intended to notify users of a room when it is upgraded, similar to what an @room notification would accomplish.

pub fn is_room_mention() -> ConditionalPushRule

Available on crate feature events only.

Matches any message from a sender with the proper power level with the room property of the m.mentions property set to true.

pub fn reaction() -> ConditionalPushRule

Available on crate feature events only.

Matches reactions to a message.

pub fn server_acl() -> ConditionalPushRule

Available on crate feature events only.

Matches room server ACLs.

pub fn suppress_edits() -> ConditionalPushRule

Available on crate feature events only.

Matches event replacements.

pub fn poll_response() -> ConditionalPushRule

Available on crate feature events only.

Matches a poll response event sent in any room.

This rule uses the unstable prefixes defined in MSC3381 and MSC3930.

impl ConditionalPushRule

Default underrides push rules

pub fn call() -> ConditionalPushRule

Available on crate feature events only.

Matches any incoming VOIP call.

pub fn encrypted_room_one_to_one() -> ConditionalPushRule

Available on crate feature events only.

Matches any encrypted event sent in a room with exactly two members.

Unlike other push rules, this rule cannot be matched against the content of the event by nature of it being encrypted. This causes the rule to be an “all or nothing” match where it either matches all events that are encrypted (in 1:1 rooms) or none.

pub fn room_one_to_one() -> ConditionalPushRule

Available on crate feature events only.

Matches any message sent in a room with exactly two members.

pub fn message() -> ConditionalPushRule

Available on crate feature events only.

Matches all chat messages.

pub fn encrypted() -> ConditionalPushRule

Available on crate feature events only.

Matches all encrypted events.

Unlike other push rules, this rule cannot be matched against the content of the event by nature of it being encrypted. This causes the rule to be an “all or nothing” match where it either matches all events that are encrypted (in group rooms) or none.

pub fn poll_start_one_to_one() -> ConditionalPushRule

Available on crate feature events only.

Matches a poll start event sent in a room with exactly two members.

This rule uses the unstable prefixes defined in MSC3381 and MSC3930.

pub fn poll_start() -> ConditionalPushRule

Available on crate feature events only.

Matches a poll start event sent in any room.

This rule uses the unstable prefixes defined in MSC3381 and MSC3930.

pub fn poll_end_one_to_one() -> ConditionalPushRule

Available on crate feature events only.

Matches a poll end event sent in a room with exactly two members.

This rule uses the unstable prefixes defined in MSC3381 and MSC3930.

pub fn poll_end() -> ConditionalPushRule

Available on crate feature events only.

Matches a poll end event sent in any room.

This rule uses the unstable prefixes defined in MSC3381 and MSC3930.

pub fn unsubscribed_thread() -> ConditionalPushRule

Available on crate feature events only.

Matches an event that’s part of a thread, that is not subscribed to, by the current user.

Thread subscriptions are defined in MSC4306.

pub fn subscribed_thread() -> ConditionalPushRule

Available on crate feature events only.

Matches an event that’s part of a thread, that is subscribed to, by the current user.

Thread subscriptions are defined in MSC4306.

impl ConditionalPushRule

pub async fn applies( &self, event: &FlattenedJson, context: &PushConditionRoomCtx, ) -> bool

Available on crate feature events only.

Check if the push rule applies to the event.

Arguments

• event - The flattened JSON representation of a room message event.
• context - The context of the room at the time of the event.

Trait Implementations

impl Clone for ConditionalPushRule

fn clone(&self) -> ConditionalPushRule

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConditionalPushRule

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConditionalPushRule

fn deserialize<__D>( __deserializer: __D, ) -> Result<ConditionalPushRule, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Equivalent<ConditionalPushRule> for str

fn equivalent(&self, key: &ConditionalPushRule) -> bool

Compare self to key and return true if they are equal.

impl From<ConditionalPushRule> for PushRule

fn from(push_rule: ConditionalPushRule) -> PushRule

Converts to this type from the input type.

impl From<ConditionalPushRuleInit> for ConditionalPushRule

fn from(init: ConditionalPushRuleInit) -> ConditionalPushRule

Converts to this type from the input type.

impl From<NewConditionalPushRule> for ConditionalPushRule

fn from(new_rule: NewConditionalPushRule) -> ConditionalPushRule

Converts to this type from the input type.

impl From<PushRule> for ConditionalPushRule

fn from(push_rule: PushRule) -> ConditionalPushRule

Converts to this type from the input type.

impl Hash for ConditionalPushRule

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ConditionalPushRule

fn eq(&self, other: &ConditionalPushRule) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ConditionalPushRule

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ConditionalPushRule