[−][src]Trait color_eyre::section::help::Help
A helper trait for attaching help text to errors to be displayed after the chain of errors
color_eyre
provides two types of help text that can be attached to error reports: custom
sections and pre-configured sections. Custom sections are added via the section
and
with_section
methods, and give maximum control over formatting. For more details check out
the docs for Section
.
The pre-configured sections are provided via suggestion
, warning
, and note
. These
sections are displayed after all other sections with no extra newlines between subsequent Help
sections. They consist only of a header portion and are prepended with a colored string
indicating the kind of section, e.g. `Note: This might have failed due to ..."
Required methods
fn section<D>(self, section: D) -> Result<T> where
D: Display + Send + Sync + 'static,
D: Display + Send + Sync + 'static,
Add a section to an error report, to be displayed after the chain of errors.
Sections are displayed in the order they are added to the error report. They are displayed
immediately after the Error:
section and before the SpanTrace
and Backtrace
sections.
They consist of a header and an optional body. The body of the section is indented by
default.
Examples
use color_eyre::{eyre::eyre, Report, Help}; Err(eyre!("command failed")) .section("Please report bugs to https://real.url/bugs")?;
fn with_section<D, F>(self, section: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
Add a Section to an error report, to be displayed after the chain of errors. The closure to create the Section is lazily evaluated only in the case of an error.
Examples
use color_eyre::{eyre::eyre, Report, Help, SectionExt}; let output = std::process::Command::new("ls") .output()?; let output = if !output.status.success() { let stderr = String::from_utf8_lossy(&output.stderr); Err(eyre!("cmd exited with non-zero status code")) .with_section(move || stderr.trim().to_string().header("Stderr:"))? } else { String::from_utf8_lossy(&output.stdout) }; println!("{}", output);
fn error<E>(self, error: E) -> Result<T> where
E: Error + Send + Sync + 'static,
E: Error + Send + Sync + 'static,
Add an error section to an error report, to be displayed after the primary error message section.
Examples
use color_eyre::{eyre::eyre, Report, Help}; use thiserror::Error; #[derive(Debug, Error)] #[error("{0}")] struct StrError(&'static str); Err(eyre!("command failed")) .error(StrError("got one error")) .error(StrError("got a second error"))?;
fn with_error<E, F>(self, error: F) -> Result<T> where
F: FnOnce() -> E,
E: Error + Send + Sync + 'static,
F: FnOnce() -> E,
E: Error + Send + Sync + 'static,
Add an error section to an error report, to be displayed after the primary error message section. The closure to create the Section is lazily evaluated only in the case of an error.
Examples
use color_eyre::{eyre::eyre, Report, Help}; use thiserror::Error; #[derive(Debug, Error)] #[error("{0}")] struct StringError(String); Err(eyre!("command failed")) .with_error(|| StringError("got one error".into())) .with_error(|| StringError("got a second error".into()))?;
fn note<D>(self, note: D) -> Result<T> where
D: Display + Send + Sync + 'static,
D: Display + Send + Sync + 'static,
Add a Note to an error report, to be displayed after the chain of errors.
Examples
use color_eyre::Help as _; fallible_fn().note("This might have failed due to ...")?;
fn with_note<D, F>(self, f: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
Add a Note to an error report, to be displayed after the chain of errors. The closure to create the Note is lazily evaluated only in the case of an error.
Examples
use color_eyre::Help as _; fallible_fn().with_note(|| { format!("This might have failed due to ... It has failed {} times", 100) })?;
fn warning<D>(self, warning: D) -> Result<T> where
D: Display + Send + Sync + 'static,
D: Display + Send + Sync + 'static,
Add a Warning to an error report, to be displayed after the chain of errors.
fn with_warning<D, F>(self, f: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
Add a Warning to an error report, to be displayed after the chain of errors. The closure to create the Warning is lazily evaluated only in the case of an error.
fn suggestion<D>(self, suggestion: D) -> Result<T> where
D: Display + Send + Sync + 'static,
D: Display + Send + Sync + 'static,
Add a Suggestion to an error report, to be displayed after the chain of errors.
fn with_suggestion<D, F>(self, f: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
Add a Suggestion to an error report, to be displayed after the chain of errors. The closure to create the Suggestion is lazily evaluated only in the case of an error.
Implementations on Foreign Types
impl<T, E> Help<T> for Result<T, E> where
E: Into<Report>,
[src]
E: Into<Report>,
fn note<D>(self, note: D) -> Result<T> where
D: Display + Send + Sync + 'static,
[src]
D: Display + Send + Sync + 'static,
fn with_note<D, F>(self, note: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
[src]
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
fn warning<D>(self, warning: D) -> Result<T> where
D: Display + Send + Sync + 'static,
[src]
D: Display + Send + Sync + 'static,
fn with_warning<D, F>(self, warning: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
[src]
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
fn suggestion<D>(self, suggestion: D) -> Result<T> where
D: Display + Send + Sync + 'static,
[src]
D: Display + Send + Sync + 'static,
fn with_suggestion<D, F>(self, suggestion: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
[src]
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
fn with_section<D, F>(self, section: F) -> Result<T> where
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
[src]
D: Display + Send + Sync + 'static,
F: FnOnce() -> D,
fn section<D>(self, section: D) -> Result<T> where
D: Display + Send + Sync + 'static,
[src]
D: Display + Send + Sync + 'static,
fn error<E2>(self, error: E2) -> Result<T> where
E2: Error + Send + Sync + 'static,
[src]
E2: Error + Send + Sync + 'static,
fn with_error<E2, F>(self, error: F) -> Result<T> where
F: FnOnce() -> E2,
E2: Error + Send + Sync + 'static,
[src]
F: FnOnce() -> E2,
E2: Error + Send + Sync + 'static,