rebound 0.4.4

Full runtime reflection for Rust, with lifetime safety
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

//! Error utilities for rebound

use crate::{Type, Variant};

use crate::ty::CommonTypeInfo;
use core::fmt;
use std::error;

/// An error during a reflection operation. Note that during, for example, a call that *returns*
/// an Error, this will not represent the call returning an error. It would instead represent the
/// call failing to occur, or panicking and that panic being caught.
#[derive(Debug)]
pub enum Error {
    /// A [`Value`](crate::Value) with an incorrect [`Type`] was passed to an operation
    WrongType {
        /// The incorrect type passed
        wrong_ty: Type,
        /// The type that was expected
        right_ty: Type,
    },

    /// Attempted to call an [`AssocFn`](crate::AssocFn) without a `self` param, but the referenced
    /// function expects one
    IsDynamic,

    /// Attempted to call an [`AssocFn`](crate::AssocFn) with a `self` param, but the referenced
    /// function doesn't expect one
    IsStatic,

    /// Attempted to call an [`AssocFn`](crate::AssocFn) with different number of arguments than
    /// expected by the referenced function.
    WrongArgsNum {
        /// The number of args passed
        wrong_num: usize,
        /// The number of args expected
        right_num: usize,
    },

    /// Attempted to perform an operation on a [`Value`](crate::Value) that requires the Value to be
    /// Owned, but it was Borrowed.
    BorrowedValue,

    /// Attempted to perform an operation on an [`AssocFn`](crate::AssocFn) or
    /// [`Field`](crate::Field), which isn't supported by that item.
    UnsupportedOperation,

    /// Attempted to call as_ref/as_mut on a reference, which can't be reborrowed as the desired
    /// reference type.
    CantReborrow,

    /// Attempted to perform an operation on an Enum with a Value of the wrong Variant
    WrongVariant {
        /// The enum variant provided
        wrong_var: Variant,
        /// The enum variant expected
        right_var: Variant,
    },
}

impl Error {
    pub(crate) const fn wrong_type(wrong: Type, right: Type) -> Error {
        Error::WrongType {
            wrong_ty: wrong,
            right_ty: right,
        }
    }

    pub(crate) const fn wrong_args_num(wrong: usize, right: usize) -> Error {
        Error::WrongArgsNum {
            wrong_num: wrong,
            right_num: right,
        }
    }

    pub(crate) fn wrong_variant(wrong: &Variant, right: &Variant) -> Error {
        Error::WrongVariant {
            wrong_var: wrong.clone(),
            right_var: right.clone(),
        }
    }
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Error::WrongType { wrong_ty, right_ty } => write!(
                f,
                "Reflection Error: Expected type \"{}\", got type \"{}\"",
                right_ty.name(),
                wrong_ty.name()
            ),
            Error::IsDynamic => write!(
                f,
                "Reflection Error: Attempted to call a dynamic function without a receiver to bind"
            ),
            Error::IsStatic => write!(
                f,
                "Reflection Error: Attempted to call a static function with a receiver instance"
            ),
            Error::WrongArgsNum { wrong_num, right_num } => write!(
                f,
                "Reflection Error: Expected {} arguments, got {}",
                wrong_num,
                right_num,
            ),
            Error::BorrowedValue => write!(
                f,
                "Reflection Error: This operation requires an Owned Value, but the provided Value was Borrowed"
            ),
            Error::UnsupportedOperation => write!(
                f,
                "Reflection Error: This operation is not supported by this object. Likely, the #[rebound] macro for this object had a `no_*` attribute"
            ),
            Error::CantReborrow => write!(
                f,
                "Reflection Error: Attempted to get a mutable reference to an existing reference, or any reference to an existing mutable reference"
            ),
            Error::WrongVariant { wrong_var, right_var } => write!(
                f,
                "Reflection Error: Expected enum variant \"{}\", got variant \"{}\"",
                wrong_var.name(),
                right_var.name()
            ),
        }
    }
}

impl error::Error for Error {}