Struct LiveFileSource 

pub struct LiveFileSource { /* private fields */ }

A file source that watches for whole-file rewrites. Unlike FileSource (which only picks up appended bytes via a streaming handle), LiveFileSource re-reads the entire file when its (mtime, size, ino) signature changes, swaps the buffer in place, and bumps a revision counter so callers know to rebuild any per-line state. Intended for source-file-sized inputs being rewritten by an editor or AI agent.

Implementations

impl LiveFileSource

pub fn open(path: &Path) -> Result<Self>

Trait Implementations

impl Debug for LiveFileSource

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

Formats the value using the given formatter.

impl Source for LiveFileSource

fn is_complete(&self) -> bool

Live sources are never “complete” — the file may be rewritten at any time. The status line picks this up as the + suffix on totals.

fn len(&self) -> usize

fn bytes(&self, range: Range<usize>) -> Cow<'_, [u8]>

fn pump(&self)

Read any new bytes that have become available since the last call. Default no-op for static sources. Streaming sources override.

fn revision(&self) -> u64

Monotonic counter that bumps whenever the source’s content has been replaced wholesale (as opposed to merely appended to). Append-style sources keep this at 0; LiveFileSource increments it on each detected rewrite so the event loop knows to rebuild the line index instead of just folding in new bytes.

fn is_empty(&self) -> bool

fn prettify_mode(&self) -> Option<PrettifyMode>

Current prettify mode if this source has a TransformingSource wrapper. None means the source is not capable of prettification (e.g. a plain FileSource). Some(Off) means wrapped but currently raw.

fn prettify_label(&self) -> Option<String>

Status-line label for the active prettify state, e.g. "json" or "json:err". None when there’s no wrapper or the mode is Off without an error.

fn set_prettify_mode(&self, _mode: PrettifyMode)

Switch to a specific prettify mode. No-op for sources without a wrapper. Bumps revision() so callers know to rebuild the line index.

fn toggle_prettify(&self)

Flip between the current mode and the last active (non-Off) mode. No-op if the source is not wrapped, or if it has never had an active mode (i.e. only ever been raw).

fn redetect_prettify(&self)

Re-run byte-based content detection and apply the result. Used by the interactive -Pa (“auto”) sub-command. No-op without a wrapper.

fn take_rotated(&self) -> bool

Returns true once when the source detected that its backing file was rotated or truncated. Append-style sources always return false. FileSource overrides this and consumes the flag on each call so the app loop only reacts once per event.

fn path(&self) -> Option<&Path>

Source’s on-disk path, when one exists. Used by the app loop to re-open the source after take_rotated() returns true. None for stdin / mock sources.