Faker

Generates fake data for testing or populating a development database. Run your tests with realistic data like names, emails, dates, countries...

A Java port of the Faker ruby gem. The goal was to reuse their locale data files.

Installing

repositories {
    // ...
    maven { url 'https://jitpack.io' }
}

dependencies {
    compile 'com.github.ghacupha:faker:1.2.5'
}

You can use testCompile or androidTestCompile, if you only want to use Faker for testing.

Usage

Faker faker = new Faker();
faker.name().firstName();    // Returns "Aaron"
faker.company().name();      // Returns "Hirthe-Ritchie"

Faker faker = new Faker("nl");
faker.name().firstName();    // Returns "Thijs"

Faker faker = new Faker();
faker.pickRandom().fromVarArgs("Mon","Tue","Wed","Thur"); // Return "Tue"

enum CurrencyEnum{ KES,USD,GBP,EUR }
Faker faker = new Faker();
faker.pickRandom().from(CurrencyEnum.class); // Return "GBP"

String[] workWeek =
            new String[]{"Monday", "Tuesday", "Wednesday", "Friday"};
List<String> workWeek = Arrays.asList(workWeek)
Faker faker = new Faker();
faker.pickRandom().fromCollection(workWeek); // Return "Tue"

For full list of available options, check the original source. We have tried to keep the operations as close as possible.

Available components

Ancient
Address
App
Artist
Beer
Book
Bool
Business
ChuckNorris
Cat
Code
Color
Commerce
Company
Crypto
DateAndTime
Demographic
Educator
Esports
File
Finance
Food
Friends
GameOfThrones
Hacker
HarryPotter
Hipster
IdNumber
Internet
Job
LordOfTheRings
Lorem
Matz
Music
Name
Number
Options
PhoneNumber
Pokemon
RickAndMorty
RockBand
Shakespeare
SlackEmoji
Space
Stock
Superhero
Team
TwinPeaks
University
Witcher
Yoda
Zelda
PickRandom

Supported Locales

bg
ca
ca-CAT
da-DK
de
de-AT
de-CH
en
en-AU
en-au-ocker
en-BORK
en-CA
en-GB
en-IND
en-NEP
en-NG
en-NZ
en-PAK
en-SG
en-UG
en-US
en-ZA
es
es-MX
fa
fi-FI
fr
he
in-ID
it
ja
ko
nb-NO
nl
pl
pt
pt-BR
ru
sk
sv
sv-SE
tr
uk
vi
zh-CN
zh-TW

TODO

Implement remaining components:
- Bitcoin
- Placeholdit
- StarWars
- Vehicle
- Read test data from configuration file
- Person (comprehensive personal attributes)

Contact

Feedback and contributions are welcome. Feel free to send an email or submit a pull request.

License

This code is free to use under the terms of the MIT license.

ghacupha/java-faker