lib/faker/default/finance.rb



# frozen_string_literal: true

module Faker
  class Finance < Base
    CREDIT_CARD_TYPES = %i[visa mastercard discover american_express
                           diners_club jcb switch solo dankort
                           maestro forbrugsforeningen laser].freeze

    MARKET_LIST = %i[nyse nasdaq].freeze

    class << self
      ##
      # Produces a random credit card number.
      #
      # @param types [String] Specific credit card type.
      # @return [String]
      #
      # @example
      #   Faker::Finance.credit_card #=> "3018-348979-1853"
      #   Faker::Finance.credit_card(:mastercard) #=> "6771-8921-2291-6236"
      #   Faker::Finance.credit_card(:mastercard, :visa) #=> "4448-8934-1277-7195"
      #
      # @faker.version 1.2.0
      def credit_card(*types)
        types = CREDIT_CARD_TYPES if types.empty?
        type = sample(types)
        template = numerify(fetch("finance.credit_card.#{type}"))

        # calculate the luhn checksum digit
        multiplier = 1
        luhn_sum = template.gsub(/[^0-9]/, '').chars.reverse.map(&:to_i).inject(0) do |sum, digit|
          multiplier = (multiplier == 2 ? 1 : 2)
          sum + (digit * multiplier).to_s.chars.map(&:to_i).inject(0) { |digit_sum, cur| digit_sum + cur }
        end

        # the sum plus whatever the last digit is must be a multiple of 10. So, the
        # last digit must be 10 - the last digit of the sum.
        luhn_digit = (10 - (luhn_sum % 10)) % 10

        template.gsub('L', luhn_digit.to_s)
      end

      ##
      # Produces a random vat number.
      #
      # @param country [String] Two capital letter country code to use for the vat number.
      # @return [String]
      #
      # @example
      #   Faker::Finance.vat_number #=> "BR38.395.329/2471-83"
      #   Faker::Finance.vat_number('DE') #=> "DE593306671"
      #   Faker::Finance.vat_number('ZA') #=> "ZA79494416181"
      #
      # @faker.version 1.9.2
      def vat_number(country: 'BR')
        numerify(fetch("finance.vat_number.#{country}"))
      rescue I18n::MissingTranslationData
        raise ArgumentError, "Could not find vat number for #{country}"
      end

      def vat_number_keys
        translate('faker.finance.vat_number').keys
      end

      ##
      # Returns a randomly-selected stock ticker from a specified market.
      #
      # @param markets [String] The name of the market to choose the ticker from (e.g. NYSE, NASDAQ)
      # @return [String]
      #
      # @example
      #   Faker::Finance.ticker #=> 'AMZN'
      #   Faker::Finance.vat_number('NASDAQ') #=> 'GOOG'
      #
      # @faker.version next
      def ticker(*markets)
        markets = MARKET_LIST if markets.empty?
        market = sample(markets)
        fetch("finance.ticker.#{market}")
      rescue I18n::MissingTranslationData
        raise ArgumentError, "Could not find market named #{market}"
      end

      ##
      # Returns a randomly-selected stock market.
      #
      # @return [String]
      #
      # @example
      #   Faker::Finance.stock_market #=> 'NASDAQ'
      #
      # @faker.version next
      def stock_market
        fetch('finance.stock_market')
      end

      ##
      # Returns a random condominium fiscal code.
      #
      # @param country [String] Two capital letter country code to use for the vat number.
      # @return [String]
      #
      # @example
      #   Faker::Finance.condominium_fiscal_code #=> "012345678"
      #
      # @faker.version next
      def condominium_fiscal_code(country: 'IT')
        numerify(fetch("finance.condominium_fiscal_code.#{country}"))
      end
    end
  end
end