ffakerTW 0.1.0

data/lib/ffakerTW/utils/array_utils.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative 'random_utils'
+
+module FFakerTW
+  module ArrayUtils
+    extend RandomUtils
+
+    def self.const_array(argument)
+      array = argument.is_a?(Array) ? argument : argument.to_a
+      array.extend ArrayUtils
+      freeze_all(array)
+    end
+
+    def self.random_pick(array, num)
+      warn '[ArrayUtils.random_pick] is deprecated. Please use the ModuleUtils#fetch_sample method'
+      fetch_sample(array, count: num)
+    end
+
+    def self.rand(array)
+      warn '[ArrayUtils.rand] is deprecated. Please use the ModuleUtils#fetch_sample method'
+      fetch_sample(array)
+    end
+
+    def self.freeze_all(array)
+      array.each(&:freeze)
+      array.freeze
+      array
+    end
+
+    def self.shuffle(array)
+      array.sort_by { FFakerTW::Random.rand }
+    end
+
+    def random_pick(num)
+      warn '[ArrayUtils#random_pick] is deprecated. Please use the ModuleUtils#fetch_sample method'
+      ArrayUtils.random_pick(self, num)
+    end
+
+    def rand
+      warn '[ArrayUtils#rand] is deprecated. Please use the ModuleUtils#fetch_sample method'
+      ArrayUtils.rand(self)
+    end
+
+    def freeze_all
+      ArrayUtils.freeze_all(self)
+    end
+
+    def shuffle
+      ArrayUtils.shuffle(self)
+    end
+  end
+end

data/lib/ffakerTW/utils/module_utils.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative 'array_utils'
+require_relative 'random_utils'
+require_relative 'unique_utils'
+
+module FFakerTW
+  module ModuleUtils
+    include RandomUtils
+
+    def k(arg)
+      FFakerTW::ArrayUtils.const_array(arg)
+    end
+
+    def const_missing(const_name)
+      if const_name =~ /[a-z]/ # Not a constant, probably a class/module name.
+        super const_name
+      else
+        mod_name = ancestors.first.to_s.split('::').last
+        data_path = "#{FFakerTW::BASE_LIB_PATH}/ffaker/data/#{underscore(mod_name)}/#{underscore(const_name.to_s)}"
+        data = k File.read(data_path, mode: 'r:UTF-8').split("\n")
+        const_set const_name, data
+        data
+      end
+    end
+
+    def underscore(string)
+      string.gsub(/::/, '/')
+            .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+            .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+            .tr('-', '_')
+            .downcase
+    end
+
+    def unique(max_retries = 10_000)
+      @unique_generator ||= FFakerTW::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/ffakerTW/utils/random_utils.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module FFakerTW
+  # Methods for returning repeatably-random data using the internal
+  # Random Number Generator. You should not need to use this directly, it is
+  # automatically included when you `include ModuleUtils` in a FFakerTW module.
+  module RandomUtils
+    # Returns a randon number from the internal Random Number Generator. Can be
+    # used in place of `rand` or `Kernal.rand`.
+    def rand(max = nil)
+      FFakerTW::Random.rand(max)
+    end
+
+    # Performs Array#sample on `list` using a the internal Random Number
+    # Generator so that the results are deterministic.
+    #
+    # * Returns one random item from `list`.
+    # * Pass `count: n` in options argument, where `n` is an integer, to
+    # return *n* items from `list`
+    def fetch_sample(list, options = {})
+      if (count = options.delete(:count))
+        list.sample(count, random: FFakerTW::Random)
+      elsif list.is_a?(Range)
+        FFakerTW::Random.rand(list)
+      else
+        list.sample(random: FFakerTW::Random)
+      end
+    end
+
+    # Performs same action as as `Array#suffle` (returns a randomly-reordered
+    # copy of `list`) except that it uses the internal Random Number Generator
+    # so that the results are deterministic.
+    def shuffle(list)
+      list.shuffle(random: FFakerTW::Random)
+    end
+  end
+end

data/lib/ffakerTW/utils/unique_utils.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+require 'set'
+
+module FFakerTW
+  class UniqueUtils
+    def initialize(generator, max_retries)
+      @generator = generator
+      @max_retries = max_retries
+      @previous_results = Hash.new { |hash, key| hash[key] = Set.new }
+    end
+
+    def method_missing(name, *arguments)
+      @generator.respond_to?(name) ? add_results_to_hash(name, *arguments) : super
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      super
+    end
+
+    RetryLimitExceeded = Class.new(StandardError)
+
+    def clear
+      @previous_results.clear
+    end
+
+    def self.clear
+      ObjectSpace.each_object(self, &:clear)
+    end
+
+    private
+
+    def add_results_to_hash(name, *arguments)
+      @max_retries.times do
+        result = @generator.send(name, *arguments)
+
+        next if @previous_results[[name, arguments]].include?(result)
+
+        @previous_results[[name, arguments]] << result
+        return result
+      end
+      raise RetryLimitExceeded
+    end
+  end
+end

data/lib/ffakerTW/vehicle.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module FFakerTW
+  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
+          FFakerTW.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 = Array('1900'..(::Time.now.year + 1).to_s).freeze
+    TRANSMISSIONS_ABBR = %w[AT MT AM CVT].freeze
+    CYLINDERS = %w[2 5 6 8].freeze
+
+    def base_color
+      FFakerTW::Color.name
+    end
+
+    def drivetrain
+      fetch_sample(DRIVETRAINS)
+    end
+
+    def make
+      fetch_sample(MAKES_LIST)
+    end
+
+    def manufacturer_color(count = 2)
+      # Take two prefixes because it's more fun than one
+      (fetch_sample(COLOR_PREFIXES, count: count) + [base_color]).join(' ')
+    end
+    alias mfg_color manufacturer_color
+
+    def model
+      fetch_sample(MODELS_LIST)
+    end
+
+    def trim
+      fetch_sample(TRIMS_LIST)
+    end
+
+    def vin
+      VIN.vin
+    end
+
+    def year
+      fetch_sample(YEARS)
+    end
+
+    def transmission
+      fetch_sample(TRANSMISSIONS_LIST)
+    end
+
+    def transmission_abbr
+      fetch_sample(TRANSMISSIONS_ABBR)
+    end
+
+    def engine_cylinders
+      fetch_sample(CYLINDERS)
+    end
+
+    def engine_displacement
+      fetch_sample(DISPLACEMENTS_LIST)
+    end
+
+    def fuel_type
+      fetch_sample(FUEL_TYPES_LIST)
+    end
+
+    def interior_upholstery
+      fetch_sample(UPHOLSTERY_LIST)
+    end
+  end
+end

data/lib/ffakerTW/venue.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module FFakerTW
+  module Venue
+    extend ModuleUtils
+    extend self
+
+    def name
+      fetch_sample(VENUE_LIST)
+    end
+  end
+end

data/lib/ffakerTW/version.rb

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

data/lib/ffakerTW/youtube.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module FFakerTW
+  module Youtube
+    extend ModuleUtils
+    extend self
+
+    def url
+      "www.youtube.com/watch?v=#{video_id}"
+    end
+
+    def share_url
+      "youtu.be/#{video_id}"
+    end
+
+    def embed_url
+      "www.youtube.com/embed/#{video_id}"
+    end
+
+    def video_id
+      fetch_sample(VIDEO_IDS)
+    end
+  end
+end

data/lib/ffakerTW.rb

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

data/lib/version.rb

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

data/scripts/benchmark.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'benchmark'
+
+NAMES_COUNT = 10_000
+
+def run(name)
+  Benchmark.bm do |rep|
+    rep.report("generating #{NAMES_COUNT} names (#{name})") do
+      mod = name == 'ffakertw' ? FFakerTW : Faker
+      NAMES_COUNT.times { mod::Name.name }
+    end
+  end
+end
+
+%w[faker ffakerTW].each do |gem_name|
+  require gem_name
+
+  fork { run(gem_name) }
+  Process.wait
+end

data/scripts/profile.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+ruby-prof -pcall_tree -fprofile.data profiling.rb

data/scripts/profiling.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative '../lib/faker'
+
+N = 1_000_000
+
+N.times do
+  FFakerTW::Name.name
+end