faker 2.0.0 → 3.8.0

data/lib/faker/sports/volleyball.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Faker
+  class Sports
+    class Volleyball < Base
+      class << self
+        ##
+        # Produces the name of a volleyball team.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Volleyball.team #=> "Leo Shoes Modena"
+        #
+        # @faker.version next
+        def team
+          fetch('volleyball.team')
+        end
+
+        ##
+        # Produces the name of a volleyball player.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Volleyball.player #=> "Saeid Marouf"
+        #
+        # @faker.version next
+        def player
+          fetch('volleyball.player')
+        end
+
+        ##
+        # Produces the name of a volleyball coach.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Volleyball.coach #=> "Russ Rose"
+        #
+        # @faker.version next
+        def coach
+          fetch('volleyball.coach')
+        end
+
+        ##
+        # Produces a position in volleyball.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Volleyball.position #=> "Middle blocker"
+        #
+        # @faker.version next
+        def position
+          fetch('volleyball.position')
+        end
+
+        ##
+        # Produces a formation in volleyball.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Volleyball.formation #=> "4-2"
+        #
+        # @faker.version next
+        def formation
+          fetch('volleyball.formation')
+        end
+      end
+    end
+  end
+end

data/lib/faker/sports.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Sports
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    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/travel.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Travel
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/tv_shows/aqua_teen_hunger_force.rb

@@ -6,9 +6,31 @@ module Faker
       flexible :aqua_teen_hunger_force
 
       class << self
+        ##
+        # Produces a character from Aqua Teen Hunger Force.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::AquaTeenHungerForce.character #=> "Master Shake"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('aqua_teen_hunger_force.character')
         end
+
+        ##
+        # Produces a perl of great ATHF wisdom
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::AquaTeenHungerForce.quote #=> "Friendship ain't about trust. Friendship's about nunchucks."
+        #
+        # @faker.version 2.13.0
+        def quote
+          fetch('aqua_teen_hunger_force.quote')
+        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/big_bang_theory.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Faker
+  class TvShows
+    class BigBangTheory < Base
+      flexible :big_bang_theory
+
+      class << self
+        ##
+        # Produces a character from Big Bang Theory
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BigBangTheory.character #=> "Sheldon Cooper"
+        #
+        # @faker.version 2.13.0
+        def character
+          fetch('big_bang_theory.characters')
+        end
+
+        ##
+        # Produces a quote from Bing Bang Theory
+        #
+        # @return [String]
+        #
+        # @example
+        #  Faker::TvShows::BigBangTheory.quote #=> "I'm not crazy. My mother had me tested."
+        #
+        # @faker.version 2.13.0
+        def quote
+          fetch('big_bang_theory.quotes')
+        end
+      end
+    end
+  end
+end

data/lib/faker/tv_shows/bojack_horseman.rb

@@ -6,14 +6,42 @@ module Faker
       flexible :bojack_horseman
 
       class << self
+        ##
+        # Produces a character from BoJack Horseman.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BojackHorseman.character #=> "BoJack Horseman"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('bojack_horseman.characters')
         end
 
+        ##
+        # Produces a tongue twister from BoJack Horseman.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BojackHorseman.tongue_twister #=> "Did you steal a meal from Neal McBeal the Navy Seal?"
+        #
+        # @faker.version 1.9.0
         def tongue_twister
           fetch('bojack_horseman.tongue_twisters')
         end
 
+        ##
+        # Produces a quote from BoJack Horseman.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BojackHorseman.quote
+        #     #=> "Not understanding that you're a horrible person doesn't make you less of a horrible person."
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('bojack_horseman.quotes')
         end

data/lib/faker/tv_shows/breaking_bad.rb

@@ -6,10 +6,28 @@ module Faker
       flexible :breaking_bad
 
       class << self
+        ##
+        # Produces the name of a character from Breaking Bad.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BreakingBad.character #=> "Walter White"
+        #
+        # @faker.version 1.8.8
         def character
           fetch('breaking_bad.character')
         end
 
+        ##
+        # Produces the name of an episode from Breaking Bad.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BreakingBad.episode #=> "Fly"
+        #
+        # @faker.version 1.8.8
         def episode
           fetch('breaking_bad.episode')
         end

data/lib/faker/tv_shows/brooklyn_nine_nine.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Faker
+  class TvShows
+    class BrooklynNineNine < Base
+      flexible :brooklyn_nine_nine
+
+      class << self
+        ##
+        # Produces a character from Brooklyn Nine Nine.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BrooklynNineNine.character #=> "Jake Peralta"
+        #
+        # @faker.version next
+        def character
+          fetch('brooklyn_nine_nine.characters')
+        end
+
+        ##
+        # Produces a quote from Brooklyn Nine Nine.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BrooklynNineNine.quote
+        #     #=> "Cool, cool, cool, cool, cool. No doubt, no doubt, no doubt."
+        #
+        # @faker.version next
+        def quote
+          fetch('brooklyn_nine_nine.quotes')
+        end
+      end
+    end
+  end
+end

data/lib/faker/tv_shows/buffy.rb

@@ -6,22 +6,67 @@ module Faker
       flexible :buffy
 
       class << self
+        ##
+        # Produces a character from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.character #=> "Buffy Summers"
+        #
+        # @faker.version 1.9.2
         def character
           fetch('buffy.characters')
         end
 
+        ##
+        # Produces a quote from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.quote #=> "If the apocalypse comes, beep me."
+        #
+        # @faker.version 1.9.2
         def quote
           fetch('buffy.quotes')
         end
 
-        def celebrity
-          fetch('buffy.celebrities')
+        ##
+        # Produces a actor from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.actor #=> "John Ritter"
+        #
+        # @faker.version next
+        def actor
+          fetch('buffy.actors')
         end
 
+        ##
+        # Produces a big bad from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.big_bad #=> "Glory"
+        #
+        # @faker.version 1.9.2
         def big_bad
           fetch('buffy.big_bads')
         end
 
+        ##
+        # Produces an episode from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.episode #=> "Once More, with Feeling"
+        #
+        # @faker.version 1.9.2
         def episode
           fetch('buffy.episodes')
         end

data/lib/faker/tv_shows/community.rb

@@ -6,10 +6,29 @@ module Faker
       flexible :community
 
       class << self
+        ##
+        # Produces a character from Community.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Community.characters #=> "Jeff Winger"
+        #
+        # @faker.version 1.9.0
         def characters
           fetch('community.characters')
         end
 
+        ##
+        # Produces a quote from Community.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Community.quotes
+        #     #=> "I fear a political career could shine a negative light on my drug dealing."
+        #
+        # @faker.version 1.9.0
         def quotes
           fetch('community.quotes')
         end

data/lib/faker/tv_shows/dr_who.rb

@@ -6,30 +6,93 @@ module Faker
       flexible :dr_who
 
       class << self
+        ##
+        # Produces a character from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.character #=> "Captain Jack Harkness"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('dr_who.character')
         end
 
+        ##
+        # Produces an iteration of The Doctor from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.the_doctor #=> "Ninth Doctor"
+        #
+        # @faker.version 1.8.0
         def the_doctor
           fetch('dr_who.the_doctors')
         end
 
+        ##
+        # Produces an actor from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.actor #=> "Matt Smith"
+        #
+        # @faker.version 1.9.0
         def actor
           fetch('dr_who.actors')
         end
 
+        ##
+        # Produces a catch phrase from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.catch_phrase #=> "Fantastic!"
+        #
+        # @faker.version 1.8.0
         def catch_phrase
           fetch('dr_who.catch_phrases')
         end
 
+        ##
+        # Produces a quote from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.quote #=> "Lots of planets have a north!"
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('dr_who.quotes')
         end
 
-        def villian
-          fetch('dr_who.villians')
+        ##
+        # Produces a villain from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.villain #=> "The Master"
+        #
+        # @faker.version 2.13.0
+        def villain
+          fetch('dr_who.villains')
         end
 
+        ##
+        # Produces a species from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.specie #=> "Dalek"
+        #
+        # @faker.version 1.8.0
         def specie
           fetch('dr_who.species')
         end

data/lib/faker/tv_shows/dumb_and_dumber.rb

@@ -6,14 +6,42 @@ module Faker
       flexible :dumb_and_dumber
 
       class << self
+        ##
+        # Produces an actor from Dumb and Dumber.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DumbAndDumber.actor #=> "Jim Carrey"
+        #
+        # @faker.version 1.8.5
         def actor
           fetch('dumb_and_dumber.actors')
         end
 
+        ##
+        # Produces a character from Dumb and Dumber.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DumbAndDumber.character #=> "Harry Dunne"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('dumb_and_dumber.characters')
         end
 
+        ##
+        # Produces a quote from Dumb and Dumber.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DumbAndDumber.quote
+        #     #=> "Why you going to the airport? Flying somewhere?"
+        #
+        # @faker.version 1.8.5
         def quote
           fetch('dumb_and_dumber.quotes')
         end