Struct SmartCollection 

pub struct SmartCollection {
    pub collection: Collection,
    pub rules: Vec<SmartRule>,
    pub match_mode: MatchMode,
    pub auto_update: bool,
    pub last_updated: DateTime<Utc>,
    pub poll_interval_secs: Option<u64>,
    pub cached_clip_ids: Vec<ClipId>,
    pub cache_valid: bool,
}

A smart collection that auto-updates based on rules.

Fields

collection: Collection

Base collection.

rules: Vec<SmartRule>

Rules for matching clips.

match_mode: MatchMode

Match mode.

auto_update: bool

Auto-update enabled.

last_updated: DateTime<Utc>

Last update timestamp.

poll_interval_secs: Option<u64>

Polling interval for auto-refresh in seconds. None means no polling.

cached_clip_ids: Vec<ClipId>

Cached result: clip IDs that currently match the rules.

cache_valid: bool

Whether the cache is considered valid.

Implementations

impl SmartCollection

pub fn new( name: impl Into<String>, rules: Vec<SmartRule>, match_mode: MatchMode, ) -> Self

Creates a new smart collection.

pub fn set_poll_interval(&mut self, interval: Duration)

Sets the polling interval for auto-refresh.

When set, needs_refresh() will return true if more than interval has elapsed since the last update.

pub fn clear_poll_interval(&mut self)

Clears the polling interval (disables timed auto-refresh).

pub fn poll_interval(&self) -> Option<Duration>

Returns the configured poll interval, if any.

pub fn needs_refresh(&self) -> bool

Returns true if the collection should be refreshed.

Criteria:

• auto_update is enabled, AND
• either the cache is marked invalid, OR the poll interval has elapsed.

pub fn invalidate_cache(&mut self)

Invalidates the cached results, forcing the next call to needs_refresh (when auto_update is enabled) to return true.

pub fn cached_clip_ids(&self) -> Option<&[ClipId]>

Returns the cached clip IDs if the cache is valid.

pub const fn id(&self) -> CollectionId

Returns the collection ID.

pub fn matches(&self, clip: &Clip) -> bool

Checks if a clip matches the smart collection rules.

pub fn update(&mut self, clips: &[Clip])

Updates the collection by evaluating all clips.

Also refreshes the internal cache so that cached_clip_ids() returns the up-to-date list.

pub fn refresh_if_needed(&mut self, clips: &[Clip]) -> bool

Updates the collection only if needs_refresh() returns true.

Returns true if a refresh was performed.

pub fn add_rule(&mut self, rule: SmartRule)

Adds a rule.

pub fn remove_rule(&mut self, index: usize) -> Option<SmartRule>

Removes a rule at index.

pub fn set_match_mode(&mut self, mode: MatchMode)

Sets the match mode.

Trait Implementations

impl Clone for SmartCollection

fn clone(&self) -> SmartCollection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SmartCollection

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SmartCollection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SmartCollection

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

where __S: Serializer,

Serialize this value into the given Serde serializer.