fantasy_faker 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: babf067689eb2d336f310659e548a6e4bd91cb3526adc40123b16c057f052590
-  data.tar.gz: 44d2c5e41e728adfd32654050608fb506ad3c0a87d9f7b9107cd83d3bf33a71f
+  metadata.gz: b2564d8293a91c1c0572693b78d0a2d472b9bada33506defd0af70015cb7de5f
+  data.tar.gz: '00709549331b1fd21196009a36c9baa8d1c1c497868b5a68320e70b8e5562f30'
 SHA512:
-  metadata.gz: 74493db82cf1d264d9217350c3dd75496ecc46899396426050d24abfa82ddffb42f0ee3494b71b37b5a109b37937d09e2d0ea9443155dc34f9163feb3c655ace
-  data.tar.gz: 3ccd876fa0ef30915fd0199285cdb8b08feb7358f24e01305163926f21fa0084798a3cc0f8f809f2bf9f096013473b23238306db5cc117346fcbb48edf44ba43
+  metadata.gz: dba61364fc29ce55098bc2610f02c5c993faeb348112acbd20b1de42f3a112f60f7fdec2c78d8f3ef4112c7dbd67480fc2d49edfc43622754174fe26dac85acb
+  data.tar.gz: 6bb6a69246f54fc860840f45e96d80a3d80f52e55dfaf21b775ae036d2d08e57ef2fc9469d6947e9eee5eaa7b5b6ac44c83fce2d83888833790de6b4f2dc7e77

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.3.0 - October 24, 2026
+
+- Add `.unique` to all character name and nickname generators, with per-method tracking across locale changes.
+- Raise `FantasyFaker::UniqueGenerator::RetryLimitExceeded` after 10,000 unsuccessful attempts to generate a new value.
+- Add `FantasyFaker::Character.unique.clear` to reset uniqueness tracking.
+
 ## 0.2.0 - October 21, 2026
 
 - Expand the first-name dictionaries from 2,499 to 5,040 distinct male names and from 1,380 to 2,795 distinct female names.

data/README.md

@@ -50,6 +50,35 @@ FantasyFaker.use_locale(:pl) do
 end
 ```
 
+### Unique values
+
+Use `.unique` with any character generator: `male_first_name`, `female_first_name`,
+`male_nickname`, `female_nickname`, `male_name`, or `female_name`.
+
+```ruby
+FantasyFaker::Character.unique.male_name
+FantasyFaker::Character.unique.female_nickname
+
+# Reset all character generators' uniqueness history (for example, between tests)
+FantasyFaker::Character.unique.clear
+```
+
+In FactoryBot (formerly FactoryGirl), use it inside the attribute block:
+
+```ruby
+factory :character do
+  name { FantasyFaker::Character.unique.male_name }
+end
+```
+
+Values are tracked separately for each method within the current Ruby process,
+including across locale changes. Ordinary calls without `.unique` are not tracked.
+This does not check existing database records or coordinate separate processes.
+
+If no new value is found after 10,000 attempts, generation raises
+`FantasyFaker::UniqueGenerator::RetryLimitExceeded` rather than returning a duplicate.
+Because generation is random, this can happen before every possible value has been used.
+
 ## Development
 
 Dictionary data is stored in YAML files under `locales/`:

data/lib/fantasy_faker/unique_generator.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'set'
+
+module FantasyFaker
+  class UniqueGenerator
+    class RetryLimitExceeded < RuntimeError; end
+
+    def initialize(generator)
+      @generator = generator
+      @previous_results = Hash.new { |results, method| results[method] = Set.new }
+    end
+
+    def clear
+      @previous_results.clear
+    end
+
+    private
+
+    def method_missing(method, ...)
+      return super unless @generator.respond_to?(method)
+
+      10_000.times do
+        result = @generator.public_send(method, ...)
+        return result if @previous_results[method].add?(result)
+      end
+
+      raise RetryLimitExceeded, "Unable to generate a unique #{method} after 10,000 attempts"
+    end
+
+    def respond_to_missing?(method, include_private = false)
+      @generator.respond_to?(method) || super
+    end
+  end
+end

data/lib/fantasy_faker/utils/base_module.rb

@@ -5,6 +5,10 @@ require_relative 'array_utils'
 
 module FantasyFaker
   module BaseModule
+    def unique
+      @unique_generator ||= UniqueGenerator.new(self)
+    end
+
     def const_missing(const_name)
       fetch_data(const_name)
     end

data/lib/fantasy_faker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FantasyFaker
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/fantasy_faker.rb

@@ -2,6 +2,7 @@
 
 require_relative 'fantasy_faker/version'
 require_relative 'fantasy_faker/utils/array_utils'
+require_relative 'fantasy_faker/unique_generator'
 require_relative 'fantasy_faker/utils/base_module'
 require_relative 'fantasy_faker/character'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fantasy_faker
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Konrad Jurkowski
@@ -21,6 +21,7 @@ files:
 - README.md
 - lib/fantasy_faker.rb
 - lib/fantasy_faker/character.rb
+- lib/fantasy_faker/unique_generator.rb
 - lib/fantasy_faker/utils/array_utils.rb
 - lib/fantasy_faker/utils/base_module.rb
 - lib/fantasy_faker/version.rb