futures

• Add forwarding sink/stream impls for stream::FromErr and sink::SinkFromErr
• Add PartialEq and Eq to mpsc::SendError
• Reimplement Shared with spawn instead of UnparkEvent

• Add Stream::from_err and Sink::from_err
• Allow SendError to be Clone when possible

The major highlight of this release is the addition of a new "default" method on the Sink trait, Sink::close. This method is used to indicate to a sink that no new values will ever need to get pushed into it. This can be used to implement graceful shutdown of protocols and otherwise simply indicates to a sink that it can start freeing up resources.

Currently this method is not a default method to preserve backwards compatibility, but it's intended to become a default method in the 0.2 series of the futures crate. It's highly recommended to audit implementations of Sink to implement the close method as is fit.

Other changes in this release are:

• A new select combinator, Future::select2 was added for a heterogeneous select.
• A Shared::peek method was added to check to see if it's done.
• Sink::map_err was implemented
• The log dependency was removed
• Implementations of the Debug trait are now generally available.
• The stream::IterStream type was renamed to stream::Iter (with a reexport for the old name).
• Add a Sink::wait method which returns an adapter to use an arbitrary Sink synchronously.
• A Stream::concat method was added to concatenate a sequence of lists.
• The oneshot::Sender::complete method was renamed to send and now returns a Result indicating successful transmission of a message or not. Note that the complete method still exists, it's just deprecated.

• Add a new unsync module which mirrors sync to the extent that it can but is intended to not perform cross-thread synchronization (only usable within one thread).
• Tweak Shared to work when handles may not get poll'd again.

• Fix Send/Sync of a few types
• Add future::tail_fn for more easily writing loops
• Export SharedItem/SharedError
• Remove an unused type parameter in from_err

• Fix some race conditions in the Shared implementation
• Add Stream::take_while
• Fix an unwrap in stream::futures_unordered
• Generalize Stream::for_each
• Add Stream::chain
• Add stream::repeat
• Relax &mut self to &self in UnboundedSender::send

• Add a Future::shared method for creating a future that can be shared amongst threads by cloning the future itself. All derivative futures will resolve to the same value once the original future has been resolved.
• Add a FutureFrom trait for future-based conversion
• Fix a wakeup bug in Receiver::close
• Add future::poll_fn for quickly adapting a Poll-based function to a future.
• Add an Either enum with two branches to easily create one future type based on two different futures created on two branches of control flow.
• Remove the 'static bound on Unpark
• Optimize send_all and forward to send as many items as possible before calling poll_complete.
• Unify the return types of the ok, err, and result future to assist returning different varieties in different branches of a function.
• Add CpuFuture::forget to allow the computation to continue running after a drop.
• Add a stream::futures_unordered combinator to turn a list of futures into a stream representing their order of completion.

• Fix Clone bound on the type parameter on UnboundedSender

• Fix #![no_std] support

This is quite a large release relative to the previous point releases! As with all 0.1 releases, this release should be fully compatible with the 0.1.3 release. If any incompatibilities are discovered please file an issue!

The largest changes in 0.1.4 are the addition of a Sink trait coupled with a reorganization of this crate. Note that all old locations for types/traits still exist, they're just deprecated and tagged with #[doc(hidden)].

The new Sink trait is used to represent types which can periodically over time accept items, but may take some time to fully process the item before another can be accepted. Essentially, a sink is the opposite of a stream. This trait will then be used in the tokio-core crate to implement simple framing by modeling I/O streams as both a stream and a sink of frames.

The organization of this crate is to now have three primary submodules, future, stream, and sink. The traits as well as all combinator types are defined in these submodules. The traits and types like Async and Poll are then reexported at the top of the crate for convenient usage. It should be a relatively rare occasion that the modules themselves are reached into.

Finally, the 0.1.4 release comes with a new module, sync, in the futures crate. This is intended to be the home of a suite of futures-aware synchronization primitives. Currently this is inhabited with a oneshot module (the old oneshot function), a mpsc module for a new multi-producer single-consumer channel, and a BiLock type which represents sharing ownership of one value between two consumers. This module may expand over time with more types like a mutex, rwlock, spsc channel, etc.

Notable deprecations in the 0.1.4 release that will be deleted in an eventual 0.2 release:

• The TaskRc type is now deprecated in favor of BiLock or otherwise Arc sharing.
• All future combinators should be accessed through the future module, not the top-level of the crate.
• The Oneshot and Complete types are now replaced with the sync::oneshot module.
• Some old names like collect are deprecated in favor of more appropriately named versions like join_all
• The finished constructor is now ok.
• The failed constructor is now err.
• The done constructor is now result.

As always, please report bugs to https://github.com/rust-lang-nursery/futures-rs and we always love feedback! If you've got situations we don't cover, combinators you'd like to see, or slow code, please let us know!

Full changelog:

• Improve scalability of buffer_unordered combinator
• Fix a memory ordering bug in oneshot
• Add a new trait, Sink
• Reorganize the crate into three primary modules
• Add a new sync module for synchronization primitives
• Add a BiLock sync primitive for two-way sharing
• Deprecate TaskRc
• Rename collect to join_all
• Use a small vec in Events for improved clone performance
• Add Stream::select for selecting items from two streams like merge but requiring the same types.
• Add stream::unfold constructor
• Add a sync::mpsc module with a futures-aware multi-producer single-consumer queue. Both bounded (with backpressure) and unbounded (no backpressure) variants are provided.
• Renamed failed, finished, and done combinators to err, ok, and result.
• Add Stream::forward to send all items to a sink, like Sink::send_all
• Add Stream::split for streams which are both sinks and streams to have separate ownership of the stream/sink halves
• Improve join_all with concurrency

• Rewrite oneshot for efficiency and removing allocations on send/recv
• Errors are passed through in Stream::take and Stream::skip
• Add a select_ok combinator to pick the first of a list that succeeds
• Remove the unnecessary SelectAllNext typedef
• Add Stream::chunks for receiving chunks of data
• Rewrite stream::channel for efficiency, correctness, and removing allocations
• Remove Send + 'static bounds on the stream::Empty type

• Fixed a bug in drop of FutureSender
• Expose the channel SendError type
• Add Future::into_stream to convert to a single-element stream
• Add Future::flatten_to_stream to convert a future of a stream to a stream
• impl Debug for SendError
• Add stream::once for a one element stream
• Accept IntoIterator in stream::iter
• Add Stream::catch_unwind

Initial release!