Skip to content

Upgrading futures-util 0.2 to 0.3

Breaking0.2.1 → 0.3.34Breaking20Security4Platform4Deprecated3New95Changed24Fixed40Other14

Full comparisonBack to futures-util
BreakingUpgrade verdict

20 breaking changes and 4 platform requirement changes and 4 security fixes.

In plain terms
  • Remove dependency to pin-utils.
  • Remove dependency on num_cpus.
  • Lets more stream types be converted into async readers, since they no longer need to be safe to move in memory.
  • An experimental feature for reading data before it is fully initialized is no longer available.
Must act Top 5 of 31 that need code or config changes

Requires Rust 1.71 from 0.3.32 (none stated before).

What you must change

Breaking20
Remove dependency to pin-utils.
pin-utils
0.3.32GitHub ReleaseOriginalView source
Remove dependency on num_cpus.
num_cpus
0.3.32GitHub ReleaseOriginalView source
Removes the Unpin bound from TryStreamExt::into_async_read.
TryStreamExt::into_async_readUnpin
0.3.22GitHub ReleaseSummarizedView source
Removes the unstable read-initializer feature.
read-initializer
0.3.19GitHub ReleaseSummarizedView source
Removes the Send bound on the output of RemoteHandle.
RemoteHandleSend
0.3.5GitHub ReleaseSummarizedView source
Removes ThreadPool::run.
ThreadPool::run
0.3.0GitHub ReleaseSummarizedView source
Removes BufReader::poll_seek_relative.
BufReader::poll_seek_relative
0.3.0GitHub ReleaseSummarizedView source
Removes Stream impl for VecDeque.
StreamVecDeque
0.3.0GitHub ReleaseSummarizedView source
Renames Peekable::peek to poll_peek.
Peekable::peekPeekable::poll_peek
0.3.0GitHub ReleaseSummarizedView source
Renames oneshot::Sender::poll_cancel to poll_canceled.
oneshot::Sender::poll_canceloneshot::Sender::poll_canceled
0.3.0GitHub ReleaseSummarizedView source
Fix soundness bug in task::waker_ref This is a breaking change but allowed because it is soundness bug fix.
task::waker_ref
0.3.31GitHub ReleaseOriginalView source
Fix parsing issue in select!/select_biased!
select!select_biased!
0.3.31GitHub ReleaseOriginalView source
Fixes type inference in sink::unfold by specifying more of its types, which is a breaking change.
sink::unfold
0.3.10GitHub ReleaseSummarizedView source
Fixes the signature of the LocalSpawn trait, a breaking change.
LocalSpawn
0.3.1GitHub ReleaseSummarizedView source
Changes Spawn trait and FuturesUnordered::push to take &self.
SpawnFuturesUnordered::push
0.3.0GitHub ReleaseSummarizedView source
Moves Spawn and FutureObj out of futures-core and into futures-task.
SpawnFutureObjfutures-corefutures-task
0.3.0GitHub ReleaseSummarizedView source
Changes case convention for feature names.
0.3.0GitHub ReleaseSummarizedView source
Moves copy_into and copy_buf_into.
copy_intocopy_buf_into
0.3.0GitHub ReleaseSummarizedView source
Changes SinkExt::send_all to accept a TryStream.
SinkExt::send_allTryStream
0.3.0GitHub ReleaseSummarizedView source
Changes skip to take a usize rather than a u64.
skip
0.3.0GitHub ReleaseSummarizedView source
Security4
Fixes a soundness issue in the join! and try_join! macros (#2649).
join!try_join!
0.3.25GitHub ReleaseSummarizedView source
Fixes a heap buffer overflow in AsyncReadExt::read_to_end and AsyncReadExt::read_to_string.
AsyncReadExt::read_to_endAsyncReadExt::read_to_string
0.3.11GitHub ReleaseSummarizedView source
MutexGuard::map can cause a data race in safe code
Medium · CVSS 4.7
0.3.7GitHub AdvisoryOriginalView source
Improper Sync implementation on FuturesUnordered in futures-utils can cause data corruption
Medium · CVSS 5.5
0.3.2GitHub AdvisoryOriginalView source
Platform4
Bump MSRV of utility crates to 1.71.
0.3.32GitHub ReleaseOriginalView source
Updates to syn 2, raising the MSRV of utility crates to 1.56.
0.3.28GitHub ReleaseSummarizedView source
Removes the proc-macro-hack dependency, raising the MSRV of utility crates to 1.45.
proc-macro-hack
0.3.18GitHub ReleaseSummarizedView source
Supports targets that do not have atomic CAS on stable Rust.
0.3.15GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated3
Soft-deprecate ready! macro in favor of std::task::ready! added in Rust 1.64.
ready!std::task::ready!
0.3.32GitHub ReleaseOriginalView source
Soft-deprecate pin_mut! macro in favor of std::pin::pin! added in Rust 1.68.
pin_mut!std::pin::pin!
0.3.32GitHub ReleaseOriginalView source
Deprecates FuturesOrdered::push in favor of FuturesOrdered::push_back.
FuturesOrdered::pushFuturesOrdered::push_back
0.3.22GitHub ReleaseSummarizedView source