Enum SessionError 

#[non_exhaustive]
pub enum SessionError {
    TooLong {
        len: usize,
        limit: usize,
    },
    SpaceExhausted {
        needed: u64,
        available: u64,
    },
}

The reason a Session could not accept a line.

Both variants mean the pending entry was too large to keep, so the session discards it before returning the error: the next line starts a fresh entry and the session stays usable. Nothing already committed is affected. The pipeline is never called with input that triggered an error.

The enum is #[non_exhaustive]; match it with a wildcard arm.

Examples

use repl_lang::{Session, SessionError, Status};

let mut session = Session::with_limit(8);
let err = session.feed("a line that is far too long", |_| Status::Complete(())).unwrap_err();
assert!(matches!(err, SessionError::TooLong { limit: 8, .. }));
assert!(!session.is_pending()); // the oversized entry was dropped

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

TooLong

The entry, with this line added, would exceed the session’s size limit.

The limit bounds how much text one entry can accumulate — and so how much the pipeline re-reads on every continuation line — guarding against a runaway paste or a pipeline that never declares input complete. Report it to the user; raise the limit with Session::with_limit if legitimate entries hit it.

Fields

len: usize

Byte length the entry would have reached, including line terminators.

limit: usize

The session’s limit, in bytes.

SpaceExhausted

The session’s source map has no room left for the entry.

Committed entries share one 32-bit position space, so a session can hold about 4 GiB of entries in total. A shorter entry may still fit, but the session is effectively full: start a fresh Session.

Fields

needed: u64

Byte length of the entry that did not fit.

available: u64

Bytes of position space that remained.

Trait Implementations

impl Clone for SessionError

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 SessionError

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

Formats the value using the given formatter.

impl Display for SessionError

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

Formats the value using the given formatter.

impl Eq for SessionError

impl Error for SessionError

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 PartialEq for SessionError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SessionError