Struct NetworkErrorDisplay 

pub struct NetworkErrorDisplay {
    pub error_code: ErrorCode,
    pub connection: ConnectionDetails,
    pub network_path: Vec<NetworkPathSegment>,
    pub env_vars: Vec<EnvVarInfo>,
    pub diagnostics: Vec<DiagnosticCommand>,
    pub timeout: Option<Duration>,
    pub retry_count: Option<u32>,
    pub raw_error: Option<String>,
    pub caused_by: Vec<String>,
    pub custom_message: Option<String>,
}

NetworkErrorDisplay - Rich error display for network/SSH errors.

Builds on ErrorPanel with network-specific context:

• Connection details (host, port, IP, credentials)
• Network path visualization
• Environment variable display
• Diagnostic command suggestions

Fields

error_code: ErrorCode

The underlying error code

connection: ConnectionDetails

Connection details

network_path: Vec<NetworkPathSegment>

Network path segments for visualization

env_vars: Vec<EnvVarInfo>

Relevant environment variables

diagnostics: Vec<DiagnosticCommand>

Diagnostic command suggestions

timeout: Option<Duration>

Connection timeout if applicable

retry_count: Option<u32>

Retry information

raw_error: Option<String>

Low-level error message from OS/library

caused_by: Vec<String>

Error chain (caused by)

custom_message: Option<String>

Custom message override

Implementations

impl NetworkErrorDisplay

pub fn ssh_connection_failed(host: impl Into<String>) -> Self

Create display for SSH connection failure (E100).

pub fn ssh_auth_failed(host: impl Into<String>) -> Self

Create display for SSH authentication failure (E101).

pub fn ssh_key_error(host: impl Into<String>) -> Self

Create display for SSH key error (E102).

pub fn ssh_host_key_error(host: impl Into<String>) -> Self

Create display for SSH host key verification failure (E103).

pub fn ssh_timeout(host: impl Into<String>) -> Self

Create display for SSH timeout (E104).

pub fn ssh_session_dropped(host: impl Into<String>) -> Self

Create display for SSH session dropped (E105).

pub fn dns_error(host: impl Into<String>) -> Self

Create display for DNS resolution failure (E106).

pub fn network_unreachable(host: impl Into<String>) -> Self

Create display for network unreachable (E107).

pub fn connection_refused(host: impl Into<String>) -> Self

Create display for connection refused (E108).

pub fn tcp_timeout(host: impl Into<String>) -> Self

Create display for TCP timeout (E109).

pub fn port(self, port: u16) -> Self

Set the port number.

pub fn resolved_ip(self, ip: IpAddr) -> Self

Set the resolved IP address.

pub fn username(self, username: impl Into<String>) -> Self

Set the SSH username.

pub fn key_path(self, path: impl Into<String>) -> Self

Set the SSH key path.

pub fn timeout(self, timeout: Duration) -> Self

Set the timeout duration.

pub fn timeout_secs(self, secs: u64) -> Self

Set the timeout in seconds (convenience method).

pub fn retries(self, count: u32) -> Self

Set the retry count.

pub fn path_segment( self, name: impl Into<String>, status: PathSegmentStatus, details: Option<String>, ) -> Self

Add a network path segment.

pub fn network_path_simple( self, local: &str, daemon: &str, worker: &str, failed_at: Option<&str>, ) -> Self

Set the full network path with simple status.

Creates a path like: local → daemon → worker The failed segment is marked based on which name matches failed_at.

pub fn env_var(self, name: impl Into<String>, value: Option<String>) -> Self

Add an environment variable with its current value.

pub fn env_var_from_env(self, name: &str) -> Self

Add an environment variable, reading from the current environment.

pub fn auto_add_ssh_env_vars(self) -> Self

Automatically add common SSH-related environment variables.

pub fn add_diagnostic( self, description: impl Into<String>, command: impl Into<String>, ) -> Self

Add a diagnostic command suggestion.

pub fn with_io_error(self, err: &Error) -> Self

Extract details from a std::io::Error.

pub fn message(self, message: impl Into<String>) -> Self

Set a custom error message.

pub fn caused_by(self, cause: impl Into<String>) -> Self

Add a caused-by entry.

pub fn to_error_panel(&self) -> ErrorPanel

Convert to an ErrorPanel for rendering.

pub fn render(&self, ctx: OutputContext)

Render the error to stderr.

Uses rich output if supported, otherwise plain text.

pub fn to_json(&self) -> Result<String>

Serialize to JSON string.

pub fn to_json_compact(&self) -> Result<String>

Serialize to compact JSON string.

Trait Implementations

impl Clone for NetworkErrorDisplay

fn clone(&self) -> NetworkErrorDisplay

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetworkErrorDisplay

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NetworkErrorDisplay

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for NetworkErrorDisplay

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

Formats the value using the given formatter.

impl Error for NetworkErrorDisplay

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl Serialize for NetworkErrorDisplay

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.