Faker is a pure Elixir library for generating fake data.
Elixir
Clone or download
Pull request Compare This branch is 100 commits behind igas:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
lib
test
.credo.exs
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
USAGE.md
mix.exs
mix.lock

README.md

Faker VersionLicenseBuild StatusIssuesDownloadsDonation

Faker is a pure Elixir library for generating fake data.

Quickstart

  • add {:faker, "~> 0.8"} 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]]
  end
...
  defp deps do
    [{:faker, "~> 0.8"}]
  end
...

Install

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

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

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

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

Requirements

  • OTP18+
  • Elixir 1.1+

Usage

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.

Troubleshooting

  • 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

Tools

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

Templating

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

Thanks

Sponsored by Evil Martians

License

Released under the MIT License.