faker_rand

faker_rand is a Rust crate that lets you easily generate fake data using the rand crate. It also provides macros so you can easily build your own data generators on top of those provided out of the box.

Installation

You can use faker_rand in your Rust project by adding the following to your Cargo.toml:

toml faker_rand = "0.1"

Usage

See the docs on docs.rs for more details, but at a high level here's how you can use this crate:

```rust use rand::Rng; use fakerrand::enus::names::FirstName;

// you can display generators using "{}" println!("random first name: {}", rand::random::()); println!("random first name: {}", rand::thread_rng().gen::());

// or, you can use tostring as well let name = rand::random::().tostring(); println!("random first name: {}", name); ```

You can also build your own generators on top of those provided by this crate, for example if you already have a file of fake data you'd like to generate:

```rust use fakerrand::fakerimplfromfile;

// First, declare your newtype wrapper around String. struct Demo(String);

// Then, use the macro. data/loremwords is a path to a file containing // example words; you will need to change this path to suit your needs. fakerimplfromfile!(Demo, "data/lorem_words");

use rand::{Rng, SeedableRng}; let mut rng = randchacha::ChaCha8Rng::seedfrom_u64(0);

asserteq!("impedit", rng.gen::().tostring()); ```

Or, if you want to compose upon sub-generators:

```rust use fakerrand::fakerimplfromtemplates;

// First, declare your newtype wrapper around String. struct Demo(String);

// Then, invoke the macro. // // Note well: all commas and semicolons in this example, even trailing // semicolons, are strictly required. fakerimplfrom_templates! { // The type we're creating a generator implementation for. Demo;

// The template patterns.
"{}.{}", faker_rand::util::AsciiDigit, faker_rand::lorem::Word;
"{} ~~~ {}", faker_rand::lorem::Word, faker_rand::util::AsciiDigit;

}

use rand::{Rng, SeedableRng}; let mut rng = randchacha::ChaCha8Rng::seedfrom_u64(0);

asserteq!("qui ~~~ 5", rng.gen::().tostring()); asserteq!("debitis ~~~ 5", rng.gen::().tostring()); asserteq!("5.aliquid", rng.gen::().tostring()); asserteq!("0.doloribus", rng.gen::().tostring()); ```

Most of the documentation for this crate lives in the Rust docs, not this README. Check out https://docs.rs/faker_rand for copy-pastable examples you can use.