Faker (Fork)

Copy Markdown View Source

TLDR

This is a fork of the project Faker which is intended to fix showstopper issues (e.g. hard deprecations in newer versions of Elixir) until the maintainers of the main project can bring the project up to speed on their own, or are willing to add new maintainers to the main project.

Switching to this project should be nearly effortless:

  • Rename the dependency in mix.exs from :faker to :faker_fork
    • The minimum supported version is 0.19.0, but ~> 0.19.1 is recommended.
  • Run mix deps.get
  • That's it!

Please visit this fork's GitHub Issues page if you have any issues.

If any maintainers are reading this: Let's get in touch! :)

build Version Hex Docs License Issues Downloads Gitter Last Updated

Faker is a pure Elixir library for generating fake data.

Quickstart

  • add {:faker_fork, "~> 0.19.1"} to your deps in mix.exs:

      defp deps do
    [
      {:faker_fork, "~> 0.19.1", only: :test}
    ]
  end

  • run:

      mix deps.get

  • add Faker.start() to test/test_helper.exs:

      ExUnit.start()
  Faker.start()

  • jump to usage examples.

Requirements

  • OTP 19+
  • Elixir 1.6+

Usage

See documentation and usage examples.

Troubleshooting

  • If you get a message like the one below when you call Faker.Address.city/0, you need to add :faker_fork 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.

Team

Faker was originally written by Igor Kapkov.

Current list of maintainers:

Contributing

Do you want to become a maintainer?

See our CONTRIBUTING.md and start contributing today. We usually elect new maintainers based on contributions.

Thanks

Sponsored by Evil Martians

License

Released under the MIT License.