Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/youpong/data-gimei

A Perl port of Ruby's gimei generates fake data that people's name and address in Japanese and supports furigana phonetic renderings of kanji.
https://github.com/youpong/data-gimei

faker perl

Last synced: 3 months ago
JSON representation

A Perl port of Ruby's gimei generates fake data that people's name and address in Japanese and supports furigana phonetic renderings of kanji.

Awesome Lists containing this project

README

        

[![Actions Status](https://github.com/youpong/Data-Gimei/workflows/test/badge.svg)](https://github.com/youpong/Data-Gimei/actions) [![MetaCPAN Release](https://badge.fury.io/pl/Data-Gimei.svg)](https://metacpan.org/release/Data-Gimei)
# NAME

Data::Gimei - a Perl port of Ruby's gimei generates fake data in Japanese.

# 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

This module generates fake data that people's name in Japanese and
supports furigana, phonetic renderings of kanji.

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

# LICENSE

MIT License

Dictionary YAML file is generated from naist-jdic.

# AUTHOR

NAKAJIMA Yusaku < [email protected] >