faker 2.4.0 → 2.8.1

data/lib/faker/movies/lord_of_the_rings.rb

@@ -4,14 +4,42 @@ module Faker
   class Movies
     class LordOfTheRings < Base
       class << self
+        ##
+        # Produces a character from Lord of the Rings.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::LordOfTheRings.character #=> "Legolas"
+        #
+        # @faker.version 1.7.0
         def character
           fetch('lord_of_the_rings.characters')
         end
 
+        ##
+        # Produces a location from Lord of the Rings.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::LordOfTheRings.location #=> "Helm's Deep"
+        #
+        # @faker.version 1.7.0
         def location
           fetch('lord_of_the_rings.locations')
         end
 
+        ##
+        # Produces a quote from Lord of the Rings.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::LordOfTheRings.quote
+        #     #=> "I wish the Ring had never come to me. I wish none of this had happened."
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('lord_of_the_rings.quotes')
         end

data/lib/faker/movies/princess_bride.rb

@@ -4,10 +4,29 @@ module Faker
   class Movies
     class PrincessBride < Base
       class << self
+        ##
+        # Produces a character from The Princess Bride.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::PrincessBride.character #=> "Dread Pirate Roberts"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('princess_bride.characters')
         end
 
+        ##
+        # Produces a quote from The Princess Bride.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::PrincessBride.quote
+        #     #=> "Hello. My name is Inigo Montoya. You killed my father. Prepare to die!"
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('princess_bride.quotes')
         end

data/lib/faker/movies/star_wars.rb

@@ -4,38 +4,118 @@ module Faker
   class Movies
     class StarWars < Base
       class << self
+        ##
+        # Produces a call squadron from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.call_squadron #=> "Green"
+        #
+        # @faker.version 1.6.2
         def call_squadron
           sample(call_squadrons)
         end
 
+        ##
+        # Produces a call sign from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.call_sign #=> "Grey 5"
+        #
+        # @faker.version 1.6.2
         def call_sign
           numerify(parse('star_wars.call_sign'))
         end
 
+        ##
+        # Produces a call number from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.call_number #=> "Leader"
+        #
+        # @faker.version 1.6.2
         def call_number
           sample(call_numbers)
         end
 
+        ##
+        # Produces a character from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.character #=> "Anakin Skywalker"
+        #
+        # @faker.version 1.6.2
         def character
           sample(characters)
         end
 
+        ##
+        # Produces a droid from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.droid #=> "C-3PO"
+        #
+        # @faker.version 1.6.2
         def droid
           sample(droids)
         end
 
+        ##
+        # Produces a planet from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.planet #=> "Tatooine"
+        #
+        # @faker.version 1.6.2
         def planet
           sample(planets)
         end
 
+        ##
+        # Produces a species from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.specie #=> "Gungan"
+        #
+        # @faker.version 1.6.2
         def specie
           sample(species)
         end
 
+        ##
+        # Produces a vehicle from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.vehicle #=> "Sandcrawler"
+        #
+        # @faker.version 1.6.2
         def vehicle
           sample(vehicles)
         end
 
+        # Produces a wookiee sentence from Star Wars.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.wookiee_sentence #=> "Yrroonn ru ooma roo ahuma ur roooarrgh hnn-rowr."
+        #
+        # @faker.version 1.6.2
         def wookiee_sentence
           sentence = sample(wookiee_words).capitalize
 
@@ -44,6 +124,20 @@ module Faker
           sentence + sample(['.', '?', '!'])
         end
 
+        ##
+        # Produces a quote from Star Wars.
+        #
+        # @param character [String] The name of a character to derive a quote from.
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::StarWars.quote #=> "Aren't you a little short for a Stormtrooper?"
+        #
+        # @example
+        #   Faker::Movies::StarWars.quote(character: "leia_organa")
+        #     #=> "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

data/lib/faker/movies/v_for_vendetta.rb

@@ -4,14 +4,43 @@ module Faker
   class Movies
     class VForVendetta < Base
       class << self
+        ##
+        # Produces a character from V For Vendetta.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::VForVendetta.character #=> "V"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('v_for_vendetta.characters')
         end
 
+        ##
+        # Produces a speech from V For Vendetta.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::VForVendetta.speech
+        #     #=> "Remember, remember, the Fifth of November, the Gunpowder Treason and Plot. I know of no reason why the Gunpowder Treason should ever be forgot..."
+        #
+        # @faker.version 1.8.5
         def speech
           fetch('v_for_vendetta.speeches')
         end
 
+        ##
+        # Produces a quote from V For Vendetta.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::VForVendetta.quote
+        #     #=> "People should not be afraid of their governments. Governments should be afraid of their people."
+        #
+        # @faker.version 1.8.5
         def quote
           fetch('v_for_vendetta.quotes')
         end

data/lib/faker/music/umphreys_mcgee.rb

@@ -4,6 +4,15 @@ module Faker
   class Music
     class UmphreysMcgee < Base
       class << self
+        ##
+        # Produces the name of a song by Umphrey's McGee.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::UmphreysMcgee.song #=> "Dump City"
+        #
+        # @faker.version 1.8.3
         def song
           fetch('umphreys_mcgee.song')
         end

data/lib/faker/sports/basketball.rb

@@ -4,18 +4,54 @@ module Faker
   class Sports
     class Basketball < Base
       class << self
+        ##
+        # Produces the name of a basketball team.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Basketball.team #=> "Golden State Warriors"
+        #
+        # @faker.version 1.9.4
         def team
           fetch('basketball.teams')
         end
 
+        ##
+        # Produces the name of a basketball player.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Basketball.player #=> "LeBron James"
+        #
+        # @faker.version 1.9.4
         def player
           fetch('basketball.players')
         end
 
+        ##
+        # Produces the name of a basketball coach.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Basketball.coach #=> "Gregg Popovich"
+        #
+        # @faker.version 1.9.4
         def coach
           fetch('basketball.coaches')
         end
 
+        ##
+        # Produces a position in basketball.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Basketball.position #=> "Point Guard"
+        #
+        # @faker.version 1.9.4
         def position
           fetch('basketball.positions')
         end

data/lib/faker/sports/football.rb

@@ -4,22 +4,67 @@ module Faker
   class Sports
     class Football < Base
       class << self
+        ##
+        # Produces the name of a football team.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Football.team #=> "Manchester United"
+        #
+        # @faker.version 1.9.0
         def team
           fetch('football.teams')
         end
 
+        ##
+        # Produces the name of a football player.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Football.player #=> "Lionel Messi"
+        #
+        # @faker.version 1.9.0
         def player
           fetch('football.players')
         end
 
+        ##
+        # Produces the name of a football coach.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Football.coach #=> "Jose Mourinho"
+        #
+        # @faker.version 1.9.0
         def coach
           fetch('football.coaches')
         end
 
+        ##
+        # Produces a football competition.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Football.competition #=> "FIFA World Cup"
+        #
+        # @faker.version 1.9.0
         def competition
           fetch('football.competitions')
         end
 
+        ##
+        # Produces a position in football.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Sports::Football.position #=> "Defensive Midfielder"
+        #
+        # @faker.version 1.9.2
         def position
           fetch('football.positions')
         end

data/lib/faker/tv_shows/aqua_teen_hunger_force.rb

@@ -6,6 +6,15 @@ 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

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