Brings the popular ruby faker gem to Java
Java
Latest commit bff9eee Mar 27, 2017 @andreldm andreldm committed with codingricky Add birthday generator (#209)

README.md

Java Faker

Maven Status Build Status Coverage Status Dependency Status License

This library is a port of Ruby's stympy/faker gem (as well as Perl's Data::Faker library) that generates fake data. It's useful when you're developing a new project and need some pretty data for showcase.

Usage

In pom.xml, add the following xml stanza between <dependencies> ... </dependencies>

<dependency>
    <groupId>com.github.javafaker</groupId>
    <artifactId>javafaker</artifactId>
    <version>0.13</version>
</dependency>

For gradle users, add the following to your build.gradle file.

repositories {
    mavenCentral()
}

dependencies {
    testCompile group: 'com.github.javafaker', name: 'javafaker', version: '0.13'
}

In your Java code

Faker faker = new Faker();

String name = faker.name().fullName(); // Miss Samanta Schmidt
String firstName = faker.name().firstName(); // Emory
String lastName = faker.name().lastName(); // Barton

String streetAddress = faker.address().streetAddress(); // 60018 Sawayn Brooks Suite 449

Javadoc

http://dius.github.io/java-faker/apidocs/index.html

Fakers

  • Ancient
  • Address
  • App
  • Artist
  • Beer
  • Book
  • Bool
  • Business
  • ChuckNorris
  • Cat
  • Code
  • Color
  • Commerce
  • Company
  • Crypto
  • DateAndTime
  • Demographic
  • Educator
  • File
  • Finance
  • Food
  • GameOfThrones
  • Hacker
  • IdNumber
  • Internet
  • Lorem
  • Music
  • Name
  • Number
  • Options
  • PhoneNumber
  • Pokemon
  • Shakespeare
  • SlackEmoji
  • Space
  • Stock
  • Superhero
  • Team
  • University

Usage with Locales

Faker faker = new Faker(new Locale("{YOUR_LOCALE}"));

Supported Locales

  • 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

  • Port more classes over as there are more entries in the yml file that we don't have classes for

LICENSE

Copyright (c) 2014 DiUS Computing Pty Ltd. See the LICENSE file for license rights and limitations.