Struct Logger 

pub struct Logger { /* private fields */ }

Logger for handling output with cargo-style progress and status messages.

All progress and status messages go to stderr (matching cargo’s behavior). This allows command output (badges, changelog, etc.) to be piped cleanly through stdout while progress messages appear on the console.

Implementations

impl Logger

pub fn new() -> Self

Create a new logger.

pub fn progress(&mut self, message: &str)

Show a progress bar (ephemeral, disappears on finish).

Use this for operations with known progress. Always uses stderr (matching cargo’s behavior).

pub fn set_progress_message(&self, message: &str)

Update the progress bar message.

pub fn status(&mut self, action: &str, target: &str)

Print a status message in cargo’s style: “ Building crate-name“.

Uses cyan color for the action word (ephemeral operations). This creates an ephemeral message that will be cleared on finish(). Always goes to stderr (matching cargo’s behavior).

pub fn status_permanent(&self, action: &str, target: &str)

Print a permanent status message in cargo’s style: “ Compiling crate-name“.

Uses green color for the action word (permanent operations). This message will NOT be cleared - use for operations that spawn subprocesses. Always goes to stderr (matching cargo’s behavior).

pub fn print_message(&self, msg: &str)

Print a permanent message (will be kept in output).

Always goes to stderr (matching cargo’s behavior).

pub fn info(&self, action: &str, target: &str)

Print an info message (cyan colored).

Info messages are permanent (not cleared). Always goes to stderr (matching cargo’s behavior).

pub fn warning(&self, action: &str, target: &str)

Print a warning message (yellow colored).

Warning messages are permanent (not cleared). Always goes to stderr (matching cargo’s behavior).

pub fn error(&self, action: &str, target: &str)

Print an error message (red colored).

Error messages are permanent (not cleared). Always goes to stderr (matching cargo’s behavior).

pub fn clear_status(&mut self)

Clear the current status message immediately.

Useful before subprocess operations that might write to stderr.

pub fn suspend<F, R>(&mut self, f: F) -> R

where F: FnOnce() -> R,

Temporarily suspend the status message (for subprocess output).

Call this before spawning subprocesses that write to stderr to avoid mixing their output with our status line.

pub fn finish(&mut self)

Finish logging and clear ephemeral status messages.

Trait Implementations

impl Default for Logger

fn default() -> Self

Returns the “default value” for a type.

impl Drop for Logger

fn drop(&mut self)

Executes the destructor for this type.