#random #regex #generator #string #random-string

rand_regex

Generates random strings and byte strings matching a regex

11 releases (7 breaking)

0.18.0 Jan 28, 2025
0.17.0 Jan 15, 2024
0.16.0 Aug 4, 2023
0.15.1 Feb 12, 2021
0.12.0 Nov 25, 2018

#51 in Algorithms

Download history 4945/week @ 2024-12-23 6040/week @ 2024-12-30 13326/week @ 2025-01-06 13383/week @ 2025-01-13 12047/week @ 2025-01-20 12931/week @ 2025-01-27 13717/week @ 2025-02-03 14401/week @ 2025-02-10 13239/week @ 2025-02-17 14494/week @ 2025-02-24 14780/week @ 2025-03-03 15683/week @ 2025-03-10 16319/week @ 2025-03-17 13435/week @ 2025-03-24 12787/week @ 2025-03-31 18264/week @ 2025-04-07

61,345 downloads per month
Used in 47 crates (16 directly)

MIT license

48KB
870 lines

rand_regex

Crates.io Build status MIT License

Generates random strings and byte strings matching a regex.

Examples

use rand::{SeedableRng, Rng};

let mut rng = rand_xorshift::XorShiftRng::from_seed(*b"The initial seed");

// creates a generator for sampling strings
let gen = rand_regex::Regex::compile(r"\d{4}-\d{2}-\d{2}", 100).unwrap();

// sample a few strings randomly
let samples = (&mut rng).sample_iter(&gen).take(3).collect::<Vec<String>>();

// all Unicode characters are included when sampling
assert_eq!(samples, vec![
    "꧰᪈৭᱃-𐒧᧒-௦۴".to_string(),
    "𞓰۳𑛐꩑-᪄9-໔᮹".to_string(),
    "𑛃𑃹९೭-١᥈-৫೪".to_string()
]);

// you could use `regex_syntax::Hir` to include more options
let mut parser = regex_syntax::ParserBuilder::new().unicode(false).build();
let hir = parser.parse(r"\d{4}-\d{2}-\d{2}").unwrap();
let gen = rand_regex::Regex::with_hir(hir, 100).unwrap();
let samples = (&mut rng).sample_iter(&gen).take(3).collect::<Vec<String>>();
assert_eq!(samples, vec![
    "2839-82-12".to_string(),
    "2857-86-63".to_string(),
    "0381-04-99".to_string(),
]);

Acknowledgement

rand_regex is heavily inspired by regex_generate and proptest.

Dependencies

~2.5MB
~51K SLoC