more-options 3.4.0

Provides support for options
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

use crate::Value;
use cfg_if::cfg_if;
use std::marker::PhantomData;

/// Defines the behavior of something that configures [`Options`](crate::Options).
///
/// # Remarks
///
/// These are all run first
#[cfg_attr(feature = "async", maybe_impl::traits(Send, Sync))]
pub trait ConfigureOptions<T> {
    /// Configures the corresponding options.
    ///
    /// # Arguments
    ///
    /// * `name` - The optional name of the options to configure
    /// * `options` - The options to configure
    fn configure(&self, name: Option<&str>, options: &mut T);
}

/// Defines the behavior of something that configures [`Options`](crate::Options).
///
/// # Remarks
///
/// These are all run last
#[cfg_attr(feature = "async", maybe_impl::traits(Send, Sync))]
pub trait PostConfigureOptions<T> {
    /// Configures the corresponding options.
    ///
    /// # Arguments
    ///
    /// * `name` - The optional name of the options to configure
    /// * `options` - The options to configure
    fn post_configure(&self, name: Option<&str>, options: &mut T);
}

macro_rules! config_impl {
    (($($bounds:tt)+)) => {
        /// Creates and returns [options configuration](ConfigureOptions) for the specified action.
        ///
        /// # Arguments
        ///
        /// * `action` - The configuration action
        #[inline]
        pub fn configure<T, F>(action: F) -> impl ConfigureOptions<T>
        where
            T: Value,
            F: Fn(Option<&str>, &mut T) + $($bounds)+,
        {
            _ConfigureOptions {
                action,
                _marker: PhantomData,
            }
        }

        /// Creates and returns [options post-configuration](PostConfigureOptions) for the specified action.
        ///
        /// # Arguments
        ///
        /// * `action` - The post configuration action
        #[inline]
        pub fn post_configure<T, F>(action: F) -> impl PostConfigureOptions<T>
        where
            T: Value,
            F: Fn(Option<&str>, &mut T) + $($bounds)+,
        {
            _ConfigureOptions {
                action,
                _marker: PhantomData,
            }
        }

        struct _ConfigureOptions<TOptions, TAction> {
            action: TAction,
            _marker: PhantomData<TOptions>,
        }

        impl<TOptions, TAction> ConfigureOptions<TOptions> for _ConfigureOptions<TOptions, TAction>
        where
            TOptions: Value,
            TAction: Fn(Option<&str>, &mut TOptions) + $($bounds)+,
        {
            #[inline]
            fn configure(&self, name: Option<&str>, options: &mut TOptions) {
                (self.action)(name, options)
            }
        }

        impl<TOptions, TAction> PostConfigureOptions<TOptions>
            for _ConfigureOptions<TOptions, TAction>
        where
            TOptions: Value,
            TAction: Fn(Option<&str>, &mut TOptions) + $($bounds)+,
        {
            #[inline]

            fn post_configure(&self, name: Option<&str>, options: &mut TOptions) {
                (self.action)(name, options)
            }
        }
    };
}

cfg_if! {
    if #[cfg(feature = "async")] {
        config_impl!((Send + Sync + 'static));
    } else {
        config_impl!(('static));
    }
}