Struct Nucleo 

pub struct Nucleo<T: Sync + Send + 'static> {
    pub pattern: MultiPattern,
    /* private fields */
}

A high level matcher worker that quickly computes matches in a background threadpool.

Fields

pattern: MultiPattern

The pattern matched by this matcher. To update the match pattern MultiPattern::reparse should be used. Note that the matcher worker will only become aware of the new pattern after a call to tick.

Implementations

impl<T: Sync + Send + 'static> Nucleo<T>

pub fn new( config: Config, notify: Arc<dyn Fn() + Sync + Send>, num_threads: Option<usize>, columns: u32, ) -> Self

Constructs a new nucleo worker threadpool with the provided config.

notify is called everytime new information is available and tick should be called. Note that notify is not debounced, that should be handled by the downstream crate (for example debouncing to only redraw at most every 1/60 seconds).

If None is passed for the number of worker threads, nucleo will use one thread per hardware thread.

Nucleo can match items with multiple orthogonal properties. columns indicates how many matching columns each item (and the pattern) has. The number of columns cannot be changed after construction.

pub fn active_injectors(&self) -> usize

Returns the total number of active injectors

pub fn snapshot(&self) -> &Snapshot<T>

Returns a snapshot of the current matcher state.

pub fn injector(&self) -> Injector<T>

Returns an injector that can be used for adding candidates to the matcher.

pub fn restart(&mut self, clear_snapshot: bool)

Restart the the item stream. Removes all items and disconnects all previously created injectors from this instance. If clear_snapshot is true then all items and matched are removed from the Snapshot immediately. Otherwise the snapshot will keep the current matches until the matcher has run again.

Note

The injectors will continue to function but they will not affect this instance anymore. The old items will only be dropped when all injectors were dropped.

pub fn update_config(&mut self, config: Config)

Update the internal configuration.

pub fn sort_results(&mut self, sort_results: bool)

pub fn reverse_items(&mut self, reverse_items: bool)

pub fn tick(&mut self, timeout: u64) -> Status

The main way to interact with the matcher, this should be called regularly (for example each time a frame is rendered). To avoid excessive redraws this method will wait timeout milliseconds for the worker thread to finish. It is recommend to set the timeout to 10ms.

Trait Implementations

impl<T: Sync + Send> Drop for Nucleo<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.