faker 2.11.0 → 2.17.0

data/lib/faker/music/opera.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Faker
-  # A generator of titles of operas by Verdi, Rossini, Donizetti and Bellini
+  # A generator of titles of operas by various composers
   class Music
     class Opera < Base
       class << self
@@ -56,6 +56,242 @@ module Faker
         def bellini
           fetch('opera.italian.by_vincenzo_bellini')
         end
+
+        ##
+        # Produces the title of an opera by Wolfgang Amadeus Mozart.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.mozart #=> "Die Zauberfloete"
+        #
+        # @faker.version next
+        def mozart
+          fetch('opera.italian.by_wolfgang_amadeus_mozart') +
+            fetch('opera.german.by_wolfgang_amadeus_mozart')
+        end
+
+        ##
+        # Produces the title of an Italian opera by Wolfgang Amadeus Mozart.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.mozart_it #=> "Cosi fan tutte"
+        #
+        # @faker.version next
+        def mozart_italian
+          fetch('opera.italian.by_wolfgang_amadeus_mozart')
+        end
+
+        ##
+        # Produces the title of a German opera by Wolfgang Amadeus Mozart.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.mozart_ger #=> "Die Zauberfloete"
+        #
+        # @faker.version next
+        def mozart_german
+          fetch('opera.german.by_wolfgang_amadeus_mozart')
+        end
+
+        ##
+        # Produces the title of an opera by Christoph Willibald Gluck.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.gluck #=> "Orfeo ed Euridice"
+        #
+        # @faker.version next
+        def gluck
+          fetch('opera.italian.by_christoph_willibald_gluck') +
+            fetch('opera.french.by_christoph_willibald_gluck')
+        end
+
+        ##
+        # Produces the title of an Italian opera by Christoph Willibald Gluck.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.gluck_it #=> "Orfeo ed Euridice"
+        #
+        # @faker.version next
+        def gluck_italian
+          fetch('opera.italian.by_christoph_willibald_gluck')
+        end
+
+        ##
+        # Produces the title of a French opera by Christoph Willibald Gluck.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.gluck_fr #=> "Orphee et Euridice"
+        #
+        # @faker.version next
+        def gluck_french
+          fetch('opera.french.by_christoph_willibald_gluck')
+        end
+
+        ##
+        # Produces the title of an opera by Ludwig van Beethoven.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.beethoven #=> "Fidelio"
+        #
+        # @faker.version next
+        def beethoven
+          fetch('opera.german.by_ludwig_van_beethoven')
+        end
+
+        ##
+        # Produces the title of an opera by Carl Maria von Weber.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.weber #=> "Der Freischuetz"
+        #
+        # @faker.version next
+        def weber
+          fetch('opera.german.by_carl_maria_von_weber')
+        end
+
+        ##
+        # Produces the title of an opera by Richard Strauss.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.strauss #=> "Elektra"
+        #
+        # @faker.version next
+        def strauss
+          fetch('opera.german.by_richard_strauss')
+        end
+
+        ##
+        # Produces the title of an opera by Richard Wagner.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.wagner #=> "Tristan und Isolde"
+        #
+        # @faker.version next
+        def wagner
+          fetch('opera.german.by_richard_wagner')
+        end
+
+        ##
+        # Produces the title of an opera by Robert Schumann.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.schumann #=> "Genoveva"
+        #
+        # @faker.version next
+        def schumann
+          fetch('opera.german.by_robert_schumann')
+        end
+
+        ##
+        # Produces the title of an opera by Franz Schubert.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.schubert #=> "Alfonso und Estrella"
+        #
+        # @faker.version next
+        def schubert
+          fetch('opera.german.by_franz_schubert')
+        end
+
+        ##
+        # Produces the title of an opera by Alban Berg.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.berg #=> "Wozzeck"
+        #
+        # @faker.version next
+        def berg
+          fetch('opera.german.by_alban_berg')
+        end
+
+        ##
+        # Produces the title of an opera by Maurice Ravel.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.ravel #=> "L'enfant et les sortileges"
+        #
+        # @faker.version next
+        def ravel
+          fetch('opera.french.by_maurice_ravel')
+        end
+
+        ##
+        # Produces the title of an opera by Hector Berlioz.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.berlioz #=> "Les Troyens"
+        #
+        # @faker.version next
+        def berlioz
+          fetch('opera.french.by_hector_berlioz')
+        end
+
+        ##
+        # Produces the title of an opera by Georges Bizet.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.bizet #=> "Carmen"
+        #
+        # @faker.version next
+        def bizet
+          fetch('opera.french.by_georges_bizet')
+        end
+
+        ##
+        # Produces the title of an opera by Charles Gounod.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.gounod #=> "Faust"
+        #
+        # @faker.version next
+        def gounod
+          fetch('opera.french.by_charles_gounod')
+        end
+
+        ##
+        # Produces the title of an opera by Camille Saint-Saens.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Opera.saint_saens #=> "Samson and Delilah"
+        #
+        # @faker.version next
+        def saint_saens
+          fetch('opera.french.by_camille_saint_saens')
+        end
       end
     end
   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 2.13.0
+        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 2.13.0
+        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 2.13.0
+        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 2.13.0
+        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 2.13.0
+        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/prince.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Faker
+  class Music
+    class Prince < Base
+      class << self
+        ##
+        # Produces a random Prince song.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Prince.song #=> "Raspberry Beret"
+        #   Faker::Music::Prince.song #=> "Starfish And Coffee"
+        #
+        # @faker.version 2.13.0
+        def song
+          fetch('prince.song')
+        end
+
+        ##
+        # Produces a random Prince song lyric.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Prince.lyric #=> "Dearly beloved, we are gathered here today to get through this thing called life."
+        #   Faker::Music::Prince.lyric #=> "You were so hard to find, the beautiful ones, they hurt you every time."
+        #
+        # @faker.version 2.13.0
+        def lyric
+          fetch('prince.lyric')
+        end
+
+        ##
+        # Produces a random Prince album.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Prince.album #=> "The Gold Experience"
+        #   Faker::Music::Prince.album #=> "Purple Rain"
+        #
+        # @faker.version 2.13.0
+        def album
+          fetch('prince.album')
+        end
+
+        ##
+        # Produces a random Prince-associated band.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Prince.band #=> "The New Power Generation"
+        #
+        # @faker.version 2.13.0
+        def band
+          fetch('prince.band')
+        end
+      end
+    end
+  end
+end

data/lib/faker/music/rock_band.rb

@@ -16,6 +16,18 @@ module Faker
         def name
           fetch('rock_band.name')
         end
+
+        # Produces a rock song.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::RockBand.song #=> "Dani California"
+        #
+        # @faker.version next
+        def song
+          fetch('rock_band.song')
+        end
       end
     end
   end

data/lib/faker/music/rush.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative 'music'
+
+module Faker
+  class Music
+    class Rush < Base
+      class << self
+        ##
+        # Produces the name of a member of Rush
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Rush.player #=> "Geddy Lee"
+        #
+        # @faker.version 2.13.0
+        def player
+          fetch('rush.players')
+        end
+
+        ##
+        # Produces the name of an album by Rush
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Rush.album #=> "Hold Your Fire"
+        #
+        # @faker.version 2.13.0
+        def album
+          fetch('rush.albums')
+        end
+      end
+    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 2.13.0
+      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 2.13.0
+      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 2.13.0
+      def play
+        fetch('show.play')
+      end
+    end
+  end
+end

data/lib/faker/quotes/quote.rb

@@ -3,30 +3,109 @@
 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 Deep Thoughts by Jack Handey.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.jack_handey # => "I hope life isn't a big joke, because I don't get it."
+      #
+      # @faker.version next
+      def jack_handey
+        fetch('quote.jack_handey')
+      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
+
+      ##
+      # Produces a quote from a fortune cookie.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Quote.fortune_cookie #=> "This cookie senses that you are superstitious; it is an inclination that is bad for your mental health."
+      #
+      # @faker.version next
+      def fortune_cookie
+        fetch('quote.fortune_cookie')
+      end
     end
   end
 end

data/lib/faker/quotes/rajnikanth.rb

@@ -6,6 +6,7 @@ module Faker
       flexible :rajnikanth
 
       class << self
+        ##
         # Produces a Rajnikanth.
         # Original list of jokes:
         # http://www.rajinikanthjokes.com/