Enum UxieError 

pub enum UxieError {
    Io(Error),
    Json(Error),
    Yaml(Error),
    InvalidFormat {
        message: String,
    },
    NotFound {
        resource_type: &'static str,
        id: String,
    },
    OutOfBounds {
        resource_type: &'static str,
        id: u32,
        max: u32,
    },
    ProjectDetectionFailed {
        path: PathBuf,
    },
    GameDetectionFailed,
    SymbolResolutionFailed {
        name: String,
    },
    MissingRequired {
        item_type: &'static str,
        path: PathBuf,
    },
}

Unified error type for all Uxie operations

This enum covers all error conditions that can occur during:

• File I/O operations
• Binary format parsing (NARC, ARM9, ROM headers)
• JSON/YAML configuration parsing
• Symbol resolution
• Project detection and loading

Variants

Io(Error)

I/O error (file not found, permission denied, etc.)

Json(Error)

JSON parsing/serialization error

Yaml(Error)

YAML parsing/serialization error

InvalidFormat

Invalid binary format (wrong magic bytes, corrupted data, etc.)

Fields

message: String

Description of what was expected vs found

NotFound

Resource not found (map header, script, text bank, etc.)

Fields

resource_type: &'static str

Type of resource (e.g., “Map header”, “Script file”)

id: String

Identifier that was searched for

OutOfBounds

Index out of bounds

Fields

resource_type: &'static str

Type of resource

id: u32

The requested ID

max: u32

Maximum valid ID

ProjectDetectionFailed

Project detection failed

Fields

path: PathBuf

Path that was examined

GameDetectionFailed

Game detection failed

SymbolResolutionFailed

Symbol resolution failed

Fields

name: String

Symbol name that couldn’t be resolved

MissingRequired

Missing required file or directory

Fields

item_type: &'static str

What kind of item is missing (e.g., “file”, “directory”)

path: PathBuf

Path to the missing item

Implementations

impl UxieError

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

Create an InvalidFormat error with a message

pub fn not_found(resource_type: &'static str, id: impl Into<String>) -> Self

Create a NotFound error

pub fn out_of_bounds(resource_type: &'static str, id: u32, max: u32) -> Self

Create an OutOfBounds error

pub fn missing_file(path: impl Into<PathBuf>) -> Self

Create a MissingRequired error

pub fn missing_directory(path: impl Into<PathBuf>) -> Self

Create a MissingRequired error for directories

Trait Implementations

impl Debug for UxieError

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

Formats the value using the given formatter.

impl Display for UxieError

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

Formats the value using the given formatter.

impl Error for UxieError

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 UxieError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for UxieError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for UxieError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<UxieError> for Error

fn from(err: UxieError) -> Self

Converts to this type from the input type.