faker 2.3.0 → 2.7.0

data/lib/faker/games/myst.rb

@@ -4,22 +4,67 @@ module Faker
   class Games
     class Myst < Base
       class << self
+        ##
+        # Produces the name of a game from the Myst series.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Myst.game #=> "Myst III: Exile"
+        #
+        # @faker.version 1.9.0
         def game
           fetch('games.myst.games')
         end
 
+        ##
+        # Produces the name of a creature from Myst.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Myst.creature #=> "squee"
+        #
+        # @faker.version 1.9.0
         def creature
           fetch('games.myst.creatures')
         end
 
+        ##
+        # Produces the name of an age from Myst.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Myst.age #=> "Relto"
+        #
+        # @faker.version 1.9.0
         def age
           fetch('games.myst.ages')
         end
 
+        ##
+        # Produces the name of a chracter from Myst.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Myst.character #=> "Gehn"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('games.myst.characters')
         end
 
+        ##
+        # Produces a quote from Myst.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Myst.quote #=> "I realized, the moment I fell into the fissure, that the Book would not be destroyed as I had planned."
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('games.myst.quotes')
         end

data/lib/faker/games/pokemon.rb

@@ -4,14 +4,41 @@ module Faker
   class Games
     class Pokemon < Base
       class << self
+        ##
+        # Produces the name of a Pokemon.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Pokemon.name #=> "Pikachu"
+        #
+        # @faker.version 1.7.0
         def name
           fetch('games.pokemon.names')
         end
 
+        ##
+        # Produces a location from Pokemon.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Pokemon.location #=> "Pallet Town"
+        #
+        # @faker.version 1.7.0
         def location
           fetch('games.pokemon.locations')
         end
 
+        ##
+        # Produces a move from Pokemon.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Pokemon.move #=> "Thunder Shock"
+        #
+        # @faker.version 1.7.0
         def move
           fetch('games.pokemon.moves')
         end

data/lib/faker/games/sonic_the_hedgehog.rb

@@ -4,14 +4,41 @@ module Faker
   class Games
     class SonicTheHedgehog < Base
       class << self
+        ##
+        # Produces the name of a character from Sonic the Hedgehog.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::SonicTheHedgehog.character #=> "Sonic the Hedgehog"
+        #
+        # @faker.version 1.9.2
         def character
           fetch('games.sonic_the_hedgehog.character')
         end
 
+        ##
+        # Produces the name of a zone from Sonic the Hedgehog.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::SonicTheHedgehog.zone #=> "Green Hill Zone"
+        #
+        # @faker.version 1.9.2
         def zone
           fetch('games.sonic_the_hedgehog.zone')
         end
 
+        ##
+        # Produces the name of a game from the Sonic the Hedgehog series.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::SonicTheHedgehog.game #=> "Waku Waku Sonic Patrol Car"
+        #
+        # @faker.version 1.9.2
         def game
           fetch('games.sonic_the_hedgehog.game')
         end

data/lib/faker/games/witcher.rb

@@ -4,26 +4,80 @@ module Faker
   class Games
     class Witcher < Base
       class << self
+        ##
+        # Produces the name of a character from The Witcher.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Witcher.character #=> "Triss Merigold"
+        #
+        # @faker.version 1.8.3
         def character
           fetch('games.witcher.characters')
         end
 
+        ##
+        # Produces the name of a witcher from The Witcher.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Witcher.witcher #=> "Geralt of Rivia"
+        #
+        # @faker.version 1.8.3
         def witcher
           fetch('games.witcher.witchers')
         end
 
+        ##
+        # Produces the name of a school from The Witcher.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Witcher.school #=> "Wolf"
+        #
+        # @faker.version 1.8.3
         def school
           fetch('games.witcher.schools')
         end
 
+        ##
+        # Produces the name of a location from The Witcher.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Witcher.location #=> "Novigrad"
+        #
+        # @faker.version 1.8.3
         def location
           fetch('games.witcher.locations')
         end
 
+        ##
+        # Produces a quote from The Witcher.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Witcher.quote #=> "No Lollygagin'!"
+        #
+        # @faker.version 1.8.3
         def quote
           fetch('games.witcher.quotes')
         end
 
+        ##
+        # Produces the name of a monster from The Witcher.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::Witcher.monster #=> "Katakan"
+        #
+        # @faker.version 1.8.3
         def monster
           fetch('games.witcher.monsters')
         end

data/lib/faker/games/world_of_warcraft.rb

@@ -4,10 +4,28 @@ module Faker
   class Games
     class WorldOfWarcraft < Base
       class << self
+        ##
+        # Produces the name of a hero from World of Warcraft.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::WorldOfWarcraft.hero #=> "Uther the Lightbringer"
+        #
+        # @faker.version 1.9.2
         def hero
           fetch('games.world_of_warcraft.hero')
         end
 
+        ##
+        # Produces a quote from World of Warcraft.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::WorldOfWarcraft.quote #=> "These are dark times indeed."
+        #
+        # @faker.version 1.9.2
         def quote
           fetch('games.world_of_warcraft.quotes')
         end

data/lib/faker/games/zelda.rb

@@ -3,7 +3,7 @@
 module Faker
   class Games
     class Zelda < Base
-      flexible :space
+      flexible :zelda
       class << self
         ##
         # Produces the name of a Legend of Zelda game.

data/lib/faker/japanese_media/dragon_ball.rb

@@ -4,6 +4,15 @@ module Faker
   class JapaneseMedia
     class DragonBall < Base
       class << self
+        ##
+        # Produces the name of a character from Dragon Ball.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Games::DragonBall.character #=> "Goku"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('dragon_ball.characters')
         end

data/lib/faker/japanese_media/one_piece.rb

@@ -4,26 +4,80 @@ module Faker
   class JapaneseMedia
     class OnePiece < Base
       class << self
+        ##
+        # Produces a character from One Piece.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::OnePiece.character #=> "Monkey D. Luffy"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('one_piece.characters')
         end
 
+        ##
+        # Produces a sea from One Piece.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::OnePiece.sea #=> "East Blue"
+        #
+        # @faker.version 1.8.5
         def sea
           fetch('one_piece.seas')
         end
 
+        ##
+        # Produces an island from One Piece.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::OnePiece.island #=> "Laftel"
+        #
+        # @faker.version 1.8.5
         def island
           fetch('one_piece.islands')
         end
 
+        ##
+        # Produces a location from One Piece.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::OnePiece.location #=> "Foosha Village"
+        #
+        # @faker.version 1.8.5
         def location
           fetch('one_piece.locations')
         end
 
+        ##
+        # Produces a quote from One Piece.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::OnePiece.quote #=> "ONE PIECE IS REAL!"
+        #
+        # @faker.version 1.8.5
         def quote
           fetch('one_piece.quotes')
         end
 
+        ##
+        # Produces an akuma no mi from One Piece.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::OnePiece.akuma_no_mi #=> "Gomu Gomu no Mi"
+        #
+        # @faker.version 1.8.5
         def akuma_no_mi
           fetch('one_piece.akumas_no_mi')
         end

data/lib/faker/japanese_media/sword_art_online.rb

@@ -4,18 +4,54 @@ module Faker
   class JapaneseMedia
     class SwordArtOnline < Base
       class << self
+        ##
+        # Produces the real name of a character from Sword Art Online.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::SwordArtOnline.real_name #=> "Kirigaya Kazuto"
+        #
+        # @faker.version 1.9.0
         def real_name
           fetch('sword_art_online.real_name')
         end
 
+        ##
+        # Produces the in-game name of a character from Sword Art Online.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::SwordArtOnline.game_name #=> "Silica"
+        #
+        # @faker.version 1.9.0
         def game_name
           fetch('sword_art_online.game_name')
         end
 
+        ##
+        # Produces the name of a location from Sword Art Online.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::SwordArtOnline.location #=> "Ruby Palace"
+        #
+        # @faker.version 1.9.0
         def location
           fetch('sword_art_online.location')
         end
 
+        ##
+        # Produces the name of an item from Sword Art Online.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::JapaneseMedia::SwordArtOnline.item #=> "Blackwyrm Coat"
+        #
+        # @faker.version 1.9.0
         def item
           fetch('sword_art_online.item')
         end

data/lib/faker/movies/back_to_the_future.rb

@@ -4,14 +4,42 @@ module Faker
   class Movies
     class BackToTheFuture < Base
       class << self
+        ##
+        # Produces a character from Back to the Future.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::BackToTheFuture.character #=> "Marty McFly"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('back_to_the_future.characters')
         end
 
+        ##
+        # Produces a date from Back to the Future.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::BackToTheFuture.date #=> "November 5, 1955"
+        #
+        # @faker.version 1.8.5
         def date
           fetch('back_to_the_future.dates')
         end
 
+        ##
+        # Produces a quote from Back to the Future.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::BackToTheFuture.quote
+        #     #=> "Roads? Where we're going, we don't need roads."
+        #
+        # @faker.version 1.8.5
         def quote
           fetch('back_to_the_future.quotes')
         end