Struct ruma_common::push::Ruleset [−][src]
pub struct Ruleset { pub content: IndexSet<PatternedPushRule>, pub override_: IndexSet<ConditionalPushRule>, pub room: IndexSet<SimplePushRule>, pub sender: IndexSet<SimplePushRule>, pub underride: IndexSet<ConditionalPushRule>, }
Expand description
A push ruleset scopes a set of rules according to some criteria.
For example, some rules may only be applied for messages from a particular sender, a particular room, or by default. The push ruleset contains the entire set of scopes and rules.
Fields
content: IndexSet<PatternedPushRule>
These rules configure behavior for (unencrypted) messages that match certain patterns.
override_: IndexSet<ConditionalPushRule>
These user-configured rules are given the highest priority.
This field is named override_
instead of override
because the latter is a reserved
keyword in Rust.
room: IndexSet<SimplePushRule>
These rules change the behavior of all messages for a given room.
sender: IndexSet<SimplePushRule>
These rules configure notification behavior for messages from a specific Matrix user ID.
underride: IndexSet<ConditionalPushRule>
These rules are identical to override rules, but have a lower priority than content
,
room
and sender
rules.
Implementations
The list of all predefined push rules.
Parameters
user_id
: the user for which to generate the default rules. Some rules depend on the user’s ID (for instance those to send notifications when they are mentioned).
pub fn iter(&self) -> RulesetIter<'_>ⓘNotable traits for RulesetIter<'a>
impl<'a> Iterator for RulesetIter<'a> type Item = AnyPushRuleRef<'a>;
pub fn iter(&self) -> RulesetIter<'_>ⓘNotable traits for RulesetIter<'a>
impl<'a> Iterator for RulesetIter<'a> type Item = AnyPushRuleRef<'a>;
Creates a borrowing iterator over all push rules in this Ruleset
.
For an owning iterator, use .into_iter()
.
Adds a rule to the rule set.
Returns true
if the new rule was correctly added, and false
if a rule with the same rule_id
is already present for this kind
of rule.
pub fn get_match<T>(
&self,
event: &Raw<T>,
context: &PushConditionRoomCtx
) -> Option<AnyPushRuleRef<'_>> where
T: Serialize,
pub fn get_match<T>(
&self,
event: &Raw<T>,
context: &PushConditionRoomCtx
) -> Option<AnyPushRuleRef<'_>> where
T: Serialize,
Get the first push rule that applies to this event, if any.
Arguments
event
- The raw JSON of a room message event.context
- The context of the message and room at the time of the event.
pub fn get_actions<T>(
&self,
event: &Raw<T>,
context: &PushConditionRoomCtx
) -> &[Action] where
T: Serialize,
pub fn get_actions<T>(
&self,
event: &Raw<T>,
context: &PushConditionRoomCtx
) -> &[Action] where
T: Serialize,
Get the push actions that apply to this event.
Returns an empty slice if no push rule applies.
Arguments
event
- The raw JSON of a room message event.context
- The context of the message and room at the time of the event.
Trait Implementations
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>,
Deserialize this value from the given Serde deserializer. Read more
Extends a collection with the contents of an iterator. Read more
extend_one
)Extends a collection with exactly one element.
extend_one
)Reserves capacity in a collection for the given number of additional elements. Read more
type Item = AnyPushRule
type Item = AnyPushRule
The type of the elements being iterated over.
type IntoIter = RulesetIntoIter
type IntoIter = RulesetIntoIter
Which kind of iterator are we turning this into?
type Item = AnyPushRuleRef<'a>
type Item = AnyPushRuleRef<'a>
The type of the elements being iterated over.
type IntoIter = RulesetIter<'a>
type IntoIter = RulesetIter<'a>
Which kind of iterator are we turning this into?
Auto Trait Implementations
impl RefUnwindSafe for Ruleset
impl UnwindSafe for Ruleset
Blanket Implementations
Mutably borrows from an owned value. Read more
Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more