16 releases (8 stable)

2.0.1 May 7, 2021
2.0.0 Aug 11, 2020
1.2.3 Jan 2, 2020
1.2.2 May 26, 2018
0.1.4 Oct 17, 2015

#1831 in Rust patterns

Download history 1694016/week @ 2025-09-23 1754470/week @ 2025-09-30 1742487/week @ 2025-10-07 1692885/week @ 2025-10-14 1772904/week @ 2025-10-21 1834049/week @ 2025-10-28 1909136/week @ 2025-11-04 1794091/week @ 2025-11-11 2060222/week @ 2025-11-18 1484703/week @ 2025-11-25 1758522/week @ 2025-12-02 2034056/week @ 2025-12-09 1909895/week @ 2025-12-16 1009628/week @ 2025-12-23 1179377/week @ 2025-12-30 1870040/week @ 2026-01-06

6,314,797 downloads per month
Used in fewer than 295 crates

MIT/Apache

49KB
962 lines

=========== Quick Error

:Status: production-ready :Documentation: https://docs.rs/quick-error/

A macro which makes error types pleasant to write.

Features:

  • Define enum type with arbitrary parameters
  • Concise notation of Display and Error traits
  • Full control of Display and Error trait implementation
  • Any number of From traits
  • Support for all enum-variants Unit, Tuple and Struct

Here is the comprehensive example:

.. code-block:: rust

quick_error! {
    #[derive(Debug)]
    pub enum IoWrapper {
        Io(err: io::Error) {
            from()
            display("I/O error: {}", err)
            source(err)
        }
        Other(descr: &'static str) {
            display("Error {}", descr)
        }
        IoAt { place: &'static str, err: io::Error } {
            source(err)
            display(me) -> ("io error at {}: {}", place, err)
            from(s: String) -> {
                place: "some string",
                err: io::Error::new(io::ErrorKind::Other, s)
            }
        }
        Discard {
            from(&'static str)
        }
    }
}

======= License

Licensed under either of

at your option.


Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps