Struct Output 

pub struct Output { /* private fields */ }

Sink for plugin output. Plugins write here instead of println! so output stays consistent with the requested mode and verbosity.

Implementations

impl Output

pub fn for_context(ctx: &Context, writer: impl Write + Send + 'static) -> Self

Build an Output from a Context and a writer (typically stdout).

pub fn with_writer(self, writer: impl Write + Send + 'static) -> Self

Replace the inner writer. Useful in tests.

pub const fn mode(&self) -> OutputMode

Reported output mode.

pub const fn color(&self) -> ColorMode

Reported color preference.

pub fn human(&mut self, msg: &str)

Write a human-readable message terminated by a newline.

Suppressed when the log level is LogLevel::Quiet or the output mode is OutputMode::Json.

pub fn json<T: Serialize>(&mut self, value: &T) -> Result<()>

Serialize a value as a single line of JSON to the output.

Always emits regardless of log level (errors are surfaced via Self::error).

Errors

Returns an Error::JsonParse if serialization fails or an Error::Io if writing to the underlying writer fails.

pub fn error(&mut self, err: &dyn Error)

Print an error using the writer’s diagnostic conventions.

pub fn flush(&mut self) -> Result<()>

Flush the underlying writer.

Errors

Forwards I/O failures from the underlying writer.