app-state 0.1.0

Thread-safe, mutable application states for rust
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

use crate::states::traits::CreateAppState;
use crate::{AppStateTrait, MutAppStateLock};
use std::ops::Deref;
use std::sync::{Arc, Mutex};

/// A mutable app state.
///
/// # Examples
/// ```rust
/// use app_state::{MutAppState, AppStateTrait, stateful};
///
/// struct MyState {
///   counter: u32,
/// }
///
/// #[stateful]
/// fn func(state: MutAppState<MyState>) {
///   let mut state = state.get_mut();
///   state.counter += 1;
/// }
/// ```
#[derive(Debug)]
pub struct MutAppState<T: ?Sized>(Arc<Mutex<T>>);

impl<T: 'static + Send> MutAppState<T> {
    /// Returns reference to inner `T`.
    pub fn get_mut(&self) -> MutAppStateLock<T> {
        MutAppStateLock::new(&self)
    }
}

impl<T: 'static + Send> CreateAppState<T> for MutAppState<T> {
    fn new(state: T) -> MutAppState<T> {
        MutAppState(Arc::new(Mutex::new(state)))
    }
}

impl<T: 'static + Send> AppStateTrait<T, MutAppState<T>> for MutAppState<T> {}

impl<T: ?Sized> MutAppState<T> {
    /// Unwraps to the internal `Arc<T>`
    pub fn into_inner(self) -> Arc<Mutex<T>> {
        self.0
    }
}

impl<T: ?Sized> Deref for MutAppState<T> {
    type Target = Arc<Mutex<T>>;

    fn deref(&self) -> &Arc<Mutex<T>> {
        &self.0
    }
}

impl<T: ?Sized> Clone for MutAppState<T> {
    fn clone(&self) -> MutAppState<T> {
        MutAppState(self.0.clone())
    }
}

impl<T: ?Sized> From<Arc<Mutex<T>>> for MutAppState<T> {
    fn from(arc: Arc<Mutex<T>>) -> Self {
        MutAppState(arc)
    }
}