Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A library for generating fake data written in scala.
Branch: master
Pull request Compare This branch is 24 commits behind justwrote:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



scala-faker is a library written in Scala which generates fake data such as names, addresses, and phone numbers. It is a Scala port of the famous Ruby library faker. It actually uses the same data for generating.

Notice: This README contains information which might only be valid for the latest snapshot version. See tags to find the README targeting your version.

This release of scala-faker is build against Scala 2.8.0, 2.8.1, 2.8.2, 2.9.0, 2.9.0-1 and 2.9.1.

scala-faker only depends on snakeyaml for reading the original faker yaml files. The tests are written with scalatest.


This section will give you a short introduction on how to get started with scala-faker.


So how do I use it? Let's see ...

import faker._ // That's all you need!

case class User(name: String, username: String, email: String)

val name =
val user = User(name, Internet.user_name(name), Internet.free_email(name))
// User(Kimi Hauke,kimihauke,

Pretty easy, right?


By default scala-faker tries you systems locale for generating fake data. If there isn't any localization for it (right now there are files for: de-ch, de, en-gb, en-us, en, nl) it will fall back to en. The locale can be changed any time with Faker.locale(newLocale).

import faker._

// changing Language to german

Add dependency

Adding scala-faker as dependency to your project is really simple. Just add


resolvers += "justwrote" at ""

libraryDependencies += "it.justwrote" %% "scala-faker" % "0.1"



where 2.9.1 is you Scala version.


This library uses the locales data from the ruby faker library.

Contribution policy

Contributions via GitHub pull requests are gladly accepted from their original author. Along with any pull requests, please state that the contribution is your original work and that you license the work to the project under the project's open source license. Whether or not you state this explicitly, by submitting any copyrighted material via pull request, email, or other means you agree to license the material under the project's open source license and warrant that you have the legal authority to do so.


scala-faker is licensed under the Apache 2.0 License.

Something went wrong with that request. Please try again.