Remove CryptoGenerator and Generator::drop; add BlockRng::clear (#69)

Author: dhardy

CHANGELOG.md

@@ -40,6 +40,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `BlockRng::reset` method ([#44])
 - `BlockRng::index` method (replaced with `BlockRng::word_offset`) ([#44])
 - `Generator::Item` associated type ([#26])
+- `CryptoBlockRng` ([#69])
 
 [0.10.0]: https://github.com/rust-random/rand_core/compare/v0.9.3...HEAD
 
@@ -60,6 +61,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#53]: https://github.com/rust-random/rand_core/pull/53
 [#56]: https://github.com/rust-random/rand_core/pull/56
 [#58]: https://github.com/rust-random/rand_core/pull/58
+[#69]: https://github.com/rust-random/rand_core/pull/69
 
 [rust-random/rand]: https://github.com/rust-random/rand
 [rust-random/rand_core]: https://github.com/rust-random/rand_core

src/block.rs

@@ -1,8 +1,7 @@
 //! The [`Generator`] trait and [`BlockRng`]
 //!
-//! Trait [`Generator`] and marker trait [`CryptoGenerator`] may be implemented
-//! by block-generators; that is PRNGs whose output is a *block* of words, such
-//! as `[u32; 16]`.
+//! Trait [`Generator`] may be implemented by block-generators; that is PRNGs
+//! whose output is a *block* of words, such as `[u32; 16]`.
 //!
 //! The struct [`BlockRng`] wraps such a [`Generator`] together with an output
 //! buffer and implements several methods (e.g. [`BlockRng::next_word`]) to
@@ -72,17 +71,8 @@
 //! # assert_eq!(rng.next_u32(), 1171109249);
 //! ```
 //!
-//! # ReseedingRng
-//!
-//! The [`Generator`] trait supports usage of [`rand::rngs::ReseedingRng`].
-//! This requires that [`SeedableRng`] be implemented on the "core" generator.
-//! Additionally, it may be useful to implement [`CryptoGenerator`].
-//! (This is in addition to any implementations on an [`TryRng`] type.)
-//!
-//! [`Generator`]: crate::block::Generator
 //! [`TryRng`]: crate::TryRng
 //! [`SeedableRng`]: crate::SeedableRng
-//! [`rand::rngs::ReseedingRng`]: https://docs.rs/rand/latest/rand/rngs/struct.ReseedingRng.html
 
 use crate::utils::Word;
 use core::fmt;
@@ -109,18 +99,6 @@ pub trait Generator {
     }
 }
 
-/// A cryptographically secure generator
-///
-/// This is a marker trait used to indicate that a [`Generator`] implementation
-/// is supposed to be cryptographically secure.
-///
-/// Mock generators should not implement this trait *except* under a
-/// `#[cfg(test)]` attribute to ensure that mock "crypto" generators cannot be
-/// used in production.
-///
-/// See [`TryCryptoRng`](crate::TryCryptoRng) docs for more information.
-pub trait CryptoGenerator: Generator {}
-
 /// RNG functionality for a block [`Generator`]
 ///
 /// This type encompasses a [`Generator`] [`core`](Self::core) and a buffer.