Faker::JapaneseName

A Faker gem that provides Japanese family names and gender-specific given names, along with their kana (reading).

Features

Random generation of Japanese family and given names (male/female)
All names include kana (reading) information
Data sourced from Wikidata (CC0-1.0 license)

Installation

Add this line to your application's Gemfile:

gem 'faker-japanese-name'

And then execute:

bundle install

Or install it yourself as:

gem install faker-japanese-name

Usage

First, require the gem:

require 'faker-japanese-name'

Generate a Full Name

name = Faker::JapaneseName.name
puts name[:name]  #=> "佐藤 太郎"
puts name[:kana]  #=> "さとう たろう"

Generate Male or Female Full Name

male_name = Faker::JapaneseName.male_name
puts male_name[:name]  #=> "佐藤 太郎"
puts male_name[:kana]  #=> "さとう たろう"

female_name = Faker::JapaneseName.female_name
puts female_name[:name]  #=> "佐藤 花子"
puts female_name[:kana]  #=> "さとう はなこ"

Generate Family Name Only

family = Faker::JapaneseName.family_name
puts family[:name]  #=> "佐藤"
puts family[:kana]  #=> "さとう"

Generate Given Name Only

given = Faker::JapaneseName.given_name
puts given[:name]  #=> "太郎"
puts given[:kana]  #=> "たろう"

Generate Male or Female Given Name

male = Faker::JapaneseName.male_given_name
puts male[:name]  #=> "太郎"
puts male[:kana]  #=> "たろう"

female = Faker::JapaneseName.female_given_name
puts female[:name]  #=> "花子"
puts female[:kana]  #=> "はなこ"

About the Return Value

Each method returns a hash with :name and :kana keys, containing the Japanese name and its reading in kana.

Data

Data source: Wikidata (CC0-1.0)
Data files: Data files in the data/ directory

License

Code: MIT License
Name data: Wikidata, CC0-1.0 License

Acknowledgements

This gem was created with reference to tily/ruby-faker-japanese. Many thanks to the original author for inspiration.

faker-japanese-name

Runtime