14 releases

Uses old Rust 2015

0.1.9 Dec 10, 2015
0.1.8 Dec 10, 2015
0.1.7 Apr 17, 2015
0.1.4 Mar 26, 2015
0.0.1 Nov 22, 2014

#2362 in Rust patterns

Download history 708/week @ 2023-11-23 440/week @ 2023-11-30 497/week @ 2023-12-07 795/week @ 2023-12-14 521/week @ 2023-12-21 398/week @ 2023-12-28 641/week @ 2024-01-04 762/week @ 2024-01-11 620/week @ 2024-01-18 578/week @ 2024-01-25 402/week @ 2024-02-01 776/week @ 2024-02-08 990/week @ 2024-02-15 773/week @ 2024-02-22 657/week @ 2024-02-29 726/week @ 2024-03-07

3,223 downloads per month
Used in 82 crates (3 directly)

MIT license

7KB
84 lines

Error

An extensible, typesafe error for everyone.

Motivation

Rust is in need of an extensible solution to error types - this is one attempt.

This crate provides the Error trait, which defines a simple interface for interacting with Errors.

Overview

Error is compromised of several immutable getters, and is just a shell for defining a clean, interoperable interface for errors. The real magic of this crate is in the ErrorRefExt trait, which provides the is and downcast methods for checking if an Error trait object is a specific error.

These methods are very similar to the ones found on std::any::Any which allow for runtime reflection. The benefit of these methods when applied to Errors is tremendous, as this allows error handlers to accept a generic error through a Box<Error> trait object and then attempt to handle the types of errors they can before forwarding the error on if they could not handle it completely.

The primary benefit is that it allows an extensible error system where errors can not only be easily propagated, but also handled across library boundaries.

Example

#[deriving(Show, PartialEq)]
pub struct ParseError {
    location: uint,
}

impl Error for ParseError {
    fn name(&self) -> &'static str { "Parse Error" }
}

#[test] fn test_generic() {
    fn produce_parse_error() -> Box<Error> {
        box ParseError { location: 7u }
    }

    fn generic_handler(raw: Box<Error>) {
        let parse = raw.downcast::<ParseError>().unwrap();
        assert_eq!(*parse, ParseError { location: 7u });
    }

    generic_handler(produce_parse_error())
}

Dependencies

~8KB