more-config 3.0.0

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

use crate::{Configuration, OwnedSection, Section};
use std::rc::Rc;
use std::sync::Arc;
use tokens::{ChangeToken, NeverChangeToken};

/// Defines the behavior of a reloadable configuration.
pub trait Reloadable: Sized {
    /// Gets a value indicating whether the configuration can be reloaded.
    fn can_reload(&self) -> bool;

    /// Gets a [change token](ChangeToken) that will be notified when the configuration is reloaded.
    fn reload_token(&self) -> impl ChangeToken + 'static;
}

macro_rules! unreloadable {
    ($type:ty) => {
        impl Reloadable for $type {
            #[inline]
            fn can_reload(&self) -> bool {
                false
            }

            #[inline]
            fn reload_token(&self) -> impl ChangeToken + 'static {
                NeverChangeToken
            }
        }
    };
}

unreloadable!(Configuration);
unreloadable!(Section<'_>);
unreloadable!(OwnedSection);

macro_rules! reloadable {
    ($type:ty) => {
        impl Reloadable for $type {
            #[inline]
            fn can_reload(&self) -> bool {
                (&**self).can_reload()
            }

            #[inline]
            fn reload_token(&self) -> impl ChangeToken + 'static {
                (&**self).reload_token()
            }
        }
    };
}

reloadable!(Arc<Configuration>);
reloadable!(Rc<Configuration>);