gimei 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b901f4ad99a870c4fccfe3c2b45d091efb1419db562b59b8a21ee28b789110d
-  data.tar.gz: 37857e0546c84936dab79d8731c0cf2dd5462819138a8bc038107632c11b76dc
+  metadata.gz: bab55c81d075ac091f92fe6dd07a17aec5e05778d30f130d947fedde41fb8736
+  data.tar.gz: 05bef7aad6981ed3a968ff757aa2231de6a123f66fedbc50957728a606cb8363
 SHA512:
-  metadata.gz: bf30c05cf967c15a0eba2713428baa490e0ffe2b0034286db8079f9a39a669685e74a6449b7d65bfe9c52418abfa6dfe85f242d3e69ec5c784b9ce47e6a198b4
-  data.tar.gz: fdbace6cac90a3cbab0d93edb084fbff7babfa729efcb2b2e31da9eba3663b0d611d79abdc3861c98b3200c620a95ba50e91ed5e5ab9e8d4927173f3df601722
+  metadata.gz: d56e36b028af21d23fd52a4cc296c00bc0e5742a678be15cca002e70269f3778fd4a081a78059504d748705307ee6f145ad290d0408bc6ce5d78eddc52e7a664
+  data.tar.gz: 1a922ee6c3ea7309382da24f41525da6a0f3b44bfbec45a6cce97757b61eac80ae5c8b2157f8aa4e853691f295c99aaf7db661d6c14b735745cc6ccdcf95fcb6

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 1.1.0
+
+- Gimei::Name#family, #given を追加 [@nard-tech](https://github.com/nard-tech) (https://github.com/willnet/gimei/pull/50)
+- テストケースの修正 [@nard-tech](https://github.com/nard-tech) https://github.com/willnet/gimei/pull/49
+
 ## 1.0.1
 
 - Ruby 3.1のサポート[@willnet](https://github.com/willnet) (https://github.com/willnet/gimei/pull/48)

data/README.md

@@ -33,6 +33,20 @@ gimei.first.katakana #=> "ハルナ"
 gimei.first.romaji   #=> "Haruna"
 ```
 
+`gimei.last`, `gimei.first` の代わりに、`gimei.family`, `gimei.given` を用いることもできます。
+
+```ruby
+gimei.family.kanji     #=> "斎藤"
+gimei.family.hiragana  #=> "さいとう"
+gimei.family.katakana  #=> "サイトウ"
+gimei.family.romaji    #=> "Saitou"
+
+gimei.given.kanji    #=> "陽菜"
+gimei.given.hiragana #=> "はるな"
+gimei.given.katakana #=> "ハルナ"
+gimei.given.romaji   #=> "Haruna"
+```
+
 下記のように男性／女性の名前を返すことを明示的に指定できます。`Gimei.name` の場合は男女の名前を等確率で返します。
 
 ```ruby
@@ -64,6 +78,16 @@ Gimei.first.kanji    #=> "結菜"
 Gimei.first.hiragana #=> "ここあ"
 Gimei.first.katakana #=> "ヤマト"
 Gimei.first.romaji   #=> "Noriyuki"
+
+Gimei.family.kanji     #=> "黒沢"
+Gimei.family.hiragana  #=> "いずみ"
+Gimei.family.katakana  #=> "エノモト"
+Gimei.family.romaji    #=> "Okada"
+
+Gimei.given.kanji    #=> "航"
+Gimei.given.hiragana #=> "まさみつ"
+Gimei.given.katakana #=> "ユカ"
+Gimei.given.romaji   #=> "Haruto"
 ```
 
 同じ名前を二度取得したくない場合には、以下のように`unique`を挟みます。次のようにすると、利用した名前をGimei内で保持することで必ず一意な名前を返すようにできます。
@@ -110,6 +134,9 @@ Gimei.unique.clear(:first) # Gimei.unique.first の結果を消去
 - `Gimei.unique.female`
 - `Gimei.unique.kanji`
 
+`Gimei.unique.family` で生成された名前は `Gimei.unique.clear(:last)` で消去します。
+また、`Gimei.unique.given` で生成された名前は `Gimei.unique.clear(:first)` で消去します。
+
 出力される名前の候補となるデータは `lib/data/names.yml` にあるので、必要であればファイルを修正してください。
 
 ### 住所をランダムで返す

data/lib/gimei/name.rb

@@ -14,7 +14,7 @@ class Gimei::Name
       new(:female)
     end
 
-    %i[kanji hiragana katakana romaji first last].each do |method_name|
+    %i[kanji hiragana katakana romaji first last family given].each do |method_name|
       define_method(method_name) do |gender = nil|
         new(gender).public_send(method_name)
       end
@@ -53,6 +53,9 @@ class Gimei::Name
 
   alias_method :to_s, :kanji
 
+  alias_method :family, :last
+  alias_method :given, :first
+
   class First
     class << self
       def male

data/lib/gimei/version.rb

@@ -1,3 +1,3 @@
 class Gimei
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/lib/gimei.rb

@@ -11,7 +11,11 @@ class Gimei
 
   GENDERS = [:male, :female].freeze
 
-  def_delegators :@name, :gender, :kanji, :hiragana, :katakana, :first, :last, :male?, :female?, :romaji
+  def_delegators :@name,
+                 :first, :last, :gender,
+                 :kanji, :hiragana, :katakana, :romaji,
+                 :male?, :female?,
+                 :family, :given
   def_delegators :@address, :prefecture, :city, :town
   alias_method :to_s, :kanji
 
@@ -35,7 +39,7 @@ class Gimei
       @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|
+    %i[kanji hiragana katakana romaji first last family given].each do |method_name|
       define_method(method_name) do |gender = nil|
         name(gender).public_send(method_name)
       end
@@ -54,6 +58,9 @@ class Gimei
         @unique.define_unique_method(method_name)
       end
 
+      @unique.define_unique_method(:family, :last)
+      @unique.define_unique_method(:given, :first)
+
       %i[male female kanji].each do |method_name|
         @unique.define_unique_method(method_name, :name)
       end

data/spec/gimei_spec.rb

@@ -108,17 +108,41 @@ describe Gimei do
   end
 
   describe '.last' do
-    it 'Gimei::Name::First オブジェクトが返ること' do
+    it 'Gimei::Name::Last オブジェクトが返ること' do
       _(Gimei.last).must_be_instance_of Gimei::Name::Last
     end
   end
 
   describe '#last' do
-    it 'Gimei::Name::First オブジェクトが返ること' do
+    it 'Gimei::Name::Last オブジェクトが返ること' do
       _(Gimei.new.last).must_be_instance_of Gimei::Name::Last
     end
   end
 
+  describe '.family' do
+    it 'Gimei::Name::Last オブジェクトが返ること' do
+      _(Gimei.family).must_be_instance_of Gimei::Name::Last
+    end
+  end
+
+  describe '#family' do
+    it 'Gimei::Name::Last オブジェクトが返ること' do
+      _(Gimei.new.family).must_be_instance_of Gimei::Name::Last
+    end
+  end
+
+  describe '.given' do
+    it 'Gimei::Name::First オブジェクトが返ること' do
+      _(Gimei.given).must_be_instance_of Gimei::Name::First
+    end
+  end
+
+  describe '#given' do
+    it 'Gimei::Name::First オブジェクトが返ること' do
+      _(Gimei.new.given).must_be_instance_of Gimei::Name::First
+    end
+  end
+
   describe '.romaji' do
     it 'ローマ字とスペースが返ること' do
       _(Gimei.romaji).must_match(/\A[a-zA-Z\s]+\z/)

data/spec/name_spec.rb

@@ -58,6 +58,30 @@ describe Gimei::Name do
     end
   end
 
+  describe '.first' do
+    it 'Gimei::Name::First オブジェクトが返ること' do
+      _(Gimei::Name.first).must_be_instance_of Gimei::Name::First
+    end
+  end
+
+  describe '.last' do
+    it 'Gimei::Name::Last オブジェクトが返ること' do
+      _(Gimei::Name.last).must_be_instance_of Gimei::Name::Last
+    end
+  end
+
+  describe '.family' do
+    it 'Gimei::Name::Last オブジェクトが返ること' do
+      _(Gimei::Name.family).must_be_instance_of Gimei::Name::Last
+    end
+  end
+
+  describe '.given' do
+    it 'Gimei::Name::First オブジェクトが返ること' do
+      _(Gimei::Name.given).must_be_instance_of Gimei::Name::First
+    end
+  end
+
   describe '#gender' do
     it ':male または :female が返ること' do
       _(Gimei::Name.new.gender).must_be_instance_of(Symbol)
@@ -83,6 +107,12 @@ describe Gimei::Name do
     end
   end
 
+  describe '#romaji' do
+    it 'ローマ字とスペースが返ること' do
+      _(Gimei::Name.new.romaji).must_match(/\A[a-zA-Z\s]+\z/)
+    end
+  end
+
   describe '#first' do
     it 'Gimei::Name::First オブジェクトが返ること' do
       _(Gimei::Name.new.first).must_be_instance_of Gimei::Name::First
@@ -95,9 +125,15 @@ describe Gimei::Name do
     end
   end
 
-  describe '.romaji' do
-    it 'ローマ字とスペースが返ること' do
-      _(Gimei::Name.new.romaji).must_match(/\A[a-zA-Z\s]+\z/)
+  describe '#family' do
+    it 'Gimei::Name::Last オブジェクトが返ること' do
+      _(Gimei::Name.new.family).must_be_instance_of Gimei::Name::Last
+    end
+  end
+
+  describe '#given' do
+    it 'Gimei::Name::First オブジェクトが返ること' do
+      _(Gimei::Name.new.given).must_be_instance_of Gimei::Name::First
     end
   end
 end

data/spec/unique_spec.rb

@@ -157,6 +157,60 @@ describe 'Gimei.unique' do
     end
   end
 
+  describe '#family' do
+    describe '姓が枯渇していないとき' do
+      it '一意な姓(漢字単位)が返ること' do
+        Gimei.stub(:names, {
+          'first_name' => { 'male' => [], 'female' => [] },
+          'last_name' => [%w[前島 まえしま マエシマ], %w[神谷 かみや カミヤ]]
+        }) do
+          _([Gimei.unique.family.kanji, Gimei.unique.family.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.family
+            Gimei.unique.family
+          end
+        end
+      end
+    end
+  end
+
+  describe '#given' do
+    describe '名が枯渇していないとき' do
+      it '一意な名(漢字単位)が返ること' do
+        Gimei.stub(:names, {
+          'first_name' => { 'male' => [%w[真一 しんいち シンイチ], %w[真二 しんじ シンジ]] },
+          'last_name' => %w[]
+        }) do
+          _([Gimei.unique.given(:male).kanji, Gimei.unique.given(: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.given(:male)
+            Gimei.unique.given(:male)
+          end
+        end
+      end
+    end
+  end
+
   describe '#kanji' do
     describe '名前が枯渇していないとき' do
       it '一意な名前(フルネームの漢字単位)が返ること' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gimei
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - willnet
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-01-07 00:00:00.000000000 Z
+date: 2022-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: romaji
@@ -115,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: random Japanese name and address generator. support kanji, hiragana, and