Struct ruma::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() -> ConditionalPushRule
pub fn master() -> ConditionalPushRule
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() -> ConditionalPushRule
pub fn suppress_notices() -> ConditionalPushRule
Matches messages with a msgtype
of notice
.
sourcepub fn invite_for_me(user_id: &UserId) -> ConditionalPushRule
pub fn invite_for_me(user_id: &UserId) -> ConditionalPushRule
Matches any invites to a new room for this user.
sourcepub fn member_event() -> ConditionalPushRule
pub fn member_event() -> ConditionalPushRule
Matches any m.room.member_event
.
sourcepub fn is_user_mention(user_id: &UserId) -> ConditionalPushRule
pub fn is_user_mention(user_id: &UserId) -> ConditionalPushRule
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() -> ConditionalPushRule
👎Deprecated: Since Matrix 1.7. Use the m.mentions property with ConditionalPushRule::is_user_mention() instead.
pub fn contains_display_name() -> ConditionalPushRule
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() -> ConditionalPushRule
pub fn tombstone() -> ConditionalPushRule
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() -> ConditionalPushRule
pub fn is_room_mention() -> ConditionalPushRule
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() -> ConditionalPushRule
👎Deprecated: Since Matrix 1.7. Use the m.mentions property with ConditionalPushRule::is_room_mention() instead.
pub fn roomnotif() -> ConditionalPushRule
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 reaction() -> ConditionalPushRule
pub fn reaction() -> ConditionalPushRule
Matches reactions to a message.
sourcepub fn server_acl() -> ConditionalPushRule
pub fn server_acl() -> ConditionalPushRule
Matches room server ACLs.
sourcepub fn suppress_edits() -> ConditionalPushRule
pub fn suppress_edits() -> ConditionalPushRule
Matches event replacements.
sourcepub fn poll_response() -> ConditionalPushRule
pub fn poll_response() -> ConditionalPushRule
source§impl ConditionalPushRule
impl ConditionalPushRule
Default underrides push rules
sourcepub fn call() -> ConditionalPushRule
pub fn call() -> ConditionalPushRule
Matches any incoming VOIP call.
sourcepub fn encrypted_room_one_to_one() -> ConditionalPushRule
pub fn encrypted_room_one_to_one() -> ConditionalPushRule
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() -> ConditionalPushRule
pub fn room_one_to_one() -> ConditionalPushRule
Matches any message sent in a room with exactly two members.
sourcepub fn message() -> ConditionalPushRule
pub fn message() -> ConditionalPushRule
Matches all chat messages.
sourcepub fn encrypted() -> ConditionalPushRule
pub fn encrypted() -> ConditionalPushRule
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() -> ConditionalPushRule
pub fn poll_start_one_to_one() -> ConditionalPushRule
sourcepub fn poll_start() -> ConditionalPushRule
pub fn poll_start() -> ConditionalPushRule
sourcepub fn poll_end_one_to_one() -> ConditionalPushRule
pub fn poll_end_one_to_one() -> ConditionalPushRule
sourcepub fn poll_end() -> ConditionalPushRule
pub fn poll_end() -> ConditionalPushRule
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<ConditionalPushRule, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(
__deserializer: __D,
) -> Result<ConditionalPushRule, <__D as Deserializer<'de>>::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<ConditionalPushRule> for PushRule
impl From<ConditionalPushRule> for PushRule
source§fn from(push_rule: ConditionalPushRule) -> PushRule
fn from(push_rule: ConditionalPushRule) -> PushRule
source§impl From<ConditionalPushRuleInit> for ConditionalPushRule
impl From<ConditionalPushRuleInit> for ConditionalPushRule
source§fn from(init: ConditionalPushRuleInit) -> ConditionalPushRule
fn from(init: ConditionalPushRuleInit) -> ConditionalPushRule
source§impl From<NewConditionalPushRule> for ConditionalPushRule
impl From<NewConditionalPushRule> for ConditionalPushRule
source§fn from(new_rule: NewConditionalPushRule) -> ConditionalPushRule
fn from(new_rule: NewConditionalPushRule) -> ConditionalPushRule
source§impl From<PushRule> for ConditionalPushRule
impl From<PushRule> for ConditionalPushRule
source§fn from(push_rule: PushRule) -> ConditionalPushRule
fn from(push_rule: PushRule) -> ConditionalPushRule
source§impl Hash for ConditionalPushRule
impl Hash for ConditionalPushRule
source§impl PartialEq for ConditionalPushRule
impl PartialEq for ConditionalPushRule
source§fn eq(&self, other: &ConditionalPushRule) -> bool
fn eq(&self, other: &ConditionalPushRule) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl Serialize for ConditionalPushRule
impl Serialize for ConditionalPushRule
source§fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
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.