Struct StdinSource 

pub struct StdinSource { /* private fields */ }

Implementations

impl StdinSource

pub fn read_all() -> Result<Self>

Read all of stdin into a buffer synchronously. After this returns, stdin (fd 0) is at EOF; the caller is responsible for redirecting fd 0 to /dev/tty before entering raw mode if interactive input is needed.

pub fn spawn_streaming() -> Result<Self>

Duplicate fd 0 onto a private fd, then spawn a thread that reads from it into a shared buffer. Caller can safely dup2(/dev/tty, 0) afterwards without disturbing the thread — it reads from the duplicated fd, not from STDIN_FILENO.

Trait Implementations

impl Source for StdinSource

fn len(&self) -> usize

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

fn is_complete(&self) -> bool

fn is_empty(&self) -> bool

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 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.