faker 2.12.0 → 2.16.0

data/lib/faker/default/placeholdit.rb

@@ -5,6 +5,8 @@ module Faker
     class << self
       SUPPORTED_FORMATS = %w[png jpg gif jpeg].freeze
 
+      # rubocop:disable Metrics/ParameterLists
+
       ##
       # Produces a random placeholder image from https://placehold.it.
       #
@@ -26,9 +28,7 @@ module Faker
       #   Faker::Placeholdit.image(size: '50x50', format: 'jpg', background_color: 'ffffff', text_color: '000', text: 'Some Custom Text') #=> "https://placehold.it/50x50.jpg/ffffff/000?text=Some Custom Text"
       #
       # @faker.version 1.6.0
-      # rubocop:disable Metrics/ParameterLists
       def image(legacy_size = NOT_GIVEN, legacy_format = NOT_GIVEN, legacy_background_color = NOT_GIVEN, legacy_text_color = NOT_GIVEN, legacy_text = NOT_GIVEN, size: '300x300', format: 'png', background_color: nil, text_color: nil, text: nil)
-        # rubocop:enable Metrics/ParameterLists
         warn_for_deprecated_arguments do |keywords|
           keywords << :size if legacy_size != NOT_GIVEN
           keywords << :format if legacy_format != NOT_GIVEN
@@ -51,6 +51,7 @@ module Faker
         image_url += "?text=#{text}" if text
         image_url
       end
+      # rubocop:enable Metrics/ParameterLists
 
       private
 

data/lib/faker/default/relationship.rb

@@ -32,7 +32,7 @@ module Faker
           end
         end
 
-        fetch('relationship.familial.' + connection)
+        fetch("relationship.familial.#{connection}")
       end
 
       ##

data/lib/faker/default/space.rb

@@ -158,7 +158,7 @@ module Faker
       #
       # @faker.version 1.6.4
       def distance_measurement
-        rand(10..100).to_s + ' ' + fetch('space.distance_measurement')
+        "#{rand(10..100)} #{fetch('space.distance_measurement')}"
       end
 
       ##

data/lib/faker/default/string.rb

@@ -3,6 +3,8 @@
 module Faker
   class String < Base
     class << self
+      # rubocop:disable Style/AsciiComments
+
       ##
       # Produces a random UTF-8 string with optional nested length selectors.
       #
@@ -10,13 +12,11 @@ module Faker
       # @return [String]
       #
       # @example
-      #   rubocop:disable Style/AsciiComments
       #   Faker::String.random #=> "3 뇦\u0017&y\u{3A109}$8^4* 녹豿4좘툢ꔾ쉙6ɉ\uA6 8TN畀챵|\"3쇤Ŵ"
       #   Faker::String.random(length: 4) #=> "⼨%0*"
       #   Faker::String.random(length: 3..12) #=> "\u{69FDC};秨툫"
       #   Faker::String.random(length: [0, 6]) #=> "I轤𣴒P溟L"
       #   Faker::String.random(length: [1, (2..5), [3, 6], nil]) #=> "葓L#ћ"
-      #   rubocop:enable Style/AsciiComments
       #
       # @faker.version 1.9.0
       def random(legacy_length = NOT_GIVEN, length: 32)
@@ -26,6 +26,7 @@ module Faker
 
         utf8string select_a length
       end
+      # rubocop:enable Style/AsciiComments
 
       private
 

data/lib/faker/default/stripe.rb

@@ -30,7 +30,7 @@ module Faker
           end
         end
 
-        fetch('stripe.valid_cards.' + card_type)
+        fetch("stripe.valid_cards.#{card_type}")
       end
 
       ##
@@ -60,7 +60,7 @@ module Faker
           end
         end
 
-        fetch('stripe.valid_tokens.' + card_type)
+        fetch("stripe.valid_tokens.#{card_type}")
       end
 
       ##
@@ -89,7 +89,7 @@ module Faker
           end
         end
 
-        fetch('stripe.invalid_cards.' + card_error)
+        fetch("stripe.invalid_cards.#{card_error}")
       end
 
       ##

data/lib/faker/default/vehicle.rb

@@ -278,7 +278,7 @@ module Faker
 
         return regexify(bothify(fetch('vehicle.license_plate'))) if state_abbreviation.empty?
 
-        key = 'vehicle.license_plate_by_state.' + state_abbreviation
+        key = "vehicle.license_plate_by_state.#{state_abbreviation}"
         regexify(bothify(fetch(key)))
       end
 

data/lib/faker/default/world_cup.rb

@@ -24,7 +24,7 @@ module Faker
       # @example
       #   Faker::WorldCup.city #=> "Moscow"
       #
-      # @faker.version next
+      # @faker.version 2.13.0
       def city
         fetch('world_cup.cities')
       end
@@ -37,7 +37,7 @@ module Faker
       # @example
       #   Faker::WorldCup.stadium #=> "Rostov Arena"
       #
-      # @faker.version next
+      # @faker.version 2.13.0
       def stadium
         fetch('world_cup.stadiums')
       end
@@ -52,7 +52,7 @@ module Faker
       # @example
       #   Faker::WorldCup.group #=> "Russia"
       #
-      # @faker.version next
+      # @faker.version 2.13.0
       def group(legacy_group = NOT_GIVEN, group: 'group_A')
         warn_for_deprecated_arguments do |keywords|
           keywords << :group if legacy_group != NOT_GIVEN
@@ -72,7 +72,7 @@ module Faker
       # @example
       #   Faker::WorldCup.roster(country: 'Spain', type: 'forwards') #=> "Diego Costa"
       #
-      # @faker.version next
+      # @faker.version 2.13.0
       def roster(legacy_country = NOT_GIVEN, legacy_type = NOT_GIVEN, country: 'Egypt', type: 'coach')
         warn_for_deprecated_arguments do |keywords|
           keywords << :country if legacy_country != NOT_GIVEN

data/lib/faker/fantasy/tolkien.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Faker
+  class Fantasy
+    class Tolkien < Base
+      flexible :tolkien
+
+      class << self
+        ##
+        # Produces a character from Tolkien's legendarium
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Fantasy::Tolkien.character
+        #    #=> "Goldberry"
+        #
+        # @faker.version next
+        def character
+          fetch('tolkien.characters')
+        end
+
+        ##
+        # Produces a location from Tolkien's legendarium
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Fantasy::Tolkien.location
+        #    #=> "Helm's Deep"
+        #
+        # @faker.version next
+        def location
+          fetch('tolkien.locations')
+        end
+
+        ##
+        # Produces a race from Tolkien's legendarium
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Fantasy::Tolkien.race
+        #     #=> "Uruk-hai"
+        #
+        # @faker.version next
+        def race
+          fetch('tolkien.races')
+        end
+
+        ##
+        # Produces the name of a poem from Tolkien's legendarium
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Fantasy::Tolkien.poem
+        #     #=> "Chip the glasses and crack the plates"
+        #
+        # @faker.version next
+        def poem
+          fetch('tolkien.poems')
+        end
+      end
+    end
+  end
+end

data/lib/faker/games/clash_of_clans.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Faker
+  class Games
+    class ClashOfClans < Base
+      class << self
+        ##
+        # Produces the name of a troop from Clash of Clans.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::ClashOfClans.troop #=> "Barbarian"
+        #
+        # @faker.version next
+        def troop
+          fetch('games.clash_of_clans.troops')
+        end
+
+        ##
+        # Produces the name of a rank from Clash Of Clans.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::ClashOfClans.rank #=> "Legend"
+        #
+        # @faker.version next
+        def rank
+          fetch('games.clash_of_clans.ranks')
+        end
+
+        ##
+        # Produces the name of a defensive buiding from Clash Of Clans.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::ClashOfClans.defensive_building #=> "Cannon"
+        #
+        # @faker.version next
+        def defensive_building
+          fetch('games.clash_of_clans.defensive_buildings')
+        end
+      end
+    end
+  end
+end

data/lib/faker/games/control.rb

@@ -12,7 +12,7 @@ module Faker
         # @example
         #   Faker::Games::Control.character #=> "Jesse Faden"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def character
           fetch('games.control.character')
         end
@@ -23,9 +23,9 @@ module Faker
         # @return [String]
         #
         # @example
-        #   Faker::Games::Control.character #=> "Dimensional Research"
+        #   Faker::Games::Control.location #=> "Dimensional Research"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def location
           fetch('games.control.location')
         end
@@ -38,7 +38,7 @@ module Faker
         # @example
         #   Faker::Games::Control.object_of_power #=> "Hotline"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def object_of_power
           fetch('games.control.object_of_power')
         end
@@ -51,7 +51,7 @@ module Faker
         # @example
         #   Faker::Games::Control.altered_item #=> "Rubber Duck"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def altered_item
           fetch('games.control.altered_item')
         end
@@ -64,7 +64,7 @@ module Faker
         # @example
         #   Faker::Games::Control.altered_world_event #=> "Ordinary, Wisconsin"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def altered_world_event
           fetch('games.control.altered_world_event')
         end
@@ -77,7 +77,7 @@ module Faker
         # @example
         #   Faker::Games::Control.hiss #=> "Push the fingers through the surface into the wet."
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def hiss
           fetch('games.control.hiss')
         end
@@ -90,7 +90,7 @@ module Faker
         # @example
         #   Faker::Games::Control.the_board #=> "< You/We wield the Gun/You. The Board appoints you. Congratulations, Director. >"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def the_board
           fetch('games.control.the_board')
         end
@@ -103,7 +103,7 @@ module Faker
         # @example
         #   Faker::Games::Control.quote #=> "He never liked fridge duty"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def quote
           fetch('games.control.quote')
         end

data/lib/faker/games/dnd.rb

@@ -5,16 +5,42 @@ module Faker
     class DnD < Base
       class << self
         ##
-        # Produces the name of a race from Dungeons and Dragons (PHB).
+        # Produces the name of an alignment from Dungeons and Dragons.
         #
         # @return [String]
         #
         # @example
-        #   Faker::Games::DnD.race #=> "Dwarf"
+        #   Faker::Games::DnD.alignment #=> "Lawful Neutral"
         #
-        # @faker.version next
-        def species
-          fetch('dnd.species')
+        # @faker.version 2.13.0
+        def alignment
+          fetch('dnd.alignments')
+        end
+
+        ##
+        # Produces the name of a background from Dungeons and Dragons (PHB).
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::DnD.background #=> "Urchin"
+        #
+        # @faker.version 2.13.0
+        def background
+          fetch('dnd.backgrounds')
+        end
+
+        ##
+        # Produces the name of a city from Dungeons and Dragons.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::DnD.city #=> "Earthfast"
+        #
+        # @faker.version 2.14.0
+        def city
+          fetch('dnd.cities')
         end
 
         ##
@@ -25,35 +51,84 @@ module Faker
         # @example
         #   Faker::Games::DnD.klass #=> "Warlock"
         #
-        # @faker.version next
+        # @faker.version 2.13.0
         def klass
           fetch('dnd.klasses')
         end
 
         ##
-        # Produces the name of a background from Dungeons and Dragons (PHB).
+        # Produces the name of a language from Dungeons and Dragons.
         #
         # @return [String]
         #
         # @example
-        #   Faker::Games::DnD.background #=> "Urchin"
+        #   Faker::Games::DnD.language #=> "Gnomish"
         #
-        # @faker.version next
-        def background
-          fetch('dnd.backgrounds')
+        # @faker.version 2.14.0
+        def language
+          fetch('dnd.languages')
         end
 
         ##
-        # Produces the name of an alignment from Dungeons and Dragons.
+        # Produces the name of a melee weapon from Dungeons and Dragons.
         #
         # @return [String]
         #
         # @example
-        #   Faker::Games::DnD.alignment #=> "Lawful Neutral"
+        #   Faker::Games::DnD.melee_weapon #=> "Handaxe"
         #
-        # @faker.version next
-        def alignment
-          fetch('dnd.alignments')
+        # @faker.version 2.14.0
+        def melee_weapon
+          fetch('dnd.melee_weapons')
+        end
+
+        ##
+        # Produces the name of a monster from Dungeons and Dragons.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::DnD.monster #=> "Manticore"
+        #
+        # @faker.version 2.14.0
+        def monster
+          fetch('dnd.monsters')
+        end
+
+        ##
+        # Produces the name of a race from Dungeons and Dragons (PHB).
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::DnD.races #=> "Dwarf"
+        #
+        # @faker.version 2.14.0
+        def race
+          fetch('dnd.races')
+        end
+
+        ##
+        # Produces the name of a ranged weapon from Dungeons and Dragons.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::DnD.ranged_weapon #=> "Shortbow"
+        #
+        # @faker.version 2.14.0
+        def ranged_weapon
+          fetch('dnd.ranged_weapons')
+        end
+
+        # This method is deprecated. The implementation will be removed in a near future release.
+        # Use `DnD.race` instead.
+        #
+        # @deprecated Use {#race} instead.
+        def species
+          warn '`DnD.species` is deprecated. Use `DnD.race` instead.'
+
+          super
         end
       end
     end