syrette 0.5.1

The convenient dependency injection framework
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

//! Error types for [`DIContainer`] and it's related structs.
//!
//! [`DIContainer`]: crate::di_container::blocking::DIContainer

use crate::errors::injectable::InjectableError;

/// Error type for [`DIContainer`].
///
/// [`DIContainer`]: crate::di_container::blocking::DIContainer
#[derive(thiserror::Error, Debug)]
pub enum DIContainerError
{
    /// Unable to cast a binding for a interface.
    #[error(
        "Unable to cast binding for interface '{interface} with kind '{binding_kind}'"
    )]
    CastFailed
    {
        /// The interface.
        interface: &'static str,

        /// The kind of the found binding.
        binding_kind: &'static str,
    },

    /// Failed to resolve a binding for a interface.
    #[error("Failed to resolve binding for interface '{interface}'")]
    BindingResolveFailed
    {
        /// The reason for the problem.
        #[source]
        reason: InjectableError,

        /// The affected bound interface.
        interface: &'static str,
    },

    /// No binding exists for a interface (and optionally a name).
    #[error(
        "No binding exists for interface '{interface}' {}",
        name.as_ref().map(|name| format!("with name '{name}'")).unwrap_or_default()
    )]
    BindingNotFound
    {
        /// The interface that doesn't have a binding.
        interface: &'static str,

        /// The name of the binding if one exists.
        name: Option<String>,
    },
}

/// Error type for [`BindingBuilder`].
///
/// [`BindingBuilder`]: crate::di_container::blocking::binding::builder::BindingBuilder
#[derive(thiserror::Error, Debug)]
pub enum BindingBuilderError
{
    /// A binding already exists for a interface.
    #[error("Binding already exists for interface '{0}'")]
    BindingAlreadyExists(&'static str),
}

/// Error type for [`BindingScopeConfigurator`].
///
/// [`BindingScopeConfigurator`]: crate::di_container::blocking::binding::scope_configurator::BindingScopeConfigurator
#[derive(thiserror::Error, Debug)]
pub enum BindingScopeConfiguratorError
{
    /// Resolving a singleton failed.
    #[error("Resolving the given singleton failed")]
    SingletonResolveFailed(#[from] InjectableError),
}

/// Error type for [`BindingWhenConfigurator`].
///
/// [`BindingWhenConfigurator`]: crate::di_container::blocking::binding::when_configurator::BindingWhenConfigurator
#[derive(thiserror::Error, Debug)]
pub enum BindingWhenConfiguratorError
{
    /// A binding for a interface wasn't found.
    #[error("A binding for interface '{0}' wasn't found'")]
    BindingNotFound(&'static str),
}