Struct SectionGuard 

pub struct SectionGuard<'p> { /* private fields */ }

Open section. Holds a reference to Printer and the renderer’s depth. Drop closes the section: emits a deferred (none) placeholder if no children rendered (and keep_when_empty was true), or leaves no trace (if keep_when_empty was false).

Implementations

impl<'p> SectionGuard<'p>

pub fn bullet(&self, text: impl Into<String>) -> &Self

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

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

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

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

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

pub fn table(&self, table: Table) -> &Self

pub fn empty_state(&self, text: impl Into<String>) -> &Self

Set the empty-state placeholder for this section (overrides the default “(none)”). Only meaningful for sections opened with section() (not section_or_collapse()).

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

Status with no extra fields. For chained detail/duration/target, use status for the chainable builder.

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

Status builder at this section’s depth. Commits on Drop.

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

Open a child section. Returns a guard that borrows &self so the parent is locked until the child drops.

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

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

Section-scoped spinner. Inherits the section’s depth so the eventual Status emitted by finish_* lands at the right indentation.

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

Section-scoped progress bar.

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

Run an external command at this section’s depth with live output. TTY+non-quiet → spinner with tailing ring indented under the section; otherwise → streaming lines. Either path captures full stdout/stderr.

pub fn close(self)

Manually close (alternative to drop). Useful when the caller needs the section to close before the binding goes out of scope.

Trait Implementations

impl Drop for SectionGuard<'_>

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.