faker travis-ci

Faker is a pure Elixir library for generating fake data.

Faker VersionLicenseBuild StatusIssuesDownloadsDonation

Faker is a pure Elixir library for generating fake data.


  • add {:faker, "~> 0.7"} to your deps in mix.exs;
  • add :faker to list of your applications;
  • jump to usage examples.

Example mix.exs:

  def application do
    [applications: [:logger, :faker]]
  defp deps do
    [{:faker, "~> 0.7"}]


In your mix.exs file, add the :faker project to your dependencies (optionally include the version):

  defp deps do
    [{:faker, "~> 0.5", only: :test}]

Do a mix deps.get to fetch the dependency. That's it.

If you want to use faker outside tests remove , only: :test part.


  • OTP18+
  • Elixir 1.1+


You need to start :faker application, but due to the many usages of fake data, (seed database, tests, etc) there's no right place to do it. For example, if you want to use it in tests, just add Faker.start to test/test_helper.exs, then, use any function described in the documentation or in usage examples.


  • If you get a message like the one below when you call Faker.Address.city, you need to add :faker to your application's mix file, in the applications function, as above.
** (FunctionClauseError) no function clause matching in Faker.Address.city_count/1
    lib/faker/address.ex:48: Faker.Address.city_count(nil)
    lib/faker/address.ex:41: Faker.Address.city/0


Faker was designed as a lightweight library, that's why it can be easily used with other tools.


You can build templates for testing purposes with the Blacksmith project. See the Blacksmith readme for details.


Sponsored by Evil Martians


Released under the MIT License.

Top Contributors

igas saulecabrera whatyouhide GesJeremie johnhamelink lowks orieken rodrigues vforvova bryanjos belaustegui efexen jarednorman piton4eg petehamilton ReadmeCritic rbeene devshane tbash trestrantham zmoshansky batate


-   v0.7.0 zip tar
-   v0.6.0 zip tar
-   v0.5.1 zip tar
-   v0.5.0 zip tar
-   v0.4.1 zip tar
-   v0.4.0 zip tar
-   v0.3.2 zip tar
-   v0.3.1 zip tar
-   v0.3.0 zip tar
-   v0.2.0 zip tar
-   v0.1.0 zip tar
-   0.6.0 zip tar