NAME
Faker - Extensible Fake Data Generator
VERSION
version 0.09
DESCRIPTION
Faker is a Perl library that generates fake data for you. The design is
heavily inspired by the PHP implementation which was heavily based on
Perl's Data::Faker. So I guess you could say that this library is a
rewrite of Data::Faker having observed how other languages have
implemented it, e.g. the Python and Ruby implementations.
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 makes it easy to generate fake
data with some semantics.
SYNPOSIS
use Faker;
my $fake = maker Faker;
$fake->name;
# Lucy Cechtelar
$fake->address;
# 426 Jordy Lodge
# Cartwrightshire, SC 88120-6700
$fake->paragraph;
# Rerum atque repellat voluptatem quia rerum. Numquam excepturi beatae sint
# laudantium consequatur. Magni occaecati itaque sint et sit tempore. Nescit
# amet quidem. Iusto deleniti cum autem ad quia aperiam.
for (0..10) {
say $fake->name;
}
# Adaline Reichel
# Dr. Santa Prosacco DVM
# Noemy Vandervort V
# Lexi O'Conner
# Gracie Weber
# Roscoe Johns
# Emmett Lebsack
# Keegan Thiel
# Wellington Koelpin II
# Ms. Karley Kiehn V
FORMATTERS
Use Faker::Factory to create and initialize a faker generator, which can
generate data by executing methods named after the type of data you
want.
use Faker::Factory;
my $fake = Faker::Factory->new(locale => 'en_US')->create;
$fake->ip_address_v4;
# 136.98.126.140
Even in this example the method call is actually being proxied to a
provider class which returns a random result with each call. Each of the
generator properties (like name, address, and paragraph) 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.
Faker::Provider::en_US::Address
city_prefix East
secondary_address Suite 666
state_name Utah
state_abbr SD
city_suffix bury
street_suffix Avenue
building_number 32
city Lake Christopville
street_name Norene Circle
street_address 28 Maritza Avenue Apt. 436
postal_code 84049
address 2556 Wuckert Street, Dale, PR 48375-4904
country_name Russian Federation
latitude -51.511412
longitude -72.341657
Faker::Provider::en_US::Color
color_name DeepPink
hex_color #bbab85
rgbcolors 50,251,69
rgbcolors_css rgb(220,14,160)
safe_color_name blue
safe_hex_color #ff00b6
Faker::Provider::en_US::Company
buzzword_type1 implement
buzzword_type2 viral
buzzword_type3 supply-chains
catch_phase paradigms user-centric evolve
company Lockman, Feeney and Collier
company_suffix Inc.
jargon_buzz_word synergy
jargon_edge_word Enterprise-wide
Faker::Provider::en_US::DateTime
century XIX
date 1992-10-04T23:10:36
date_now 2014-01-27T11:04:26
date_this_century 1998-06-05T11:04:26
date_this_decade 2012-08-12T11:04:26
date_this_year 2013-08-26T11:04:26
time_unix 1346319297
timezone Europe/Moscow
Faker::Provider::en_US::File
mime_type xar
file_extension video/x-m4v
Faker::Provider::en_US::Internet
company_email_address Abshire.Nya@dooley.org
domain_name aufderhar-mcdermott.info
domain_word lindgren-lynch
email_address Emely52@schuppe-crist.biz
email_domain gmail.com
ip_address 178.127.173.141
ip_address_v4 73.244.92.148
ip_address_v6 0482:6a30:7453:3940:967f:5448:65e8:23ef
safe_email_domain example.org
safe_email_address oLuettgen@ruecker.net
top_level_domain net
url http://stoltenberg-volkman.net/
username Melisa.Lynch
Faker::Provider::en_US::Lorem
paragraph quas libero esse eaque. aut qui ...
paragraphs ad laboriosam magnam. architecto ...
sentence nisi animi est harum sit.
sentences sit sapiente non ipsam. praesentium ...
word fewq
words esrar laborum aliquid atque sunt
Faker::Provider::en_US::Miscellaneous
boolean 1
country_code PT
language_code it
locale aa_DJ
md5 39dc0ea879e740d0268bc6a005d7cc19
sha1 f5e9fd4b31b9693c475db245ed2e1cc382a...
sha256 2a9cac8e68aa2355cef421609e3db51a946...
Faker::Provider::en_US::Person
prefix 'Ms.'
suffix 'Jr.'
name 'Dr. Zane Stroman'
first_name 'Maynard'
last_name 'Zulauf'
Faker::Provider::en_US::PhoneNumber
phone_number 1-199-961-5441x982
Faker::Provider::en_US::UserAgent
chrome_user_agent Mozilla/5.0 (Windows; U; Windows NT ...
firefox_user_agent Mozilla/5.0 (X11; U; Linux x86_64; ...
internet_explorer_user_agent Mozilla/4.0 (compatible; MSIE 5.01; ...
opera_user_agent Opera/6.01 (Windows 2000; U) [de] ...
safari_user_agent Mozilla/5.0 (Macintosh; U; PPC Mac ...
ACKNOWLEDGEMENTS
Some parts of this library were adopted from the following
implementations.
* PHP Faker <https://github.com/fzaninotto/Faker>
* Python Faker <https://github.com/joke2k/faker>
* Ruby Faker <https://github.com/stympy/faker>
AUTHOR
Al Newkirk <anewkirk@ana.io>
COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Al Newkirk.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.