ffaker 2.24.0 → 2.25.0

data/lib/ffaker/identification_fi.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module FFaker
+  module IdentificationFI
+    extend ModuleUtils
+    extend self
+
+    CHECK_DIGITS = '0123456789ABCDEFHJKLMNPRSTUVWXY'
+    # Number ranges in real use
+    POSSIBLY_REAL_FEMALE_INDIVIDUAL_NUMBERS = (2..898).step(2).to_a.freeze
+    POSSIBLY_REAL_MALE_INDIVIDUAL_NUMBERS = (3..899).step(2).to_a.freeze
+    # Number ranges not in real use
+    FAKE_FEMALE_INDIVIDUAL_NUMBERS = (900..998).step(2).to_a.freeze
+    FAKE_MALE_INDIVIDUAL_NUMBERS = (901..999).step(2).to_a.freeze
+
+    def identity_number(gender: FFaker::Gender.binary, birthday: FFaker::Date.birthday, fake: true)
+      day = fetch_formatted_day(birthday)
+      month = fetch_formatted_month(birthday)
+      year = fetch_formatted_year(birthday)
+      separator = fetch_separator(birthday)
+      individual_number = fetch_individual_number(gender, fake)
+      check_digit = calculate_check_digit(birthday, individual_number)
+      "#{day}#{month}#{year}#{separator}#{individual_number}#{check_digit}"
+    end
+
+    private
+
+    def fetch_formatted_day(birthday)
+      format('%.2d', birthday.day)
+    end
+
+    def fetch_formatted_month(birthday)
+      format('%.2d', birthday.month)
+    end
+
+    def fetch_formatted_year(birthday)
+      check_birth_year(birthday.year)
+      birthday.strftime('%y')
+    end
+
+    def fetch_separator(birthday)
+      case birthday.year
+      when ..1899
+        '+'
+      when 1900..1999
+        '-'
+      else
+        'A'
+      end
+    end
+
+    def fetch_individual_number(gender, fake)
+      numbers_range = if gender == 'female'
+                        fake ? FAKE_FEMALE_INDIVIDUAL_NUMBERS : POSSIBLY_REAL_FEMALE_INDIVIDUAL_NUMBERS
+                      else
+                        fake ? FAKE_MALE_INDIVIDUAL_NUMBERS : POSSIBLY_REAL_MALE_INDIVIDUAL_NUMBERS
+                      end
+      format('%.3d', fetch_sample(numbers_range))
+    end
+
+    def calculate_check_digit(birthday, individual_number)
+      digit = "#{birthday.day}#{fetch_formatted_month(birthday)}#{fetch_formatted_year(birthday)}#{individual_number}"
+              .to_i % 31
+      CHECK_DIGITS[digit]
+    end
+
+    def check_birth_year(birth_year)
+      return if birth_year.between?(1799, 2100)
+
+      raise ArgumentError, "Birth year: #{birth_year} is not between supported 1799 and 2100 range"
+    end
+  end
+end

data/lib/ffaker/identification_mx.rb

@@ -27,7 +27,7 @@ module FFaker
     def rfc_persona_moral
       consonants_n_amp = CONSONANTS + ['Ñ', '&']
       all_letters = consonants_n_amp + VOWELS
-      [fetch_sample(all_letters, count: 3), date, fetch_sample(HOMOCLAVE, count: 3)].flatten.join
+      [*fetch_sample(all_letters, count: 3), date, *fetch_sample(HOMOCLAVE, count: 3)].join
     end
 
     # http://es.wikipedia.org/wiki/Registro_Federal_de_Contribuyentes_(M%C3%A9xico)

data/lib/ffaker/job_tw.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module FFaker
+  module JobTW
+    extend ModuleUtils
+    extend self
+
+    def title
+      fetch_sample(JOB_NOUNS)
+    end
+  end
+end

data/lib/ffaker/lorem_tw.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module FFaker
+  module LoremTW
+    extend ModuleUtils
+    extend self
+
+    def word
+      fetch_sample(WORDS)
+    end
+
+    def words(num = 3)
+      fetch_sample(WORDS, count: num)
+    end
+
+    def sentence(word_count = 4)
+      s = words(word_count + rand(0..5))
+      s = s.join
+      "#{s},"
+    end
+
+    def sentences(sentence_count = 3)
+      s = (1..sentence_count).map { sentence }
+      def s.to_s
+        result = join(' ')
+        result[-1] = '。'
+        result
+      end
+      s
+    end
+
+    def paragraph(sentence_count = 3)
+      sentences(sentence_count + rand(0..2)).to_s
+    end
+
+    def paragraphs(paragraph_count = 3)
+      (1..paragraph_count).map { paragraph }
+    end
+  end
+end

data/lib/ffaker/tweet.rb

@@ -19,7 +19,7 @@ module FFaker
       }.merge(args)
 
       my_reply = options[:reply] ? "#{mention} " : ''
-      my_mentions = (options[:num_mentions]).positive? ? "#{mentions(options[:num_mentions])} " : ''
+      my_mentions = options[:num_mentions].positive? ? "#{mentions(options[:num_mentions])} " : ''
       my_tags = tags(options[:num_hashtags])
 
       remaining = [

data/lib/ffaker/utils/module_utils.rb

@@ -14,7 +14,7 @@ module FFaker
 
     def const_missing(const_name)
       if const_name.match?(/[a-z]/) # Not a constant, probably a class/module name.
-        super(const_name)
+        super
       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/lib/ffaker/version.rb

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

data/test/test_address_ua.rb

@@ -41,7 +41,7 @@ class TestAddressUA < Test::Unit::TestCase
   end
 
   def test_street_address_with_secondary
-    assert_match( \
+    assert_match(
       /\Aвул\.\s[а-яА-ЯіїєґІЇЄҐ’\-\s]+,\s\d{1,3},\sкв\.\s\d{1,3}\z/,
       @tester.street_address(true)
     )

data/test/test_array_utils.rb

@@ -89,7 +89,7 @@ class TestArrayUtils < Test::Unit::TestCase
 
   private
 
-  # Supress the deprecation warning that some methods output, so we get less
+  # Suppress the deprecation warning that some methods output, so we get less
   # noise in our test run.
   def supress_warn_output
     original_verbosity = $VERBOSE

data/test/test_bank.rb

@@ -7,7 +7,7 @@ class TestBank < Test::Unit::TestCase
 
   assert_methods_are_deterministic(
     FFaker::Bank,
-    :iban, :card_number, :card_expiry_date, :card_type
+    :iban, :card_number, :card_expiry_date, :card_type, :loan_interest_rate, :loan_term, :loan_amount
   )
 
   def setup
@@ -50,4 +50,18 @@ class TestBank < Test::Unit::TestCase
   def test_card_type
     assert_include @tester::CARD_TYPES, @tester.card_type
   end
+
+  def test_loan_interest_rate
+    rate = FFaker::Bank.loan_interest_rate
+    assert(rate.to_f.between?(1.5, 15.0), "Rate #{rate} is out of bounds")
+  end
+
+  def test_loan_term
+    assert_includes([12, 24, 36, 48, 60, 72, 84], FFaker::Bank.loan_term)
+  end
+
+  def test_loan_amount
+    amount = FFaker::Bank.loan_amount
+    assert(amount.between?(1_000, 100_000), "Amount #{amount} is out of bounds")
+  end
 end

data/test/test_boolean.rb

@@ -5,10 +5,41 @@ require_relative 'helper'
 class TestBoolean < Test::Unit::TestCase
   include DeterministicHelper
 
-  assert_methods_are_deterministic(FFaker::Boolean, :maybe)
+  assert_methods_are_deterministic(FFaker::Boolean, :maybe, :boolean)
 
   def test_maybe
     maybe = FFaker::Boolean.maybe
     assert [true, false].include?(maybe)
   end
+
+  def test_boolean_with_default_ratio
+    true_count = 0
+    1000.times do
+      true_count += 1 if FFaker::Boolean.boolean
+    end
+    assert_in_delta 0.5, true_count / 1000.0, 0.1
+  end
+
+  def test_boolean_with_true_ratio
+    true_ratio = 0.8
+    true_count = 0
+    1000.times do
+      true_count += 1 if FFaker::Boolean.boolean(true_ratio: true_ratio)
+    end
+    assert_in_delta true_ratio, true_count / 1000.0, 0.1
+  end
+
+  def test_boolean_with_true_ratio_zero
+    true_ratio = 0
+    100.times do
+      assert_equal false, FFaker::Boolean.boolean(true_ratio: true_ratio)
+    end
+  end
+
+  def test_boolean_with_true_ratio_one
+    true_ratio = 1
+    100.times do
+      assert_equal true, FFaker::Boolean.boolean(true_ratio: true_ratio)
+    end
+  end
 end

data/test/test_date.rb

@@ -22,16 +22,16 @@ class TestFakerDate < Test::Unit::TestCase
   def test_backward
     today = Date.today
 
-    assert_random_between(today - 365..today - 1) { @tester.backward }
-    assert_random_between(today - 30..today - 1) { @tester.backward(30) }
+    assert_random_between((today - 365)..(today - 1)) { @tester.backward }
+    assert_random_between((today - 30)..(today - 1)) { @tester.backward(30) }
     assert_instance_of Date, @tester.backward
   end
 
   def test_forward
     today = Date.today
 
-    assert_random_between(today + 1..today + 365) { @tester.forward }
-    assert_random_between(today + 1..today + 30) { @tester.forward(30) }
+    assert_random_between((today + 1)..(today + 365)) { @tester.forward }
+    assert_random_between((today + 1)..(today + 30)) { @tester.forward(30) }
     assert_instance_of Date, @tester.forward
   end
 

data/test/test_identification_fi.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative 'helper'
+
+class TestFakerIdentificationFI < Test::Unit::TestCase
+  include DeterministicHelper
+
+  assert_methods_are_deterministic(
+    FFaker::IdentificationFI,
+    :identity_number
+  )
+
+  def setup
+    @tester = FFaker::IdentificationFI
+  end
+
+  def test_identity_number
+    general_regex = /^(0[1-9]|[1-2]\d|3[01])(0[1-9]|1[0-2])(\d\d)([-+A-FU-Y])(\d\d\d)([0-9A-FHJ-NPR-Y])$/
+    assert_match(general_regex, @tester.identity_number)
+    random_far_past_date = rand(Date.civil(1700)..Date.civil(1800))
+    assert_raises ArgumentError do
+      @tester.identity_number(birthday: random_far_past_date)
+    end
+    random_far_future_date = rand(Date.civil(2100)..Date.civil(2200))
+    assert_raises ArgumentError do
+      @tester.identity_number(birthday: random_far_future_date)
+    end
+    date_match_regex = /^010100A(\d\d\d)([0-9A-FHJ-NPR-Y])$/
+    assert_match(date_match_regex, @tester.identity_number(birthday: Date.civil(2000, 1, 1)))
+    fake_number_match_regex = /^(0[1-9]|[1-2]\d|3[01])(0[1-9]|1[0-2])(\d\d)([-+A-FU-Y])9(\d\d)([0-9A-FHJ-NPR-Y])$/
+    assert_match(fake_number_match_regex, @tester.identity_number(fake: true))
+    real_number_match_regex = /^(0[1-9]|[1-2]\d|3[01])(0[1-9]|1[0-2])(\d\d)([-+A-FU-Y])([0-8])(\d\d)([0-9A-FHJ-NPR-Y])$/
+    assert_match(real_number_match_regex, @tester.identity_number(fake: false))
+    female_match_regex = /^(0[1-9]|[1-2]\d|3[01])(0[1-9]|1[0-2])(\d\d)([-+A-FU-Y])(\d\d)([02468])([0-9A-FHJ-NPR-Y])$/
+    assert_match(female_match_regex, @tester.identity_number(gender: 'female'))
+    male_match_regex = /^(0[1-9]|[1-2]\d|3[01])(0[1-9]|1[0-2])(\d\d)([-+A-FU-Y])(\d\d)([13579])([0-9A-FHJ-NPR-Y])$/
+    assert_match(male_match_regex, @tester.identity_number(gender: 'male'))
+  end
+end

data/test/test_job_tw.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative 'helper'
+
+class TestFakerJobTW < Test::Unit::TestCase
+  include DeterministicHelper
+
+  assert_methods_are_deterministic(FFaker::JobTW, :title)
+
+  def setup
+    @tester = FFaker::JobTW
+  end
+
+  def test_title
+    assert_greater_than_or_equal_to @tester.title.length, 1
+  end
+
+  def test_nouns
+    assert_kind_of Array, @tester::JOB_NOUNS
+  end
+end

data/test/test_lorem_br.rb

@@ -10,9 +10,9 @@ class TestLoremBR < Test::Unit::TestCase
     :paragraph, :sentence, :phrase, :paragraphs, :sentences, :phrases, :words, :word, :characters
   )
 
-  CHARACTERS = /\A[A-zÀ-ü0-9]+\z/i
-  WORD = /\A[A-zÀ-ü-]+\z/i
-  WORDS = /[ A-zÀ-ü\-.]+/i
+  CHARACTERS = /\A[A-Za-zÀ-ü0-9]+\z/i
+  WORD = /\A[A-Za-zÀ-ü-]+\z/i
+  WORDS = /[ A-Za-zÀ-ü\-.]+/i
 
   def test_paragraph
     assert_match(WORDS, FFaker::LoremBR.paragraph)

data/test/test_lorem_tw.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require_relative 'helper'
+
+class TestLoremTW < Test::Unit::TestCase
+  include DeterministicHelper
+
+  assert_methods_are_deterministic(
+    FFaker::LoremTW,
+    :paragraph, :paragraphs, :sentence, :sentences, :word, :words
+  )
+
+  def test_paragraph
+    assert_greater_than_or_equal_to FFaker::LoremTW.paragraph.length, 3 * 4 * 2
+  end
+
+  def test_sentence
+    assert_greater_than_or_equal_to FFaker::LoremTW.sentence.length, 4 * 2
+  end
+
+  def test_paragraphs
+    assert_greater_than_or_equal_to FFaker::LoremTW.paragraphs.length, 2
+  end
+
+  def test_paragraphs_is_not_a_string_representation_of_an_array
+    assert !/[\[\]]+/.match([FFaker::LoremTW.paragraphs].flatten.join(' '))
+  end
+
+  def test_paragraphs_is_an_array
+    assert FFaker::LoremTW.paragraphs.instance_of?(Array)
+  end
+
+  def test_sentences
+    assert_greater_than_or_equal_to FFaker::LoremTW.sentences.length, 2
+  end
+
+  def test_sentences_is_an_array
+    assert FFaker::LoremTW.sentences.instance_of?(Array)
+  end
+
+  def test_sentences_via_to_s_produces_string_terminated_with_period
+    string = FFaker::LoremTW.sentences.to_s
+    assert string.instance_of?(String)
+    assert string =~ /。$/
+  end
+
+  def test_words
+    assert_greater_than_or_equal_to FFaker::LoremTW.words.length, 2
+  end
+
+  def test_word
+    assert_greater_than_or_equal_to FFaker::LoremTW.word.length, 1
+  end
+end

data/test/test_music.rb

@@ -11,18 +11,18 @@ class TestMusic < Test::Unit::TestCase
   )
 
   def test_genre
-    assert_match(%r{[A-z]|\W|&/+}, FFaker::Music.genre)
+    assert_match(%r{[A-Za-z]|\W|&/+}, FFaker::Music.genre)
   end
 
   def test_album
-    assert_match(/\s|[A-z]|\W|\d|'|\?+/, FFaker::Music.album)
+    assert_match(/\s|[A-Za-z]|\W|\d|'|\?+/, FFaker::Music.album)
   end
 
   def test_artist
-    assert_match(/\s|[A-z]|\W|\d|'|\?|&|\+|\.|-+/, FFaker::Music.artist)
+    assert_match(/\s|[A-Za-z]|\W|\d|'|\?|&|\+|\.|-+/, FFaker::Music.artist)
   end
 
   def test_song
-    assert_match(/\s|[A-z]|\W|\d|'|\?|&|\+|\.|-+/, FFaker::Music.song)
+    assert_match(/\s|[A-Za-z]|\W|\d|'|\?|&|\+|\.|-+/, FFaker::Music.song)
   end
 end

data/test/test_number.rb

@@ -13,7 +13,7 @@ class TestNumber < Test::Unit::TestCase
 
   def test_number
     assert @tester.number.is_a?(Integer)
-    assert @tester.number.digits.count == 1
+    assert @tester.number.digits.one?
     assert @tester.number(digits: 3).digits.count == 3
     assert_match(/\d/, @tester.number.to_s)
     assert_match(/\d{3}/, @tester.number(digits: 3).to_s)

data/test/test_ssn_se.rb

@@ -24,7 +24,7 @@ class TestSSNSE < Test::Unit::TestCase
     assert equal?(ssn_female[10].to_i)
 
     assert_raise ArgumentError do
-      FFaker::SSNSE.ssn(gender: :unkown)
+      FFaker::SSNSE.ssn(gender: :unknown)
     end
   end
 

data/test/test_vehicle.rb

@@ -94,7 +94,6 @@ class TestVehicle < Test::Unit::TestCase
     end
 
     check_digit = weighted_sum % 11
-    check_digit == '10' ? 'X' : check_digit
     check_digit = 'X' if check_digit == 10
     check_digit.to_s
   end

metadata

@@ -1,24 +1,23 @@
 --- !ruby/object:Gem::Specification
 name: ffaker
 version: !ruby/object:Gem::Version
-  version: 2.24.0
+  version: 2.25.0
 platform: ruby
 authors:
 - https://github.com/ffaker/ffaker/graphs/contributors
 - Emmanuel Oga
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Ffaker generates dummy data.
 email: EmmanuelOga@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.md
-- LICENSE
 - Changelog.md
+- LICENSE
+- README.md
 files:
 - Changelog.md
 - Gemfile
@@ -280,6 +279,7 @@ files:
 - lib/ffaker/data/job_it/job_prefix
 - lib/ffaker/data/job_ja/job_nouns
 - lib/ffaker/data/job_kr/job_nouns
+- lib/ffaker/data/job_tw/job_nouns
 - lib/ffaker/data/job_vn/job_nouns
 - lib/ffaker/data/locale/language
 - lib/ffaker/data/locale/language_code
@@ -306,6 +306,7 @@ files:
 - lib/ffaker/data/lorem_ru/capital_chars
 - lib/ffaker/data/lorem_ru/chars
 - lib/ffaker/data/lorem_ru/words
+- lib/ffaker/data/lorem_tw/words
 - lib/ffaker/data/lorem_ua/capital_chars
 - lib/ffaker/data/lorem_ua/chars
 - lib/ffaker/data/lorem_ua/words
@@ -481,6 +482,7 @@ files:
 - lib/ffaker/identification_es.rb
 - lib/ffaker/identification_es_cl.rb
 - lib/ffaker/identification_es_co.rb
+- lib/ffaker/identification_fi.rb
 - lib/ffaker/identification_in.rb
 - lib/ffaker/identification_it.rb
 - lib/ffaker/identification_kr.rb
@@ -498,6 +500,7 @@ files:
 - lib/ffaker/job_it.rb
 - lib/ffaker/job_ja.rb
 - lib/ffaker/job_kr.rb
+- lib/ffaker/job_tw.rb
 - lib/ffaker/job_vn.rb
 - lib/ffaker/locale.rb
 - lib/ffaker/lorem.rb
@@ -511,6 +514,7 @@ files:
 - lib/ffaker/lorem_kr.rb
 - lib/ffaker/lorem_pl.rb
 - lib/ffaker/lorem_ru.rb
+- lib/ffaker/lorem_tw.rb
 - lib/ffaker/lorem_ua.rb
 - lib/ffaker/movie.rb
 - lib/ffaker/music.rb
@@ -688,6 +692,7 @@ files:
 - test/test_identification_es.rb
 - test/test_identification_es_cl.rb
 - test/test_identification_es_mx.rb
+- test/test_identification_fi.rb
 - test/test_identification_in.rb
 - test/test_identification_it.rb
 - test/test_identification_kr.rb
@@ -704,6 +709,7 @@ files:
 - test/test_job_it.rb
 - test/test_job_ja.rb
 - test/test_job_kr.rb
+- test/test_job_tw.rb
 - test/test_job_vn.rb
 - test/test_locale.rb
 - test/test_lorem.rb
@@ -717,6 +723,7 @@ files:
 - test/test_lorem_kr.rb
 - test/test_lorem_pl.rb
 - test/test_lorem_ru.rb
+- test/test_lorem_tw.rb
 - test/test_lorem_ua.rb
 - test/test_module_utils.rb
 - test/test_movie.rb
@@ -800,7 +807,6 @@ metadata:
   changelog_uri: https://github.com/ffaker/ffaker/blob/main/Changelog.md
   documentation_uri: https://github.com/ffaker/ffaker/blob/main/REFERENCE.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options:
 - "--charset=UTF-8"
 require_paths:
@@ -809,15 +815,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.8
 specification_version: 4
 summary: Ffaker generates dummy data.
 test_files: []