The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

NAME

Faker - Fake Data Generator

ABSTRACT

Extensible Fake Data Generator

VERSION

1.19

SYNOPSIS

package main;
use Faker;
my $faker = Faker->new('en-us');
# my $first_name = $faker->person_name;
# "Russel Krajcik"
# my $last_name = $faker->person_name;
# "Alayna Josephine Kunde"

DESCRIPTION

This distribution provides a library of fake data generators and a framework for extending the library via plugins.

ATTRIBUTES

This package has the following attributes:

caches

caches(HashRef $data) (Object)

The caches attribute holds the cached values returned from "cache".

Since 1.10

caches example 1
# given: synopsis
package main;
my $caches = $faker->caches;
# bless({value => {}}, 'Venus::Hash')
caches example 2
# given: synopsis
package main;
my $caches = $faker->caches({});
# bless({value => {}}, 'Venus::Hash')

locales

locales(ArrayRef $data) (Object)

The locales attribute holds the locales used to find and generate localized data.

Since 1.10

locales example 1
# given: synopsis
package main;
my $locales = $faker->locales;
# bless({value => []}, 'Venus::Array')
locales example 2
# given: synopsis
package main;
my $locales = $faker->locales([]);
# bless({value => []}, 'Venus::Array')

INTEGRATES

This package integrates behaviors from:

Venus::Role::Buildable

Venus::Role::Proxyable

Venus::Role::Optional

METHODS

This package provides the following methods:

address_city_name

address_city_name(HashRef $data) (Str)

The address_city_name method returns a random address city name.

Since 1.10

address_city_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_city_name = $faker->address_city_name;
# "West Jamison"
# $address_city_name = $faker->address_city_name;
# "Mayertown"
# $address_city_name = $faker->address_city_name;
# "Juliaborough"

address_city_prefix

address_city_prefix(HashRef $data) (Str)

The address_city_prefix method returns a random address city prefix.

Since 1.10

address_city_prefix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_city_prefix = $faker->address_city_prefix;
# "West"
# $address_city_prefix = $faker->address_city_prefix;
# "West"
# $address_city_prefix = $faker->address_city_prefix;
# "Lake"

address_city_suffix

address_city_suffix(HashRef $data) (Str)

ok $address_city_suffix method returns a random address city suffix.

Since 1.10

address_city_suffix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_city_suffix = $faker->address_city_suffix;
# "borough"
# $address_city_suffix = $faker->address_city_suffix;
# "view"
# $address_city_suffix = $faker->address_city_suffix;
# "haven"

address_country_name

address_country_name(HashRef $data) (Str)

The address_country_name method returns a random address country name.

Since 1.10

address_country_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_country_name = $faker->address_country_name;
# "Greenland"
# $address_country_name = $faker->address_country_name;
# "Ireland"
# $address_country_name = $faker->address_country_name;
# "Svalbard & Jan Mayen Islands"

address_latitude

address_latitude(HashRef $data) (Str)

The address_latitude method returns a random address latitude.

Since 1.10

address_latitude example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_latitude = $faker->address_latitude;
# 30.843133
# $address_latitude = $faker->address_latitude;
# 77.079663
# $address_latitude = $faker->address_latitude;
# -41.660985

address_line1

address_line1(HashRef $data) (Str)

The address_line1 method returns a random address line1.

Since 1.10

address_line1 example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_line1 = $faker->address_line1;
# "44084 Mayer Brook"
# $address_line1 = $faker->address_line1;
# "4 Amalia Terrace"
# $address_line1 = $faker->address_line1;
# "20370 Emard Street"

address_line2

address_line2(HashRef $data) (Str)

The address_line2 method returns a random address line2.

Since 1.10

address_line2 example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_line2 = $faker->address_line2;
# "Mailbox 1408"
# $address_line2 = $faker->address_line2;
# "Mailbox 684"
# $address_line2 = $faker->address_line2;
# "Suite 076"

address_lines

address_lines(HashRef $data) (Str)

The address_lines method returns a random address lines.

Since 1.10

address_lines example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_lines = $faker->address_lines;
# "4 Koelpin Plaza Unit 694\nWest Viviane, IA 37022"
# $address_lines = $faker->address_lines;
# "90558 Greenholt Orchard\nApt. 250\nPfannerstillberg, New Mexico 52836"
# $address_lines = $faker->address_lines;
# "68768 Weissnat Point\nRitchieburgh, New Mexico 53892"

address_longitude

address_longitude(HashRef $data) (Str)

The address_longitude method returns a random address longitude.

Since 1.10

address_longitude example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_longitude = $faker->address_longitude;
# 30.843133
# $address_longitude = $faker->address_longitude;
# 77.079663
# $address_longitude = $faker->address_longitude;
# -41.660985

address_number

address_number(HashRef $data) (Str)

The address_number method returns a random address number.

Since 1.10

address_number example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_number = $faker->address_number;
# 8140
# $address_number = $faker->address_number;
# 5684
# $address_number = $faker->address_number;
# 57694

address_postal_code

address_postal_code(HashRef $data) (Str)

The address_postal_code method returns a random address postal code.

Since 1.10

address_postal_code example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_postal_code = $faker->address_postal_code;
# 14084
# $address_postal_code = $faker->address_postal_code;
# "84550-7694"
# $address_postal_code = $faker->address_postal_code;
# 43908

address_region_name

address_region_name(HashRef $data) (Str)

The address_region_name method returns a random address region name.

Since 1.10

address_region_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_region_name = $faker->address_region_name;
# "Massachusetts"
# $address_region_name = $faker->address_region_name;
# "MO"
# $address_region_name = $faker->address_region_name;
# "NE"

address_state_abbr

address_state_abbr(HashRef $data) (Str)

The address_state_abbr method returns a random address state abbr.

Since 1.10

address_state_abbr example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_state_abbr = $faker->address_state_abbr;
# "KY"
# $address_state_abbr = $faker->address_state_abbr;
# "ME"
# $address_state_abbr = $faker->address_state_abbr;
# "TX"

address_state_name

address_state_name(HashRef $data) (Str)

The address_state_name method returns a random address state name.

Since 1.10

address_state_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_state_name = $faker->address_state_name;
# "Kentucky"
# $address_state_name = $faker->address_state_name;
# "Massachusetts"
# $address_state_name = $faker->address_state_name;
# "Texas"

address_street_address

address_street_address(HashRef $data) (Str)

The address_street_address method returns a random address street address.

Since 1.10

address_street_address example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_street_address = $faker->address_street_address;
# "4084 Mayer Brook Suite 94"
# $address_street_address = $faker->address_street_address;
# "9908 Mustafa Harbor Suite 828"
# $address_street_address = $faker->address_street_address;
# "958 Greenholt Orchard"

address_street_name

address_street_name(HashRef $data) (Str)

The address_street_name method returns a random address street name.

Since 1.10

address_street_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_street_name = $faker->address_street_name;
# "Russel Parkway"
# $address_street_name = $faker->address_street_name;
# "Mayer Brook"
# $address_street_name = $faker->address_street_name;
# "Kuhic Path"

address_street_suffix

address_street_suffix(HashRef $data) (Str)

The address_street_suffix method returns a random address street suffix.

Since 1.10

address_street_suffix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $address_street_suffix = $faker->address_street_suffix;
# "Key"
# $address_street_suffix = $faker->address_street_suffix;
# "Mission"
# $address_street_suffix = $faker->address_street_suffix;
# "Street"

cache

cache(Str $method, Any @args) (Str)

The cache method dispatches to the method specified, caches the method name and return value, and returns the value. Subsequent calls will return the cached value.

Since 1.10

cache example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $cache = $faker->cache('person_name');
# "Keeley Balistreri"
# $cache = $faker->cache('person_name');
# "Keeley Balistreri"
cache example 2
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $cache = $faker->cache('company_tagline');
# "iterate back-end content"
# $cache = $faker->cache('company_tagline');
# "iterate back-end content"

color_hex_code

color_hex_code(HashRef $data) (Str)

The color_hex_code method returns a random color hex code.

Since 1.10

color_hex_code example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $color_hex_code = $faker->color_hex_code;
# "#57bb49"
# $color_hex_code = $faker->color_hex_code;
# "#6c1e68"
# $color_hex_code = $faker->color_hex_code;
# "#db3fb2"

color_name

color_name(HashRef $data) (Str)

The color_name method returns a random color name.

Since 1.10

color_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $color_name = $faker->color_name;
# "GhostWhite"
# $color_name = $faker->color_name;
# "Khaki"
# $color_name = $faker->color_name;
# "SeaGreen"

color_rgb_colorset

color_rgb_colorset(HashRef $data) (Str)

The color_rgb_colorset method returns a random color rgb colorset.

Since 1.10

color_rgb_colorset example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $color_rgb_colorset = $faker->color_rgb_colorset;
# [28, 112, 22]
# $color_rgb_colorset = $faker->color_rgb_colorset;
# [219, 63, 178]
# $color_rgb_colorset = $faker->color_rgb_colorset;
# [176, 217, 21]

color_rgb_colorset_css

color_rgb_colorset_css(HashRef $data) (Str)

The color_rgb_colorset_css method returns a random color rgb colorset css.

Since 1.10

color_rgb_colorset_css example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $color_rgb_colorset_css = $faker->color_rgb_colorset_css;
# "rgb(108, 30, 104)"
# $color_rgb_colorset_css = $faker->color_rgb_colorset_css;
# "rgb(122, 147, 147)"
# $color_rgb_colorset_css = $faker->color_rgb_colorset_css;
# "rgb(147, 224, 22)"

color_safe_hex_code

color_safe_hex_code(HashRef $data) (Str)

The color_safe_hex_code method returns a random color safe hex code.

Since 1.10

color_safe_hex_code example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $color_safe_hex_code = $faker->color_safe_hex_code;
# "#ff0057"
# $color_safe_hex_code = $faker->color_safe_hex_code;
# "#ff006c"
# $color_safe_hex_code = $faker->color_safe_hex_code;
# "#ff00db"

color_safe_name

color_safe_name(HashRef $data) (Str)

The color_safe_name method returns a random color safe name.

Since 1.10

color_safe_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $color_safe_name = $faker->color_safe_name;
# "purple"
# $color_safe_name = $faker->color_safe_name;
# "teal"
# $color_safe_name = $faker->color_safe_name;
# "fuchsia"

company_description

company_description(HashRef $data) (Str)

The company_description method returns a random company description.

Since 1.10

company_description example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $company_description = $faker->company_description;
# "Excels at full-range synchronised implementations"
# $company_description = $faker->company_description;
# "Provides logistical ameliorated methodologies"
# $company_description = $faker->company_description;
# "Offering hybrid future-proofed applications"

company_name

company_name(HashRef $data) (Str)

The company_name method returns a random company name.

Since 1.10

company_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $company_name = $faker->company_name;
# "Johnston-Steuber"
# $company_name = $faker->company_name;
# "Skiles-Mayer"
# $company_name = $faker->company_name;
# "Miller and Sons"

company_name_suffix

company_name_suffix(HashRef $data) (Str)

The company_name_suffix method returns a random company name suffix.

Since 1.10

company_name_suffix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $company_name_suffix = $faker->company_name_suffix;
# "Inc."
# $company_name_suffix = $faker->company_name_suffix;
# "Incorporated"
# $company_name_suffix = $faker->company_name_suffix;
# "Ventures"

company_tagline

company_tagline(HashRef $data) (Str)

The company_tagline method returns a random company tagline.

Since 1.10

company_tagline example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $company_tagline = $faker->company_tagline;
# "transform revolutionary supply-chains"
# $company_tagline = $faker->company_tagline;
# "generate front-end web-readiness"
# $company_tagline = $faker->company_tagline;
# "iterate back-end content"

internet_domain_name

internet_domain_name(HashRef $data) (Str)

The internet_domain_name method returns a random internet domain name.

Since 1.10

internet_domain_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_domain_name = $faker->internet_domain_name;
# "steuber-krajcik.org"
# $internet_domain_name = $faker->internet_domain_name;
# "miller-and-sons.com"
# $internet_domain_name = $faker->internet_domain_name;
# "witting-entertainment.com"

internet_domain_tld

internet_domain_tld(HashRef $data) (Str)

The internet_domain_tld method returns a random internet domain tld.

Since 1.10

internet_domain_tld example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_domain_tld = $faker->internet_domain_tld;
# "com"
# $internet_domain_tld = $faker->internet_domain_tld;
# "com"
# $internet_domain_tld = $faker->internet_domain_tld;
# "org"

internet_domain_word

internet_domain_word(HashRef $data) (Str)

The internet_domain_word method returns a random internet domain word.

Since 1.10

internet_domain_word example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_domain_word = $faker->internet_domain_word;
# "bode-and-sons"
# $internet_domain_word = $faker->internet_domain_word;
# "mayer-balistreri-and-miller"
# $internet_domain_word = $faker->internet_domain_word;
# "kerluke-waelchi"

internet_email_address

internet_email_address(HashRef $data) (Str)

The internet_email_address method returns a random internet email address.

Since 1.10

internet_email_address example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_email_address = $faker->internet_email_address;
# "russel54\@mayer-balistreri-and-miller.com"
# $internet_email_address = $faker->internet_email_address;
# "viviane82\@rempel-entertainment.com"
# $internet_email_address = $faker->internet_email_address;
# "yborer\@outlook.com"

internet_email_domain

internet_email_domain(HashRef $data) (Str)

The internet_email_domain method returns a random internet email domain.

Since 1.10

internet_email_domain example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_email_domain = $faker->internet_email_domain;
# "icloud.com"
# $internet_email_domain = $faker->internet_email_domain;
# "icloud.com"
# $internet_email_domain = $faker->internet_email_domain;
# "yahoo.com"

internet_ip_address

internet_ip_address(HashRef $data) (Str)

The internet_ip_address method returns a random internet ip address.

Since 1.10

internet_ip_address example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_ip_address = $faker->internet_ip_address;
# "108.20.219.127"
# $internet_ip_address = $faker->internet_ip_address;
# "7680:93e0:88b2:06a0:c512:99e4:e8a9:7d48"
# $internet_ip_address = $faker->internet_ip_address;
# "89.236.15.220"

internet_ip_address_v4

internet_ip_address_v4(HashRef $data) (Str)

The internet_ip_address_v4 method returns a random internet ip address v4.

Since 1.10

internet_ip_address_v4 example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_ip_address_v4 = $faker->internet_ip_address_v4;
# "87.28.108.20"
# $internet_ip_address_v4 = $faker->internet_ip_address_v4;
# "127.122.176.213"
# $internet_ip_address_v4 = $faker->internet_ip_address_v4;
# "147.136.6.197"

internet_ip_address_v6

internet_ip_address_v6(HashRef $data) (Str)

The internet_ip_address_v6 method returns a random internet ip address v6.

Since 1.10

internet_ip_address_v6 example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_ip_address_v6 = $faker->internet_ip_address_v6;
# "57bb:1c70:6c1e:14c3:db3f:7fb1:7a93:b0d9"
# $internet_ip_address_v6 = $faker->internet_ip_address_v6;
# "7680:93e0:88b2:06a0:c512:99e4:e8a9:7d48"
# $internet_ip_address_v6 = $faker->internet_ip_address_v6;
# "7f27:7009:5984:ec03:0f75:dc22:f8d4:d951"

internet_url

internet_url(HashRef $data) (Str)

The internet_url method returns a random internet url.

Since 1.10

internet_url example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $internet_url = $faker->internet_url;
# $internet_url = $faker->internet_url;
# $internet_url = $faker->internet_url;

jargon_adjective

jargon_adjective(HashRef $data) (Str)

The jargon_adjective method returns a random jargon adjective.

Since 1.10

jargon_adjective example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $jargon_adjective = $faker->jargon_adjective;
# "virtual"
# $jargon_adjective = $faker->jargon_adjective;
# "killer"
# $jargon_adjective = $faker->jargon_adjective;
# "cutting-edge"

jargon_adverb

jargon_adverb(HashRef $data) (Str)

The jargon_adverb method returns a random jargon adverb.

Since 1.10

jargon_adverb example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $jargon_adverb = $faker->jargon_adverb;
# "future-proofed"
# $jargon_adverb = $faker->jargon_adverb;
# "managed"
# $jargon_adverb = $faker->jargon_adverb;
# "synchronised"

jargon_noun

jargon_noun(HashRef $data) (Str)

The jargon_noun method returns a random jargon noun.

Since 1.10

jargon_noun example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $jargon_noun = $faker->jargon_noun;
# "action-items"
# $jargon_noun = $faker->jargon_noun;
# "technologies"
# $jargon_noun = $faker->jargon_noun;
# "applications"

jargon_term_prefix

jargon_term_prefix(HashRef $data) (Str)

The jargon_term_prefix method returns a random jargon term prefix.

Since 1.10

jargon_term_prefix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $jargon_term_prefix = $faker->jargon_term_prefix;
# "encompassing"
# $jargon_term_prefix = $faker->jargon_term_prefix;
# "full-range"
# $jargon_term_prefix = $faker->jargon_term_prefix;
# "systematic"

jargon_term_suffix

jargon_term_suffix(HashRef $data) (Str)

The jargon_term_suffix method returns a random jargon term suffix.

Since 1.10

jargon_term_suffix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $jargon_term_suffix = $faker->jargon_term_suffix;
# "flexibilities"
# $jargon_term_suffix = $faker->jargon_term_suffix;
# "graphical user interfaces"
# $jargon_term_suffix = $faker->jargon_term_suffix;
# "standardization"

jargon_verb

jargon_verb(HashRef $data) (Str)

The jargon_verb method returns a random jargon verb.

Since 1.10

jargon_verb example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $jargon_verb = $faker->jargon_verb;
# "harness"
# $jargon_verb = $faker->jargon_verb;
# "strategize"
# $jargon_verb = $faker->jargon_verb;
# "exploit"

lorem_paragraph

lorem_paragraph(HashRef $data) (Str)

The lorem_paragraph method returns a random lorem paragraph.

Since 1.10

lorem_paragraph example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $lorem_paragraph = $faker->lorem_paragraph;
# "deleniti fugiat in accusantium animi corrupti dolores. eos ..."
# $lorem_paragraph = $faker->lorem_paragraph;
# "ducimus placeat autem ut sit adipisci asperiores quae ipsum..."
# $lorem_paragraph = $faker->lorem_paragraph;
# "dignissimos est magni quia aut et hic eos architecto repudi..."

lorem_paragraphs

lorem_paragraphs(HashRef $data) (Str)

The lorem_paragraphs method returns a random lorem paragraphs.

Since 1.10

lorem_paragraphs example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $lorem_paragraphs = $faker->lorem_paragraphs;
# "eligendi laudantium provident assumenda voluptates sed iu..."
# $lorem_paragraphs = $faker->lorem_paragraphs;
# "accusantium ex pariatur perferendis voluptate iusto iure fu..."
# $lorem_paragraphs = $faker->lorem_paragraphs;
# "sit ut molestiae consequatur error tempora inventore est so..."

lorem_sentence

lorem_sentence(HashRef $data) (Str)

The lorem_sentence method returns a random lorem sentence.

Since 1.10

lorem_sentence example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $lorem_sentence = $faker->lorem_sentence;
# "vitae et eligendi laudantium provident assumenda voluptates..."
# $lorem_sentence = $faker->lorem_sentence;
# "aspernatur qui ad error numquam illum sunt cupiditate recus..."
# $lorem_sentence = $faker->lorem_sentence;
# "incidunt ut ratione sequi non illum laborum dolorum et earu..."

lorem_sentences

lorem_sentences(HashRef $data) (Str)

The lorem_sentences method returns a random lorem sentences.

Since 1.10

lorem_sentences example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $lorem_sentences = $faker->lorem_sentences;
# "vero deleniti fugiat in accusantium animi corrupti. et eos ..."
# $lorem_sentences = $faker->lorem_sentences;
# "enim accusantium aliquid id reprehenderit consequatur ducim..."
# $lorem_sentences = $faker->lorem_sentences;
# "reprehenderit ut autem cumque ea sint dolorem impedit et qu..."

lorem_word

lorem_word(HashRef $data) (Str)

The lorem_word method returns a random lorem word.

Since 1.10

lorem_word example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $lorem_word = $faker->lorem_word;
# "nisi"
# $lorem_word = $faker->lorem_word;
# "nihil"
# $lorem_word = $faker->lorem_word;
# "vero"

lorem_words

lorem_words(HashRef $data) (Str)

The lorem_words method returns a random lorem words.

Since 1.10

lorem_words example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $lorem_words = $faker->lorem_words;
# "aut vitae et eligendi laudantium"
# $lorem_words = $faker->lorem_words;
# "accusantium animi corrupti dolores aliquid"
# $lorem_words = $faker->lorem_words;
# "eos pariatur quia corporis illo"

new

new(Str $data | ArrayRef $data | HashRef $data) (Faker)

The new method returns a new instance of the class.

Since 1.10

new example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $first_name = $faker->person_name;
# "Russel Krajcik"
new example 2
package main;
use Faker;
my $faker = Faker->new(['en-us', 'es-es']);
# my $first_name = $faker->person_name;
# "Rafael Loera"
new example 3
package main;
use Faker;
my $faker = Faker->new({locales => ['en-us']});
# my $first_name = $faker->person_name;
# "Russel Krajcik"

payment_card_american_express

payment_card_american_express(HashRef $data) (Str)

The payment_card_american_express method returns a random payment card american express.

Since 1.10

payment_card_american_express example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $payment_card_american_express = $faker->payment_card_american_express;
# 34140844684550
# $payment_card_american_express = $faker->payment_card_american_express;
# 37945443908982
# $payment_card_american_express = $faker->payment_card_american_express;
# 34370225828820

payment_card_discover

payment_card_discover(HashRef $data) (Str)

The payment_card_discover method returns a random payment card discover.

Since 1.10

payment_card_discover example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $payment_card_discover = $faker->payment_card_discover;
# 601131408446845
# $payment_card_discover = $faker->payment_card_discover;
# 601107694544390
# $payment_card_discover = $faker->payment_card_discover;
# 601198220370225

payment_card_expiration

payment_card_expiration(HashRef $data) (Str)

The payment_card_expiration method returns a random payment card expiration.

Since 1.10

payment_card_expiration example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $payment_card_expiration = $faker->payment_card_expiration;
# "02/24"
# $payment_card_expiration = $faker->payment_card_expiration;
# "11/23"
# $payment_card_expiration = $faker->payment_card_expiration;
# "09/24"

payment_card_mastercard

payment_card_mastercard(HashRef $data) (Str)

The payment_card_mastercard method returns a random payment card mastercard.

Since 1.10

payment_card_mastercard example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $payment_card_mastercard = $faker->payment_card_mastercard;
# 521408446845507
# $payment_card_mastercard = $faker->payment_card_mastercard;
# 554544390898220
# $payment_card_mastercard = $faker->payment_card_mastercard;
# 540225828820558

payment_card_number

payment_card_number(HashRef $data) (Str)

The payment_card_number method returns a random payment card number.

Since 1.10

payment_card_number example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $payment_card_number = $faker->payment_card_number;
# 453208446845507
# $payment_card_number = $faker->payment_card_number;
# 37443908982203
# $payment_card_number = $faker->payment_card_number;
# 491658288205589

payment_card_visa

payment_card_visa(HashRef $data) (Str)

The payment_card_visa method returns a random payment card visa.

Since 1.10

payment_card_visa example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $payment_card_visa = $faker->payment_card_visa;
# 453214084468
# $payment_card_visa = $faker->payment_card_visa;
# 402400715076
# $payment_card_visa = $faker->payment_card_visa;
# 492954439089

payment_vendor

payment_vendor(HashRef $data) (Str)

The payment_vendor method returns a random payment vendor.

Since 1.10

payment_vendor example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $payment_vendor = $faker->payment_vendor;
# "Visa"
# $payment_vendor = $faker->payment_vendor;
# "MasterCard"
# $payment_vendor = $faker->payment_vendor;
# "American Express"

person_first_name

person_first_name(HashRef $data) (Str)

The person_first_name method returns a random person first name.

Since 1.10

person_first_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $person_first_name = $faker->person_first_name;
# "Haskell"
# $person_first_name = $faker->person_first_name;
# "Jamison"
# $person_first_name = $faker->person_first_name;
# "Keeley"

person_formal_name

person_formal_name(HashRef $data) (Str)

The person_formal_name method returns a random person formal name.

Since 1.10

person_formal_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $person_formal_name = $faker->person_formal_name;
# "Russel Krajcik"
# $person_formal_name = $faker->person_formal_name;
# "Miss Josephine Forest Beier DDS"
# $person_formal_name = $faker->person_formal_name;
# "Duncan Mann"

person_gender

person_gender(HashRef $data) (Str)

The person_gender method returns a random person gender.

Since 1.10

person_gender example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $person_gender = $faker->person_gender;
# "male"
# $person_gender = $faker->person_gender;
# "male"
# $person_gender = $faker->person_gender;
# "female"

person_last_name

person_last_name(HashRef $data) (Str)

The person_last_name method returns a random person last name.

Since 1.10

person_last_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $person_last_name = $faker->person_last_name;
# "Heaney"
# $person_last_name = $faker->person_last_name;
# "Johnston"
# $person_last_name = $faker->person_last_name;
# "Steuber"

person_name

person_name(HashRef $data) (Str)

The person_name method returns a random person name.

Since 1.10

person_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $person_name = $faker->person_name;
# "Russel Krajcik"
# $person_name = $faker->person_name;
# "Alayna Josephine Kunde"
# $person_name = $faker->person_name;
# "Viviane Fritsch"

person_name_prefix

person_name_prefix(HashRef $data) (Str)

The person_name_prefix method returns a random person name prefix.

Since 1.10

person_name_prefix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $person_name_prefix = $faker->person_name_prefix;
# "Mr."
# $person_name_prefix = $faker->person_name_prefix;
# "Mr."
# $person_name_prefix = $faker->person_name_prefix;
# "Sir"

person_name_suffix

person_name_suffix(HashRef $data) (Str)

The person_name_suffix method returns a random person name suffix.

Since 1.10

person_name_suffix example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $person_name_suffix = $faker->person_name_suffix;
# "I"
# $person_name_suffix = $faker->person_name_suffix;
# "I"
# $person_name_suffix = $faker->person_name_suffix;
# "II"

software_author

software_author(HashRef $data) (Str)

The software_author method returns a random software author.

Since 1.10

software_author example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $software_author = $faker->software_author;
# "Jamison Skiles"
# $software_author = $faker->software_author;
# "Josephine Kunde"
# $software_author = $faker->software_author;
# "Darby Boyer"

software_name

software_name(HashRef $data) (Str)

The software_name method returns a random software name.

Since 1.10

software_name example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $software_name = $faker->software_name;
# "Job"
# $software_name = $faker->software_name;
# "Zamit"
# $software_name = $faker->software_name;
# "Stronghold"

software_semver

software_semver(HashRef $data) (Str)

The software_semver method returns a random software semver.

Since 1.10

software_semver example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $software_semver = $faker->software_semver;
# "1.4.0"
# $software_semver = $faker->software_semver;
# "4.6.8"
# $software_semver = $faker->software_semver;
# "5.0.7"

software_version

software_version(HashRef $data) (Str)

The software_version method returns a random software version.

Since 1.10

software_version example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $software_version = $faker->software_version;
# 1.4
# $software_version = $faker->software_version;
# "0.4.4"
# $software_version = $faker->software_version;
# "0.4.5"

telephone_number

telephone_number(HashRef $data) (Str)

The telephone_number method returns a random telephone number.

Since 1.10

telephone_number example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $telephone_number = $faker->telephone_number;
# "01408446845"
# $telephone_number = $faker->telephone_number;
# "769-454-4390"
# $telephone_number = $faker->telephone_number;
# "1-822-037-0225x82882"

user_login

user_login(HashRef $data) (Str)

The user_login method returns a random user login.

Since 1.10

user_login example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $user_login = $faker->user_login;
# "Russel44"
# $user_login = $faker->user_login;
# "aMayer7694"
# $user_login = $faker->user_login;
# "Amalia89"

user_password

user_password(HashRef $data) (Str)

The user_password method returns a random user password.

Since 1.10

user_password example 1
package main;
use Faker;
my $faker = Faker->new('en-us');
# my $user_password = $faker->user_password;
# "48R+a}[Lb?&0725"
# $user_password = $faker->user_password;
# ",0w\$h4155>*0M"
# $user_password = $faker->user_password;
# ")P2^'q695a}8GX"

FEATURES

This package provides the following features:

plugins-feature

This package loads and dispatches calls to plugins (the fake data generators) which allow for extending the library in environment-specific ways.

example 1

sub execute {
'video/mpeg'
}
package main;
use Faker;
my $faker = Faker->new;
my $http_content_type = $faker->http_content_type;
# "video/mpeg"

example 2

sub execute {
'video/mpeg'
}
package main;
my $plugin = Faker::Plugin::HttpContentType->new;
my $http_content_type = $plugin->execute;
# "video/mpeg"
locales-feature

This package can be configured to return localized fake data, typically organized under namespaces specific to the locale specified.

example 1

sub execute {
'Hash yer dothrae chek asshekh?'
}
package main;
use Faker;
my $faker = Faker->new('dothraki');
my $random_phrase = $faker->random_phrase;
# "Hash yer dothrae chek asshekh?"

example 2

sub execute {
'nuqDaq ’oH puchpa’’e’'
}
package main;
use Faker;
my $faker = Faker->new('klingon');
my $random_phrase = $faker->random_phrase;
# "nuqDaq ’oH puchpa’’e’"

example 3

sub execute {
'Hash yer dothrae chek asshekh?'
}
sub execute {
'nuqDaq ’oH puchpa’’e’'
}
package main;
use Faker;
my $faker = Faker->new(['dothraki', 'klingon']);
my $random_phrase = $faker->random_phrase;
# "nuqDaq ’oH puchpa’’e’"
# $random_phrase = $faker->random_phrase;
# "Hash yer dothrae chek asshekh?"
# $random_phrase = $faker->random_phrase;
# "nuqDaq ’oH puchpa’’e’"
# $random_phrase = $faker->random_phrase;
# "nuqDaq ’oH puchpa’’e’"
caching-feature

Often one generator's fake data is composed of the output from other generators. Caching can be used to make generators faster, and to make fake data more realistic.

example 1

package main;
use Faker;
my $faker = Faker->new('en-us');
my $person_first_name = $faker->person_first_name;
# "Jordi"
my $person_last_name = $faker->person_last_name;
# "Smitham"
my $internet_email_address = $faker->internet_email_address;
# "deshaun8768@hotmail.com"
$person_first_name = $faker->cache('person_first_name');
# "Arlene"
$person_last_name = $faker->cache('person_last_name');
# "Cassin"
$internet_email_address = $faker->internet_email_address;
# "arlene6025@proton.me"

AUTHORS

Awncorp, awncorp@cpan.org

LICENSE

Copyright (C) 2000, Al Newkirk.

This program is free software, you can redistribute it and/or modify it under the terms of the Apache license version 2.0.