gimei 0.4.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35cb5bc32bc45d0b86828d6752260ea90a70c7fdd4151bd0e425425eee7cb8ca
-  data.tar.gz: a3cbf8105592bbd8bb38753bfa5acca44ceea9675ffe9963e89dd74ab91f8e04
+  metadata.gz: 8b901f4ad99a870c4fccfe3c2b45d091efb1419db562b59b8a21ee28b789110d
+  data.tar.gz: 37857e0546c84936dab79d8731c0cf2dd5462819138a8bc038107632c11b76dc
 SHA512:
-  metadata.gz: 07b60a6af8982950d8786c4ee4a8d2522b4e2381e70c73e9c686238818b3117ecce405aeae08a1334d32e774caaf23e18ce0f21a6ed017679306c701415e50dc
-  data.tar.gz: b7fcac6a4a5101ba31053153b274c0994b4b27bdf453c370ab4fa50cbde32c361357e05e4a865deb5631e316b2af7737442f03a55ef28bd8c8a207b04e909819
+  metadata.gz: bf30c05cf967c15a0eba2713428baa490e0ffe2b0034286db8079f9a39a669685e74a6449b7d65bfe9c52418abfa6dfe85f242d3e69ec5c784b9ce47e6a198b4
+  data.tar.gz: fdbace6cac90a3cbab0d93edb084fbff7babfa729efcb2b2e31da9eba3663b0d611d79abdc3861c98b3200c620a95ba50e91ed5e5ab9e8d4927173f3df601722

data/.github/workflows/test.yml

@@ -0,0 +1,61 @@
+name: test
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    container: ${{ matrix.ruby }}
+
+    strategy:
+      fail-fast: false
+
+      matrix:
+        ruby:
+          - ruby:2.2
+          - ruby:2.3
+          - ruby:2.4
+          - ruby:2.5
+          - ruby:2.6
+          - ruby:2.7
+          - ruby:3.0
+          - ruby:3.1
+          - rubylang/ruby:master-nightly-bionic
+        include:
+          - ruby: rubylang/ruby:master-nightly-bionic
+            allow_failures: "true"
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Cache vendor/bundle
+        uses: actions/cache@v1
+        id: cache_gem
+        with:
+          path: vendor/bundle
+          key: v1-gem-${{ runner.os }}-${{ matrix.ruby }}-${{ github.sha }}
+          restore-keys: |
+            v1-gem-${{ runner.os }}-${{ matrix.ruby }}-
+        continue-on-error: ${{ matrix.allow_failures == 'true' }}
+
+      - name: bundle update
+        run: |
+          set -xe
+          bundle config path vendor/bundle
+          bundle update --jobs $(nproc) --retry 3
+        continue-on-error: ${{ matrix.allow_failures == 'true' }}
+
+      - name: Run test
+        run: |
+          set -xe
+          bundle exec rake
+        continue-on-error: ${{ matrix.allow_failures == 'true' }}

data/CHANGELOG.md

@@ -1,8 +1,30 @@
+## 1.0.1
+
+- Ruby 3.1のサポート[@willnet](https://github.com/willnet) (https://github.com/willnet/gimei/pull/48)
+- 他言語による実装リストの更新 [@youpong](https://github.com/youpong) (https://github.com/willnet/gimei/pull/47)
+- READMEに「再現可能なランダムデータ」の節を追加 [@youpong](https://github.com/youpong) (https://github.com/willnet/gimei/pull/45)
+
+## 1.0.0
+
+* データの読み込みを遅延させた [@willnet](https://github.com/willnet) (https://github.com/willnet/gimei/pull/41)
+* Ruby2.2以下のサポートを削除 [@willnet](https://github.com/willnet)
+  * [Drop ruby suport < 2.2.0 · willnet/gimei@d02363f](https://github.com/willnet/gimei/commit/d02363f2fc6ffa31a531576cb9f599a01e25194f)
+  * 現時点ではテストしていないだけなので、未サポートのRubyでも動作はすると思いますが保証外です
+
+## 0.5.1
+
+* 住所データの更新 [kossy0701 (kawagoekeisuke)](https://github.com/kossy0701) (https://github.com/willnet/gimei/pull/38)
+
+## 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,29 +164,74 @@ 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` にあるので、必要であればファイルを修正してください。
 
+### 再現可能なランダムデータ
+
+下記のように乱数生成器を設定することで、再現性のあるランダムデータを生成できます。
+
+```ruby
+Gimei.config.rng = Random.new(42)
+Gimei.name.kanji    #=> "飯島 誠吾"
+Gimei.address.kanji #=> "熊本県日進市東場内"
+
+Gimei.config.rng = Random.new(42)
+Gimei.name.kanji    #=> "飯島 誠吾"
+Gimei.address.kanji #=> "熊本県日進市東場内"
+```
+
 ## Supported versions
 
-- 2.0.0
-- 2.1.x
 - 2.2.x
 - 2.3.x
 - 2.4.x
 - 2.5.x
 - 2.6.x
 - 2.7.x
+- 3.0.x
+- 3.1.x
 
 ## 他言語による実装
 
-- [mattn/go-gimei](https://github.com/mattn/go-gimei)
-- [moznion/gimei-java](https://github.com/moznion/gimei-java)
-- [nabetama/gimei](https://github.com/nabetama/gimei)
-- [gongo/emacs-gimei](https://github.com/gongo/emacs-gimei)
-- [ma2gedev/gimei_ex](https://github.com/ma2gedev/gimei_ex)
-- [demiglacesource/node-gimei](https://github.com/demiglacesource/node-gimei)
-- [matarillo/dot-gimei](https://github.com/matarillo/dot-gimei)
-- [abcb2/type-gimei](https://github.com/abcb2/type-gimei)
+- .NET       [matarillo/dot-gimei](https://github.com/matarillo/dot-gimei)
+- Elixir     [ma2gedev/gimei_ex](https://github.com/ma2gedev/gimei_ex)
+- Emacs Lisp [gongo/emacs-gimei](https://github.com/gongo/emacs-gimei)
+- Go         [mattn/go-gimei](https://github.com/mattn/go-gimei)
+- Java       [moznion/gimei-java](https://github.com/moznion/gimei-java)
+- Node.js    [demiglacesource/node-gimei](https://github.com/demiglacesource/node-gimei)
+- Perl       [youpong/Data-Gimei](https://github.com/youpong/Data-Gimei)
+- Python     [nabetama/gimei](https://github.com/nabetama/gimei)
+- TypeScript [abcb2/type-gimei](https://github.com/abcb2/type-gimei)
 
 ## Installation
 

data/gimei.gemspec

@@ -19,7 +19,6 @@ 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('coveralls')
 end

data/lib/data/addresses.yml

@@ -326,6 +326,7 @@ addresses:
     - ['栗原市', 'くりはらし', 'クリハラシ']
     - ['東松島市', 'ひがしまつしまし', 'ヒガシマツシマシ']
     - ['大崎市', 'おおさきし', 'オオサキシ']
+    - ['富谷市', 'とみやし', 'トミヤシ']
     - ['刈田郡蔵王町', 'かったぐんざおうまち', 'カッタグンザオウマチ']
     - ['刈田郡七ヶ宿町', 'かったぐんしちかしゅくまち', 'カッタグンシチカシュクマチ']
     - ['柴田郡大河原町', 'しばたぐんおおがわらまち', 'シバタグンオオガワラマチ']
@@ -340,7 +341,6 @@ addresses:
     - ['宮城郡利府町', 'みやぎぐんりふちょう', 'ミヤギグンリフチョウ']
     - ['黒川郡大和町', 'くろかわぐんたいわちょう', 'クロカワグンタイワチョウ']
     - ['黒川郡大郷町', 'くろかわぐんおおさとちょう', 'クロカワグンオオサトチョウ']
-    - ['黒川郡富谷町', 'くろかわぐんとみやまち', 'クロカワグントミヤマチ']
     - ['黒川郡大衡村', 'くろかわぐんおおひらむら', 'クロカワグンオオヒラムラ']
     - ['加美郡色麻町', 'かみぐんしかまちょう', 'カミグンシカマチョウ']
     - ['加美郡加美町', 'かみぐんかみまち', 'カミグンカミマチ']
@@ -1352,7 +1352,7 @@ addresses:
     - ['小野市', 'おのし', 'オノシ']
     - ['三田市', 'さんだし', 'サンダシ']
     - ['加西市', 'かさいし', 'カサイシ']
-    - ['篠山市', 'ささやまし', 'ササヤマシ']
+    - ['丹波篠山市', 'たんばささやまし', 'タンバササヤマシ']
     - ['養父市', 'やぶし', 'ヤブシ']
     - ['丹波市', 'たんばし', 'タンバシ']
     - ['南あわじ市', 'みなみあわじし', 'ミナミアワジシ']
@@ -1693,7 +1693,7 @@ addresses:
     - ['朝倉市', 'あさくらし', 'アサクラシ']
     - ['みやま市', 'みやまし', 'ミヤマシ']
     - ['糸島市', 'いとしまし', 'イトシマシ']
-    - ['筑紫郡那珂川町', 'ちくしぐんなかがわまち', 'チクシグンナカガワマチ']
+    - ['那珂川市', 'なかがわし', 'ナカガワシ']
     - ['糟屋郡宇美町', 'かすやぐんうみまち', 'カスヤグンウミマチ']
     - ['糟屋郡篠栗町', 'かすやぐんささぐりまち', 'カスヤグンササグリマチ']
     - ['糟屋郡志免町', 'かすやぐんしめまち', 'カスヤグンシメマチ']

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 = "1.0.1"
 end

data/lib/gimei.rb

@@ -3,12 +3,12 @@ require 'yaml'
 require 'gimei/version'
 require 'gimei/name'
 require 'gimei/address'
+require 'gimei/unique_generator'
+require 'gimei/config'
 
 class Gimei
   extend Forwardable
 
-  NAMES = YAML.load_file(File.expand_path(File.join('..', 'data', 'names.yml'), __FILE__))
-  ADDRESSES = YAML.load_file(File.expand_path(File.join('..', 'data', 'addresses.yml'), __FILE__))
   GENDERS = [:male, :female].freeze
 
   def_delegators :@name, :gender, :kanji, :hiragana, :katakana, :first, :last, :male?, :female?, :romaji
@@ -20,19 +20,53 @@ 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
+
+    def names
+      @names ||= YAML.load_file(File.expand_path(File.join('..', 'data', 'names.yml'), __FILE__))
+    end
+
+    def addresses
+      @addresses ||= YAML.load_file(File.expand_path(File.join('..', 'data', 'addresses.yml'), __FILE__))
+    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/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,12 @@ Coveralls.wear!
 
 require 'gimei'
 require 'minitest/autorun'
-require 'moji'
+
+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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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(: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: 1.0.1
 platform: ruby
 authors:
 - willnet
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-12-26 00:00:00.000000000 Z
+date: 2022-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: romaji
@@ -38,20 +38,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: moji
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -88,8 +74,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".coveralls.yml"
+- ".github/workflows/test.yml"
 - ".gitignore"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -101,17 +87,20 @@ 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
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -126,8 +115,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.33
+signing_key:
 specification_version: 4
 summary: random Japanese name and address generator. support kanji, hiragana, and
   katakana
@@ -136,3 +125,4 @@ test_files:
 - spec/gimei_spec.rb
 - spec/name_spec.rb
 - spec/spec_helper.rb
+- spec/unique_spec.rb

data/.travis.yml

@@ -1,13 +0,0 @@
-language: ruby
-rvm:
-  - "2.0.0"
-  - "2.1.10"
-  - "2.2.7"
-  - "2.3.4"
-  - "2.4.1"
-  - "2.5.0"
-  - "2.6.0"
-  - "2.7.0"
-
-before_install:
-  - gem update bundler