//! 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>, AE: Into, B: Future>, BE: Into, { type Output = Result; fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll { match self.project() { EitherProj::A(fut) => Poll::Ready(Ok(ready!(fut.poll(cx)).map_err(Into::into)?)), EitherProj::B(fut) => Poll::Ready(Ok(ready!(fut.poll(cx)).map_err(Into::into)?)), } } } impl Layer for Either where A: Layer, B: Layer, { type Service = Either; fn layer(&self, inner: S) -> Self::Service { match self { Either::A(layer) => Either::A(layer.layer(inner)), Either::B(layer) => Either::B(layer.layer(inner)), } } }