Scroll to navigation

FAKER(1) User Commands FAKER(1)


faker - command to generate fake data


usage: faker [-h] [--version] [-o output] [-l LOCALE] [-r REPEAT] [-s SEP]
[-i [INCLUDE [INCLUDE ...]]] [fake] [fake argument [fake argument ...]]

faker version 0.7.7

positional arguments:

name of the fake to generate output for (e.g. profile)
fake argument
optional arguments to pass to the fake (e.g. the profile fake takes an optional list of comma separated field names as the first argument)

optional arguments:

-h, --help
show this help message and exit
show program's version number and exit
-o output
redirect output to a file
-l LOCALE, --lang LOCALE
specify the language for a localized provider (e.g. de_DE)
-r REPEAT, --repeat REPEAT
generate the specified number of outputs
-s SEP, --sep SEP
use the specified separator after each output
-i [INCLUDE [INCLUDE ...]], --include [INCLUDE [INCLUDE ...]]
list of additional custom providers to user, given as the import path of the module containing your Provider class (not the provider class itself)

supported locales:

bg_BG, bs_BA, cs_CZ, de_AT, de_DE, dk_DK, el_GR, en, en_AU, en_CA, en_GB, en_US, es, es_ES, es_MX, fa_IR, fi_FI, fr_CH, fr_FR, hi_IN, hr_HR, it_IT, ja_JP, ko_KR, la, lt_LT, lv_LV, ne_NP, nl_BE, nl_NL, no_NO, pl_PL, pt_BR, pt_PT, ru_RU, sk_SK, sl_SI, sv_SE, tr_TR, uk_UA, zh_CN, zh_TW
faker can take a locale as an argument, to return localized data. If no localized provider is found, the factory falls back to the default en_US locale.


$ faker address
968 Bahringer Garden Apt. 722 Kristinaland, NJ 09890
$ faker -l de_DE address
Samira-Niemeier-Allee 56 94812 Biedenkopf
$ faker profile ssn,birthdate
{'ssn': u'628-10-1085', 'birthdate': '2008-03-29'}
$ faker -r=3 -s=";" name
Willam Kertzmann; Josiah Maggio; Gayla Schmitt;
June 2018 faker 0.7.7