//! Contains [`Either`] and related types and functions.
//!
//! See [`Either`] documentation for more details.
use futures_core::ready;
use pin_project::pin_project;
use std::{
future::Future,
pin::Pin,
task::{Context, Poll},
};
use tower_layer::Layer;
use tower_service::Service;
/// Combine two different service types into a single type.
///
/// Both services must be of the same request, response, and error types.
/// [`Either`] is useful for handling conditional branching in service middleware
/// to different inner service types.
#[pin_project(project = EitherProj)]
#[derive(Clone, Debug)]
pub enum Either {
/// One type of backing [`Service`].
A(#[pin] A),
/// The other type of backing [`Service`].
B(#[pin] B),
}
impl Service for Either
where
A: Service,
A::Error: Into,
B: Service,
B::Error: Into,
{
type Response = A::Response;
type Error = crate::BoxError;
type Future = Either;
fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll> {
use self::Either::*;
match self {
A(service) => Poll::Ready(Ok(ready!(service.poll_ready(cx)).map_err(Into::into)?)),
B(service) => Poll::Ready(Ok(ready!(service.poll_ready(cx)).map_err(Into::into)?)),
}
}
fn call(&mut self, request: Request) -> Self::Future {
use self::Either::*;
match self {
A(service) => A(service.call(request)),
B(service) => B(service.call(request)),
}
}
}
impl Future for Either
where
A: Future