Struct EventLog 

pub struct EventLog { /* private fields */ }

Thread-safe ring-buffer event log. Automatically evicts the oldest events when capacity is reached. All operations recover from mutex poisoning.

Implementations

impl EventLog

pub fn new(max_capacity: usize) -> Self

Creates a new event log with the given maximum capacity.

use victauri_core::EventLog;

let log = EventLog::new(100);
assert!(log.is_empty());
assert_eq!(log.capacity(), 100);

pub fn capacity(&self) -> usize

Returns the maximum number of events this log can hold.

pub fn push(&self, event: AppEvent)

Appends an event, evicting the oldest if at capacity.

Examples

use victauri_core::{EventLog, AppEvent};
use chrono::Utc;

let log = EventLog::new(100);
log.push(AppEvent::StateChange {
    key: "theme".to_string(),
    timestamp: Utc::now(),
    caused_by: None,
});
assert_eq!(log.len(), 1);
assert_eq!(log.snapshot().len(), 1);

pub fn snapshot(&self) -> Vec<AppEvent>

Returns a clone of all events currently in the log.

pub fn snapshot_range(&self, offset: usize, limit: usize) -> Vec<AppEvent>

Returns a paginated slice of events starting at offset, up to limit items.

pub fn since(&self, timestamp: DateTime<Utc>) -> Vec<AppEvent>

Returns all events with a timestamp at or after the given time.

pub fn ipc_calls(&self) -> Vec<IpcCall>

Returns all IPC call events, filtering out non-IPC events.

Examples

use victauri_core::{EventLog, AppEvent, IpcCall, IpcResult};
use chrono::Utc;

let log = EventLog::new(100);
log.push(AppEvent::Ipc(IpcCall {
    id: "c1".to_string(),
    command: "greet".to_string(),
    timestamp: Utc::now(),
    duration_ms: Some(5),
    result: IpcResult::Ok(serde_json::json!("hi")),
    arg_size_bytes: 0,
    webview_label: "main".to_string(),
}));
assert_eq!(log.ipc_calls().len(), 1);

pub fn ipc_calls_since(&self, timestamp: DateTime<Utc>) -> Vec<IpcCall>

Returns IPC calls with a timestamp at or after the given time.

pub fn len(&self) -> usize

Returns the number of events currently in the log.

pub fn is_empty(&self) -> bool

Returns true if the log contains no events.

pub fn clear(&self)

Removes all events from the log.

Trait Implementations

impl Clone for EventLog

fn clone(&self) -> EventLog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventLog

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

Formats the value using the given formatter.