name_bank 0.1.2

data/data/variants/US/african_american.yml

@@ -0,0 +1,93 @@
+firstnames_male:
+  - DeShawn
+  - Marcus
+  - Jamal
+  - Malik
+  - Terrell
+  - Darnell
+  - Andre
+  - Xavier
+  - Isaiah
+  - Jerome
+  - Tyrone
+  - DeAndre
+  - Rashad
+  - Demetrius
+  - Jaylen
+  - Kwame
+  - Darius
+  - Elijah
+  - Trevon
+  - Lamar
+  - Cedric
+  - Reggie
+  - Deon
+  - Maurice
+  - Devonte
+  - Roosevelt
+  - Amari
+  - Jabari
+  - Keshawn
+  - Tremaine
+firstnames_female:
+  - Aaliyah
+  - Tanisha
+  - Keisha
+  - Latasha
+  - Ebony
+  - Jasmine
+  - Destiny
+  - Imani
+  - Ayana
+  - Shanice
+  - Latoya
+  - Nia
+  - Kiara
+  - Aisha
+  - Chantel
+  - Deja
+  - Precious
+  - Tamika
+  - Kenya
+  - Latrice
+  - Ericka
+  - Monique
+  - Raven
+  - Essence
+  - Amara
+  - Zaria
+  - Tiana
+  - Jada
+  - Makayla
+  - Nyla
+lastnames:
+  - Jackson
+  - Washington
+  - Jefferson
+  - Robinson
+  - Coleman
+  - Freeman
+  - Brooks
+  - Dixon
+  - Banks
+  - Greene
+  - Mosley
+  - Rhodes
+  - Bryant
+  - Gaines
+  - Hampton
+  - Ellison
+  - Winters
+  - Boyd
+  - Simmons
+  - Charles
+  - Prince
+  - Sutton
+  - Carver
+  - Diggs
+  - Fields
+  - Vance
+  - Overton
+  - Dupree
+  - Toussaint
+  - Beaumont

data/lib/name_bank/repository.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module NameBank
+  # Lazy, memoized loader of per-country name pools stored as YAML in data_dir.
+  class Repository
+    def initialize(data_dir:)
+      @data_dir = data_dir
+      @countries_cache = {}
+      @variants_cache = {}
+    end
+
+    def firstnames(country:, gender:, variant: nil)
+      load(country, variant).fetch(gender_key(gender))
+    end
+
+    def lastnames(country:, variant: nil)
+      load(country, variant).fetch("lastnames")
+    end
+
+    def countries
+      @countries ||= yml_basenames(File.join(@data_dir, "countries"))
+    end
+
+    def variants(country:)
+      yml_basenames(File.join(@data_dir, "variants", country))
+    end
+
+    private
+
+    def gender_key(gender)
+      case gender
+      when :male then "firstnames_male"
+      when :female then "firstnames_female"
+      else raise ArgumentError, "gender must be :male or :female, got #{gender.inspect}"
+      end
+    end
+
+    def load(country, variant)
+      variant ? load_variant(country, variant) : load_country(country)
+    end
+
+    def load_country(country)
+      @countries_cache[country] ||= begin
+        path = File.join(@data_dir, "countries", "#{country}.yml")
+        raise UnknownCountry, country unless File.exist?(path)
+
+        YAML.safe_load_file(path)
+      end
+    end
+
+    def load_variant(country, variant)
+      @variants_cache[[country, variant]] ||= begin
+        path = File.join(@data_dir, "variants", country, "#{variant}.yml")
+        raise UnknownVariant, "#{country}/#{variant}" unless File.exist?(path)
+
+        YAML.safe_load_file(path)
+      end
+    end
+
+    def yml_basenames(dir)
+      return [] unless Dir.exist?(dir)
+
+      Dir.children(dir).select { |f| f.end_with?(".yml") }
+         .map { |f| File.basename(f, ".yml") }.sort
+    end
+  end
+end

data/lib/name_bank/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module NameBank
+  VERSION = "0.1.2"
+end

data/lib/name_bank.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "name_bank/version"
+require_relative "name_bank/repository"
+
+module NameBank
+  Error = Class.new(StandardError)
+  UnknownCountry = Class.new(Error)
+  UnknownVariant = Class.new(Error)
+
+  DATA_DIR = File.expand_path("../data", __dir__)
+
+  module_function
+
+  def first_name(country:, gender:, rng:, variant: nil)
+    repository.firstnames(country: country, gender: gender, variant: variant).sample(random: rng)
+  end
+
+  def last_name(country:, rng:, variant: nil)
+    repository.lastnames(country: country, variant: variant).sample(random: rng)
+  end
+
+  def full_name(country:, gender:, rng:, variant: nil)
+    {
+      firstname: first_name(country: country, gender: gender, rng: rng, variant: variant),
+      lastname: last_name(country: country, rng: rng, variant: variant)
+    }
+  end
+
+  def countries
+    repository.countries
+  end
+
+  def variants(country:)
+    repository.variants(country: country)
+  end
+
+  def repository
+    @repository ||= Repository.new(data_dir: DATA_DIR)
+  end
+end

metadata

@@ -0,0 +1,181 @@
+--- !ruby/object:Gem::Specification
+name: name_bank
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Patrick Bartels
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: A fast, dependency-free generator of authentic, gender-matched given
+  names and surnames for 105+ countries, plus hand-curated pools and cultural variants.
+  Uniform, deterministic sampling from a caller-supplied RNG.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- NOTICE
+- README.md
+- data/countries/AE.yml
+- data/countries/AF.yml
+- data/countries/AL.yml
+- data/countries/AO.yml
+- data/countries/AR.yml
+- data/countries/AT.yml
+- data/countries/AZ.yml
+- data/countries/BD.yml
+- data/countries/BE.yml
+- data/countries/BF.yml
+- data/countries/BG.yml
+- data/countries/BH.yml
+- data/countries/BI.yml
+- data/countries/BN.yml
+- data/countries/BO.yml
+- data/countries/BR.yml
+- data/countries/BW.yml
+- data/countries/CA.yml
+- data/countries/CH.yml
+- data/countries/CL.yml
+- data/countries/CM.yml
+- data/countries/CN.yml
+- data/countries/CO.yml
+- data/countries/CR.yml
+- data/countries/CY.yml
+- data/countries/CZ.yml
+- data/countries/DE.yml
+- data/countries/DJ.yml
+- data/countries/DK.yml
+- data/countries/DZ.yml
+- data/countries/EC.yml
+- data/countries/EE.yml
+- data/countries/EG.yml
+- data/countries/ES.yml
+- data/countries/ET.yml
+- data/countries/FI.yml
+- data/countries/FJ.yml
+- data/countries/FR.yml
+- data/countries/GB.yml
+- data/countries/GE.yml
+- data/countries/GH.yml
+- data/countries/GR.yml
+- data/countries/GT.yml
+- data/countries/HK.yml
+- data/countries/HN.yml
+- data/countries/HR.yml
+- data/countries/HT.yml
+- data/countries/HU.yml
+- data/countries/ID.yml
+- data/countries/IE.yml
+- data/countries/IL.yml
+- data/countries/IN.yml
+- data/countries/IQ.yml
+- data/countries/IR.yml
+- data/countries/IS.yml
+- data/countries/IT.yml
+- data/countries/JM.yml
+- data/countries/JO.yml
+- data/countries/JP.yml
+- data/countries/KH.yml
+- data/countries/KR.yml
+- data/countries/KW.yml
+- data/countries/KZ.yml
+- data/countries/LB.yml
+- data/countries/LT.yml
+- data/countries/LU.yml
+- data/countries/LY.yml
+- data/countries/MA.yml
+- data/countries/MD.yml
+- data/countries/MO.yml
+- data/countries/MT.yml
+- data/countries/MU.yml
+- data/countries/MV.yml
+- data/countries/MX.yml
+- data/countries/MY.yml
+- data/countries/NA.yml
+- data/countries/NG.yml
+- data/countries/NL.yml
+- data/countries/NO.yml
+- data/countries/OM.yml
+- data/countries/PA.yml
+- data/countries/PE.yml
+- data/countries/PH.yml
+- data/countries/PL.yml
+- data/countries/PR.yml
+- data/countries/PS.yml
+- data/countries/PT.yml
+- data/countries/QA.yml
+- data/countries/RS.yml
+- data/countries/RU.yml
+- data/countries/SA.yml
+- data/countries/SD.yml
+- data/countries/SE.yml
+- data/countries/SG.yml
+- data/countries/SI.yml
+- data/countries/SV.yml
+- data/countries/SY.yml
+- data/countries/TM.yml
+- data/countries/TN.yml
+- data/countries/TR.yml
+- data/countries/TW.yml
+- data/countries/UA.yml
+- data/countries/US.yml
+- data/countries/UY.yml
+- data/countries/YE.yml
+- data/countries/ZA.yml
+- data/variants/US/african_american.yml
+- lib/name_bank.rb
+- lib/name_bank/repository.rb
+- lib/name_bank/version.rb
+homepage: https://github.com/roughneck/name_bank
+licenses:
+- Apache-2.0
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Authentic, gender-matched given and family names for 105+ countries.
+test_files: []