class Faker::IDNumber
Constants
- BRAZILIAN_ID_FORMAT
- BRAZILIAN_ID_FROM
- BRAZILIAN_ID_TO
- CHECKS
- CHILEAN_MODULO
- INVALID_SSN
- ZA_CITIZENSHIP_DIGITS
- ZA_RACE_DIGIT
Public Class Methods
Produces a random Brazilian Citizen Number
(CPF).
@param formatted [Boolean] Specifies if the number is formatted with dividers. @return [String]
@example
Faker::IDNumber.brazilian_citizen_number #=> "53540542221" Faker::IDNumber.brazilian_citizen_number(formatted: true) #=> "535.405.422-21"
@faker.version 1.9.2
# File lib/faker/default/id_number.rb, line 149 def brazilian_citizen_number(legacy_formatted = NOT_GIVEN, formatted: false) warn_for_deprecated_arguments do |keywords| keywords << :formatted if legacy_formatted != NOT_GIVEN end digits = Faker::Number.leading_zero_number(digits: 9) until digits&.match(/(\d)((?!\1)\d)+/) first_digit = brazilian_citizen_number_checksum_digit(digits) second_digit = brazilian_citizen_number_checksum_digit(digits + first_digit) number = [digits, first_digit, second_digit].join formatted ? format('%s.%s.%s-%s', *number.scan(/\d{2,3}/).flatten) : number end
Produces a random Brazilian ID Number
(RG).
@param formatted [Boolean] Specifies if the number is formatted with dividers. @return [String]
@example
Faker::IDNumber.brazilian_id #=> "493054029" Faker::IDNumber.brazilian_id(formatted: true) #=> "49.305.402-9"
@faker.version 2.1.2
# File lib/faker/default/id_number.rb, line 174 def brazilian_id(legacy_formatted = NOT_GIVEN, formatted: false) warn_for_deprecated_arguments do |keywords| keywords << :formatted if legacy_formatted != NOT_GIVEN end digits = Faker::Number.between(to: BRAZILIAN_ID_FROM, from: BRAZILIAN_ID_TO).to_s check_digit = brazilian_id_checksum_digit(digits) number = [digits, check_digit].join formatted ? format('%s.%s.%s-%s', *number.scan(BRAZILIAN_ID_FORMAT).flatten) : number end
Produces a random Chilean ID (Rut with 8 digits).
@return [String]
@example
Faker::IDNumber.chilean_id #=> "15620613-K"
@faker.version 2.1.2
# File lib/faker/default/id_number.rb, line 196 def chilean_id digits = Faker::Number.number(digits: 8) verification_code = chilean_verification_code(digits) "#{digits}-#{verification_code}" end
Produces a random Croatian ID number (OIB).
@param international [Boolean] Specifies whether to add international prefix. @return [String]
@example
Faker::IDNumber.croatian_id #=> "88467617508" Faker::IDNumber.croatian_id(international: true) #=> "HR88467617508"
@faker.version next
# File lib/faker/default/id_number.rb, line 214 def croatian_id(international: false) prefix = international ? 'HR' : '' digits = Faker::Number.number(digits: 10).to_s checksum_digit = croatian_id_checksum_digit(digits) "#{prefix}#{digits}#{checksum_digit}" end
Produces a random invalid US Social Security number.
@return [String]
@example
Faker::IDNumber.invalid #=> "311-72-0000"
@faker.version 1.6.0
# File lib/faker/default/id_number.rb, line 44 def invalid _translate('invalid') end
Produces a random invalid South African ID Number
.
@return [String]
@example
Faker::IDNumber.invalid_south_african_id_number #=> "1642972065088"
@faker.version 1.9.2
# File lib/faker/default/id_number.rb, line 121 def invalid_south_african_id_number invalid_date_of_birth = [ Faker::Number.number(digits: 2), Faker::Number.between(from: 13, to: 99), Faker::Number.between(from: 32, to: 99) ].map(&:to_s).join id_number = [ invalid_date_of_birth, Faker::Number.number(digits: 4), ZA_CITIZENSHIP_DIGITS.sample(random: Faker::Config.random), ZA_RACE_DIGIT ].join [id_number, south_african_id_checksum_digit(id_number)].join end
Produces a random Spanish citizen identifier (DNI).
@return [String]
@example
Faker::IDNumber.spanish_citizen_number #=> "53290236-H"
@faker.version 1.9.0
# File lib/faker/default/id_number.rb, line 63 def spanish_citizen_number num = Faker::Number.number(digits: 8) mod = num.to_i % 23 check = CHECKS[mod] "#{num}-#{check}" end
Produces a random Spanish foreign born citizen identifier (NIE).
@return [String]
@example
Faker::IDNumber.spanish_foreign_citizen_number #=> "Z-1600870-Y"
@faker.version 1.9.0
# File lib/faker/default/id_number.rb, line 79 def spanish_foreign_citizen_number code = 'XYZ' digits = Faker::Number.number(digits: 7) prefix = code[rand(code.length)] prefix_val = 'XYZ'.index(prefix).to_s mod = "#{prefix_val}#{digits}".to_i % 23 check = CHECKS[mod] "#{prefix}-#{digits}-#{check}" end
# File lib/faker/default/id_number.rb, line 48 def ssn_valid ssn = regexify(/[0-8]\d{2}-\d{2}-\d{4}/) # We could still have all 0s in one segment or another INVALID_SSN.any? { |regex| regex =~ ssn } ? ssn_valid : ssn end
Produces a random valid US Social Security number.
@return [String]
@example
Faker::IDNumber.valid #=> "552-56-3593"
@faker.version 1.6.0
# File lib/faker/default/id_number.rb, line 31 def valid _translate('valid') end
Produces a random valid South African ID Number
.
@return [String]
@example
Faker::IDNumber.south_african_id_number #=> "8105128870184" Faker::IDNumber.valid_south_african_id_number #=> "8105128870184"
@faker.version 1.9.2
# File lib/faker/default/id_number.rb, line 99 def valid_south_african_id_number id_number = [ Faker::Date.birthday.strftime('%y%m%d'), Faker::Number.number(digits: 4), ZA_CITIZENSHIP_DIGITS.sample(random: Faker::Config.random), ZA_RACE_DIGIT ].join [id_number, south_african_id_checksum_digit(id_number)].join end
Private Class Methods
# File lib/faker/default/id_number.rb, line 308 def _translate(key) parse("id_number.#{key}") end
# File lib/faker/default/id_number.rb, line 277 def brazilian_citizen_number_checksum_digit(digits) checksum = brazilian_document_checksum(digits) brazilian_document_digit(checksum) end
# File lib/faker/default/id_number.rb, line 298 def brazilian_citizen_number_digit(remainder) remainder == 10 ? '0' : remainder.to_s end
# File lib/faker/default/id_number.rb, line 287 def brazilian_document_checksum(digits) digits.chars.each_with_index.inject(0) do |acc, (digit, i)| acc + digit.to_i * (digits.size + 1 - i) end * 10 end
# File lib/faker/default/id_number.rb, line 293 def brazilian_document_digit(checksum, id: false) remainder = checksum % 11 id ? brazilian_id_digit(remainder) : brazilian_citizen_number_digit(remainder) end
# File lib/faker/default/id_number.rb, line 282 def brazilian_id_checksum_digit(digits) checksum = brazilian_document_checksum(digits) brazilian_document_digit(checksum, id: true) end
# File lib/faker/default/id_number.rb, line 302 def brazilian_id_digit(remainder) subtraction = 11 - remainder.to_i digits = { 10 => 'X', 11 => '0' } digits.include?(subtraction) ? digits[subtraction] : subtraction.to_s end
# File lib/faker/default/id_number.rb, line 239 def chilean_verification_code(digits) # First digit is multiplied by 3, second by 2, and so on multiplication_rule = [3, 2, 7, 6, 5, 4, 3, 2] digits_splitted = digits.to_s.chars.map(&:to_i) sum = digits_splitted.map.with_index { |digit, index| digit * multiplication_rule[index] }.reduce(:+) modulo = sum.modulo(CHILEAN_MODULO) difference = CHILEAN_MODULO - modulo case difference when 0..9 difference when 10 'K' when 11 0 end end
# File lib/faker/default/id_number.rb, line 224 def croatian_id_checksum_digit(digits) control_sum = 10 digits.chars.map(&:to_i).each do |digit| control_sum += digit control_sum %= 10 control_sum = 10 if control_sum.zero? control_sum *= 2 control_sum %= 11 end control_sum = 11 - control_sum control_sum % 10 end
# File lib/faker/default/id_number.rb, line 259 def south_african_id_checksum_digit(id_number) value_parts = id_number.chars even_digits = value_parts .select .with_index { |_, i| (i + 1).even? } odd_digits_without_last_character = value_parts[0...-1] .select .with_index { |_, i| (i + 1).odd? } sum_of_odd_digits = odd_digits_without_last_character.map(&:to_i).reduce(:+) even_digits_times_two = (even_digits.join('').to_i * 2).to_s sum_of_even_digits = even_digits_times_two.chars.map(&:to_i).reduce(:+) total_sum = sum_of_odd_digits + sum_of_even_digits ((10 - (total_sum % 10)) % 10).to_s end