Struct StderrExcerpt 

pub struct StderrExcerpt { /* private fields */ }

What a failed server startup wrote to stderr, bounded and sanitized.

Holds the first and last bytes of the output (or all of it when short), so both the opening banner and the final error survive.

Sanitizing

Control characters other than newline and tab are dropped, as are characters that forge or reorder text in logs and terminals: the Unicode line and paragraph separators, bidirectional controls and zero-width characters.

Redaction

Values that look secret are replaced with [redacted:NAME] before the text leaves mcpls. A value counts as secret (and must be at least 8 bytes) when it is:

• an environment variable value, from the server’s configured env or mcpls’s own environment, whose name contains TOKEN, KEY, SECRET, PASSW, CRED or AUTH (case-insensitive);
• the value of a --flag=value or --flag value argument whose flag name matches the same patterns;
• a string under a matching key of initialization_options.

Other values, such as RUSTUP_TOOLCHAIN, stay visible so the cause of a failure can still be read. Matching is by exact value: encoded forms (URL, base64, JSON-escaped) are not found. A secret cut by the head/tail elision is hidden only for the fragment of at least 4 bytes on either side of the cut. Put secrets in a name-matching env entry rather than in other places.

Display renders one line: trimmed non-empty lines joined with |, with ... between head and tail when elided. The raw multi-line text is available through Self::head and Self::tail.

Examples

use mcpls_core::Error;
use mcpls_core::error::InitPhase;

fn server_output(err: &Error) -> Option<String> {
    match err {
        Error::LspInitFailed { stderr: Some(stderr), .. }
        | Error::ServerExitedDuringInit { stderr: Some(stderr), .. } => {
            Some(stderr.to_string())
        }
        _ => None,
    }
}

let err = Error::LspInitFailed {
    phase: InitPhase::Initialize,
    cause: Box::new(Error::ServerTerminated),
    hint: None,
    stderr: None,
};
assert_eq!(server_output(&err), None);

Implementations

impl StderrExcerpt

pub fn head(&self) -> &str

The start of the output, or all of it when nothing was dropped.

pub fn tail(&self) -> Option<&str>

The end of the output, present only when the middle was dropped.

pub const fn is_elided(&self) -> bool

Whether the middle of the output was dropped.

Trait Implementations

impl Clone for StderrExcerpt

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StderrExcerpt

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for StderrExcerpt

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for StderrExcerpt

impl PartialEq for StderrExcerpt

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for StderrExcerpt