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
111
112
113
114
115
116
117
118

use {
    parking_lot::{RwLock, RwLockReadGuard, RwLockWriteGuard},
    std::ops::{Deref, DerefMut},
};
pub use auto_impl::{AutoReadApi, AutoWriteApi};

mod auto_impl;

#[doc = include_str!("../README.md")]
pub trait ReadWriteApi<T>: ReadApi<Target=T> + WriteApi<Target=T>
{}

impl<T, R> ReadWriteApi<R> for T
    where
        T: ReadApi<Target=R> + WriteApi<Target=R>
{}

/// Provides constant part of the [`ReadWriteApi`] interface.
pub trait ReadApi
{
    /// Dereference target of the return type of the
    /// [`Self::read`] method.
    type Target;

    /// [`Self::read`] return type.
    type ReadGuard<'a>: Deref<Target=Self::Target>
        where Self: 'a;

    /// [`RwLock::read`] analogue.
    fn read(&self) -> Self::ReadGuard<'_>;
}

/// Provides mutable part of the [`ReadWriteApi`] interface.
pub trait WriteApi
{
    /// Dereference target of the return type of the
    /// [`Self::write`] method.
    type Target;

    /// [`Self::write`] return type.
    type WriteGuard<'a>: DerefMut<Target=Self::Target>
        where Self: 'a;

    /// [`RwLock::write`] analogue.
    fn write(&mut self) -> Self::WriteGuard<'_>;
}

impl<T> ReadApi for RwLock<T>
{
    type Target = T;
    type ReadGuard<'a> = RwLockReadGuard<'a, T>
        where Self: 'a;

    #[inline]
    fn read(&self) -> RwLockReadGuard<'_, T> {
        RwLock::read(self)
    }
}

impl<T> WriteApi for RwLock<T>
{
    type Target = T;
    type WriteGuard<'a> = &'a mut T
        where Self: 'a;

    #[inline]
    fn write(&mut self) -> &mut T {
        self.get_mut()
    }
}

impl<T> ReadApi for &RwLock<T>
{
    type Target = T;
    type ReadGuard<'a> = RwLockReadGuard<'a, T>
        where Self: 'a;

    #[inline]
    fn read(&self) -> RwLockReadGuard<'_, T> {
        RwLock::read(self)
    }
}

impl<T> WriteApi for &RwLock<T>
{
    type Target = T;
    type WriteGuard<'a> = RwLockWriteGuard<'a, T>
        where Self: 'a;

    #[inline]
    fn write(&mut self) -> RwLockWriteGuard<'_, T> {
        RwLock::write(self)
    }
}

impl<T> ReadApi for &mut RwLock<T>
{
    type Target = T;
    type ReadGuard<'a> = RwLockReadGuard<'a, T>
        where Self: 'a;

    #[inline]
    fn read(&self) -> RwLockReadGuard<'_, T> {
        RwLock::read(self)
    }
}

impl<T> WriteApi for &mut RwLock<T>
{
    type Target = T;
    type WriteGuard<'a> = &'a mut T
        where Self: 'a;

    #[inline]
    fn write(&mut self) -> &mut T {
        self.get_mut()
    }
}