faker 2.9.0 → 2.12.0

data/lib/faker/music/opera.rb

@@ -5,18 +5,54 @@ module Faker
   class Music
     class Opera < Base
       class << self
+        ##
+        # Produces the title of an opera by Giuseppe Verdi.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.verdi #=> "Il Trovatore"
+        #
+        # @faker.version 1.9.4
         def verdi
           fetch('opera.italian.by_giuseppe_verdi')
         end
 
+        ##
+        # Produces the title of an opera by Gioacchino Rossini.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.rossini #=> "Il Barbiere di Siviglia"
+        #
+        # @faker.version 1.9.4
         def rossini
           fetch('opera.italian.by_gioacchino_rossini')
         end
 
+        ##
+        # Produces the title of an opera by Gaetano Donizetti.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.donizetti #=> "Lucia di Lammermoor"
+        #
+        # @faker.version 1.9.4
         def donizetti
           fetch('opera.italian.by_gaetano_donizetti')
         end
 
+        ##
+        # Produces the title of an opera by Vincenzo Bellini.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.bellini #=> "Norma"
+        #
+        # @faker.version 1.9.4
         def bellini
           fetch('opera.italian.by_vincenzo_bellini')
         end

data/lib/faker/music/pearl_jam.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative 'music'
+
+module Faker
+  class Music
+    class PearlJam < Base
+      class << self
+        ##
+        # Produces the name of a member of Pearl Jam (current and former)
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::PearlJam.musician #=> "Eddie Vedder"
+        #
+        # @faker.version next
+        def musician
+          fetch('pearl_jam.musicians')
+        end
+
+        ##
+        # Produces the name of an album by Pearl Jam.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::PearlJam.album #=> "Ten"
+        #
+        # @faker.version next
+        def album
+          fetch('pearl_jam.albums')
+        end
+
+        ##
+        # Produces the name of a song by Pearl Jam.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::PearlJam.song #=> "Even Flow"
+        #
+        # @faker.version next
+        def song
+          fetch('pearl_jam.songs')
+        end
+      end
+    end
+  end
+end

data/lib/faker/music/phish.rb

@@ -4,6 +4,32 @@ module Faker
   class Music
     class Phish < Base
       class << self
+        ##
+        # Produces the name of a album by Phish.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Phish.album #=> "Fuego"
+        #
+        # @faker.version next
+        def album
+          fetch('phish.albums')
+        end
+
+        ##
+        # Produces the name of a musician in Phish.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Phish.musician #=> "Trey Anastasio"
+        #
+        # @faker.version next
+        def musician
+          fetch('phish.musicians')
+        end
+
         ##
         # Produces the name of a song by Phish.
         #
@@ -14,7 +40,7 @@ module Faker
         #
         # @faker.version 1.9.2
         def song
-          fetch('phish.song')
+          fetch('phish.songs')
         end
       end
     end

data/lib/faker/music/show.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Faker
+  class Show < Base
+    class << self
+      ##
+      # Produces the name of a musical for an older audience
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Alphanumeric.alpha
+      #     #=> "West Side Story"
+      #
+      # @faker.version next
+      def adult_musical
+        fetch('show.adult_musical')
+      end
+
+      ##
+      # Produces the name of a musical for a younger audience
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Alphanumeric.alpha
+      #     #=> "Into the Woods JR."
+      #
+      # @faker.version next
+      def kids_musical
+        fetch('show.kids_musical')
+      end
+
+      ##
+      # Produces the name of a play
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Alphanumeric.alpha
+      #     #=> "Death of a Salesman"
+      #
+      # @faker.version next
+      def play
+        fetch('show.play')
+      end
+    end
+  end
+end

data/lib/faker/quotes/chiquito.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Faker
+  class Quotes
+    class Chiquito < Base
+      class << self
+        ##
+        # Produces an Expression from Chiquito
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Chiquito.expression # => "Ereh un torpedo!"
+        #
+        # @faker.version 2.11.0
+        def expression
+          sample(expressions)
+        end
+
+        ##
+        # Produces a concept from Chiquito
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Chiquito.term # => "Fistro"
+        #
+        # @faker.version 2.11.0
+        def term
+          sample(terms)
+        end
+
+        ##
+        # Produces a joke from Chiquito
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Chiquito.joke # => "- Papar papar llevame al circo!
+        #                                      - Noorl! El que quiera verte que venga a la casa"
+        #
+        # @faker.version 2.11.0
+        def joke
+          sample(jokes)
+        end
+
+        ##
+        # Produces a sentence from Chiquito
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Chiquito.sentence # => "Te llamo trigo por no llamarte Rodrigo"
+        #
+        # @faker.version 2.11.0
+        def sentence
+          sample(sentences)
+        end
+
+        private
+
+        def expressions
+          fetch('chiquito.expressions')
+        end
+
+        def terms
+          fetch('chiquito.terms')
+        end
+
+        def jokes
+          fetch('chiquito.jokes')
+        end
+
+        def sentences
+          fetch('chiquito.sentences')
+        end
+      end
+    end
+  end
+end

data/lib/faker/quotes/quote.rb

@@ -3,27 +3,80 @@
 module Faker
   class Quote < Base
     class << self
+      ##
+      # Produces a famous last words quote.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.famous_last_words #=> "My vocabulary did this to me. Your love will let you go on..."
+      #
+      # @faker.version 1.9.0
       def famous_last_words
         fetch('quote.famous_last_words')
       end
 
+      ##
+      # Produces a quote from Matz.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.matz #=> "You want to enjoy life, don't you? If you get your job done quickly and your job is fun, that's good isn't it? That's the purpose of life, partly. Your life is better."
+      #
+      # @faker.version 1.9.0
       def matz
         fetch('quote.matz')
       end
 
+      ##
+      # Produces a quote about the most interesting man in the world.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.most_interesting_man_in_the_world #=> "He can speak Russian... in French"
+      #
+      # @faker.version 1.9.0
       def most_interesting_man_in_the_world
         fetch('quote.most_interesting_man_in_the_world')
       end
 
+      ##
+      # Produces a Robin quote.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.robin #=> "Holy Razors Edge"
+      #
+      # @faker.version 1.9.0
       def robin
         fetch('quote.robin')
       end
 
+      ##
+      # Produces a singular siegler quote.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.singular_siegler #=> "Texas!"
+      #
+      # @faker.version 1.9.0
       def singular_siegler
         fetch('quote.singular_siegler')
       end
 
-      # from: http://morecoolquotes.com/famous-yoda-quotes/
+      ##
+      # Produces a quote from Yoda.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.yoda #=> "Use your feelings, Obi-Wan, and find him you will."
+      #
+      # @faker.version 1.9.0
       def yoda
         fetch('quote.yoda')
       end

data/lib/faker/quotes/rajnikanth.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Faker
+  class Quotes
+    class Rajnikanth < Base
+      flexible :rajnikanth
+
+      class << self
+        # Produces a Rajnikanth.
+        # Original list of jokes:
+        # http://www.rajinikanthjokes.com/
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Rajnikanth.joke
+        #     #=> "Rajinikanth is so fast that he always comes yesterday."
+        #
+        # @faker.version 2.11.0
+        def joke
+          fetch('rajnikanth.joke')
+        end
+      end
+    end
+  end
+end

data/lib/faker/quotes/shakespeare.rb

@@ -4,18 +4,54 @@ module Faker
   class Quotes
     class Shakespeare < Base
       class << self
+        ##
+        # Produces a Shakespeare quote from Hamlet.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Shakespeare.hamlet_quote # => "To be, or not to be: that is the question."
+        #
+        # @faker.version 1.9.2
         def hamlet_quote
           sample(hamlet)
         end
 
+        ##
+        # Produces a Shakespeare quote from As You Like It.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Shakespeare.as_you_like_it_quote # => "Can one desire too much of a good thing?."
+        #
+        # @faker.version 1.9.2
         def as_you_like_it_quote
           sample(as_you_like_it)
         end
 
+        ##
+        # Produces a Shakespeare quote from King Richard III.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Shakespeare.king_richard_iii_quote # => "Now is the winter of our discontent."
+        #
+        # @faker.version 1.9.2
         def king_richard_iii_quote
           sample(king_richard_iii)
         end
 
+        ##
+        # Produces a Shakespeare quote from Romeo And Juliet.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Quotes::Shakespeare.romeo_and_juliet_quote # => "O Romeo, Romeo! wherefore art thou Romeo?."
+        #
+        # @faker.version 1.9.2
         def romeo_and_juliet_quote
           sample(romeo_and_juliet)
         end

data/lib/faker/tv_shows/suits.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Faker
+  class TvShows
+    class Suits < Base
+      flexible :suits
+
+      class << self
+        ##
+        # Produces a character from Suits.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Suits.character #=> "Harvey Specter"
+        #
+        # @faker.version next
+        def character
+          fetch('suits.characters')
+        end
+
+        ##
+        # Produces a quote from Suits.
+        #
+        # @return [String]
+        #
+        # @example
+        # Faker::TvShows::Suits.quote #=> "Don't play the odds, play the man."
+        #
+        # @faker.version next
+        def quote
+          fetch('suits.quotes')
+        end
+      end
+    end
+  end
+end