Struct MontyException 

pub struct MontyException { /* private fields */ }

Public representation of a Monty exception.

Implementations

impl MontyException

pub fn new(exc_type: ExcType, message: Option<String>) -> MontyException

Create a new MontyException with the given exception type and message.

You can’t provide a traceback here, it’s send when raising the exception.

pub fn with_traceback( exc_type: ExcType, message: Option<String>, traceback: Vec<StackFrame>, ) -> MontyException

Creates an exception with an explicit traceback.

Most callers should use MontyException::new — the traceback is normally attached when the exception is raised. This constructor exists for boundaries that reconstruct an exception that was raised elsewhere (e.g. deserializing one received from a monty subprocess worker) and must preserve its original frames.

pub fn with_data(self, data: ExcData) -> MontyException

Attaches a structured payload — see ExcData. Public for boundaries that reconstruct an exception raised elsewhere (like MontyException::with_traceback); in-process raises attach the payload at the raise site instead.

pub fn data(&self) -> &ExcData

The structured payload, ExcData::None for most exceptions.

pub fn unicode_data(&self) -> Option<&UnicodeErrorData>

Structured UnicodeDecodeError/UnicodeEncodeError fields, present only for unicode errors raised by codec operations on objects no larger than UnicodeErrorData::MAX_OBJECT_LEN.

pub fn json_data(&self) -> Option<&JsonErrorData>

Structured json.JSONDecodeError fields, present only for decode errors raised by json.loads (not for manually raised exceptions).

pub fn take_data(&mut self) -> ExcData

Removes and returns the structured payload, for consumers (like the Python bindings) that rebuild the native exception and want the payload by value without cloning it.

pub fn add_traceback(&mut self, traceback: impl IntoIterator<Item = StackFrame>)

Appends frames to this exception’s traceback.

pub fn runtime_error(err: impl Display) -> MontyException

Shorthand for a traceback-free RuntimeError wrapping err’s display output — used at host boundaries (input conversion, REPL feeds) where no sandbox stack frames exist.

pub fn exc_type(&self) -> ExcType

The exception type raised.

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

Optional exception message explaining what went wrong.

Equivalent of python’s exc.args[0]

pub fn into_message(self) -> Option<String>

Optional exception message explaining what went wrong.

This takes ownership of the MontyException and returns an owned String.

Equivalent of python’s exc.args[0]

pub fn traceback(&self) -> &[StackFrame]

Stack trace of the exception, first is the outermost frame shown first in the traceback

pub fn summary(&self) -> String

Returns a compact summary of the exception.

Format: ExceptionType: message (e.g., NotImplementedError: feature not supported) If there’s no message, just returns the exception type name.

pub fn py_repr(&self) -> String

Returns the exception formatted as Python’s repr() would display it.

Format: ExceptionType('message') (e.g., ValueError('invalid value')) Uses appropriate quoting for messages containing quotes.

Trait Implementations

impl Clone for MontyException

fn clone(&self) -> MontyException

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MontyException

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MontyException

fn deserialize<__D>( __deserializer: __D, ) -> Result<MontyException, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for MontyException

Display implementation for MontyException should exactly match python traceback format.

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

Formats the value using the given formatter.

impl Error for MontyException

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<MontyException> for ExtFunctionResult

fn from(exception: MontyException) -> ExtFunctionResult

Converts to this type from the input type.

impl PartialEq for MontyException

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for MontyException

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MontyException