gimei 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35cb5bc32bc45d0b86828d6752260ea90a70c7fdd4151bd0e425425eee7cb8ca
-  data.tar.gz: a3cbf8105592bbd8bb38753bfa5acca44ceea9675ffe9963e89dd74ab91f8e04
+  metadata.gz: 27f074f6bdfe0c87b52c92fd3d407b092752776022b6d84197d2c91966ed69d7
+  data.tar.gz: 53bcf822b645c25fb235c3b45b5b82a4d4613192b6b9b253477cb4c28cc4bfec
 SHA512:
-  metadata.gz: 07b60a6af8982950d8786c4ee4a8d2522b4e2381e70c73e9c686238818b3117ecce405aeae08a1334d32e774caaf23e18ce0f21a6ed017679306c701415e50dc
-  data.tar.gz: b7fcac6a4a5101ba31053153b274c0994b4b27bdf453c370ab4fa50cbde32c361357e05e4a865deb5631e316b2af7737442f03a55ef28bd8c8a207b04e909819
+  metadata.gz: 47eaca2ac1937f88e14c7fe904db52c30a799f19ae993939bc83a884ae1ca44bb013a1143ba2c98dbda15acddf44b5eb0d89595ee6564764dfa5eaeba27cf9e5
+  data.tar.gz: 510d2295139449a6a8b652947d94cbf756c331002cca6f3835f238e9e3f5c6c73395d04dd4d319c1ae9d64b94e30a590d8ce80fe0cbb59ae155e30bc04a10d01

data/CHANGELOG.md

@@ -1,8 +1,13 @@
+## 0.5.0
+
+* Gimei.uniqueメソッドの追加 [@willnet](https://github.com/willnet) (https://github.com/willnet/gimei/pull/35) 
+* 乱数生成器を Config 経由で設定できるようにした [@purintai](https://github.com/purintai) ( https://github.com/willnet/gimei/pull/34  )
+
 ## 0.4.0
 
 * Gimei#genderメソッドの追加 - [@nard-tech](https://github.com/nard-tech)
-* Ruby 1.9のサポートの停止
-* Ruby 2.7をサポート開始
+* Ruby 1.9のサポートを停止
+* Ruby 2.7のサポートを開始
 
 ## 0.3.0
 

data/README.md

@@ -66,6 +66,50 @@ Gimei.first.katakana #=> "ヤマト"
 Gimei.first.romaji   #=> "Noriyuki"
 ```
 
+同じ名前を二度取得したくない場合には、以下のように`unique`を挟みます。次のようにすると、利用した名前をGimei内で保持することで必ず一意な名前を返すようにできます。
+
+```ruby
+Gimei.unique.name
+```
+
+上記の場合は、フルネームの漢字が一意であることを保証します。つまり、次のように姓や名の単位では重複することもありえます。
+
+```ruby
+Gimei.unique.name.kanji #=> "前島 真一"
+Gimei.unique.name.kanji #=> "神谷 真一"
+Gimei.unique.name.kanji #=> "前島 太郎"
+```
+
+これを避けたいときは次のように`last`や`first`を利用してください。これは姓や名の単位で一意な名前を返します。
+
+```ruby
+Gimei.unique.last
+Gimei.unique.first
+```
+
+この場合でも、ふりがな(フリガナ)の単位では重複することがあります。
+
+```ruby
+Gimei.unique.first.hiragana #=> "しんいち"
+Gimei.unique.first.hiragana #=> "しんいち"
+```
+
+もし名前の候補が枯渇するなど、一意な名前を返せない場合はエラーになります。
+
+これまで利用した名前のリストを消去したい場合は、次のようにします。
+
+```ruby
+Gimei.unique.clear # 全体を消去
+Gimei.unique.clear(:name) # Gimei.unique.name の結果を消去
+Gimei.unique.clear(:first) # Gimei.unique.first の結果を消去
+```
+
+次のメソッドで生成された名前は`Gimei.unique.clear(:name)`で消去します。
+
+- `Gimei.unique.male`
+- `Gimei.unique.female`
+- `Gimei.unique.kanji`
+
 出力される名前の候補となるデータは `lib/data/names.yml` にあるので、必要であればファイルを修正してください。
 
 ### 住所をランダムで返す
@@ -120,6 +164,36 @@ Gimei.town.katakana           # => イケナイ
 Gimei.town.romaji             # => Heisei
 ```
 
+同じ住所を二度取得したくない場合には、以下のように`unique`を挟みます。次のようにすると、利用した住所をGimei内で保持することで必ず一意な名前を返すようにできます。
+
+```ruby
+address = Gimei.unique.address
+```
+
+上記の場合は、住所全体が一意であることを保証します。つまり、次のように県や市町村の単位では重複することもありえます。
+
+```ruby
+Gimei.unique.address.prefecture.kanji #=> 東京都
+Gimei.unique.address.prefecture.kanji #=> 東京都
+```
+
+もし県や市町村の単位で一意であることを保証したいのであれば、次のように短縮形を使います。
+
+```ruby
+Gimei.unique.prefecture.kanji #=> 東京都
+Gimei.unique.prefecture.kanji #=> 神奈川県
+```
+
+もし住所の候補が枯渇するなど、一意な名前を返せない場合はエラーになります。
+
+これまで利用した住所のリストを消去したい場合は、次のようにします。
+
+```ruby
+Gimei.unique.clear # 全体を消去
+Gimei.unique.clear(:address) # Gimei.unique.address の結果を消去
+Gimei.unique.clear(:prefecture) # Gimei.unique.prefecture の結果を消去
+```
+
 出力される住所の候補となるデータは `lib/data/addresses.yml` にあるので、必要であればファイルを修正してください。
 
 ## Supported versions

data/gimei.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.add_dependency('romaji')
   gem.add_development_dependency('rake')
-  gem.add_development_dependency('moji')
   gem.add_development_dependency('minitest')
+  gem.add_development_dependency('minitest-stub-const')
   gem.add_development_dependency('coveralls')
 end

data/lib/gimei.rb

@@ -3,6 +3,8 @@ require 'yaml'
 require 'gimei/version'
 require 'gimei/name'
 require 'gimei/address'
+require 'gimei/unique_generator'
+require 'gimei/config'
 
 class Gimei
   extend Forwardable
@@ -20,19 +22,45 @@ class Gimei
   class << self
     extend Forwardable
 
-    def_delegators :name, :kanji, :hiragana, :katakana, :first, :last, :romaji
     def_delegators Gimei::Name, :male, :female
     def_delegators :address, :prefecture, :city, :town
 
-    def name
-      Name.new
+    def name(gender = nil)
+      Name.new(gender)
+    end
+
+    %i[kanji hiragana katakana romaji first last].each do |method_name|
+      define_method(method_name) do |gender = nil|
+        name(gender).public_send(method_name)
+      end
     end
 
     def address
       Address.new
     end
+
+    def unique(max_retries = 10_000)
+      return @unique if defined? @unique
+
+      @unique = UniqueGenerator.new(self, max_retries)
+
+      %i[name last first hiragana katakana romaji address prefecture city town].each do |method_name|
+        @unique.define_unique_method(method_name)
+      end
+
+      %i[male female kanji].each do |method_name|
+        @unique.define_unique_method(method_name, :name)
+      end
+
+      @unique
+    end
+
+    def config
+      @config ||= Config.new
+    end
   end
 
+
   def initialize(gender = nil)
     @name = Name.new(gender)
     @address = Address.new

data/lib/gimei/address.rb

@@ -43,7 +43,7 @@ class Gimei::Address
     end
 
     def initialize
-      @prefectures = Gimei::ADDRESSES['addresses']['prefecture'].sample
+      @prefectures = Gimei::ADDRESSES['addresses']['prefecture'].sample(random: Gimei.config.rng)
     end
 
     alias_method :to_s, :kanji
@@ -67,7 +67,7 @@ class Gimei::Address
     end
 
     def initialize
-      @cities = Gimei::ADDRESSES['addresses']['city'].sample
+      @cities = Gimei::ADDRESSES['addresses']['city'].sample(random: Gimei.config.rng)
     end
 
     alias_method :to_s, :kanji
@@ -91,7 +91,7 @@ class Gimei::Address
     end
 
     def initialize
-      @towns = Gimei::ADDRESSES['addresses']['town'].sample
+      @towns = Gimei::ADDRESSES['addresses']['town'].sample(random: Gimei.config.rng)
     end
 
     alias_method :to_s, :kanji

data/lib/gimei/config.rb

@@ -0,0 +1,9 @@
+class Gimei
+  class Config
+    attr_accessor :rng
+
+    def initialize(rng: Random.new)
+      @rng = rng
+    end
+  end
+end

data/lib/gimei/name.rb

@@ -5,7 +5,6 @@ class Gimei::Name
 
   class << self
     extend Forwardable
-    def_delegators :new, :kanji, :hiragana, :katakana, :first, :last, :romaji
 
     def male
       new(:male)
@@ -14,10 +13,16 @@ class Gimei::Name
     def female
       new(:female)
     end
+
+    %i[kanji hiragana katakana romaji first last].each do |method_name|
+      define_method(method_name) do |gender = nil|
+        new(gender).public_send(method_name)
+      end
+    end
   end
 
   def initialize(gender = nil)
-    @gender = gender || Gimei::GENDERS.sample
+    @gender = gender || Gimei::GENDERS.sample(random: Gimei.config.rng)
     @first = First.new @gender
     @last = Last.new
   end
@@ -63,8 +68,8 @@ class Gimei::Name
     def_delegators :@name, :kanji, :hiragana, :katakana, :to_s, :romaji
 
     def initialize(gender = nil)
-      @gender = gender || Gimei::GENDERS.sample
-      @name = NameWord.new(Gimei::NAMES['first_name'][@gender.to_s].sample)
+      @gender = gender || Gimei::GENDERS.sample(random: Gimei.config.rng)
+      @name = NameWord.new(Gimei::NAMES['first_name'][@gender.to_s].sample(random: Gimei.config.rng))
     end
 
     def male?
@@ -81,7 +86,7 @@ class Gimei::Name
     def_delegators :@name, :kanji, :hiragana, :katakana, :to_s, :romaji
 
     def initialize
-      @name = NameWord.new(Gimei::NAMES['last_name'].sample)
+      @name = NameWord.new(Gimei::NAMES['last_name'].sample(random: Gimei.config.rng))
     end
   end
 

data/lib/gimei/unique_generator.rb

@@ -0,0 +1,47 @@
+class Gimei
+  class RetryLimitExceeded < StandardError; end
+
+  class UniqueGenerator
+    class << self
+      def previous_results
+        @previous_results ||= Hash.new { |hash, key| hash[key] = Set.new }
+      end
+    end
+
+    def initialize(klass, max_retries)
+      @klass = klass
+      @max_retries = max_retries
+    end
+
+    def previous_results
+      self.class.previous_results
+    end
+
+    def clear(key = nil)
+      if key
+        previous_results[key.to_sym].clear
+      else
+        previous_results.clear
+      end
+    end
+
+    def define_unique_method(method_name, previous_result_key = method_name)
+      define_singleton_method method_name do |*args|
+        max_retries.times do
+          result = klass.public_send(method_name, *args)
+
+          next if previous_results[previous_result_key].include?(result.to_s)
+
+          previous_results[previous_result_key] << result.to_s
+          return result
+        end
+
+        raise RetryLimitExceeded, "Retry limit exceeded for #{method_name}"
+      end
+    end
+
+    private
+
+    attr_reader :klass, :max_retries
+  end
+end

data/lib/gimei/version.rb

@@ -1,3 +1,3 @@
 class Gimei
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/spec/address_spec.rb

@@ -4,21 +4,21 @@ require_relative 'spec_helper'
 describe Gimei do
   describe '#kanji and #to_s' do
     it '全角文字が返ること' do
-      _(Gimei.address.kanji).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.address.to_s).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.address.prefecture.kanji).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.address.prefecture.to_s).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.address.city.kanji).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.address.city.to_s).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.address.town.kanji).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.address.town.to_s).must_match(/\A[#{Moji.zen}]+\z/)
+      _(Gimei.address.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.address.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.address.prefecture.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.address.prefecture.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.address.city.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.address.city.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.address.town.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.address.town.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
 
-      _(Gimei.prefecture.kanji).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.prefecture.to_s).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.city.kanji).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.city.to_s).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.town.kanji).must_match(/\A[#{Moji.zen}]+\z/)
-      _(Gimei.town.to_s).must_match(/\A[#{Moji.zen}]+\z/)
+      _(Gimei.prefecture.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.prefecture.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.city.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.city.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.town.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
+      _(Gimei.town.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
     end
   end
 

data/spec/gimei_spec.rb

@@ -43,19 +43,19 @@ describe Gimei do
 
   describe '#kanji' do
     it '全角文字とスペースが返ること' do
-      _(Gimei.new.kanji).must_match(/\A[#{Moji.zen}\s]+\z/)
+      _(Gimei.new.kanji).must_match(/\A#{zenkaku_or_space_regexp}+\z/)
     end
   end
 
   describe '#to_s' do
     it '全角文字とスペースが返ること' do
-      _(Gimei.new.to_s).must_match(/\A[#{Moji.zen}\s]+\z/)
+      _(Gimei.new.to_s).must_match(/\A#{zenkaku_or_space_regexp}+\z/)
     end
   end
 
   describe '.kanji' do
     it '全角文字とスペースが返ること' do
-      _(Gimei.kanji).must_match(/\A[#{Moji.zen}\s]+\z/)
+      _(Gimei.kanji).must_match(/\A#{zenkaku_or_space_regexp}+\z/)
     end
   end
 

data/spec/name_spec.rb

@@ -36,7 +36,7 @@ describe Gimei::Name do
 
   describe '.kanji' do
     it '全角文字とスペースが返ること' do
-      _(Gimei::Name.kanji).must_match(/\A[#{Moji.zen}\s]+\z/)
+      _(Gimei::Name.kanji).must_match(/\A#{zenkaku_or_space_regexp}+\z/)
     end
   end
 
@@ -67,7 +67,7 @@ describe Gimei::Name do
 
   describe '#kanji' do
     it '全角文字とスペースが返ること' do
-      _(Gimei::Name.new.kanji).must_match(/\A[#{Moji.zen}\s]+\z/)
+      _(Gimei::Name.new.kanji).must_match(/\A#{zenkaku_or_space_regexp}+\z/)
     end
   end
 
@@ -129,7 +129,7 @@ describe Gimei::Name::First do
 
   describe '#kanji' do
     it '全角文字が返ること' do
-      _(Gimei::Name::First.new.kanji).must_match(/\A#{Moji.zen}+\z/)
+      _(Gimei::Name::First.new.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
     end
   end
 
@@ -147,7 +147,7 @@ describe Gimei::Name::First do
 
   describe '#to_s' do
     it '全角文字が返ること' do
-      _(Gimei::Name::First.new.to_s).must_match(/\A#{Moji.zen}+\z/)
+      _(Gimei::Name::First.new.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
     end
   end
 
@@ -163,7 +163,7 @@ describe Gimei::Name::Last do
 
   describe '#kanji' do
     it '全角文字が返ること' do
-      _(@name.kanji).must_match(/\A#{Moji.zen}+\z/)
+      _(@name.kanji).must_match(/\A#{zenkaku_regexp}+\z/)
     end
   end
 
@@ -181,7 +181,7 @@ describe Gimei::Name::Last do
 
   describe '#to_s' do
     it '全角文字が返ること' do
-      _(@name.to_s).must_match(/\A#{Moji.zen}+\z/)
+      _(@name.to_s).must_match(/\A#{zenkaku_regexp}+\z/)
     end
   end
 

data/spec/spec_helper.rb

@@ -8,4 +8,13 @@ Coveralls.wear!
 
 require 'gimei'
 require 'minitest/autorun'
-require 'moji'
+require 'minitest/stub_const'
+
+def zenkaku_regexp
+  /\p{Hiragana}|\p{Katakana}|[一-龠々]/
+end
+
+def zenkaku_or_space_regexp
+  /\p{Hiragana}|\p{Katakana}|[一-龠々]|\s/
+end
+

data/spec/unique_spec.rb

@@ -0,0 +1,399 @@
+# coding: utf-8
+require_relative 'spec_helper'
+
+describe 'Gimei.unique' do
+  before do
+    Gimei.unique.clear
+  end
+
+  describe '#clear' do
+    describe '名前が枯渇してからclearを実行し、再度名前を取得しようとしたとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生しないこと' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          Gimei.unique.male
+          Gimei.unique.clear
+          Gimei.unique.male
+        end
+      end
+    end
+
+    describe '名前が枯渇してからclear(:name)を実行し再度名前を取得しようとしたとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生しないこと' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => {'male' => [%w[真一 しんいち シンイチ]]},
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          Gimei.unique.male
+          Gimei.unique.clear(:name)
+          Gimei.unique.male
+        end
+      end
+    end
+
+    describe '名前が枯渇してからclear(:address)を実行し再度名前を取得しようとしたとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => {'male' => [%w[真一 しんいち シンイチ]]},
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.male
+            Gimei.unique.clear(:address)
+            Gimei.unique.male
+          end
+        end
+      end
+    end
+  end
+
+  describe '#male' do
+    describe '名前が枯渇していないとき' do
+      it '一意な名前(フルネームの漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.male.kanji, Gimei.unique.male.kanji].sort).must_equal ['前島 真一', '神谷 真一']
+        end
+      end
+    end
+
+    describe '名前が枯渇したとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.male
+            Gimei.unique.male
+          end
+        end
+      end
+    end
+  end
+
+  describe '#female' do
+    describe '名前が枯渇していないとき' do
+      it '一意な名前(フルネームの漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'female' => [%w[花子 はなこ ハナコ]] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.female.kanji, Gimei.unique.female.kanji].sort).must_equal ['前島 花子', '神谷 花子']
+        end
+      end
+    end
+
+    describe '名前が枯渇したとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'female' => [%w[花子 はなこ ハナコ]] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.female
+            Gimei.unique.female
+          end
+        end
+      end
+    end
+  end
+
+  describe '#first' do
+    describe '名が枯渇していないとき' do
+      it '一意な名(漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ], %w[真二 しんじ シンジ]] },
+          'last_name' => %w[]
+        }) do
+          _([Gimei.unique.first(:male).kanji, Gimei.unique.first(:male).kanji].sort).must_equal %w[真一 真二]
+        end
+      end
+    end
+
+    describe '名が枯渇したとき' do
+      it 'Gimei::RetryLimitExceeded例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => []
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.first(:male)
+            Gimei.unique.first(:male)
+          end
+        end
+      end
+    end
+  end
+
+  describe '#last' do
+    describe '姓が枯渇していないとき' do
+      it '一意な姓(漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [], 'female' => [] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.last.kanji, Gimei.unique.last.kanji].sort).must_equal %w[前島 神谷]
+        end
+      end
+    end
+
+    describe '姓が枯渇したとき' do
+      it 'Gimei::RetryLimitExceeded例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [], 'female' => [] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.last
+            Gimei.unique.last
+          end
+        end
+      end
+    end
+  end
+
+  describe '#kanji' do
+    describe '名前が枯渇していないとき' do
+      it '一意な名前(フルネームの漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.kanji(:male), Gimei.unique.kanji(:male)].sort).must_equal ['前島 真一', '神谷 真一']
+        end
+      end
+    end
+
+    describe '名前が枯渇したとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.kanji(:male)
+            Gimei.unique.kanji(:male)
+          end
+        end
+      end
+    end
+  end
+
+  describe '#hiragana' do
+    describe '名前が枯渇していないとき' do
+      it '一意な名前(フルネームの漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.hiragana(:male), Gimei.unique.hiragana(:male)].sort).must_equal ['かみや しんいち', 'まえしま しんいち']
+        end
+      end
+    end
+
+    describe '名前が枯渇したとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.hiragana(:male)
+            Gimei.unique.hiragana(:male)
+          end
+        end
+      end
+    end
+  end
+
+  describe '#katakana' do
+    describe '名前が枯渇していないとき' do
+      it '一意な名前(フルネームの漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.katakana(:male), Gimei.unique.katakana(:male)].sort).must_equal ['カミヤ シンイチ', 'マエシマ シンイチ']
+        end
+      end
+    end
+
+    describe '名前が枯渇したとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.katakana(:male)
+            Gimei.unique.katakana(:male)
+          end
+        end
+      end
+    end
+  end
+
+  describe '#romaji' do
+    describe '名前が枯渇していないとき' do
+      it '一意な名前(フルネームの漢字単位)が返ること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.romaji(:male), Gimei.unique.romaji(:male)].sort).must_equal ['Shinichi Kamiya', 'Shinichi Maeshima']
+        end
+      end
+    end
+
+    describe '名前が枯渇したとき' do
+      it 'Gimei::RetryLimitExceededed例外が発生すること' do
+        Gimei.stub_const(:NAMES, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ]] },
+          'last_name' => [%w[前島 まえしま マエシマ]]
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.romaji(:male)
+            Gimei.unique.romaji(:male)
+          end
+        end
+      end
+    end
+  end
+
+  describe '#address' do
+    describe '住所が枯渇していないとき' do
+      it '一意な住所(漢字単位)が返ること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [%w[東京都 とうきょうと トウキョウト]],
+            'city' => [%w[渋谷区 しぶやく シブヤク]],
+            'town' => [%w[恵比寿 えびす エビス], %w[蛭子 えびす エビス]]
+          }
+        }) do
+          _([Gimei.unique.address.kanji, Gimei.unique.address.kanji].sort).must_equal %w[東京都渋谷区恵比寿 東京都渋谷区蛭子]
+        end
+      end
+    end
+
+    describe '住所が枯渇したとき' do
+      it 'Gimei::RetryLimitExceeded例外が発生すること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [%w[東京都 とうきょうと トウキョウト]],
+            'city' => [%w[渋谷区 しぶやく シブヤク]],
+            'town' => [%w[恵比寿 えびす エビス]]
+          }
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.address
+            Gimei.unique.address
+          end
+        end
+      end
+    end
+  end
+
+  describe '#prefecture' do
+    describe '県が枯渇していないとき' do
+      it '一意な県が返ること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [%w[東京都 とうきょうと トウキョウト], %w[静岡県 しずおかけん シズオカケン]],
+            'city' => [],
+            'town' => []
+          }
+        }) do
+          _([Gimei.unique.prefecture.kanji, Gimei.unique.prefecture.kanji].sort).must_equal %w[東京都 静岡県]
+        end
+      end
+    end
+
+    describe '県が枯渇したとき' do
+      it 'Gimei::RetryLimitExceeded例外が発生すること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [%w[東京都 とうきょうと トウキョウト]],
+            'city' => [],
+            'town' => []
+          }
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.prefecture
+            Gimei.unique.prefecture
+          end
+        end
+      end
+    end
+  end
+
+  describe '#city' do
+    describe '市区町村が枯渇していないとき' do
+      it '一意な市区町村が返ること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [],
+            'city' => [%w[渋谷区 しぶやく シブヤク], %w[新宿区 しんじゅくく シンジュクク]],
+            'town' => []
+          }
+        }) do
+          _([Gimei.unique.city.kanji, Gimei.unique.city.kanji].sort).must_equal %w[新宿区 渋谷区]
+        end
+      end
+    end
+
+    describe '市区町村が枯渇したとき' do
+      it 'Gimei::RetryLimitExceeded例外が発生すること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [],
+            'city' => [%w[渋谷区 しぶやく シブヤク]],
+            'town' => []
+          }
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.city
+            Gimei.unique.city
+          end
+        end
+      end
+    end
+  end
+
+  describe '#town' do
+    describe 'その他住所が枯渇していないとき' do
+      it '一意なその他住所が返ること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [],
+            'city' => [],
+            'town' => [%w[恵比寿 えびす エビス], %w[蛭子 えびす エビス]]
+          }
+        }) do
+          _([Gimei.unique.town.kanji, Gimei.unique.town.kanji].sort).must_equal %w[恵比寿 蛭子]
+        end
+      end
+    end
+
+    describe 'その他住所が枯渇したとき' do
+      it 'Gimei::RetryLimitExceeded例外が発生すること' do
+        Gimei.stub_const(:ADDRESSES, {
+          'addresses' => {
+            'prefecture' => [],
+            'city' => [],
+            'town' => [%w[恵比寿 えびす エビス]]
+          }
+        }) do
+          assert_raises Gimei::RetryLimitExceeded do
+            Gimei.unique.town
+            Gimei.unique.town
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gimei
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - willnet
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-26 00:00:00.000000000 Z
+date: 2020-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: romaji
@@ -39,7 +39,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: moji
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: minitest-stub-const
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -101,12 +101,15 @@ files:
 - lib/data/names.yml
 - lib/gimei.rb
 - lib/gimei/address.rb
+- lib/gimei/config.rb
 - lib/gimei/name.rb
+- lib/gimei/unique_generator.rb
 - lib/gimei/version.rb
 - spec/address_spec.rb
 - spec/gimei_spec.rb
 - spec/name_spec.rb
 - spec/spec_helper.rb
+- spec/unique_spec.rb
 homepage: https://github.com/willnet/gimei
 licenses:
 - MIT
@@ -136,3 +139,4 @@ test_files:
 - spec/gimei_spec.rb
 - spec/name_spec.rb
 - spec/spec_helper.rb
+- spec/unique_spec.rb