Struct UsesCollector 

pub struct UsesCollector { /* private fields */ }

Global uses collector - fire-and-forget event capture

Uses a bounded channel to prevent unbounded memory growth. Events are written to disk by a background thread.

Implementations

impl UsesCollector

pub fn new(uses_dir: &Path, enabled: bool) -> Self

Create a new uses collector

Spawns a background thread that writes events to disk.

Arguments

• uses_dir - Directory to store event logs (e.g., ~/.sqry/uses/)
• enabled - Whether to actually record events

Returns

A new UsesCollector instance. The background writer thread is automatically spawned and will run until the collector is dropped.

pub fn disabled() -> Self

Create a disabled collector that doesn’t record anything

pub fn record(&self, event: UseEvent)

Record a use event (non-blocking, fire-and-forget)

Uses try_send - drops events if queue is full (backpressure). Disconnected errors are also ignored for graceful shutdown.

Arguments

• event - The event to record

pub fn record_event(&self, event_type: UseEventType)

Record an event of a specific type with the current timestamp

Convenience method that creates a UseEvent and records it.

pub fn timed(&self, event_type: UseEventType) -> CollectorTimedUse<'_>

Create a scoped timer that auto-records duration on drop

Returns a CollectorTimedUse that, when dropped, records the event with the elapsed duration.

Arguments

• event_type - The event type to record (duration will be added)

Returns

A timer that records the event on drop

pub fn set_enabled(&self, enabled: bool)

Enable or disable event recording

pub fn is_enabled(&self) -> bool

Check if recording is enabled

pub fn dropped_count(&self) -> u64

Get count of dropped events (for diagnostics)

Events are dropped when the queue is full (backpressure). A high count may indicate performance issues.

pub fn reset_dropped_count(&self)

Reset the dropped events counter

Trait Implementations

impl Clone for UsesCollector

fn clone(&self) -> UsesCollector

Returns a duplicate of the value.

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

Performs copy-assignment from source.