faker 2.20.0 → 3.2.1

data/lib/faker/movies/avatar.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Faker
+  class Movies
+    class Avatar < Base
+      class << self
+        ##
+        # Produces a character from Avatar.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Avatar.character #=> "Jake Sully"
+        #
+        # @faker.version next
+        def character
+          fetch('avatar.characters')
+        end
+
+        ##
+        # Produces a date from Avatar.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Avatar.date #=> "December 15, 2022"
+        #
+        # @faker.version next
+        def date
+          fetch('avatar.dates')
+        end
+
+        ##
+        # Produces a quote from Avatar.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Avatar.quote
+        #     #=> "If it ain't raining, we ain't training."
+        #
+        # @faker.version next
+        def quote
+          fetch('avatar.quotes')
+        end
+      end
+    end
+  end
+end

data/lib/faker/movies/hackers.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Faker
+  class Movies
+    class Hackers < Base
+      class << self
+        ##
+        # Produces a real character name from Hackers.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Hackers.character #=> "Dade Murphy"
+        #
+        # @faker.version next
+        def character
+          fetch('hackers.characters')
+        end
+
+        ##
+        # Produces a character hacker "handle" from Hackers.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Hackers.handle #=> "Zero Cool"
+        #
+        # @faker.version next
+        def handle
+          fetch('hackers.handles')
+        end
+
+        ##
+        # Produces a quote from Hackers.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Hackers.quote #=> "Hack the Planet!"
+        #
+        # @faker.version next
+        def quote
+          fetch('hackers.quotes')
+        end
+      end
+    end
+  end
+end

data/lib/faker/movies/star_wars.rb

@@ -138,11 +138,7 @@ module Faker
         #     #=> "Aren't you a little short for a Stormtrooper?"
         #
         # @faker.version 1.6.2
-        def quote(legacy_character = NOT_GIVEN, character: nil)
-          warn_for_deprecated_arguments do |keywords|
-            keywords << :character if legacy_character != NOT_GIVEN
-          end
-
+        def quote(character: nil)
           quoted_characters = translate('faker.star_wars.quotes')
 
           if character.nil?

data/lib/faker/movies/tron.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module Faker
+  class Movies
+    class Tron < Base
+      class << self
+        ##
+        # Produces a character from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.character #=> "Bit"
+        #
+        # @faker.version next
+        def character
+          sample(characters)
+        end
+
+        ##
+        # Produces a game from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.game #=> "Space Paranoids"
+        #
+        # @faker.version next
+        def game
+          sample(games)
+        end
+
+        ##
+        # Produces a location from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.location #=> "Flynn's Arcade"
+        #
+        # @faker.version next
+        def location
+          sample(locations)
+        end
+
+        ##
+        # Produces a program from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.program #=> "Clu"
+        #
+        # @faker.version next
+        def program
+          sample(programs)
+        end
+
+        ##
+        # Produces a quote from Tron.
+        #
+        # @param character [String] The name of a character to derive a quote from.
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.quote #=> "Greetings, Programs!"
+        #
+        # @example
+        #   Faker::Movies::Tron.quote(character: "mcp")
+        #     #=> "End of Line."
+        #
+        # @faker.version next
+        def quote(character: nil)
+          quoted_characters = translate('faker.tron.quotes')
+
+          if character.nil?
+            character = sample(quoted_characters.keys).to_s
+          else
+            character = character.to_s.downcase
+
+            # check alternate spellings, nicknames, titles of characters
+            translate('faker.tron.alternate_character_spellings').each do |k, v|
+              character = k.to_s if v.include?(character)
+            end
+
+            raise ArgumentError, "Character for quotes can be left blank or #{quoted_characters.keys.join(', ')}" unless quoted_characters.key?(character.to_sym)
+          end
+
+          fetch("tron.quotes.#{character}")
+        end
+
+        ##
+        # Produces a tagline from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.tagline #=> "The Electronic Gladiator"
+        #
+        # @faker.version next
+        def tagline
+          sample(taglines)
+        end
+
+        ##
+        # Produces a user from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.user #=> "Light Cycle"
+        #
+        # @faker.version next
+        def user
+          sample(users)
+        end
+
+        ##
+        # Produces a vehicle from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.vehicle #=> "Light Cycle"
+        #
+        # @faker.version next
+        def vehicle
+          sample(vehicles)
+        end
+
+        def characters
+          translate('faker.tron.characters').values.flatten
+        end
+
+        def games
+          fetch_all('tron.games')
+        end
+
+        def locations
+          fetch_all('tron.locations')
+        end
+
+        def programs
+          fetch_all('tron.characters.programs')
+        end
+
+        def taglines
+          fetch_all('tron.taglines')
+        end
+
+        def users
+          fetch_all('tron.characters.users')
+        end
+
+        def vehicles
+          fetch_all('tron.vehicles')
+        end
+      end
+    end
+  end
+end

data/lib/faker/quotes/quote.rb

@@ -106,6 +106,19 @@ module Faker
       def fortune_cookie
         fetch('quote.fortune_cookie')
       end
+
+      ##
+      # Produces a quote from comedian Mitch Hedberg.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.mitch_hedberg # => "I like Kit-Kats, unless I'm with four or more people."
+      #
+      # @faker.version next
+      def mitch_hedberg
+        fetch('quote.mitch_hedberg')
+      end
     end
   end
 end

data/lib/faker/sports/chess.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Faker
+  class Sports
+    class Chess < Base
+      class << self
+        ##
+        # Produces the name of a chess player name.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Chess.player #=> "Golden State Warriors"
+        #
+        # @faker.version next
+        def player
+          fetch('chess.players')
+        end
+
+        ##
+        # Produces a long (alpha-3) ISO 3166 country code.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Chess.federation #=> "COL"
+        #
+        # @faker.version next
+        def federation
+          Faker::Address.country_code_long
+        end
+
+        def tournament
+          ##
+          # Produces the name of a famous chess tournament name.
+          #
+          # @return [String]
+          #
+          # @example
+          #   Faker::Chess.tournament #=> "Khanty-Mansisyk (Candidates Tournament)"
+          #
+          # @faker.version next
+          fetch('chess.tournaments')
+        end
+
+        def rating(from: 2000, to: 2900)
+          ##
+          # Produces a rating between two provided values. Boundaries are inclusive.
+          #
+          # @param from [Numeric] The lowest number to include.
+          # @param to [Numeric] The highest number to include.
+          # @return [Numeric]
+          #
+          # @example
+          #   Faker::Sports::Chess.rating #=> 2734
+          #   Faker::Sports::Chess.rating(from: 2400, to: 2700) #=> 2580
+          #
+          # @faker.version next
+          Faker::Base.rand_in_range(from, to)
+        end
+
+        ##
+        # Produces the name of a chess opening.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Chess.opening #=> "Giuoco Piano"
+        #
+        # @faker.version next
+        def opening
+          fetch('chess.openings')
+        end
+
+        ##
+        # Produces a chess title.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Chess.title #=> "GM"
+        #
+        # @faker.version next
+        def title
+          fetch('chess.titles')
+        end
+      end
+    end
+  end
+end

data/lib/faker/sports/mountaineering.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Faker
+  class Sports
+    class Mountaineering < Base
+      class << self
+        ##
+        # Produces the name of a Mountaineer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Mountaineering.mountaineer #=> "Junko Tabei"
+        #
+        # @faker.version next
+        def mountaineer
+          fetch('mountaineering.mountaineer')
+        end
+      end
+    end
+  end
+end

data/lib/faker/sports/sport.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Faker
+  class Sport < Base
+    class << self
+      ##
+      # Produces a sport from the modern olympics or paralympics, summer or winter.
+      #
+      # @param include_ancient [Boolean] If true, may produce a sport from the ancient olympics
+      # @param include_unusual [Boolean] If true, may produce an unusual (definitely not olympic) sport
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Sport.sport #=> "Football"
+      # @example
+      #   Faker::Sport.sport(include_ancient: true) #=> "Chariot racing"
+      # @example
+      #   Faker::Sport.sport(include_unsual: true) #=> "Flugtag/Birdman"
+      # @example
+      #   Faker::Sport.sport(include_ancient:true, include_unusual: true) #=> "Water polo"
+      #
+      # @faker.version next
+      def sport(include_ancient: false, include_unusual: false)
+        sports = []
+        sports.concat(
+          fetch_all('sport.summer_olympics'),
+          fetch_all('sport.summer_paralympics'),
+          fetch_all('sport.winter_olympics'),
+          fetch_all('sport.winter_paralympics')
+        )
+        sports.concat(fetch_all('sport.ancient_olympics')) if include_ancient
+        sports.concat(fetch_all('sport.unusual')) if include_unusual
+        sample(sports)
+      end
+
+      ##
+      # Produces a sport from the summer olympics.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Sport.summer_olympics_sport #=> "Archery"
+      #
+      # @faker.version next
+      def summer_olympics_sport
+        fetch('sport.summer_olympics')
+      end
+
+      ##
+      # Produces a sport from the winter olympics.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Sport.winter_olympics_sport #=> "Bobsleigh"
+      #
+      # @faker.version next
+      def winter_olympics_sport
+        fetch('sport.winter_olympics')
+      end
+
+      ##
+      # Produces a sport from the summer paralympics.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Sport.summer_paralympics_sport #=> "Wheelchair Basketball"
+      #
+      # @faker.version next
+      def summer_paralympics_sport
+        fetch('sport.summer_paralympics')
+      end
+
+      ##
+      # Produces a sport from the winter paralympics.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Sport.winter_paralympics_sport #=> "Para Ice Hockey"
+      #
+      # @faker.version next
+      def winter_paralympics_sport
+        fetch('sport.winter_paralympics')
+      end
+
+      ##
+      # Produces an unusual sport.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Sport.unusual_sport #=> "Camel Jumping"
+      #
+      # @faker.version next
+      def unusual_sport
+        fetch('sport.unusual')
+      end
+
+      ##
+      # Produces a sport from the ancient olympics.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Sport.ancient_olympics_sport #=> "Pankration"
+      #
+      # @faker.version next
+      def ancient_olympics_sport
+        fetch('sport.ancient_olympics')
+      end
+    end
+  end
+end

data/lib/faker/travel/airport.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Faker
+  class Travel
+    class Airport < Base
+      class << self
+        ##
+        # Produces random Airport by name and takes arguments for size and region
+        #
+        # @param size [String] airport size, united_states has large, or medium, or small, european_union has large, or medium
+        #
+        # @param region [String] airport region, currently available -> united_states or european_union
+        #
+        # @return [String]
+        #
+        # @example
+        # Faker::Travel::Airport.name(size: 'large', region: 'united_states') => "Los Angeles International Airport"
+        #
+        # @faker.version next
+        def name(size:, region:)
+          fetch("airport.#{region}.#{size}")
+        end
+
+        ##
+        # Produces random Airport by IATA code and takes arguments for size and region
+        #
+        # @param size [String] airport size, united_states has large, or medium, or small, european_union has large, or medium
+        #
+        # @param region [String] airport region, currently available -> united_states or european_union
+        #
+        # @return [String]
+        #
+        # @example
+        # Faker::Travel::Airport.iata(size: 'large', region: 'united_states') => "LAX"
+        #
+        # @faker.version next
+        def iata(size:, region:)
+          fetch("airport.#{region}.iata_code.#{size}")
+        end
+      end
+    end
+  end
+end

data/lib/faker/travel/train_station.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Faker
+  class Travel
+    class TrainStation < Base
+      class << self
+        ##
+        # Produces random Train Station by name and takes optional arguments for region and type
+        #
+        # @param region [String] Train station region: germany, spain, united_kingdom, united_states
+        #
+        # @param type [String] Train station type: metro, railway
+        #
+        # @return [String]
+        #
+        # @examples
+        # Faker::Travel::TrainStation.name(region: 'united_kingdom', type: 'metro') => "Brockley"
+        # Faker::Travel::TrainStation.name(type: 'railway') => "Düsseldorf Hauptbahnhof"
+        # Faker::Travel::TrainStation.name(region: 'spain') => "Santa Eulàlia"
+        #
+        # @faker.version next
+        def name(region: nil, type: nil)
+          region, type = fill_missing_inputs_with_samples(region, type)
+          fetch("train_station.#{region}.#{type}")
+        end
+
+        private
+
+        def fill_missing_inputs_with_samples(region, type)
+          regions = %w[germany spain united_kingdom united_states]
+          types = %w[metro railway]
+
+          if region.nil? && type.nil?
+            region = sample(regions)
+            type = sample(types)
+          elsif region.nil?
+            validate_arguments(type, types, 'type')
+            region = sample(regions)
+          elsif type.nil?
+            validate_arguments(region, regions, 'region')
+            type = sample(types)
+          end
+          [region, type]
+        end
+
+        def validate_arguments(argument, correct_values, argument_name)
+          return if correct_values.include?(argument)
+
+          raise ArgumentError, "'#{argument}' not found, #{argument_name} can be blank, or one of the following, as strings: #{correct_values.join(', ')}"
+        end
+      end
+    end
+  end
+end

data/lib/faker/tv_shows/archer.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Faker
+  class TvShows
+    class Archer < Base
+      flexible :archer
+
+      class << self
+        ##
+        # Produces a character from Archer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Archer.character #=> "Sterling Archer"
+        #
+        # @faker.version next
+        def character
+          fetch('archer.characters')
+        end
+
+        ##
+        # Produces a location from Archer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Archer.location #=> "The Tuntmore Towers"
+        #
+        # @faker.version next
+        def location
+          fetch('archer.locations')
+        end
+
+        ##
+        # Produces a quote from Archer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Archer.quote
+        #     #=> "You're not my supervisor!"
+        #
+        # @faker.version next
+        def quote
+          fetch('archer.quotes')
+        end
+      end
+    end
+  end
+end

data/lib/faker/tv_shows/south_park.rb

@@ -32,6 +32,21 @@ module Faker
         def quote
           fetch('south_park.quotes')
         end
+
+        ##
+        # Produces an episode name from South Park.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SouthPark.episode_name
+        #     #=> "Make Love, Not Warcraft"
+        #
+        # @faker.version next
+
+        def episode_name
+          fetch('south_park.episodes')
+        end
       end
     end
   end