Struct Printer 

pub struct Printer { /* private fields */ }

Implementations

impl Printer

pub fn new(verbosity: Verbosity) -> Self

Production constructor: stderr/stdout via console::Term.

pub fn with_theme_name(verbosity: Verbosity, theme_name: Option<&str>) -> Self

pub fn with_format( verbosity: Verbosity, theme_name: Option<&str>, output_format: OutputFormat, ) -> Self

pub fn verbosity(&self) -> Verbosity

pub fn output_format(&self) -> &OutputFormat

pub fn is_structured(&self) -> bool

pub fn is_wide(&self) -> bool

pub fn disable_colors()

Disable color globally (today’s disable_colors).

pub fn enable_colors()

Force color globally regardless of TTY detection. Symmetric to disable_colors so demo / example binaries that pipe their output for capture can still emit real ANSI escapes. Production CLI dispatch goes through with_format, which honors NO_COLOR and structured-output gating — call this only from non-production entry points.

pub fn heading(&self, text: impl Into<String>)

pub fn kv(&self, key: impl Into<String>, value: impl Into<String>)

pub fn kv_block<I, K, V>(&self, pairs: I)

where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

pub fn hint(&self, text: impl Into<String>)

pub fn note(&self, text: impl Into<String>)

pub fn table(&self, table: Table)

pub fn status_simple(&self, role: Role, subject: impl Into<String>)

Status with no extra fields. For detail/duration/target, use the builder returned by the binding helper status (see status_builder.rs).

pub fn status( &self, role: Role, subject: impl Into<String>, ) -> StatusBuilder<'_>

Status builder at depth 0. Commits on Drop.

pub fn spinner(&self, message: impl Into<String>) -> Spinner<'_>

Top-level spinner (depth 0). Required for ~14 lib-side call sites in cfgd-core that today take &Printer and have no section context (oci/, upgrade/, sources/, modules/git.rs, reconciler/scripts.rs).

pub fn progress_bar( &self, total: u64, message: impl Into<String>, ) -> ProgressBar<'_>

pub fn multi_progress(&self) -> &MultiProgress

Expose the underlying MultiProgress for callers that need fine-grained control (kept for API parity with the old Printer).

pub fn run( &self, cmd: &mut Command, label: impl Into<String>, ) -> Result<CommandOutput>

Run an external command at top-level (depth 0) with live output. TTY+non-quiet → spinner with tailing ring; otherwise → streaming lines. Either path captures full stdout/stderr in the returned CommandOutput.

pub fn flush(&self)

Final flush — call at the end of a streaming command to ensure any buffered kvs land. (Drop on Printer would also do this but tests need explicit control.)

pub fn render(&self, doc: Doc)

Force human render of a Doc to stderr, regardless of output_format. Used by tests; production code should call emit (T24) which routes by OutputFormat and falls back to this for human formats.

pub fn emit(&self, doc: Doc)

Routed emit: structured formats go to stdout as JSON/YAML/etc.; Table/Wide go to stderr as the human render. This is the canonical buffered-output entry; production callers use this, not render.

pub fn section(&self, name: impl Into<String>) -> SectionGuard<'_>

pub fn section_or_collapse(&self, name: impl Into<String>) -> SectionGuard<'_>

impl Printer

pub fn prompt_confirm(&self, message: &str) -> Result<bool, InquireError>

pub fn prompt_select<'a>( &self, message: &str, options: &'a [String], ) -> Result<&'a String, InquireError>

pub fn prompt_text( &self, message: &str, default: &str, ) -> Result<String, InquireError>

impl Printer

pub fn diff(&self, old: &str, new: &str)

Diff renderer. Goes to stderr.

pub fn syntax_highlight(&self, code: &str, lang: &str)

Syntax-highlighted code. Goes to stderr.

pub fn data_line(&self, text: &str)

Raw stdout line, no decoration, no indent. For config get-shaped callers whose output is consumed by other programs.

Trait Implementations

impl Drop for Printer

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.