GitHunt
DV

dvbeato/java-faker

Brings the popular ruby faker gem to Java

Java Faker

Maven Status

Build Status

Coverage Status

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 following between <dependencies> ... </dependencies>

<dependency>
    <groupId>com.github.javafaker</groupId>
    <artifactId>javafaker</artifactId>
    <version>0.8</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.8'
}

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

  • Address
  • Book
  • Business
  • Code
  • Color
  • Company
  • CreditCardType
  • DateAndTime
  • Faker
  • Finance
  • Internet
  • Lorem
  • Name
  • Number
  • Options
  • PhoneNumber

Usage with Locales

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

Supported Locales

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

How to build

  1. Make sure Apache Maven 3 is installed. ($ mvn --version)
  2. $ mvn package

TODO

  1. Add regexify method so we can just use the en.yml from faker as is
  2. 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.

Languages

Java100.0%
Other
Created April 20, 2016
Updated April 20, 2016