more-di 3.2.1

Provides support for dependency injection (DI)
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

use crate::{Activator, ServiceDependency, ServiceDescriptor, ServiceLifetime, Type};
use std::sync::OnceLock;

/// Represents the builder for an injected type.
pub struct InjectBuilder {
    activator: Activator,
    lifetime: ServiceLifetime,
    key_type: Option<Type>,
    dependencies: Vec<ServiceDependency>,
}

impl InjectBuilder {
    /// Initializes a new builder.
    ///
    /// # Arguments
    ///
    /// * `activator` - The [activator](Activator) used to activate the service
    /// * `lifetime` - The [lifetime](ServiceLifetime) of the service
    pub fn new(activator: Activator, lifetime: ServiceLifetime) -> Self {
        Self {
            activator,
            lifetime,
            key_type: None,
            dependencies: Vec::default(),
        }
    }

    /// Defines a dependency used by the service.
    ///
    /// # Arguments
    ///
    /// * `dependency` - The [dependency](ServiceDependency) associated with the services
    pub fn depends_on(mut self, dependency: ServiceDependency) -> Self {
        if !self.dependencies.contains(&dependency) {
            self.dependencies.push(dependency);
        }
        self
    }

    /// Applies a key to the injected service.
    pub fn with_key<TKey>(mut self) -> Self {
        self.key_type = Some(Type::of::<TKey>());
        self
    }

    /// Indicates the injected service is mutable.
    pub fn as_mut(mut self) -> Self {
        self.activator.as_mut();
        self
    }

    /// Builds and returns a new [ServiceDescriptor].
    pub fn build(mut self) -> ServiceDescriptor {
        ServiceDescriptor::new(
            self.lifetime,
            if let Some(key) = self.key_type {
                self.activator.service_type().with_key(&key)
            } else {
                self.activator.service_type().clone()
            },
            self.activator.implementation_type().clone(),
            if self.dependencies.is_empty() {
                Vec::new()
            } else {
                self.dependencies.shrink_to_fit();
                self.dependencies
            },
            OnceLock::new(),
            self.activator.factory(),
        )
    }
}

impl From<InjectBuilder> for ServiceDescriptor {
    fn from(value: InjectBuilder) -> Self {
        value.build()
    }
}