faker 2.2.0 → 3.2.2

data/lib/faker/tv_shows/dr_who.rb

@@ -6,30 +6,106 @@ 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 villain from Doctor Who.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DrWho.villian #=> "The Master"
+        #
+        # @deprecated Use the correctly-spelled `villain` method instead.
+        #
+        # @faker.version 1.8.0
+        alias villian villain
+
+        ##
+        # 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

data/lib/faker/tv_shows/family_guy.rb

@@ -6,14 +6,42 @@ module Faker
       flexible :family_guy
 
       class << self
+        ##
+        # Produces a character from Family Guy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FamilyGuy.character #=> "Peter Griffin"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('family_guy.character')
         end
 
+        ##
+        # Produces a location from Family Guy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FamilyGuy.location #=> "James Woods High"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('family_guy.location')
         end
 
+        ##
+        # Produces a quote from Family Guy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FamilyGuy.quote
+        #     #=> "It's Peanut Butter Jelly Time."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('family_guy.quote')
         end

data/lib/faker/tv_shows/final_space.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Faker
+  class TvShows
+    class FinalSpace < Base
+      flexible :final_space
+
+      class << self
+        ##
+        # Produces a character from Final Space.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FinalSpace.character #=> "Gary Goodspeed"
+        #
+        # @faker.version next
+        def character
+          fetch('final_space.characters')
+        end
+
+        ##
+        # Produces a vehicle from Final Space.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FinalSpace.vehicle #=> "Imperium Cruiser"
+        #
+        # @faker.version next
+        def vehicle
+          fetch('final_space.vehicles')
+        end
+
+        ##
+        # Produces a quote from Final Space.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FinalSpace.quote
+        #     #=> "It's an alien on my face! It's an alien on my...It's a space alien!"
+        #
+        # @faker.version next
+        def quote
+          fetch('final_space.quotes')
+        end
+      end
+    end
+  end
+end

data/lib/faker/tv_shows/friends.rb

@@ -6,14 +6,41 @@ module Faker
       flexible :friends
 
       class << self
+        ##
+        # Produces a character from Friends.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Friends.character #=> "Rachel Green"
+        #
+        # @faker.version 1.7.3
         def character
           fetch('friends.characters')
         end
 
+        ##
+        # Produces a location from Friends.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Friends.location #=> "Central Perk"
+        #
+        # @faker.version 1.7.3
         def location
           fetch('friends.locations')
         end
 
+        ##
+        # Produces a quote from Friends.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Friends.quote #=> "We were on a break!"
+        #
+        # @faker.version 1.7.3
         def quote
           fetch('friends.quotes')
         end

data/lib/faker/tv_shows/futurama.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Faker
+  class TvShows
+    class Futurama < Base
+      flexible :futurama
+
+      class << self
+        ##
+        # Produces a character from Futurama.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Futurama.character #=> "Amy Wong"
+        #
+        # @faker.version 2.13.0
+        def character
+          fetch('futurama.characters')
+        end
+
+        ##
+        # Produces a location from Futurama.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Futurama.location #=> "Wormulon"
+        #
+        # @faker.version 2.13.0
+        def location
+          fetch('futurama.locations')
+        end
+
+        ##
+        # Produces a quote from Futurama.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Futurama.quote
+        #     #=> "Ugh, it's like a party in my mouth & everyone's throwing up."
+        #
+        # @faker.version 2.13.0
+        def quote
+          fetch('futurama.quotes')
+        end
+
+        ##
+        # Produces a catchphrase from Hermes Conrad.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Futurama.hermes_catchphrase
+        #     #=> "Great foo of bar!"
+        #
+        # @faker.version 2.13.0
+        def hermes_catchphrase
+          fetch('futurama.hermes_catchphrases')
+        end
+      end
+    end
+  end
+end

data/lib/faker/tv_shows/game_of_thrones.rb

@@ -6,22 +6,68 @@ module Faker
       flexible :game_of_thrones
 
       class << self
+        ##
+        # Produces a character from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.character #=> "Tyrion Lannister"
+        #
+        # @faker.version 1.6.6
         def character
           fetch('game_of_thrones.characters')
         end
 
+        ##
+        # Produces a house from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.house #=> "Stark"
+        #
+        # @faker.version 1.6.6
         def house
           fetch('game_of_thrones.houses')
         end
 
+        ##
+        # Produces a city from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.city #=> "Lannisport"
+        #
+        # @faker.version 1.6.6
         def city
           fetch('game_of_thrones.cities')
         end
 
+        ##
+        # Produces a quote from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.quote
+        #     #=> "Never forget who you are. The rest of the world won't. Wear it like an armor and it can never be used against you."
+        #
+        # @faker.version 1.6.6
         def quote
           fetch('game_of_thrones.quotes')
         end
 
+        ##
+        # Produces a dragon from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.dragon #=> "Drogon"
+        #
+        # @faker.version 1.6.6
         def dragon
           fetch('game_of_thrones.dragons')
         end

data/lib/faker/tv_shows/hey_arnold.rb

@@ -6,14 +6,41 @@ module Faker
       flexible :hey_arnold
 
       class << self
+        ##
+        # Produces a character from Hey Arnold!
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HeyArnold.character #=> "Arnold"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('hey_arnold.characters')
         end
 
+        ##
+        # Produces a location from Hey Arnold!
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HeyArnold.location #=> "Big Bob's Beeper Emporium"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('hey_arnold.locations')
         end
 
+        ##
+        # Produces a quote from Hey Arnold!
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HeyArnold.quote #=> "Stoop Kid's afraid to leave his stoop!"
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('hey_arnold.quotes')
         end

data/lib/faker/tv_shows/how_i_met_your_mother.rb

@@ -6,18 +6,55 @@ module Faker
       flexible :how_i_met_your_mother
 
       class << self
+        ##
+        # Produces a character from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.character #=> "Barney Stinson"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('how_i_met_your_mother.character')
         end
 
+        ##
+        # Produces a catch phrase from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.catch_phrase #=> "Legendary"
+        #
+        # @faker.version 1.8.0
         def catch_phrase
           fetch('how_i_met_your_mother.catch_phrase')
         end
 
+        ##
+        # Produces a high five from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.high_five #=> "Relapse Five"
+        #
+        # @faker.version 1.8.0
         def high_five
           fetch('how_i_met_your_mother.high_five')
         end
 
+        ##
+        # Produces a quote from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.quote
+        #     #=> "Whenever I'm sad, I stop being sad and be awesome instead."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('how_i_met_your_mother.quote')
         end

data/lib/faker/tv_shows/michael_scott.rb

@@ -4,6 +4,16 @@ module Faker
   class TvShows
     class MichaelScott < Base
       class << self
+        ##
+        # Produces a quote from Michael Scott.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::MichaelScott.quote
+        #     #=> "I am Beyoncé, always."
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('michael_scott.quotes')
         end

data/lib/faker/tv_shows/new_girl.rb

@@ -6,10 +6,29 @@ module Faker
       flexible :new_girl
 
       class << self
+        ##
+        # Produces a character from New Girl.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::NewGirl.character #=> "Jessica Day"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('new_girl.characters')
         end
 
+        ##
+        # Produces a quote from New Girl.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::NewGirl.quote
+        #     #=> "Are you cooking a frittata in a sauce pan? What is this - prison?"
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('new_girl.quotes')
         end

data/lib/faker/tv_shows/parks_and_rec.rb

@@ -6,10 +6,28 @@ module Faker
       flexible :parks_and_rec
 
       class << self
+        ##
+        # Produces a character from Parks and Recreation.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::ParksAndRec.character #=> "Leslie Knope"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('parks_and_rec.characters')
         end
 
+        ##
+        # Produces a city from Parks and Recreation.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::ParksAndRec.city #=> "Pawnee"
+        #
+        # @faker.version 1.9.0
         def city
           fetch('parks_and_rec.cities')
         end

data/lib/faker/tv_shows/rick_and_morty.rb

@@ -6,14 +6,42 @@ module Faker
       flexible :rick_and_morty
 
       class << self
+        ##
+        # Produces a character from Rick and Morty.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RickAndMorty.character #=> "Rick Sanchez"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('rick_and_morty.characters')
         end
 
+        ##
+        # Produces a location from Rick and Morty.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RickAndMorty.location #=> "Dimension C-132"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('rick_and_morty.locations')
         end
 
+        ##
+        # Produces a quote from Rick and Morty.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RickAndMorty.quote
+        #     #=> "Ohh yea, you gotta get schwifty."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('rick_and_morty.quotes')
         end

data/lib/faker/tv_shows/ru_paul.rb

@@ -6,10 +6,28 @@ module Faker
       flexible :rupaul
 
       class << self
+        ##
+        # Produces a quote from RuPaul's Drag Race.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RuPaul.quote #=> "That's Funny, Tell Another One."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('rupaul.quotes')
         end
 
+        ##
+        # Produces a queen from RuPaul's Drag Race.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RuPaul.queen #=> "Latrice Royale"
+        #
+        # @faker.version 1.8.0
         def queen
           fetch('rupaul.queens')
         end