//! Contains [`Either`] and related types and functions.
//!
//! See [`Either`] documentation for more details.
use pin_project_lite::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.
#[derive(Clone, Copy, Debug)]
pub enum Either {
#[allow(missing_docs)]
Left(A),
#[allow(missing_docs)]
Right(B),
}
impl Service for Either
where
A: Service,
B: Service,
{
type Response = A::Response;
type Error = A::Error;
type Future = EitherResponseFuture;
fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll> {
match self {
Either::Left(service) => service.poll_ready(cx),
Either::Right(service) => service.poll_ready(cx),
}
}
fn call(&mut self, request: Request) -> Self::Future {
match self {
Either::Left(service) => EitherResponseFuture {
kind: Kind::Left {
inner: service.call(request),
},
},
Either::Right(service) => EitherResponseFuture {
kind: Kind::Right {
inner: service.call(request),
},
},
}
}
}
pin_project! {
/// Response future for [`Either`].
pub struct EitherResponseFuture {
#[pin]
kind: Kind
}
}
pin_project! {
#[project = KindProj]
enum Kind {
Left { #[pin] inner: A },
Right { #[pin] inner: B },
}
}
impl Future for EitherResponseFuture
where
A: Future,
B: Future