Struct ruma_common::push::ConditionalPushRule
source · #[non_exhaustive]pub struct ConditionalPushRule {
pub actions: Vec<Action>,
pub default: bool,
pub enabled: bool,
pub rule_id: String,
pub conditions: Vec<PushCondition>,
}
Expand description
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)§
This struct is marked as non-exhaustive
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§
source§impl ConditionalPushRule
impl ConditionalPushRule
Default override push rules
sourcepub fn master() -> Self
pub fn master() -> Self
Matches all events, this can be enabled to turn off all push notifications other than those generated by override rules set by the user.
sourcepub fn suppress_notices() -> Self
pub fn suppress_notices() -> Self
Matches messages with a msgtype
of notice
.
sourcepub fn invite_for_me(user_id: &UserId) -> Self
pub fn invite_for_me(user_id: &UserId) -> Self
Matches any invites to a new room for this user.
sourcepub fn member_event() -> Self
pub fn member_event() -> Self
Matches any m.room.member_event
.
sourcepub fn is_user_mention(user_id: &UserId) -> Self
pub fn is_user_mention(user_id: &UserId) -> Self
Matches any message which contains the user’s Matrix ID in the list of user_ids
under the
m.mentions
property.
sourcepub fn contains_display_name() -> Self
👎Deprecated: Since Matrix 1.7. Use the m.mentions property with ConditionalPushRule::is_user_mention() instead.
pub fn contains_display_name() -> Self
Matches any message whose content is unencrypted and contains the user’s current display name in the room in which it was sent.
Since Matrix 1.7, this rule only matches if the event’s content does not contain an
m.mentions
property.
sourcepub fn tombstone() -> Self
pub fn tombstone() -> Self
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.
sourcepub fn is_room_mention() -> Self
pub fn is_room_mention() -> Self
Matches any message from a sender with the proper power level with the room
property of
the m.mentions
property set to true
.
sourcepub fn roomnotif() -> Self
👎Deprecated: Since Matrix 1.7. Use the m.mentions property with ConditionalPushRule::is_room_mention() instead.
pub fn roomnotif() -> Self
Matches any message whose content is unencrypted and contains the text @room
, signifying
the whole room should be notified of the event.
Since Matrix 1.7, this rule only matches if the event’s content does not contain an
m.mentions
property.
sourcepub fn server_acl() -> Self
pub fn server_acl() -> Self
Matches room server ACLs.
sourcepub fn suppress_edits() -> Self
pub fn suppress_edits() -> Self
Matches event replacements.
sourcepub fn poll_response() -> Self
pub fn poll_response() -> Self
source§impl ConditionalPushRule
impl ConditionalPushRule
Default underrides push rules
sourcepub fn encrypted_room_one_to_one() -> Self
pub fn encrypted_room_one_to_one() -> Self
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.
sourcepub fn room_one_to_one() -> Self
pub fn room_one_to_one() -> Self
Matches any message sent in a room with exactly two members.
sourcepub fn encrypted() -> Self
pub fn encrypted() -> Self
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.
sourcepub fn poll_start_one_to_one() -> Self
pub fn poll_start_one_to_one() -> Self
sourcepub fn poll_start() -> Self
pub fn poll_start() -> Self
sourcepub fn poll_end_one_to_one() -> Self
pub fn poll_end_one_to_one() -> Self
source§impl ConditionalPushRule
impl ConditionalPushRule
sourcepub fn applies(
&self,
event: &FlattenedJson,
context: &PushConditionRoomCtx,
) -> bool
pub fn applies( &self, event: &FlattenedJson, context: &PushConditionRoomCtx, ) -> bool
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§
source§impl Clone for ConditionalPushRule
impl Clone for ConditionalPushRule
source§fn clone(&self) -> ConditionalPushRule
fn clone(&self) -> ConditionalPushRule
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for ConditionalPushRule
impl Debug for ConditionalPushRule
source§impl<'de> Deserialize<'de> for ConditionalPushRule
impl<'de> Deserialize<'de> for ConditionalPushRule
source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
source§impl Equivalent<ConditionalPushRule> for str
impl Equivalent<ConditionalPushRule> for str
source§fn equivalent(&self, key: &ConditionalPushRule) -> bool
fn equivalent(&self, key: &ConditionalPushRule) -> bool
key
and return true
if they are equal.source§impl From<ConditionalPushRuleInit> for ConditionalPushRule
impl From<ConditionalPushRuleInit> for ConditionalPushRule
source§fn from(init: ConditionalPushRuleInit) -> Self
fn from(init: ConditionalPushRuleInit) -> Self
source§impl From<NewConditionalPushRule> for ConditionalPushRule
impl From<NewConditionalPushRule> for ConditionalPushRule
source§fn from(new_rule: NewConditionalPushRule) -> Self
fn from(new_rule: NewConditionalPushRule) -> Self
source§impl Hash for ConditionalPushRule
impl Hash for ConditionalPushRule
source§impl PartialEq for ConditionalPushRule
impl PartialEq for ConditionalPushRule
source§impl Serialize for ConditionalPushRule
impl Serialize for ConditionalPushRule
impl Eq for ConditionalPushRule
Auto Trait Implementations§
impl Freeze for ConditionalPushRule
impl RefUnwindSafe for ConditionalPushRule
impl Send for ConditionalPushRule
impl Sync for ConditionalPushRule
impl Unpin for ConditionalPushRule
impl UnwindSafe for ConditionalPushRule
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.