#regex #random #generator

rand_regex

Generates random strings and byte strings matching a regex

8 releases (4 breaking)

0.15.1 Feb 12, 2021
0.15.0 Jan 9, 2021
0.14.2 Feb 1, 2020
0.14.1 Jan 27, 2020
0.11.0 Oct 27, 2018

#105 in Algorithms

Download history 2445/week @ 2022-03-12 2685/week @ 2022-03-19 2420/week @ 2022-03-26 1890/week @ 2022-04-02 2827/week @ 2022-04-09 1920/week @ 2022-04-16 2344/week @ 2022-04-23 2331/week @ 2022-04-30 2336/week @ 2022-05-07 1730/week @ 2022-05-14 3024/week @ 2022-05-21 2826/week @ 2022-05-28 2929/week @ 2022-06-04 1924/week @ 2022-06-11 2726/week @ 2022-06-18 2735/week @ 2022-06-25

11,051 downloads per month
Used in 19 crates (6 directly)

MIT license

44KB
859 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(),
    "𝟽٩𑃶᱒-៤꣖-൭᧓".to_string(),
    "𑃰꩗१௭-9၅-६௫".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![
    "8922-87-63".to_string(),
    "3149-18-88".to_string(),
    "5420-58-55".to_string(),
]);

Acknowledgement

rand_regex is heavily inspired by regex_generate and proptest.

Dependencies

~1–1.3MB
~37K SLoC