Struct LspLogger 

pub struct LspLogger { /* private fields */ }

Producer-side log facade. One per LSP subsystem; each actor gets a clone (cheap – internal state is Arc<Mutex<...>>).

Cheap-by-design: append is O(1) amortized, level gating is one HashMap lookup, trace gating is one HashSet lookup. Logging is not a hot path – per-keystroke cost is the didChange encode + send, not the log emission.

Implementations

impl LspLogger

pub fn new(default_min_level: LogLevel, default_capacity: usize) -> Self

Construct a logger with the given default min level and default per-server ring capacity (e.g. LogLevel::Info, 10_000). Conservative defaults: Info filters out trace noise; 10k records ≈ a few MB of memory at most.

pub fn set_event_publisher(&self, publisher: LogEventPublisher)

Install / replace the event publisher. Subsequent log calls fire the closure with LspLogPushed after the record lands in its ring. The App wires this at boot so the runtime event bus sees every append; subscribers (live log views) drain the bus on tick.

pub fn with_defaults() -> Self

Sensible defaults: Info level, 10k records / ring.

pub fn log( &self, instance: Option<&InstanceKey>, level: LogLevel, source: LogSource, message: impl Into<String>, )

Append a record. Gated by per-instance min level (or the default). Records with instance = None route to the subsystem-wide ring (*lsp*) and use the default min level. Trace-level records are additionally gated by the per-instance trace toggle.

pub fn is_tracing(&self, instance: &InstanceKey) -> bool

True iff trace mode is enabled for the instance. Cheap; the trace interceptors call this once per message and short-circuit the record build when false.

pub fn enable_trace(&self, instance: InstanceKey)

Enable JSON-RPC trace for an instance. Trace records start landing in the per-instance ring on the next emission.

pub fn disable_trace(&self, instance: &InstanceKey)

Disable JSON-RPC trace for an instance.

pub fn toggle_trace(&self, instance: InstanceKey) -> bool

Toggle JSON-RPC trace for an instance; returns the new state (true = on).

pub fn set_instance_level(&self, instance: InstanceKey, level: Option<LogLevel>)

Set per-instance min level. None removes the override and reverts to the default.

pub fn set_default_level(&self, level: LogLevel)

Set the default min level (applies to subsystem-wide records and to instances without an override).

pub fn set_default_capacity(&self, capacity: usize)

Set the default ring capacity. Existing rings are resized; future per-instance rings inherit the new value.

pub fn snapshot_global(&self) -> Vec<LogRecord>

Snapshot the subsystem-wide ring. Used by the *lsp* buffer view to populate its body.

pub fn snapshot_instance(&self, instance: &InstanceKey) -> Vec<LogRecord>

Snapshot an instance’s ring (empty if the instance has never logged anything).

pub fn known_instances(&self) -> Vec<InstanceKey>

List every instance with a per-instance ring. Useful for :lsp-status and the *lsp* buffer’s “servers” header.

pub fn clear_global(&self)

Drop the subsystem-wide ring’s contents.

pub fn clear_instance(&self, instance: &InstanceKey)

Drop an instance’s ring contents.

Trait Implementations

impl Clone for LspLogger

fn clone(&self) -> LspLogger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LspLogger

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

Formats the value using the given formatter.

impl Default for LspLogger

fn default() -> Self

Returns the “default value” for a type.