Upgrading rand 0.8 to 0.9

Breaking0.8.8 → 0.9.5Breaking39Security7Platform5Deprecated2New59Changed37Fixed23Other71

Full comparison Back to rand

SecurityRand is unsound with a custom logger using `rand::rng()`GHSA-cq8v-f236-94qc ↗

BreakingUpgrade verdict

36 breaking changes and 5 platform requirement changes and 7 security fixes.

In plain terms

Rename fn SeedableRng::from_rng -> try_from_rng and add infallible variant fn from_rng.
Rename fn SeedableRng::from_entropy -> from_os_rng and add fallible variant fn try_from_os_rng.
Rename fn rand::thread_rng() to rand::rng() and remove from the prelude.
Remove fn rand::random() from the prelude.

Must act Top 5 of 50 that need code or config changes

Requires Rust 1.63 from 0.9.0-beta.0 (none stated before).

Adds rayon ^1.7.

Drops libc.

Installs 23 packages in all (was 18).

What you must change

Breaking36

Rename fn SeedableRng::from_rng -> try_from_rng and add infallible variant fn from_rng.

try_from_rng

0.9.0GitHub ReleaseOriginalView source

Rename fn SeedableRng::from_entropy -> from_os_rng and add fallible variant fn try_from_os_rng.

from_os_rng

0.9.0GitHub ReleaseOriginalView source

Rename fn rand::thread_rng() to rand::rng() and remove from the prelude.

rand::thread_rng()rand::rng()

0.9.0GitHub ReleaseOriginalView source

Remove fn rand::random() from the prelude.

rand::random()

0.9.0GitHub ReleaseOriginalView source

Rename fn Rng::gen to random to avoid conflict with the new gen keyword in Rust 2024.

Rng::genrandomgen

0.9.0GitHub ReleaseOriginalView source

Rename fns Rng::gen_range to random_range, gen_bool to random_bool, gen_ratio to random_ratio.

Rng::gen_rangerandom_rangegen_boolrandom_boolgen_ratiorandom_ratio

0.9.0GitHub ReleaseOriginalView source

Remove first parameter (rng) of ReseedingRng::new.

rngReseedingRng::new

0.9.0GitHub ReleaseOriginalView source

Rename module rand::distributions to rand::distr.

rand::distributionsrand::distr

0.9.0GitHub ReleaseOriginalView source

Rename distribution Standard to StandardUniform.

StandardStandardUniform

0.9.0GitHub ReleaseOriginalView source

Rename trait distr::DistString -> distr::SampleString.

distr::DistStringdistr::SampleString

0.9.0GitHub ReleaseOriginalView source

Rename distr::DistIter -> distr::Iter, distr::DistMap -> distr::Map.

distr::DistIterdistr::Iterdistr::DistMapdistr::Map

0.9.0GitHub ReleaseOriginalView source

Remove impl of Distribution<Option> for StandardUniform.

Distribution<Option<T>>StandardUniform

0.9.0GitHub ReleaseOriginalView source

Remove support for generating isize and usize values with StandardUniform, Uniform (except via UniformUsize) and Fill and usage as a WeightedAliasIndex weight.

isizeusizeStandardUniformUniformUniformUsizeFill

0.9.0GitHub ReleaseOriginalView source

Rename enum WeightedError to weighted::Error, revising variants and mark as #[non_exhaustive].

WeightedErrorweighted::Error#[non_exhaustive]

0.9.0GitHub ReleaseOriginalView source

Remove unused fields.

0.9.0GitHub ReleaseOriginalView source

Remove redundant bounds.

0.9.0GitHub ReleaseOriginalView source

Rename WeightedError → WeightError; add IndexedRandom, IndexedMutRandom.

0.9.0GitHub ReleaseOriginalView source

Remove automatic (delayed) reseed-on-fork.

0.9.0GitHub ReleaseOriginalView source

Rename Rng::gen to Rng::random.

Rng::genRng::random

0.9.0GitHub ReleaseOriginalView source

Rename doc_cfg to docsrs and use doc_auto_cfg.

doc_cfgdocsrsdoc_auto_cfg

0.9.0GitHub ReleaseOriginalView source

Rename serde1 feature to serde.

serde1serde

0.9.0GitHub ReleaseOriginalView source

Rename gen_iter → random_iter, misc.

0.9.0GitHub ReleaseOriginalView source

Remove some unsafe, update to zerocopy 0.8.0.

0.9.0GitHub ReleaseOriginalView source

Remove u64 support for Poisson.

0.9.0GitHub ReleaseOriginalView source

Remove conditional compilation around using core.

0.9.0GitHub ReleaseOriginalView source

Remove SmallRng::from_thread_rng.

0.9.0GitHub ReleaseOriginalView source

Make ReseedingRng::reseed discard remaining data from the last block generated.

ReseedingRng::reseed

0.9.0GitHub ReleaseOriginalView source

Change fn SmallRng::seed_from_u64 implementation.

SmallRng::seed_from_u64

0.9.0GitHub ReleaseOriginalView source

Allow UniformFloat::new samples and UniformFloat::sample_single to yield high.

UniformFloat::newUniformFloat::sample_singlehigh

0.9.0GitHub ReleaseOriginalView source

Fix portability of distribution Slice.

Slice

0.9.0GitHub ReleaseOriginalView source

Fix IndexdRandom::choose_multiple_weighted for very small seeds and optimize for large input length / low memory.

IndexdRandom::choose_multiple_weighted

0.9.0GitHub ReleaseOriginalView source

Optimize fn sample_floyd, affecting output of rand::seq::index::sample and rand::seq::SliceRandom::choose_multiple.

sample_floydrand::seq::index::samplerand::seq::SliceRandom::choose_multiple

0.9.0GitHub ReleaseOriginalView source

New, faster algorithms for IteratorRandom::choose and choose_stable.

IteratorRandom::choosechoose_stable

0.9.0GitHub ReleaseOriginalView source

New, faster algorithms for SliceRandom::shuffle and partial_shuffle.

SliceRandom::shufflepartial_shuffle

0.9.0GitHub ReleaseOriginalView source

Optimize distribution Uniform: use Canon's method (single sampling) / Lemire's method (distribution sampling) for faster sampling (breaks value stability; ).

Uniform

0.9.0GitHub ReleaseOriginalView source

Optimize fn sample_single_inclusive for floats (+~20% perf).

sample_single_inclusive

0.9.0GitHub ReleaseOriginalView source

Security7

Rand is unsound with a custom logger using rand::rng()

0.9.3GitHub AdvisoryOriginalView source

Revise "not a crypto library" policy again.

0.9.1GitHub ReleaseOriginalView source

Remove zerocopy dependency from rand.

zerocopyrand

0.9.1GitHub ReleaseOriginalView source

Policy: "rand is not a crypto library".

0.9.0GitHub ReleaseOriginalView source

Remove fork-protection from ReseedingRng and ThreadRng.

ReseedingRngThreadRngThreadRng::reseed

0.9.0GitHub ReleaseOriginalView source

Use zerocopy to replace some unsafe code.

zerocopyunsafe

0.9.0GitHub ReleaseOriginalView source

GitHub Workflows security hardening.

0.9.0GitHub ReleaseOriginalView source

Platform5

Bump the MSRV to 1.63.0; note that 1.60.0 may work for dependents when using --ignore-rust-version.

--ignore-rust-version

0.9.0GitHub ReleaseOriginalView source

Bump MSRV to 1.51.0.

0.9.0GitHub ReleaseOriginalView source

Bump MSRV to 1.56 (Edition 2021).

0.9.0GitHub ReleaseOriginalView source

Bump the MSRV to 1.61.0.

0.9.0GitHub ReleaseOriginalView source

Bump the MSRV to 1.63.0.

0.9.0GitHub ReleaseOriginalView source

Deprecations to plan for

Deprecated2

Deprecate feature log.

log

0.9.3GitHub ReleaseOriginalView source

Deprecate rand::rngs::mock module and StepRng generator.

rand::rngs::mockStepRng

0.9.2GitHub ReleaseOriginalView source