faker 2.6.0

data/lib/faker/default/demographic.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Faker
+  class Demographic < Base
+    class << self
+      def race
+        fetch('demographic.race')
+      end
+
+      def educational_attainment
+        fetch('demographic.educational_attainment')
+      end
+
+      def demonym
+        fetch('demographic.demonym')
+      end
+
+      def marital_status
+        fetch('demographic.marital_status')
+      end
+
+      def sex
+        fetch('demographic.sex')
+      end
+
+      def height(legacy_unit = NOT_GIVEN, unit: :metric)
+        warn_for_deprecated_arguments do |keywords|
+          keywords << :unit if legacy_unit != NOT_GIVEN
+        end
+
+        case unit
+        when :imperial
+          inches = rand_in_range(57, 86)
+          "#{inches / 12} ft, #{inches % 12} in"
+        when :metric
+          rand_in_range(1.45, 2.13).round(2).to_s
+        end
+      end
+    end
+  end
+end

data/lib/faker/default/dessert.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Faker
+  class Dessert < Base
+    flexible :dessert
+
+    class << self
+      ##
+      # Produces the name of a dessert variety.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Dessert.variety #=> "Cake"
+      #
+      # @faker.version 1.8.0
+      def variety
+        fetch('dessert.variety')
+      end
+
+      ##
+      # Produces the name of a dessert topping.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Dessert.topping #=> "Gummy Bears"
+      #
+      # @faker.version 1.8.0
+      def topping
+        fetch('dessert.topping')
+      end
+
+      ##
+      # Produces the name of a dessert flavor.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Dessert.flavor #=> "Salted Caramel"
+      #
+      # @faker.version 1.8.0
+      def flavor
+        fetch('dessert.flavor')
+      end
+    end
+  end
+end

data/lib/faker/default/device.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Faker
+  class Device < Base
+    class << self
+      ##
+      # Produces a build number between 1 and 500.
+      #
+      # @return [Integer]
+      #
+      # @example
+      #   Faker::Device.build_number #=> 5
+      #
+      # @faker.version 1.9.0
+      def build_number
+        Faker::Number.between(from: 1, to: 500)
+      end
+
+      ##
+      # Produces the name of a manufacturer for a device.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Device.manufacturer #=> "Apple"
+      #
+      # @faker.version 1.9.0
+      def manufacturer
+        fetch('device.manufacturer')
+      end
+
+      ##
+      # Produces a model name for a device.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Device.model_name #=> "iPhone 4"
+      #
+      # @faker.version 1.9.0
+      def model_name
+        fetch('device.model_name')
+      end
+
+      ##
+      # Produces the name of a platform for a device.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Device.platform #=> "webOS"
+      #
+      # @faker.version 1.9.0
+      def platform
+        fetch('device.platform')
+      end
+
+      ##
+      # Produces a serial code for a device.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Device.serial #=> "ejfjnRNInxh0363JC2WM"
+      #
+      # @faker.version 1.9.0
+      def serial
+        fetch('device.serial')
+      end
+
+      ##
+      # Produces a version number between 1 and 1000.
+      #
+      # @return [Integer]
+      #
+      # @example
+      #   Faker::Device.version #=> 42
+      #
+      # @faker.version 1.9.0
+      def version
+        Faker::Number.between(from: 1, to: 1000)
+      end
+    end
+  end
+end

data/lib/faker/default/driving_licence.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Faker
+  class DrivingLicence < Base
+    GB_PADDING = '9999'
+    NI_CHANCE = 0.03 # NI Pop is about 3% of total UK population
+
+    class << self
+      # rubocop:disable Metrics/ParameterLists
+      def british_driving_licence(legacy_last_name = NOT_GIVEN, legacy_initials = NOT_GIVEN, legacy_gender = NOT_GIVEN, legacy_date_of_birth = NOT_GIVEN, last_name: Faker::Name.last_name, initials: Faker::Name.initials, gender: random_gender, date_of_birth: Faker::Date.birthday(min_age: 18, max_age: 65))
+        # rubocop:enable Metrics/ParameterLists
+        warn_for_deprecated_arguments do |keywords|
+          keywords << :last_name if legacy_last_name != NOT_GIVEN
+          keywords << :initials if legacy_initials != NOT_GIVEN
+          keywords << :gender if legacy_gender != NOT_GIVEN
+          keywords << :date_of_birth if legacy_date_of_birth != NOT_GIVEN
+        end
+
+        [
+          gb_licence_padding(last_name, 5),
+          gb_licence_year(date_of_birth, gender),
+          gb_licence_padding(initials, 2),
+          gb_licence_checksum
+        ].join
+      end
+
+      def northern_irish_driving_licence
+        Faker::Number.number(digits: 8).to_s
+      end
+
+      def uk_driving_licence(*args)
+        if Faker::Config.random.rand < NI_CHANCE
+          northern_irish_driving_licence
+        else
+          british_driving_licence(*args)
+        end
+      end
+
+      private
+
+      def random_gender
+        %i[male female].sample(random: Faker::Config.random)
+      end
+
+      def gb_licence_padding(str, num_chars)
+        prepped = str.upcase.gsub(%r{[^A-Z]}, '') + GB_PADDING
+        prepped[0..(num_chars - 1)]
+      end
+
+      def gb_licence_year(dob, gender)
+        decade = (dob.year / 10) % 10
+        year = dob.year % 10
+        month = gender == :female ? dob.month + 50 : dob.month
+        # Rubocop's preferred formatting is pretty gory
+        # rubocop:disable Style/FormatString
+        "#{decade}#{'%02d' % month}#{'%02d' % dob.day}#{year}"
+        # rubocop:enable Style/FormatString
+      end
+
+      def gb_licence_checksum
+        regexify(/[0-9][A-Z][A-Z]/)
+      end
+    end
+  end
+end

data/lib/faker/default/educator.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Faker
+  class Educator < Base
+    flexible :educator
+
+    class << self
+      def university
+        "#{parse('educator.name')} #{fetch('educator.tertiary.type')}"
+      end
+
+      def degree
+        "#{fetch('educator.tertiary.degree.type')} #{fetch('educator.tertiary.degree.subject')}"
+      end
+
+      alias course degree
+
+      def subject
+        fetch('educator.tertiary.degree.subject')
+      end
+
+      def course_name
+        "#{fetch('educator.tertiary.degree.subject')} #{numerify(fetch('educator.tertiary.degree.course_number'))}"
+      end
+
+      def secondary_school
+        "#{parse('educator.name')} #{fetch('educator.secondary')}"
+      end
+
+      def campus
+        "#{parse('educator.name')} Campus"
+      end
+    end
+  end
+end

data/lib/faker/default/electrical_components.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Faker
+  class ElectricalComponents < Base
+    flexible :electrical_components
+
+    class << self
+      ##
+      # Produces an active electrical component.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::ElectricalComponents.active #=> "Transistor"
+      #
+      # @faker.version 1.9.0
+      def active
+        fetch('electrical_components.active')
+      end
+
+      ##
+      # Produces a passive electrical component.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::ElectricalComponents.passive #=> "Resistor"
+      #
+      # @faker.version 1.9.0
+      def passive
+        fetch('electrical_components.passive')
+      end
+
+      ##
+      # Produces an electromechanical electrical component.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::ElectricalComponents.electromechanical #=> "Toggle Switch"
+      #
+      # @faker.version 1.9.0
+      def electromechanical
+        fetch('electrical_components.electromechanical')
+      end
+    end
+  end
+end

data/lib/faker/default/esport.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Faker
+  class Esport < Base
+    class << self
+      def player
+        fetch('esport.players')
+      end
+
+      def team
+        fetch('esport.teams')
+      end
+
+      def league
+        fetch('esport.leagues')
+      end
+
+      def event
+        fetch('esport.events')
+      end
+
+      def game
+        fetch('esport.games')
+      end
+    end
+  end
+end

data/lib/faker/default/file.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Faker
+  class File < Base
+    class << self
+      # rubocop:disable Metrics/ParameterLists
+      def dir(legacy_segment_count = NOT_GIVEN, legacy_root = NOT_GIVEN, legacy_directory_separator = NOT_GIVEN, segment_count: 3, root: nil, directory_separator: '/')
+        # rubocop:enable Metrics/ParameterLists
+        warn_for_deprecated_arguments do |keywords|
+          keywords << :segment_count if legacy_segment_count != NOT_GIVEN
+          keywords << :root if legacy_root != NOT_GIVEN
+          keywords << :directory_separator if legacy_directory_separator != NOT_GIVEN
+        end
+
+        Array
+          .new(segment_count) { Faker::Internet.slug }
+          .unshift(root)
+          .compact
+          .join(directory_separator)
+          .squeeze(directory_separator)
+      end
+
+      def extension
+        fetch('file.extension')
+      end
+
+      def mime_type
+        fetch('file.mime_type')
+      end
+
+      # rubocop:disable Metrics/ParameterLists
+      def file_name(legacy_dir = NOT_GIVEN, legacy_name = NOT_GIVEN, legacy_ext = NOT_GIVEN, legacy_directory_separator = NOT_GIVEN, dir: nil, name: nil, ext: nil, directory_separator: '/')
+        # rubocop:enable Metrics/ParameterLists
+        warn_for_deprecated_arguments do |keywords|
+          keywords << :dir if legacy_dir != NOT_GIVEN
+          keywords << :name if legacy_name != NOT_GIVEN
+          keywords << :ext if legacy_ext != NOT_GIVEN
+          keywords << :directory_separator if legacy_directory_separator != NOT_GIVEN
+        end
+
+        dir ||= dir(segment_count: 1)
+        name ||= Faker::Lorem.word.downcase
+        ext ||= extension
+
+        [dir, name].join(directory_separator) + ".#{ext}"
+      end
+    end
+  end
+end

data/lib/faker/default/fillmurray.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Faker
+  class Fillmurray < Base
+    class << self
+      # rubocop:disable Metrics/ParameterLists
+      def image(legacy_grayscale = NOT_GIVEN, legacy_width = NOT_GIVEN, legacy_height = NOT_GIVEN, grayscale: false, width: 200, height: 200)
+        # rubocop:enable Metrics/ParameterLists
+        warn_for_deprecated_arguments do |keywords|
+          keywords << :grayscale if legacy_grayscale != NOT_GIVEN
+          keywords << :width if legacy_width != NOT_GIVEN
+          keywords << :height if legacy_height != NOT_GIVEN
+        end
+
+        raise ArgumentError, 'Width should be a number' unless width.to_s =~ /^\d+$/
+        raise ArgumentError, 'Height should be a number' unless height.to_s =~ /^\d+$/
+        raise ArgumentError, 'Grayscale should be a boolean' unless [true, false].include?(grayscale)
+
+        "https://www.fillmurray.com#{'/g' if grayscale == true}/#{width}/#{height}"
+      end
+    end
+  end
+end

data/lib/faker/default/finance.rb

@@ -0,0 +1,44 @@
+# 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
+
+    class << self
+      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]/, '').split('').reverse.map(&:to_i).inject(0) do |sum, digit|
+          multiplier = (multiplier == 2 ? 1 : 2)
+          sum + (digit * multiplier).to_s.split('').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
+
+      def vat_number(legacy_country = NOT_GIVEN, country: 'BR')
+        warn_for_deprecated_arguments do |keywords|
+          keywords << :country if legacy_country != NOT_GIVEN
+        end
+
+        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
+    end
+  end
+end