Add DelayQueue implementation to tokio-timer (#550)

This patch adds a `DelayQueue` to tokio_timer. The `DelayQueue` allows
inserting elements as well as specifying a time at which the element
should be returned to the user. This allows handling more complex
timeout situations.

src/timer.rs

@@ -14,6 +14,9 @@
 //!   a specified `Instant` in time. If the future does not complete in time,
 //!   then it is canceled and an error is returned.
 //!
+//! * [`DelayQueue`]: A queue where items are returned once the requested delay
+//!   has expired.
+//!
 //! These types are sufficient for handling a large number of scenarios
 //! involving time.
 //!
@@ -79,10 +82,13 @@
 //! [Deadline]: struct.Deadline.html
 //! [Delay]: struct.Delay.html
 //! [Interval]: struct.Interval.html
+//! [`DelayQueue`]: struct.DelayQueue.html
 
 pub use tokio_timer::{
+    delay_queue,
     Deadline,
     DeadlineError,
+    DelayQueue,
     Error,
     Interval,
     Delay,

tokio-timer/Cargo.toml

@@ -19,5 +19,10 @@ Timer facilities for Tokio
 futures = "0.1.19"
 tokio-executor = { version = "0.1.1", path = "../tokio-executor" }
 
+# Backs `DelayQueue`
+slab = "0.4.1"
+
 [dev-dependencies]
 rand = "0.5"
+tokio-mock-task = "0.1.0"
+tokio = { version = "0.1.7", path = "../" }