finchers 0.13.5

A combinator library for builidng asynchronous HTTP services
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

//! Built-in wrappers.

mod after_apply;
mod and_then;
mod before_apply;
mod map;
mod or_reject;
mod recover;
mod try_chain;

pub use self::after_apply::{after_apply, AfterApply};
pub use self::and_then::{and_then, AndThen};
pub use self::before_apply::{before_apply, BeforeApply};
pub use self::map::{map, Map};
pub use self::or_reject::{or_reject, or_reject_with, OrReject, OrRejectWith};
pub use self::recover::{recover, Recover};

use common::{Func, Tuple};
use endpoint::Endpoint;
use error::Error;

use futures::IntoFuture;

/// A trait representing the conversion of an endpoint to another endpoint.
pub trait Wrapper<'a, E: Endpoint<'a>> {
    /// The inner type of converted `Endpoint`.
    type Output: Tuple;

    /// The type of converted `Endpoint`.
    type Endpoint: Endpoint<'a, Output = Self::Output>;

    /// Performs conversion from the provided endpoint into `Self::Endpoint`.
    fn wrap(self, endpoint: E) -> Self::Endpoint;
}

/// A set of extension methods for using built-in `Wrapper`s.
pub trait EndpointWrapExt<'a>: Endpoint<'a> + Sized {
    #[allow(missing_docs)]
    fn map<F>(self, f: F) -> <Map<Self::Output, F> as Wrapper<'a, Self>>::Endpoint
    where
        F: Func<Self::Output> + 'a,
    {
        self.wrap(map(f))
    }

    #[allow(missing_docs)]
    fn and_then<F>(self, f: F) -> <AndThen<Self::Output, F> as Wrapper<'a, Self>>::Endpoint
    where
        F: Func<Self::Output> + 'a,
        F::Out: IntoFuture<Error = Error> + 'a,
    {
        self.wrap(and_then(f))
    }
}

impl<'a, E: Endpoint<'a>> EndpointWrapExt<'a> for E {}