workaround bug in rustdoc

rust-lang/rust#58011

Author: brunocodutra

src/dispatcher/async.rs

@@ -1,6 +1,6 @@
 use crate::dispatcher::Dispatcher;
 use futures::channel::{mpsc, oneshot};
-use futures::future::{FutureExt, TryFutureExt};
+use futures::future::{TryFutureExt, UnwrapOrElse};
 use futures::stream::StreamExt;
 use futures::task::{SpawnError, SpawnExt};
 use std::marker::PhantomData;
@@ -157,7 +157,11 @@ impl<D, A> Dispatcher<A> for AsyncHandle<D, A>
 where
     D: Dispatcher<A>,
 {
-    existential type Output: FutureExt<Output = D::Output>;
+    /// A type that implements `FutureExt<Output = D::Output>`.
+    ///
+    /// _**Important:** do not rely on the actual type,_
+    /// _this will become an existential type once issues with rustdoc are solved._
+    type Output = Promise<D::Output>;
 
     /// Asynchronously sends an action through the dispatcher managed by [Async](struct.Async.html)
     /// and returns a *promise* to its output.
@@ -175,6 +179,8 @@ where
     }
 }
 
+type Promise<T> = UnwrapOrElse<oneshot::Receiver<T>, fn(oneshot::Canceled) -> T>;
+
 #[cfg(test)]
 mod tests {
     use super::*;

src/lib.rs

@@ -29,10 +29,7 @@
 //!
 //!     Enables integration with [futures-rs](https://crates.io/crates/futures-preview).
 
-#![cfg_attr(
-    feature = "async",
-    feature(async_await, await_macro, futures_api, existential_type)
-)]
+#![cfg_attr(feature = "async", feature(async_await, await_macro, futures_api))]
 
 mod macros;
 mod mock;