devela 0.29.0

A development substrate of coherence.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

// devela/src/error/kind.rs
//
//! Reusable failure categories.
//
// TOC
// - individual error types:
//   - InvalidErrorConversion
//   - NotImplemented
//   - NotSupported
//   - InvalidValue
// - composite error types:
//   - NotAvailable: NotImplemented + NotSupported

use crate::{_tags, define_error};

/* individual errors */

define_error![individual: pub struct FailedErrorConversion;
    #[derive(Default)],
    +location: "error",
    +tag: _tags!(value error),

    DOC_FAILED_CONVERSION = "A failed conversion between two error types.",
    self+f => write!(f, "Failed to convert between error types."),
];
define_error![individual: pub struct NotImplemented;
    #[derive(Default)],
    +location: "error",
    +tag: _tags!(no error),

    DOC_NOT_IMPLEMENTED = "The requested functionality is not implemented.",
    self+f => write!(f, "The requested functionality is not implemented."),
];
define_error![individual: pub struct NotSupported;
    #[derive(Default)],
    +location: "error",
    +tag: _tags!(no error),

    DOC_NOT_SUPPORTED = "The requested functionality is not supported by this type.",
    self+f => write!(f, "The requested functionality is not supported by this type."),
];

define_error![individual: pub struct InvalidValue;
    #[derive(Default)],
    +location: "error",
    +tag: _tags!(value error),

    DOC_INVALID_VALUE = "An invalid value was received for the given type or operation.",
    self+f => write!(f, "An invalid value was received for the given type or operation."),
];

/* composite errors */

define_error! { composite: fmt(f)
    +location: "error",
    +tag: _tags!(no error_composite),

    /// An error composite of [`NotImplemented`] + [`NotSupported`].
    pub enum NotAvailable {
        +tag: _tags!(no),
        DOC_NOT_IMPLEMENTED: +const NotImplemented => NotImplemented,
        +tag: _tags!(no),
        DOC_NOT_SUPPORTED: +const NotSupported => NotSupported,
    }
}