ffaker 2.7.0 → 2.21.0

data/lib/ffaker/utils/array_utils.rb

@@ -1,4 +1,7 @@
-require 'ffaker/utils/random_utils'
+# frozen_string_literal: true
+
+require_relative 'random_utils'
+
 module FFaker
   module ArrayUtils
     extend RandomUtils
@@ -9,9 +12,9 @@ module FFaker
       freeze_all(array)
     end
 
-    def self.random_pick(array, n)
+    def self.random_pick(array, num)
       warn '[ArrayUtils.random_pick] is deprecated. Please use the ModuleUtils#fetch_sample method'
-      fetch_sample(array, count: n)
+      fetch_sample(array, count: num)
     end
 
     def self.rand(array)
@@ -29,9 +32,9 @@ module FFaker
       array.sort_by { FFaker::Random.rand }
     end
 
-    def random_pick(n)
+    def random_pick(num)
       warn '[ArrayUtils#random_pick] is deprecated. Please use the ModuleUtils#fetch_sample method'
-      ArrayUtils.random_pick(self, n)
+      ArrayUtils.random_pick(self, num)
     end
 
     def rand

data/lib/ffaker/utils/module_utils.rb

@@ -1,6 +1,8 @@
-require 'ffaker/utils/array_utils'
-require 'ffaker/utils/random_utils'
-require 'ffaker/utils/unique_utils'
+# frozen_string_literal: true
+
+require_relative 'array_utils'
+require_relative 'random_utils'
+require_relative 'unique_utils'
 
 module FFaker
   module ModuleUtils
@@ -16,7 +18,7 @@ module FFaker
       else
         mod_name = ancestors.first.to_s.split('::').last
         data_path = "#{FFaker::BASE_LIB_PATH}/ffaker/data/#{underscore(mod_name)}/#{underscore(const_name.to_s)}"
-        data = k File.read(data_path).split("\n")
+        data = k File.read(data_path, mode: 'r:UTF-8').split("\n")
         const_set const_name, data
         data
       end
@@ -33,5 +35,25 @@ module FFaker
     def unique(max_retries = 10_000)
       @unique_generator ||= FFaker::UniqueUtils.new(self, max_retries)
     end
+
+    # http://en.wikipedia.org/wiki/Luhn_algorithm
+    def luhn_check(number)
+      multiplications = []
+
+      number.split(//).each_with_index do |digit, i|
+        multiplications << i.even? ? digit.to_i * 2 : digit.to_i
+      end
+
+      sum = 0
+      multiplications.each do |num|
+        num.to_s.each_byte do |character|
+          sum += character.chr.to_i
+        end
+      end
+
+      control_digit = (sum % 10).zero? ? 0 : (sum / 10 + 1) * 10 - sum
+      control_digit.to_s
+    end
+
   end
 end

data/lib/ffaker/utils/random_utils.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module FFaker
   # Methods for returning repeatably-random data using the internal
   # Random Number Generator. You should not need to use this directly, it is
@@ -18,6 +20,8 @@ module FFaker
     def fetch_sample(list, options = {})
       if (count = options.delete(:count))
         list.sample(count, random: FFaker::Random)
+      elsif list.is_a?(Range)
+        FFaker::Random.rand(list)
       else
         list.sample(random: FFaker::Random)
       end

data/lib/ffaker/utils/unique_utils.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-
 require 'set'
 
 module FFaker

data/lib/ffaker/vehicle.rb

@@ -1,16 +1,74 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Vehicle
+    module VIN
+      extend ModuleUtils
+      extend self
+
+      # https://en.wikibooks.org/wiki/Vehicle_Identification_Numbers_(VIN_codes)/World_Manufacturer_Identifier_(WMI)
+      VALID_WMI_REGIONS = [*'A'..'C', *'J'..'Z', *'1'..'9'].freeze
+
+      VALID_YEAR_CHARS = %w[
+        5 6 7 8 9 A B C D E F G H J K L M N P R S T V W X Y 1 2 3 4 5 6 7 8 9
+      ].freeze # 2005-2039
+
+      # https://en.wikibooks.org/wiki/Vehicle_Identification_Numbers_(VIN_codes)/Check_digit
+      TRANSLITERATION_VALUES = {
+        'A' => 1, 'B' => 2, 'C' => 3, 'D' => 4, 'E' => 5, 'F' => 6, 'G' => 7, 'H' => 8,
+        'J' => 1, 'K' => 2, 'L' => 3, 'M' => 4, 'N' => 5, 'P' => 7, 'R' => 9,
+        'S' => 2, 'T' => 3, 'U' => 4, 'V' => 5, 'W' => 6, 'X' => 7, 'Y' => 8, 'Z' => 9
+      }.freeze
+      POSITION_WEIGHTS = [8, 7, 6, 5, 4, 3, 2, 10, 0, 9, 8, 7, 6, 5, 4, 3, 2].freeze
+
+      VALID_ALPHA = TRANSLITERATION_VALUES.keys
+      VALID_ALPHANUMERIC = [*VALID_ALPHA, *'1'..'9'].freeze
+
+      # Generate a VIN that is compliant with specifications of US Title 49 Section 565.15
+      # https://www.govinfo.gov/content/pkg/CFR-2019-title49-vol6/xml/CFR-2019-title49-vol6-part565.xml#seqnum565.15
+      #
+      # Position  Meaning
+      # 1-3       Manufacturer ID aka WMI (alpha and digits)
+      # 4-8       Vehicle Description ("For passenger cars ..[position 7].. shall be alphabetic")
+      # 9         Check Digit (0-9 or "X")
+      # 10        Year (see VIN_VALID_YEARS)
+      # 11        Plant of manufacture (alpha and digits)
+      # 12-17     Serial number (digits only)
+      #
+      # I, O and Q are NOT allowed. VIN_VALID_ALPHA has valid alpha characters.
+      def vin
+        generated_vin = [
+          # Manufacturer ID / WMI
+          fetch_sample(VALID_WMI_REGIONS),
+          fetch_sample(VALID_ALPHANUMERIC, count: 2),
+          # Vehicle Description
+          fetch_sample(VALID_ALPHANUMERIC, count: 3),
+          fetch_sample(VALID_ALPHA),
+          fetch_sample(VALID_ALPHANUMERIC),
+          '0', # check digit placeholder
+          fetch_sample(VALID_YEAR_CHARS), # Year of Manufacture
+          fetch_sample(VALID_ALPHANUMERIC), # Plant ID
+          FFaker.numerify('######') # Serial Number
+        ].join
+
+        # Calculate the Check Digit
+        weighted_sum = generated_vin.chars.each_with_index.sum do |char, idx|
+          (TRANSLITERATION_VALUES[char.to_sym] || char).to_i * POSITION_WEIGHTS[idx]
+        end
+
+        check_digit = weighted_sum % 11
+        check_digit = 'X' if check_digit == 10
+        generated_vin[8] = check_digit.to_s
+
+        generated_vin
+      end
+    end
+
     extend ModuleUtils
     extend self
 
     DRIVETRAINS = %w[4WD 4X4 AWD FWD RWD].freeze
-    YEARS = [*'1900'..(Date.today.year + 1).to_s].freeze
-    COLOR_PREFIXES = k(%w[
-                         beautiful bright calm dangerous dark dull fast magnetic magnificent majestic melodic metallic
-                         mundane mute mysterious new pleasant pretty resonant royal slate soft tranquil vibrant weak
-                       ])
+    YEARS = Array('1900'..(::Time.now.year + 1).to_s).freeze
     TRANSMISSIONS_ABBR = %w[AT MT AM CVT].freeze
     CYLINDERS = %w[2 5 6 8].freeze
 
@@ -26,9 +84,9 @@ module FFaker
       fetch_sample(MAKES_LIST)
     end
 
-    def manufacturer_color(n = 2)
+    def manufacturer_color(count = 2)
       # Take two prefixes because it's more fun than one
-      (fetch_sample(COLOR_PREFIXES, count: n) + [base_color]).join(' ')
+      (fetch_sample(COLOR_PREFIXES, count: count) + [base_color]).join(' ')
     end
     alias mfg_color manufacturer_color
 
@@ -41,7 +99,7 @@ module FFaker
     end
 
     def vin
-      FFaker.bothify('1#???#####?######').upcase
+      VIN.vin
     end
 
     def year

data/lib/ffaker/venue.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Venue

data/lib/ffaker/youtube.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Youtube

data/lib/ffaker.rb

@@ -1,14 +1,14 @@
-module FFaker
-  VERSION = '2.2.0'.freeze
+# frozen_string_literal: true
 
-  require 'ffaker/utils/array_utils'
-  require 'ffaker/utils/module_utils'
+module FFaker
+  require_relative 'ffaker/utils/array_utils'
+  require_relative 'ffaker/utils/module_utils'
 
   extend ModuleUtils
 
-  BASE_LIB_PATH = File.expand_path('..', __FILE__)
+  BASE_LIB_PATH = File.expand_path(__dir__)
 
-  LETTERS = [*'a'..'z'].freeze
+  LETTERS = Array('a'..'z').freeze
 
   HEX = %w[0 1 2 3 4 5 6 7 8 9 A B C D E F].freeze
 
@@ -28,22 +28,206 @@ module FFaker
     letterify(numerify(masks))
   end
 
-  # Load all constants.
-  Dir["#{BASE_LIB_PATH}/ffaker/*.rb"].sort.each do |f|
-    require "ffaker/#{File.basename(f, '.rb')}"
-  end
+  autoload :Address, 'ffaker/address'
+  autoload :AddressAU, 'ffaker/address_au'
+  autoload :AddressBR, 'ffaker/address_br'
+  autoload :AddressCA, 'ffaker/address_ca'
+  autoload :AddressCH, 'ffaker/address_ch'
+  autoload :AddressCHDE, 'ffaker/address_ch_de'
+  autoload :AddressCHFR, 'ffaker/address_ch_fr'
+  autoload :AddressCHIT, 'ffaker/address_ch_it'
+  autoload :AddressDA, 'ffaker/address_da'
+  autoload :AddressDE, 'ffaker/address_de'
+  autoload :AddressFI, 'ffaker/address_fi'
+  autoload :AddressFR, 'ffaker/address_fr'
+  autoload :AddressGR, 'ffaker/address_gr'
+  autoload :AddressID, 'ffaker/address_id'
+  autoload :AddressIN, 'ffaker/address_in'
+  autoload :AddressIT, 'ffaker/address_it'
+  autoload :AddressJA, 'ffaker/address_ja'
+  autoload :AddressKR, 'ffaker/address_kr'
+  autoload :AddressMX, 'ffaker/address_mx'
+  autoload :AddressNL, 'ffaker/address_nl'
+  autoload :AddressPL, 'ffaker/address_pl'
+  autoload :AddressRU, 'ffaker/address_ru'
+  autoload :AddressSE, 'ffaker/address_se'
+  autoload :AddressSN, 'ffaker/address_sn'
+  autoload :AddressUA, 'ffaker/address_ua'
+  autoload :AddressUK, 'ffaker/address_uk'
+  autoload :AddressUS, 'ffaker/address_us'
+  autoload :Airline, 'ffaker/airline'
+  autoload :Animal, 'ffaker/animal'
+  autoload :AnimalBR, 'ffaker/animal_br'
+  autoload :AnimalCN, 'ffaker/animal_cn'
+  autoload :AnimalES, 'ffaker/animal_es'
+  autoload :AnimalPL, 'ffaker/animal_pl'
+  autoload :AnimalUS, 'ffaker/animal_us'
+  autoload :Avatar, 'ffaker/avatar'
+  autoload :AWS, 'ffaker/aws'
+  autoload :BaconIpsum, 'ffaker/bacon_ipsum'
+  autoload :Bank, 'ffaker/bank'
+  autoload :Book, 'ffaker/book'
+  autoload :Boolean, 'ffaker/boolean'
+  autoload :CheesyLingo, 'ffaker/cheesy_lingo'
+  autoload :Code, 'ffaker/code'
+  autoload :Color, 'ffaker/color'
+  autoload :ColorPL, 'ffaker/color_pl'
+  autoload :ColorUA, 'ffaker/color_ua'
+  autoload :Company, 'ffaker/company'
+  autoload :CompanyCN, 'ffaker/company_cn'
+  autoload :CompanyFR, 'ffaker/company_fr'
+  autoload :CompanyIT, 'ffaker/company_it'
+  autoload :CompanyJA, 'ffaker/company_ja'
+  autoload :CompanySE, 'ffaker/company_se'
+  autoload :Conference, 'ffaker/conference'
+  autoload :CoursesFR, 'ffaker/courses_fr'
+  autoload :Currency, 'ffaker/currency'
+  autoload :DizzleIpsum, 'ffaker/dizzle_ipsum'
+  autoload :Education, 'ffaker/education'
+  autoload :EducationCN, 'ffaker/education_cn'
+  autoload :Filesystem, 'ffaker/filesystem'
+  autoload :Food, 'ffaker/food'
+  autoload :FoodPL, 'ffaker/food_pl'
+  autoload :FreedomIpsum, 'ffaker/freedom_ipsum'
+  autoload :Game, 'ffaker/game'
+  autoload :Gender, 'ffaker/gender'
+  autoload :GenderBR, 'ffaker/gender_br'
+  autoload :GenderCN, 'ffaker/gender_cn'
+  autoload :GenderID, 'ffaker/gender_id'
+  autoload :GenderIT, 'ffaker/gender_it'
+  autoload :GenderJA, 'ffaker/gender_ja'
+  autoload :GenderJP, 'ffaker/gender_jp'
+  autoload :GenderKR, 'ffaker/gender_kr'
+  autoload :GenderPL, 'ffaker/gender_pl'
+  autoload :GenderRU, 'ffaker/gender_ru'
+  autoload :Geolocation, 'ffaker/geolocation'
+  autoload :Guid, 'ffaker/guid'
+  autoload :HealthcareIpsum, 'ffaker/healthcare_ipsum'
+  autoload :HealthcareRU, 'ffaker/healthcare_ru'
+  autoload :HipsterIpsum, 'ffaker/hipster_ipsum'
+  autoload :HTMLIpsum, 'ffaker/html_ipsum'
+  autoload :Identification, 'ffaker/identification'
+  autoload :IdentificationBR, 'ffaker/identification_br'
+  autoload :IdentificationES, 'ffaker/identification_es'
+  autoload :IdentificationESCL, 'ffaker/identification_es_cl'
+  autoload :IdentificationESCO, 'ffaker/identification_es_co'
+  autoload :IdentificationIN, 'ffaker/identification_in'
+  autoload :IdentificationIT, 'ffaker/identification_it'
+  autoload :IdentificationKr, 'ffaker/identification_kr'
+  autoload :IdentificationMX, 'ffaker/identification_mx'
+  autoload :IdentificationPL, 'ffaker/identification_pl'
+  autoload :IdentificationTW, 'ffaker/identification_tw'
+  autoload :Image, 'ffaker/image'
+  autoload :Internet, 'ffaker/internet'
+  autoload :InternetSE, 'ffaker/internet_se'
+  autoload :Job, 'ffaker/job'
+  autoload :JobBR, 'ffaker/job_br'
+  autoload :JobCN, 'ffaker/job_cn'
+  autoload :JobFR, 'ffaker/job_fr'
+  autoload :JobIT, 'ffaker/job_it'
+  autoload :JobJA, 'ffaker/job_ja'
+  autoload :JobKR, 'ffaker/job_kr'
+  autoload :JobVN, 'ffaker/job_vn'
+  autoload :Locale, 'ffaker/locale'
+  autoload :Lorem, 'ffaker/lorem'
+  autoload :LoremAR, 'ffaker/lorem_ar'
+  autoload :LoremBR, 'ffaker/lorem_br'
+  autoload :LoremCN, 'ffaker/lorem_cn'
+  autoload :LoremFR, 'ffaker/lorem_fr'
+  autoload :LoremIE, 'ffaker/lorem_ie'
+  autoload :LoremIT, 'ffaker/lorem_it'
+  autoload :LoremJA, 'ffaker/lorem_ja'
+  autoload :LoremKR, 'ffaker/lorem_kr'
+  autoload :LoremPL, 'ffaker/lorem_pl'
+  autoload :LoremRU, 'ffaker/lorem_ru'
+  autoload :LoremUA, 'ffaker/lorem_ua'
+  autoload :Movie, 'ffaker/movie'
+  autoload :Music, 'ffaker/music'
+  autoload :Name, 'ffaker/name'
+  autoload :NameAR, 'ffaker/name_ar'
+  autoload :NameBR, 'ffaker/name_br'
+  autoload :NameCN, 'ffaker/name_cn'
+  autoload :NameCS, 'ffaker/name_cs'
+  autoload :NameDA, 'ffaker/name_da'
+  autoload :NameDE, 'ffaker/name_de'
+  autoload :NameES, 'ffaker/name_es'
+  autoload :NameFR, 'ffaker/name_fr'
+  autoload :NameGA, 'ffaker/name_ga'
+  autoload :NameGR, 'ffaker/name_gr'
+  autoload :NameID, 'ffaker/name_id'
+  autoload :NameIN, 'ffaker/name_in'
+  autoload :NameIT, 'ffaker/name_it'
+  autoload :NameJA, 'ffaker/name_ja'
+  autoload :NameKH, 'ffaker/name_kh'
+  autoload :NameKR, 'ffaker/name_kr'
+  autoload :NameMX, 'ffaker/name_mx'
+  autoload :NameNB, 'ffaker/name_nb'
+  autoload :NameNL, 'ffaker/name_nl'
+  autoload :NamePH, 'ffaker/name_ph'
+  autoload :NamePL, 'ffaker/name_pl'
+  autoload :NameRU, 'ffaker/name_ru'
+  autoload :NameSE, 'ffaker/name_se'
+  autoload :NameSN, 'ffaker/name_sn'
+  autoload :NameTH, 'ffaker/name_th'
+  autoload :NameTW, 'ffaker/name_tw'
+  autoload :NameTHEN, 'ffaker/name_th_en'
+  autoload :NameUA, 'ffaker/name_ua'
+  autoload :NameVN, 'ffaker/name_vn'
+  autoload :NatoAlphabet, 'ffaker/nato_alphabet'
+  autoload :Number, 'ffaker/number'
+  autoload :PhoneNumber, 'ffaker/phone_number'
+  autoload :PhoneNumberAU, 'ffaker/phone_number_au'
+  autoload :PhoneNumberBR, 'ffaker/phone_number_br'
+  autoload :PhoneNumberCH, 'ffaker/phone_number_ch'
+  autoload :PhoneNumberCU, 'ffaker/phone_number_cu'
+  autoload :PhoneNumberDA, 'ffaker/phone_number_da'
+  autoload :PhoneNumberDE, 'ffaker/phone_number_de'
+  autoload :PhoneNumberFR, 'ffaker/phone_number_fr'
+  autoload :PhoneNumberID, 'ffaker/phone_number_id'
+  autoload :PhoneNumberIT, 'ffaker/phone_number_it'
+  autoload :PhoneNumberJA, 'ffaker/phone_number_ja'
+  autoload :PhoneNumberKR, 'ffaker/phone_number_kr'
+  autoload :PhoneNumberMX, 'ffaker/phone_number_mx'
+  autoload :PhoneNumberNL, 'ffaker/phone_number_nl'
+  autoload :PhoneNumberPL, 'ffaker/phone_number_pl'
+  autoload :PhoneNumberSE, 'ffaker/phone_number_se'
+  autoload :PhoneNumberSG, 'ffaker/phone_number_sg'
+  autoload :PhoneNumberSN, 'ffaker/phone_number_sn'
+  autoload :PhoneNumberTW, 'ffaker/phone_number_tw'
+  autoload :PhoneNumberUA, 'ffaker/phone_number_ua'
+  autoload :PhoneNumberRU, 'ffaker/phone_number_ru'
+  autoload :Product, 'ffaker/product'
+  autoload :SemVer, 'ffaker/sem_ver'
+  autoload :Skill, 'ffaker/skill'
+  autoload :Sport, 'ffaker/sport'
+  autoload :SportPL, 'ffaker/sport_pl'
+  autoload :SportUS, 'ffaker/sport_us'
+  autoload :SportRU, 'ffaker/sport_ru'
+  autoload :SSN, 'ffaker/ssn'
+  autoload :SSNMX, 'ffaker/ssn_mx'
+  autoload :SSNSE, 'ffaker/ssn_se'
+  autoload :String, 'ffaker/string'
+  autoload :Time, 'ffaker/time'
+  autoload :Tweet, 'ffaker/tweet'
+  autoload :Unit, 'ffaker/unit'
+  autoload :UnitEnglish, 'ffaker/unit_english'
+  autoload :UnitMetric, 'ffaker/unit_metric'
+  autoload :VERSION, 'version'
+  autoload :Vehicle, 'ffaker/vehicle'
+  autoload :Venue, 'ffaker/venue'
+  autoload :Youtube, 'ffaker/youtube'
 
   # Random Number Generator (RNG) used with ModuleUtils#fetch, #shuffle, #rand
   # in order to provide deterministic repeatability.
   module Random
     # Returns the current RNG seed.
     def self.seed
-      @random_seed ||= ::Random.new_seed
+      @seed ||= ::Random.new_seed
     end
 
     # Sets the RNG seed and creates a new internal RNG.
     def self.seed=(new_seed)
-      @random_seed = new_seed
+      @seed = new_seed
       reset!
       new_seed
     end
@@ -55,11 +239,9 @@ module FFaker
 
     # Returns a random number using an RNG with a known seed.
     def self.rand(max = nil)
-      if max
-        rng.rand(max)
-      else
-        rng.rand
-      end
+      return rng.rand(max) if max
+
+      rng.rand
     end
 
     # Returns the current Random object.

data/lib/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module FFaker
+  VERSION = '2.21.0'
+end

data/scripts/benchmark.rb

@@ -1,20 +1,21 @@
-require 'rubygems'
+# frozen_string_literal: true
+
 require 'benchmark'
 
-N = 10_000
+NAMES_COUNT = 10_000
 
 def run(name)
-  require name
   Benchmark.bm do |rep|
-    rep.report("generating #{N} names (#{name} #{FFaker::VERSION})") do
-      N.times do
-        FFaker::Name.name
-      end
+    rep.report("generating #{NAMES_COUNT} names (#{name})") do
+      mod = name == 'ffaker' ? FFaker : Faker
+      NAMES_COUNT.times { mod::Name.name }
     end
   end
-  $stdout.flush
-  exit(0)
 end
 
-fork { run('faker') }; Process.wait
-fork { run('ffaker') }; Process.wait
+%w[faker ffaker].each do |gem_name|
+  require gem_name
+
+  fork { run(gem_name) }
+  Process.wait
+end

data/scripts/profiling.rb

@@ -1,4 +1,6 @@
-require File.dirname(__FILE__) + '/../lib/faker'
+# frozen_string_literal: true
+
+require_relative '../lib/faker'
 
 N = 1_000_000
 

data/scripts/reference.rb

@@ -1,28 +1,32 @@
-$LOAD_PATH << File.dirname(__FILE__) + '/../lib'
-require 'ffaker'
+# frozen_string_literal: true
+
+require_relative '../lib/ffaker'
+require 'set'
+
+# always use the same seed for consistency
+FFaker::Random.seed = 1337
 
 ICONS = {
   error: '‼️',
   warning: '❗'
 }.freeze
 
+UTILS_MODULES = %i[ArrayUtils ModuleUtils RandomUtils Random]
+UTILS_METHODS = %i[k underscore fetch_sample rand shuffle unique luhn_check]
+
 # Get a list of sections
 def faker_modules
-  FFaker.constants.map do |const|
-    mod = FFaker.const_get(const)
-    next unless mod.is_a?(Module)
-    next if mod == FFaker::ArrayUtils
-    next if mod == FFaker::ModuleUtils
-    next if mod == FFaker::RandomUtils
-    next if mod == FFaker::Random
-    mod
-  end.compact
+  FFaker
+    .constants
+    .reject { |const| UTILS_MODULES.include?(const) }
+    .select { |const| FFaker.const_get(const).instance_of?(Module) }
+    .sort
+    .map { |const| FFaker.const_get(const) }
 end
 
 # Returns faker methods for a given module
 def faker_methods(mod)
-  methods = mod.methods - Module.methods -
-            %i[k underscore fetch_sample rand shuffle]
+  methods = mod.methods - Module.methods - UTILS_METHODS
 
   # For Company.name (et al), don't discard :name if it was reimplemented
   methods << :name if mod.send(:name) != mod.to_s
@@ -44,7 +48,7 @@ def escape(str)
   str.gsub('&', '&amp;').gsub('<', '&lt;').gsub('>', '&gt;').delete("\n")
 end
 
-sections = faker_modules.each.map do |mod|
+sections = faker_modules.map do |mod|
   lines = []
 
   methods = faker_methods(mod)
@@ -59,19 +63,19 @@ sections = faker_modules.each.map do |mod|
     left = "`#{meth}`"
     right = ''
 
-    if arity > 0
+    if arity.positive?
       left = "`#{meth}`(#{Array.new(arity) { '...' }.join(', ')})"
     else
       begin
         examples, warnings = catch_warnings do
-          Array.new(3) { mod.send meth }
+          Array.new(3) { mod.unique.send meth }
         end
         right = if warnings.any?
                   "#{ICONS[:warning]} *#{warnings.first}*"
                 else
                   (escape examples.join(', ')).to_s
                 end
-      rescue => e
+      rescue StandardError => e
         right = "#{ICONS[:error]} #{e.class}: #{e.message}"
       end
     end

data/test/helper.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 require 'test/unit'
-require 'ffaker'
+require_relative '../lib/ffaker'
 
 # Helpers for checking if a method is deterministic -- e.g., that the Random
 # results are repeatable given the same random seed.
@@ -26,6 +28,41 @@ module DeterministicHelper
     assert(returns.uniq.length == 1, options[:message])
   end
 
+  %w[< > <= >=].each do |operator|
+    operator_name =
+      case operator[0]
+      when '<' then 'less_than'
+      when '>' then 'greater_than'
+      else raise 'Unexpected operator'
+      end
+    operator_name += '_or_equal_to' if operator[1] == '='
+
+    define_method "assert_#{operator_name}" do |got, expected|
+      assert(
+        got.public_send(operator, expected),
+        "Expected #{operator} \"#{expected}\", but got #{got}"
+      )
+    end
+  end
+
+  def assert_between(got, range)
+    assert_greater_than_or_equal_to got, range.begin
+    public_send "assert_less_than#{'_or_equal_to' unless range.exclude_end?}", got, range.end
+  end
+
+  def assert_random(original_block, *args)
+    100.times do
+      yield(*args)
+      assert_deterministic(&original_block)
+    end
+  end
+
+  %w[less_than_or_equal_to between].each do |method_name|
+    define_method "assert_random_#{method_name}" do |*args, &block|
+      assert_random(block) { send "assert_#{method_name}", block.call, *args }
+    end
+  end
+
   # Methods to be called outside of individual examples.
   module ClassMethods
     # Shorthand method to quickly test the determinability of multiple methods.

data/test/test_address.rb

@@ -1,6 +1,6 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
-require 'helper'
+require_relative 'helper'
 
 class TestAddress < Test::Unit::TestCase
   include DeterministicHelper