faker 2.4.0 → 2.8.1

data/lib/faker/default/world_cup.rb

@@ -3,18 +3,56 @@
 module Faker
   class WorldCup < Base
     class << self
+      ##
+      # Produces a national team name.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::WorldCup.team #=> "Iran"
+      #
+      # @faker.version 1.9.0
       def team
         fetch('world_cup.teams')
       end
 
+      ##
+      # Produces a city name hosting the World Cup match.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::WorldCup.city #=> "Moscow"
+      #
+      # @faker.version next
       def city
         fetch('world_cup.cities')
       end
 
+      ##
+      # Produces the name of a stadium that has hosted a World Cup match.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::WorldCup.stadium #=> "Rostov Arena"
+      #
+      # @faker.version next
       def stadium
         fetch('world_cup.stadiums')
       end
 
+      ##
+      # Produces a random national team name from a group.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::WorldCup.group(group: 'group_B') #=> "Spain"
+      # @example
+      #   Faker::WorldCup.group #=> "Russia"
+      #
+      # @faker.version next
       def group(legacy_group = NOT_GIVEN, group: 'group_A')
         warn_for_deprecated_arguments do |keywords|
           keywords << :group if legacy_group != NOT_GIVEN
@@ -23,6 +61,18 @@ module Faker
         fetch("world_cup.groups.#{group}")
       end
 
+      ##
+      # Produces a random name from national team roster.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::WorldCup.roster #=> "Hector Cuper"
+      #
+      # @example
+      #   Faker::WorldCup.roster(country: 'Spain', type: 'forwards') #=> "Diego Costa"
+      #
+      # @faker.version next
       def roster(legacy_country = NOT_GIVEN, legacy_type = NOT_GIVEN, country: 'Egypt', type: 'coach')
         warn_for_deprecated_arguments do |keywords|
           keywords << :country if legacy_country != NOT_GIVEN

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/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/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

data/lib/faker/movies/ghostbusters.rb

@@ -4,14 +4,42 @@ module Faker
   class Movies
     class Ghostbusters < Base
       class << self
+        ##
+        # Produces an actor from Ghostbusters.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Ghostbusters.actor #=> "Bill Murray"
+        #
+        # @faker.version 1.9.2
         def actor
           fetch('ghostbusters.actors')
         end
 
+        ##
+        # Produces a character from Ghostbusters.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Ghostbusters.character #=> "Dr. Egon Spengler"
+        #
+        # @faker.version 1.9.2
         def character
           fetch('ghostbusters.characters')
         end
 
+        ##
+        # Produces a quote from Ghostbusters.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Ghostbusters.quote
+        #     #=> "I tried to think of the most harmless thing. Something I loved from my childhood. Something that could never ever possibly destroy us. Mr. Stay Puft!"
+        #
+        # @faker.version 1.9.2
         def quote
           fetch('ghostbusters.quotes')
         end

data/lib/faker/movies/harry_potter.rb

@@ -4,26 +4,80 @@ module Faker
   class Movies
     class HarryPotter < Base
       class << self
+        ##
+        # Produces a character from Harry Potter.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HarryPotter.character #=> "Harry Potter"
+        #
+        # @faker.version 1.7.3
         def character
           fetch('harry_potter.characters')
         end
 
+        ##
+        # Produces a location from Harry Potter.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HarryPotter.location #=> "Hogwarts"
+        #
+        # @faker.version 1.7.3
         def location
           fetch('harry_potter.locations')
         end
 
+        ##
+        # Produces a quote from Harry Potter.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HarryPotter.quote #=> "I solemnly swear that I am up to good."
+        #
+        # @faker.version 1.7.3
         def quote
           fetch('harry_potter.quotes')
         end
 
+        ##
+        # Produces a book from Harry Potter.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HarryPotter.book #=> "Harry Potter and the Chamber of Secrets"
+        #
+        # @faker.version 1.7.3
         def book
           fetch('harry_potter.books')
         end
 
+        ##
+        # Produces a house from Harry Potter.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HarryPotter.house #=> "Gryffindor"
+        #
+        # @faker.version 1.7.3
         def house
           fetch('harry_potter.houses')
         end
 
+        ##
+        # Produces a spell from Harry Potter.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HarryPotter.spell #=> "Reparo"
+        #
+        # @faker.version 1.7.3
         def spell
           fetch('harry_potter.spells')
         end

data/lib/faker/movies/hitchhikers_guide_to_the_galaxy.rb

@@ -4,30 +4,99 @@ module Faker
   class Movies
     class HitchhikersGuideToTheGalaxy < Base
       class << self
+        ##
+        # Produces a character from The Hitchhiker's Guide to the Galaxy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HitchhikersGuideToTheGalaxy.character #=> "Marvin"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('hitchhikers_guide_to_the_galaxy.characters')
         end
 
+        ##
+        # Produces a location from The Hitchhiker's Guide to the Galaxy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HitchhikersGuideToTheGalaxy.location
+        #     #=> "Arthur Dent's house"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('hitchhikers_guide_to_the_galaxy.locations')
         end
 
+        ##
+        # Produces a Marvin quote from The Hitchhiker's Guide to the Galaxy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HitchhikersGuideToTheGalaxy.marvin_quote
+        #     #=> "Life? Don't talk to me about life."
+        #
+        # @faker.version 1.8.0
         def marvin_quote
           fetch('hitchhikers_guide_to_the_galaxy.marvin_quote')
         end
 
+        ##
+        # Produces a planet from The Hitchhiker's Guide to the Galaxy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HitchhikersGuideToTheGalaxy.planet
+        #     #=> "Magrathea"
+        #
+        # @faker.version 1.8.0
         def planet
           fetch('hitchhikers_guide_to_the_galaxy.planets')
         end
 
+        ##
+        # Produces a quote from The Hitchhiker's Guide to the Galaxy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HitchhikersGuideToTheGalaxy.quote
+        #     #=> "In the beginning, the Universe was created. This has made a lot of people very angry and been widely regarded as a bad move."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('hitchhikers_guide_to_the_galaxy.quotes')
         end
 
+        ##
+        # Produces a species from The Hitchhiker's Guide to the Galaxy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HitchhikersGuideToTheGalaxy.specie
+        #     #=> "Perfectly Normal Beast"
+        #
+        # @faker.version 1.8.0
         def specie
           fetch('hitchhikers_guide_to_the_galaxy.species')
         end
 
+        ##
+        # Produces a starship from The Hitchhiker's Guide to the Galaxy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::HitchhikersGuideToTheGalaxy.starship
+        #     #=> "Vogon Constructor Fleet"
+        #
+        # @faker.version 1.8.0
         def starship
           fetch('hitchhikers_guide_to_the_galaxy.starships')
         end

data/lib/faker/movies/lebowski.rb

@@ -4,14 +4,41 @@ module Faker
   class Movies
     class Lebowski < Base
       class << self
+        ##
+        # Produces an actor from The Big Lebowski.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Lebowski.actor #=> "John Goodman"
+        #
+        # @faker.version 1.8.8
         def actor
           fetch('lebowski.actors')
         end
 
+        ##
+        # Produces a character from The Big Lebowski.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Lebowski.character #=> "Jackie Treehorn"
+        #
+        # @faker.version 1.8.8
         def character
           fetch('lebowski.characters')
         end
 
+        ##
+        # Produces a quote from The Big Lebowski.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Lebowski.quote #=> "Forget it, Donny, you're out of your element!"
+        #
+        # @faker.version 1.8.8
         def quote
           fetch('lebowski.quotes')
         end