Struct Context 

pub struct Context { /* private fields */ }

Available on crate feature context only.

Context is useful for taking moderation actions on a per-user basis i.e. each user would get their own Context.

Recommendation

Use this as a reference implementation e.g. by copying and adapting it.

Implementations

impl Context

pub fn new() -> Self

pub fn process(&mut self, message: String) -> Result<String, BlockReason>

Takes user message, returns censored message trimmed of whitespace (if it should be sent) or BlockReason (explaining why it should be blocked entirely).

pub fn process_with_options( &mut self, message: String, options: &ContextProcessingOptions, ) -> Result<String, BlockReason>

Takes user message, returns censored message trimmed of whitespace (if it should be sent) or BlockReason (explaining why it should be blocked entirely).

Takes a set of options for fine-tuning the processing.

pub fn muted_for(&self) -> Duration

Returns how long the user is muted for (possibly Duration::ZERO).

pub fn last_message(&self) -> Option<Instant>

Returns the instant of the last processed message.

pub fn muted_until(&self) -> Option<Instant>

Returns the latest instant the user is muted (possibly in the past).

pub fn restricted_for(&self) -> Duration

Returns how long the user is restricted to Type::SAFE for (possibly Duration::ZERO).

pub fn restricted_until(&self) -> Option<Instant>

Returns the latest instant the user is restricted (possibly in the past).

pub fn mute_for(&mut self, duration: Duration)

Manually mute this user’s messages for a duration. Overwrites any previous manual mute. Passing Duration::ZERO will therefore un-mute.

pub fn mute_until(&mut self, instant: Instant)

Manually mute this user’s messages until an instant. Overwrites any previous manual mute. Passing an instant in the past will therefore un-mute.

pub fn restrict_for(&mut self, duration: Duration)

Manually restrict this user’s messages to known safe phrases for a duration. Overwrites any previous manual restriction. Passing Duration::ZERO will therefore un-restrict.

pub fn restrict_until(&mut self, instant: Instant)

Manually restrict this user’s messages to known safe phrases until an instant. Overwrites any previous manual restriction. Passing an instant in the past will therefore un-restrict.

pub fn report(&mut self)

Call if another user “reports” this user’s message(s). The function of reports is for suspicion of bad behavior to be confirmed faster.

pub fn reports(&self) -> usize

Returns number of reports received via Self::report(). It is not guaranteed that the full range of usize of reports will be counted (currently only u8::MAX are counted).

pub fn exonerate(&mut self)

Clear suspicion, reports, inappropriate counter, and automatic mutes (not manual mute or rate limit).

pub fn total(&self) -> usize

Returns total number of messages processed. It is not guaranteed that the full range of usize of messages will be counted (currently only u16::MAX are counted).

pub fn total_inappropriate(&self) -> usize

Returns total number of messages processed that were Type::INAPPROPRIATE. It is not guaranteed that the full range of usize of messages will be counted (currently only u16::MAX are counted).

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.

impl Default for Context

fn default() -> Self

Returns the “default value” for a type.