Enum StdioClientError 

pub enum StdioClientError {
    Document(RequestError),
    Stdio(StdioError),
    Source(SourceError),
    PeerClosed {
        method: MethodName,
    },
    TimedOut {
        method: MethodName,
        after: Duration,
    },
    Request(RequestError),
    NoAnswer {
        skipped: usize,
    },
    Terminate,
}

Why a client call did not complete.

Deliberately not ClientError, which is the layer above: that one adds “this session cannot do that”, and this one cannot know. A caller that has a negotiated profile can add the fact; a caller holding a transport and a pipe can only report the pipe.

Variants

Document(RequestError)

The request document could not be assembled.

Kept separate from Request because they happen at opposite ends of the call: this one is this client’s fault and happens before a byte is written, and that one is the peer’s answer arriving wrong. A caller that logged both as “bad request” would be wrong about one of them.

Stdio(StdioError)

A frame could not be written to the child.

Source(SourceError)

The child’s bytes could not be read.

PeerClosed

The child closed its stdout before answering.

Its own account of having exited, as distinct from a child that has not answered yet — which is TimedOut, and is the failure a caller is most likely to meet and least likely to recognise.

Fields

method: MethodName

The method that went unanswered.

TimedOut

The child did not answer within the client’s deadline.

Fields

method: MethodName

The method that went unanswered.

after: Duration

The deadline that passed.

Request(RequestError)

The peer’s answer was not a result.

NoAnswer

A run of frames arrived that were all somebody else’s.

Separate from TimedOut because the child is demonstrably alive and sending: it is answering, just never this request. A caller reading a log should not conclude the peer went away when it is in fact answering everything except what was asked.

Fields

skipped: usize

How many frames were read and passed over.

Terminate

The child could not be waited for after being killed.

Trait Implementations

impl Clone for StdioClientError

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 StdioClientError

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

Formats the value using the given formatter.

impl Display for StdioClientError

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

Formats the value using the given formatter.

impl Eq for StdioClientError

impl Error for StdioClientError

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 From<RequestError> for StdioClientError

fn from(source: RequestError) -> Self

Converts to this type from the input type.

impl From<SourceError> for StdioClientError

fn from(source: SourceError) -> Self

Converts to this type from the input type.

impl From<StdioError> for StdioClientError

fn from(source: StdioError) -> Self

Converts to this type from the input type.

impl PartialEq for StdioClientError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StdioClientError