Skip to content

A Perl port of Ruby's gimei generates fake Japanese names and addresses.

License

Notifications You must be signed in to change notification settings

youpong/Data-Gimei

Repository files navigation

Actions Status MetaCPAN Release

NAME

Data::Gimei - A Perl module ported from Ruby's gimei that randomly generates Japanese names and addresses.

SYNOPSIS

use 5.010;
use strict;
use warnings;

binmode STDOUT, ":utf8";

use Data::Gimei;
my $name = Data::Gimei::Name->new();
                                 # for example
say $name->kanji;                # "斎藤 陽菜"
say $name->hiragana;             # "さいとう はるな"
say $name->katakana;             # "サイトウ ハルナ"
say $name->romaji;               # "Haruna Saito"

say $name->surname->kanji;       # "斎藤"
say $name->surname->hiragana;    # "さいとう"
say $name->surname->katakana;    # "サイトウ"
say $name->surname->romaji;      # "Saito"

say $name->forename->kanji;      # "陽菜"
say $name->forename->hiragana;   # "はるな"
say $name->forename->katakana;   # "ハルナ"
say $name->forename->romaji;     # "Haruna"

say $name->gender;               # "female"

my $addr = Data::Gimei::Address->new();
say $addr->kanji;                # "北海道札幌市中央区モエレ沼公園"
say $addr->hiragana;             # "ほっかいどうさっぽろしちゅうおうくもえれぬまこうえん"
say $addr->katakana;             # "ホッカイドウサッポロシチュウオウクモエレヌマコウエン"

say $addr->prefecture->kanji;    # "北海道"
say $addr->prefecture->hiragana; # "ほっかいどう"
say $addr->prefecture->katakana; # "ホッカイドウ"

say $addr->city->kanji;          # "札幌市中央区"
say $addr->city->hiragana;       # "さっぽろしちゅうおうく"
say $addr->city->katakana;       # "サッポロシチュウオウク"

say $addr->town->kanji;          # "モエレ沼公園"
say $addr->town->hiragana;       # "もえれぬまこうえん"
say $addr->town->katakana;       # "モエレヌマコウエン"

DESCRIPTION

Data::Gimei generates fake Japanese names and addresses. Generated names include a first name, a last name, and their associated gender. Names are available in kanji, hiragana, katakana, and romanized forms, where hiragana, katakana, and romanized forms are phonetic renderings for kanji. Addresses include a prefecture, city, and town, and can be generated in kanji, hiragana or katakana. The output format can be customized using specific options. Note that the gender notation cannot be changed.

The project name comes from Japanese '偽名' means a false name.

Deterministic Random

Data::Gimei supports seeding of its pseudo-random number generator to provide deterministic output of repeated method calls.

Data::Gimei::set_random_seed(42);
my $name = Data::Gimei::Name->new();
$name->kanji;                    # "村瀬 零"
$address = Data::Gimei::Address->new();
$address->kanji;                 # "沖縄県那覇市祝子町"

Data::Gimei::set_random_seed(42);
my $name = Data::Gimei::Name->new();
$name->kanji;                    # "村瀬 零"
rand;                            # Do not change result by calling rand()
$address = Data::Gimei::Address->new();
$address->kanji;                 # "沖縄県那覇市祝子町"

INSTALL

This module is available on CPAN. You can install this module by following the step below.

$ cpanm Data::Gimei

DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

$ perldoc Data::Gimei

You can also look for information at:

GitHub Repository (report bugs here)
    https://github.com/youpong/Data-Gimei

Search CPAN
    https://metacpan.org/dist/Data-Gimei

SEE ALSO

LICENSE

MIT License

Dictionary YAML file is generated from naist-jdic.

AUTHOR

NAKAJIMA Yusaku < [email protected] >

About

A Perl port of Ruby's gimei generates fake Japanese names and addresses.

Topics

Resources

License

Stars

Watchers

Forks