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
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 = Name.name val user = User(name, Internet.user_name(name), Internet.free_email(name)) // User(Kimi Hauke,kimihauke,firstname.lastname@example.org)
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
import faker._ // changing Language to german Faker.locale("de")
Adding scala-faker as dependency to your project is really simple. Just add
resolvers += "justwrote" at "http://repo.justwrote.it/releases/" libraryDependencies += "it.justwrote" %% "scala-faker" % "0.1"
<repository> <id>justwrote</id> <url>http://repo.justwrote.it/releases/</url> </repository> ... <dependency> <groupId>it.justwrote</groupId> <artifactId>scala-faker_2.9.1</artifactId> <version>0.1</version> </dependency>
2.9.1 is you Scala version.
This library uses the locales data from the ruby faker library.
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.