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.markmooibroek:faker-1:1.3.0'
}

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"

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

Available components

Address
App
Avatar
Book
Bool
Business
Color
Commerce
Company
Date
Food
Internet
Lorem
Name
Number
PhoneNumber
Placeholdit
SlackEmoji
Team
Time
University

Warnings

Currently we don't support locale specific operations like Address.postcode_by_state or Business.swedish_organisation_number.

TODO

Implement remaining components:
- Beer
- Bitcoin
- Cat
- ChuckNorris
- Code
- Crypto
- Educator
- Finance
- GameOfThrones
- Hacker
- Hipster
- IDNumber
- Pokemon
- Shakespeare
- Space
- Superhero
- StarWars
- Vehicle

Proguard

To use Faker with proguard, here are the rules you need to add:

# SnakeYAML
-keep class org.yaml.snakeyaml.** { public protected private *; }
-keep class org.yaml.snakeyaml.** { public protected private *; }
-dontwarn org.yaml.snakeyaml.**

# Joda Time
-dontwarn org.joda.convert.**
-dontwarn org.joda.time.**
-keep class org.joda.time.** { *; }
-keep interface org.joda.time.** { *; }

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.

markmooibroek/faker-1