A Rust library and command line tool for generating fake data in different languages. Currently supports:
Language Code English en French fr_fr Arabic ar_sa Traditional Chinese zh_tw Simplified Chinese zh_cn Japanese ja_jp Portugese (Brazilian) pt_br Portugese (Portugal) pt_pt German de_de Italian it_it Cymraeg (Welsh) cy_gb
[dependencies]
fake = { version = "4", features = ["derive"] }
Available library features:
derive: if you want to use #[derive(Dummy)]chronochrono-tzhttpulidferroiduuidbigdecimal (via bigdecimal-rs)rust_decimalrandom_colorgeosemverserde_jsontimezerocopyglamurlindexmapeitheralways-true-rng: expose AlwaysTrueRngmaybe-non-empty-collections: allow to use AlwaysTrueRng to generate non-empty collectionscargo install --features=cli --git https://github.com/cksac/fake-rs.git
Access cli using fake command. Below are the currently available fake generators.
❯ fake An easy to use library and command line for generating fake data like name, number, address, lorem, dates, etc. Usage: fake [OPTIONS] [COMMAND] Commands: CityPrefix CitySuffix CityName CountryName CountryCode StreetSuffix StreetName TimeZone StateName StateAbbr SecondaryAddressType SecondaryAddress ZipCode PostCode BuildingNumber Latitude Longitude Geohash Isbn Isbn10 Isbn13 CreditCardNumber CompanySuffix CompanyName Buzzword BuzzwordMiddle BuzzwordTail CatchPhrase BsVerb BsAdj BsNoun Bs Profession Industry FreeEmailProvider DomainSuffix FreeEmail SafeEmail Username Password IPv4 IPv6 IP MACAddress UserAgent Seniority Field Position Word Words Sentence Sentences Paragraph Paragraphs ItalicWord BoldWord Link BulletPoints ListItems BlockQuoteSingleLine BlockQuoteMultiLine Code FirstName LastName Title Suffix Name NameWithTitle PhoneNumber CellNumber FilePath FileName FileExtension DirPath MimeType Semver SemverStable SemverUnstable CurrencyCode CurrencyName CurrencySymbol Bic Isin HexColor RgbColor RgbaColor HslColor HslaColor Color Time Date DateTime RfcStatusCode ValidStatusCode help Print this message or the help of the given subcommand(s) Options: -r, --repeat <repeat> [default: 1] -l, --locale <locale> [default: EN] -h, --help Print help -V, --version Print version
use fake::{Dummy, Fake, Faker};
use fake::rand::rngs::StdRng;
use fake::rand::SeedableRng;
#[derive(Debug, Dummy)]
pub struct Foo {
#[dummy(faker = "1000..2000")]
order_id: usize,
customer: String,
paid: bool,
}
#[derive(Debug, Dummy)]
struct Bar<T> {
field: Vec<T>,
}
fn main() {
// type derived Dummy
let f: Foo = Faker.fake();
println!("{:?}", f);
let b: Bar<Foo> = Faker.fake();
println!("{:?}", b);
// using `Faker` to generate default fake value of given type
let tuple = Faker.fake::<(u8, u32, f32)>();
println!("tuple {:?}", tuple);
println!("String {:?}", Faker.fake::<String>());
// types U can used to generate fake value T, if `T: Dummy<U>`
println!("String {:?}", (8..20).fake::<String>());
println!("u32 {:?}", (8..20).fake::<u32>());
// using `faker` module with locales
use fake::faker::name::raw::*;
use fake::locales::*;
let name: String = Name(EN).fake();
println!("name {:?}", name);
let name: String = Name(ZH_TW).fake();
println!("name {:?}", name);
// using convenient function without providing locale
use fake::faker::lorem::en::*;
let words: Vec<String> = Words(3..5).fake();
println!("words {:?}", words);
// using macro to generate nested collection
let name_vec = fake::vec![String as Name(EN); 4, 3..5, 2];
println!("random nested vec {:?}", name_vec);
// fixed seed rng
let seed = [
1, 0, 0, 0, 23, 0, 0, 0, 200, 1, 0, 0, 210, 30, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0,
];
let ref mut r = StdRng::from_seed(seed);
for _ in 0..5 {
let v: usize = Faker.fake_with_rng(r);
println!("value from fixed seed {}", v);
}
}
Generate random name (defaults to EN locale)
❯ ./fake Name Generating 1 fakes for EN locale Theresa Walker
Generate 5 chinese random names by mentioning locale to zh_cn
❯ ./fake -r5 -lzh_cn Name Generating 5 fakes for ZH_CN locale 何丹华 尹雅瑾 于金福 郭雨珍 龙菲霞
Generate 5 random passwords with minimum 10 characters
❯ ./fake -r5 Password --min 10 Generating 5 fakes for EN locale Q6eeXHfC3uzSRqtZwB 6fDHAOh3I7Ah77duLL R8ygoTLmd4i1z1Z 5Uxj3RdEK5O4Af3ow 2XWsGT0lUaDnMZTb7
Arguments can be sent to fake generators like password that accept different ranges
❯ ./fake Password --help
Usage: fake Password [OPTIONS]
Options:
--max <max> [default: 20]
--min <min> [default: 10]
-h, --help Print help
Word(); Words(count: Range<usize>); Sentence(count: Range<usize>); Sentences(count: Range<usize>); Paragraph(count: Range<usize>); Paragraphs(count: Range<usize>);
FirstName(); LastName(); Title(); Suffix(); Name(); NameWithTitle();
Digit(); // Format is a &str such that: // - `^` will be subsituted by a random number 1-9. // - `#` will be subsituted by a random number 0-9. // - Any other character will be left as-is. NumberWithFormat<'a>(fmt: &'a str);
FreeEmailProvider(); DomainSuffix(); FreeEmail(); SafeEmail(); Username(); Password(len_range: Range<usize>); IPv4(); IPv6(); IP(); MACAddress(); UserAgent();
RfcStatusCode(); ValidStatusCode();
HexColor(); RgbColor(); RgbaColor(); HslColor(); HslaColor(); Color();
CompanySuffix(); CompanyName(); Buzzword(); BuzzwordMiddle(); BuzzwordTail(); CatchPhrase(); BsVerb(); BsAdj(); BsNoun(); Bs(); Profession(); Industry();
CurrencyCode(); CurrencyName(); CurrencySymbol();
CityPrefix(); CitySuffix(); CityName(); CountryName(); CountryCode(); StreetSuffix(); StreetName(); TimeZone(); StateName(); StateAbbr(); SecondaryAddressType(); SecondaryAddress(); ZipCode(); PostCode(); BuildingNumber(); Latitude(); Longitude(); Geohash(precision: u8);
Isbn(); Isbn13(); Isbn10();
PhoneNumber(); CellNumber();
Time(); Date(); DateTime(); Duration(); DateTimeBefore(dt: DateTime<Utc>); DateTimeAfter(dt: DateTime<Utc>); DateTimeBetween(start: DateTime<Utc>, end: DateTime<Utc>);
FilePath(); FileName(); FileExtension(); DirPath();
FerroidULID(); FerroidTwitterId(); FerroidInstagramId(); FerroidMastodonId(); FerroidDiscordId();
UUIDv1(); UUIDv3(); UUIDv4(); UUIDv5();
Decimal(); PositiveDecimal(); NegativeDecimal(); NoDecimalPoints();
BigDecimal(); PositiveBigDecimal(); NegativeBigDecimal(); NoBigDecimalPoints();
ItalicWord(); BoldWord(); Link(); BulletPoints(); ListItems(); BlockQuoteSingleLine(); BlockQuoteMultiLine(); Code();
use fake::faker::phone_number::en::{CellNumber, PhoneNumber};
use fake::{utils::{either, WrappedVal}, Dummy, Fake, Faker};
#[derive(Debug, Dummy)]
struct Foo {
#[dummy(faker = "either(PhoneNumber(), CellNumber())", wrapper = "WrappedVal")]
phone_number: String,
}
This project is licensed under either of
at your option.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4