Enum MemScopeError 

pub enum MemScopeError {
    Memory {
        operation: MemoryOperation,
        message: Arc<str>,
        context: Option<Arc<str>>,
        error_kind: ErrorKind,
        error_context: ErrorContext,
    },
    Analysis {
        analyzer: Arc<str>,
        message: Arc<str>,
        recoverable: bool,
        error_kind: ErrorKind,
        error_context: ErrorContext,
    },
    Export {
        format: Arc<str>,
        message: Arc<str>,
        partial_success: bool,
        error_kind: ErrorKind,
        error_context: ErrorContext,
    },
    Configuration {
        component: Arc<str>,
        message: Arc<str>,
        error_kind: ErrorKind,
        error_context: ErrorContext,
    },
    System {
        error_type: SystemErrorType,
        message: Arc<str>,
        source_message: Option<Arc<str>>,
        error_kind: ErrorKind,
        error_context: ErrorContext,
    },
    Internal {
        message: Arc<str>,
        location: Option<Arc<str>>,
        error_kind: ErrorKind,
        error_context: ErrorContext,
    },
}

Unified error type for the entire memscope-rs system

This replaces the complex TrackingError with a simpler, more efficient design while maintaining all existing error information and backward compatibility.

Variants

Memory

Memory tracking operations (allocation, deallocation, association)

Fields

operation: MemoryOperation

message: Arc<str>

context: Option<Arc<str>>

error_kind: ErrorKind

error_context: ErrorContext

Analysis

Analysis operations (fragmentation, lifecycle, etc.)

Fields

analyzer: Arc<str>

message: Arc<str>

recoverable: bool

error_kind: ErrorKind

error_context: ErrorContext

Export

Export operations (JSON, binary, HTML, etc.)

Fields

format: Arc<str>

message: Arc<str>

partial_success: bool

error_kind: ErrorKind

error_context: ErrorContext

Configuration

Configuration and initialization errors

Fields

component: Arc<str>

message: Arc<str>

error_kind: ErrorKind

error_context: ErrorContext

System

System-level errors (IO, threading, etc.)

Fields

error_type: SystemErrorType

message: Arc<str>

source_message: Option<Arc<str>>

error_kind: ErrorKind

error_context: ErrorContext

Internal

Internal errors that should not normally occur

Fields

message: Arc<str>

location: Option<Arc<str>>

error_kind: ErrorKind

error_context: ErrorContext

Implementations

impl MemScopeError

pub fn error(module: &str, method: &str, message: impl Into<Arc<str>>) -> Self

Unified error creation - external modules only need to provide:

• module: which module the error occurred in (e.g., “variable_registry”)
• method: which method/function (e.g., “register_variable”)
• message: what went wrong

Internal classification by module:

• MemoryError: tracker, allocator, variable_registry, memory_tracker, capture
• ExportError: export, render_engine, snapshot
• AnalysisError: ffi_function_resolver, call_stack_normalizer, analysis, lifecycle, rule_engine, pattern_matcher, detector, unsafe_ffi_tracker
• ConfigurationError: config, initialization
• IoError: system errors (io, threading, locking, network, filesystem)
• InternalError: fallback for unknown modules

pub fn new(kind: ErrorKind, message: impl Into<Arc<str>>) -> Self

Create a new error with the specified kind and message

pub fn with_context( kind: ErrorKind, _severity: ErrorSeverity, message: impl Into<Arc<str>>, context: impl Into<Arc<str>>, ) -> Self

Create a new error with the specified kind, severity, and context

pub fn memory(operation: MemoryOperation, message: impl Into<Arc<str>>) -> Self

Create a memory operation error

pub fn memory_with_context( operation: MemoryOperation, message: impl Into<Arc<str>>, context: impl Into<Arc<str>>, ) -> Self

Create a memory operation error with context

pub fn analysis( analyzer: impl Into<Arc<str>>, message: impl Into<Arc<str>>, ) -> Self

Create an analysis error

pub fn analysis_fatal( analyzer: impl Into<Arc<str>>, message: impl Into<Arc<str>>, ) -> Self

Create a non-recoverable analysis error

pub fn export(format: impl Into<Arc<str>>, message: impl Into<Arc<str>>) -> Self

Create an export error

pub fn export_partial( format: impl Into<Arc<str>>, message: impl Into<Arc<str>>, ) -> Self

Create an export error with partial success

pub fn export_with_source( format: impl Into<Arc<str>>, message: impl Into<Arc<str>>, source: impl AsRef<str>, ) -> Self

Create an export error with source information

pub fn config( component: impl Into<Arc<str>>, message: impl Into<Arc<str>>, ) -> Self

Create a configuration error

pub fn system(error_type: SystemErrorType, message: impl Into<Arc<str>>) -> Self

Create a system error

pub fn system_with_source( error_type: SystemErrorType, message: impl Into<Arc<str>>, source: impl Error, ) -> Self

Create a system error with source

pub fn internal(message: impl Into<Arc<str>>) -> Self

Create an internal error

pub fn internal_at( message: impl Into<Arc<str>>, location: impl Into<Arc<str>>, ) -> Self

Create an internal error with location

pub fn is_recoverable(&self) -> bool

Check if this error is recoverable

pub fn kind(&self) -> ErrorKind

Get error kind for categorization and statistics

pub fn severity(&self) -> ErrorSeverity

Get error severity level

pub fn user_message(&self) -> &str

Get a user-friendly error message

pub fn category(&self) -> &'static str

Get error category for logging/metrics

pub fn context(&self) -> &ErrorContext

Get error context information

pub fn description(&self) -> String

Get a detailed error description

Trait Implementations

impl Clone for MemScopeError

fn clone(&self) -> MemScopeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemScopeError

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

Formats the value using the given formatter.

impl Display for MemScopeError

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

Formats the value using the given formatter.

impl Error for MemScopeError

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<Error> for MemScopeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MemScopeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ExportError> for MemScopeError

fn from(err: ExportError) -> Self

Converts to this type from the input type.