*Faker* is a Python package that generates fake data for you. Whether you need to bootstrap your database,create good-looking XML documents, fill-in your persistence to stress test it, or anonymize data taken from a production service,Faker is for you.

Faker is heavily inspired by PHP's [Faker][php-faker], Perl's [Data::Faker][perl-faker], and by ruby's [Faker][ruby-faker].

Each of the generator properties (like `name`, `address`, and `lorem`) are called "formatters".A faker generator has many of them, packaged in "providers". Here is a list of the bundled formatters in the default locale.

You can check available Faker locales in the source code, under the providers package.The localization of Faker is an ongoing process, for which we need your help.Don't hesitate to create localized providers to your own locale and submit a PR!

# then add new provider to faker instance fake.add_provider(MyProvider)

# now you can use: fake.foo() > 'bar'

# Seeding the Generator

You may want to get always the same generated data - for instance when using Faker for unit testing purposes.The generator offers a `seed()` method, which seeds the random number generator.Calling the same script twice with the same seed produces the same results.

from faker import Faker fake = Faker() fake.seed(4321)

print fake.name() # Margaret Boehm

# Tests

Run tests:

$ python setup.py test

or

$ python -m unittest -v faker.tests

Write documentation for providers:

$ python -m faker > docs.txt

## License

Faker is released under the MIT Licence. See the bundled LICENSE file for details.