desaturate 0.0.2

This package aims to makes it easier to maintain a single code base for both regular and async functions.
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

macro_rules! features {
    (: $($rest:tt)+) => {
        $($rest)+
    };
    (async $($rest:tt)+) => {
        #[cfg(feature = "generate-async")]
        features!{ $($rest)+ }
    };
    (!async $($rest:tt)+) => {
        #[cfg(not(feature = "generate-async"))]
        features!{ $($rest)+ }
    };
    (fn $($rest:tt)+) => {
        #[cfg(feature = "generate-blocking")]
        features!{ $($rest)+ }
    };
    (!fn $($rest:tt)+) => {
        #[cfg(not(feature = "generate-blocking"))]
        features!{ $($rest)+ }
    };
}

macro_rules! create_asyncable {
    ($T:ident => $($($traits:tt)+)?) => {
        /// This trait is dynamic based on feature flags. For this reason, it's not allowed to be
        /// directly implemented, as this would break the [additive features
        /// guideline](https://doc.rust-lang.org/cargo/reference/features.html#feature-unification).
        ///
        /// When the flag `generate-async` is set, this trait implements [`IntoFuture`].
        ///
        /// When the flag `generate-blocking` is set, this trait implements [`Blocking`].
        ///
        /// Note that the [`into_future()`] (which is implicitly called when you use `.await`) and
        /// [`call()`] functions both consume this value, and the arguments. For this reason, your
        /// arguments can include owned variables, as they can only be consumed once.
        ///
        /// [`IntoFuture`]: core::future::IntoFuture
        /// [`into_future()`]: core::future::IntoFuture::into_future
        /// [`call()`]: Blocking::call
        pub trait Desaturated<$T>: $($($traits)+ +)? internal::OnlyAutomatic<$T> {}
        $(
            impl<$T, U: $($traits)+> Desaturated<$T> for U {}
            impl<$T, U: $($traits)+> internal::OnlyAutomatic<$T> for U {}
        )?
    };
}

pub(crate) use {create_asyncable, features};