long tail

Author: AndyGauge

Cargo.toml

@@ -7,6 +7,10 @@ license = "MIT/Apache-2.0"
 publish = false
 build = "build.rs"
 
+[features]
+default = []
+test-rand = []
+
 [dependencies]
 ansi_term = "0.11.0"
 approx = "0.3"
@@ -16,7 +20,7 @@ byteorder = "1.0"
 cc = "1.0"
 chrono = "0.4"
 clap = "4.5"
-crossbeam = "0.5"
+crossbeam = "0.8"
 crossbeam-channel = "0.3.9"
 csv = "1.0"
 data-encoding = "2.1.0"
@@ -36,8 +40,8 @@ num_cpus = "1.16"
 percent-encoding = "2.3"
 petgraph = "0.6"
 postgres = "0.19"
-rand = "0.9"
-rand_distr = "0.5.1"
+rand = "0.8"
+rand_distr = "0.4"
 rayon = "1.10"
 regex = "1.11"
 reqwest = { version = "0.12", features = ["blocking", "json", "stream"] }
@@ -65,9 +69,9 @@ walkdir = "2.5"
 syslog = "5.0"
 
 [build-dependencies]
-skeptic = "0.13"
+skeptic = { git = "https://github.com/andygauge/rust-skeptic", branch = "rlib-patch" }
 walkdir = "2.5"
 
 [dev-dependencies]
-skeptic = "0.13"
+skeptic = { git = "https://github.com/andygauge/rust-skeptic", branch = "rlib-patch" }
 walkdir = "2.5"

build.rs

@@ -6,6 +6,20 @@ const REMOVED_TESTS: &[&str] = &[
 ];
 
 fn main() {
+    #[cfg(feature = "test-rand")]
+    {
+        let rand_paths = vec![
+            "./src/algorithms/randomness/rand.md",
+            "./src/algorithms/randomness/rand-range.md",
+            "./src/algorithms/randomness/rand-dist.md",
+            "./src/algorithms/randomness/rand-custom.md",
+            "./src/algorithms/randomness/rand-passwd.md",
+            "./src/algorithms/randomness/rand-choose.md",
+        ];
+        skeptic::generate_doc_tests(&rand_paths[..]);
+        return;
+    }
+
     let paths = WalkDir::new("./src/").into_iter()
         // convert paths to Strings
         .map(|p| p.unwrap().path().to_str().unwrap().to_string())

src/about.md

@@ -62,7 +62,8 @@ use rand::Rng;
 
 fn main() {
     let mut rng = rand::thread_rng();
-    println!("Random f64: {}", rng.gen::<f64>());
+    let random_number: u32 = rng.gen();
+    println!("Random number: {}", random_number);
 }
 ```
 

src/algorithms/randomness/rand-choose.md

@@ -3,27 +3,29 @@
 [![rand-badge]][rand] [![cat-os-badge]][cat-os]
 
 Randomly generates a string of given length ASCII characters with custom
-user-defined bytestring, with [`random_range`].
+user-defined bytestring, with [`gen_range`].
 
 ```rust,edition2018
 extern crate rand;
+use rand::Rng;
+
+const CHARSET: &[u8] = b"ABCDEFGHIJKLMNOPQRSTUVWXYZ\
+                        abcdefghijklmnopqrstuvwxyz\
+                        0123456789)(*&^%$#@!~";
+const PASSWORD_LEN: usize = 30;
+
 fn main() {
-    use rand::Rng;
-    const CHARSET: &[u8] = b"ABCDEFGHIJKLMNOPQRSTUVWXYZ\
-                            abcdefghijklmnopqrstuvwxyz\
-                            0123456789)(*&^%$#@!~";
-    const PASSWORD_LEN: usize = 30;
-    let mut rng = rand::rng();
+    let mut rng = rand::thread_rng();
 
     let password: String = (0..PASSWORD_LEN)
         .map(|_| {
-            let idx = rng.random_range(0..CHARSET.len());
-            CHARSET[idx] as char
+            let idx = rng.gen_range(0..CHARSET.len());
+            char::from(CHARSET[idx])
         })
         .collect();
 
     println!("{:?}", password);
 }
 ```
 
-[`random_range`]: https://docs.rs/rand/*/rand/trait.Rng.html#method.random_range
+[`gen_range`]: https://docs.rs/rand/*/rand/trait.Rng.html#method.gen_range

src/algorithms/randomness/rand-custom.md

@@ -18,7 +18,8 @@ struct Point {
 
 impl Distribution<Point> for Standard {
     fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> Point {
-        let (rand_x, rand_y) = rng.random();
+        let rand_x: i32 = rng.gen();
+        let rand_y: i32 = rng.gen();
         Point {
             x: rand_x,
             y: rand_y,
@@ -27,13 +28,13 @@ impl Distribution<Point> for Standard {
 }
 
 fn main() {
-    let mut rng = rand::rng();
-    let rand_tuple = rng.random::<(i32, bool, f64)>();
-    let rand_point: Point = rng.random();
+    let mut rng = rand::thread_rng();
+    let rand_tuple = rng.gen::<(i32, bool, f64)>();
+    let rand_point: Point = rng.gen();
     println!("Random tuple: {:?}", rand_tuple);
     println!("Random Point: {:?}", rand_point);
 }
 ```
 
-[`Distribution`]: https://docs.rs/rand/*/rand/distributions/trait.Distribution.html
-[`Standard`]: https://docs.rs/rand/*/rand/distributions/struct.Standard.html
+[Distribution]: https://docs.rs/rand/*/rand/distributions/trait.Distribution.html
+[Standard]: https://docs.rs/rand/*/rand/distributions/struct.Standard.html

src/algorithms/randomness/rand-dist.md

@@ -12,18 +12,22 @@ generator [`rand::Rng`].
 The [distributions available are documented here][rand-distributions].
 An example using the [`Normal`] distribution is shown below.
 
-```rust,edition2018,ignore
+```rust,edition2018
 extern crate rand;
 extern crate rand_distr;
-use rand_distr::{Distribution, Normal, NormalError};
-use rand::rng;
+use rand::thread_rng;
+use rand_distr::{Distribution, LogNormal, Normal};
+use rand::distributions::Distribution as RandDistribution;
+
+fn main() {
+    let mut rng = thread_rng();
+    let normal = Normal::new(2.0, 3.0).unwrap();
+    let log_normal = LogNormal::new(1.0, 0.5).unwrap();
 
-fn main() -> Result<(), NormalError> {
-    let mut rng = rng();
-    let normal = Normal::new(2.0, 3.0)?;
     let v = normal.sample(&mut rng);
     println!("{} is from a N(2, 9) distribution", v);
-    Ok(())
+    let v = log_normal.sample(&mut rng);
+    println!("{} is from an ln N(1, 0.25) distribution", v);
 }
 ```
 

src/algorithms/randomness/rand-passwd.md

@@ -7,11 +7,11 @@ a-z, 0-9`, with [`Alphanumeric`] sample.
 
 ```rust,edition2018
 extern crate rand;
-use rand::{rng, Rng};
+use rand::{thread_rng, Rng};
 use rand::distributions::Alphanumeric;
 
 fn main() {
-    let rand_string: String = rng()
+    let rand_string: String = thread_rng()
         .sample_iter(&Alphanumeric)
         .take(30)
         .map(char::from)

src/algorithms/randomness/rand-range.md

@@ -2,16 +2,16 @@
 
 [![rand-badge]][rand] [![cat-science-badge]][cat-science]
 
-Generates a random value within half-open `[0, 10)` range (not including `10`) with [`Rng::random_range`].
+Generates a random value within half-open `[0, 10)` range (not including `10`) with [`Rng::gen_range`].
 
 ```rust,edition2018
 extern crate rand;
 use rand::Rng;
 
 fn main() {
-    let mut rng = rand::rng();
-    println!("Integer: {}", rng.random_range(0..10));
-    println!("Float: {}", rng.random_range(0.0..10.0));
+    let mut rng = rand::thread_rng();
+    println!("Integer: {}", rng.gen_range(0..10));
+    println!("Float: {}", rng.gen_range(0.0..10.0));
 }
 ```
 
@@ -21,10 +21,12 @@ in the same range.
 
 ```rust,edition2018
 extern crate rand;
-use rand::distributions::{Distribution, Uniform};
+extern crate rand_distr;
+use rand::Rng;
+use rand_distr::{Distribution, Uniform};
 
 fn main() {
-    let mut rng = rand::rng();
+    let mut rng = rand::thread_rng();
     let die = Uniform::from(1..7);
 
     loop {
@@ -35,8 +37,4 @@ fn main() {
         }
     }
 }
-```
-
-[`Uniform`]: https://docs.rs/rand/*/rand/distributions/uniform/struct.Uniform.html
-[`Rng::random_range`]: https://doc.rust-lang.org/rand/*/rand/trait.Rng.html#method.random_range
-[uniform distribution]: https://en.wikipedia.org/wiki/Uniform_distribution_(continuous)
+```

src/algorithms/randomness/rand.md

@@ -13,15 +13,9 @@ extern crate rand;
 use rand::Rng;
 
 fn main() {
-    let mut rng = rand::rng();
-
-    let n1: u8 = rng.random();
-    let n2: u16 = rng.random();
-    println!("Random u8: {}", n1);
-    println!("Random u16: {}", n2);
-    println!("Random u32: {}", rng.random::<u32>());
-    println!("Random i32: {}", rng.random::<i32>());
-    println!("Random float: {}", rng.random::<f64>());
+    let mut rng = rand::thread_rng();
+    let random_number: u32 = rng.gen();
+    println!("Random number: {}", random_number);
 }
 ```
 

src/concurrency/parallel/rayon-parallel-sort.md

@@ -10,19 +10,20 @@ exist to sort an enumerable data type, [`par_sort_unstable`]
 is usually faster than [stable sorting] algorithms.
 
 ```rust,edition2018
-extern crate rayon;
 extern crate rand;
-use rand::{Rng, thread_rng};
-use rand::distributions::Alphanumeric;
+extern crate rayon;
+use rand::Rng;
 use rayon::prelude::*;
 
 fn main() {
-  let mut vec = vec![String::new(); 100_000];
-  vec.par_iter_mut().for_each(|p| {
-    let mut rng = thread_rng();
-    *p = (0..5).map(|_| rng.sample(&Alphanumeric) as char).collect()
-  });
-  vec.par_sort_unstable();
+    let mut vec = vec![0; 1_000_000];
+    rand::thread_rng().fill(&mut vec[..]);
+
+    vec.par_sort_unstable();
+
+    let first = vec.first().unwrap();
+    let last = vec.last().unwrap();
+    assert!(first <= last);
 }
 ```