faker 2.2.0 → 3.2.2

data/lib/faker/music/opera.rb

@@ -1,25 +1,297 @@
 # 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
+        ##
+        # 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
+
+        ##
+        # 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,8 +4,43 @@ 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.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Phish.song #=> "Tweezer"
+        #
+        # @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

@@ -4,9 +4,30 @@ module Faker
   class Music
     class RockBand < Base
       class << self
+        ##
+        # Produces the name of a rock band.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::RockBand.name #=> "Led Zeppelin"
+        #
+        # @faker.version 1.7.0
         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/music/smashing_pumpkins.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative 'music'
+
+module Faker
+  class Music
+    class SmashingPumpkins < Base
+      class << self
+        ##
+        # Produces the name of a member of the Smashing Pumpkins (current and former)
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::SmashingPumpkins.musician #=> "Billy Corgan"
+        #
+        # @faker.version next
+        def musician
+          fetch('smashing_pumpkins.musicians')
+        end
+
+        ##
+        # Produces the name of an album by the Smashing Pumpkins.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::SmashingPumpkins.album #=> "Siamese Dream"
+        #
+        # @faker.version next
+        def album
+          fetch('smashing_pumpkins.albums')
+        end
+
+        ##
+        # Produces a random Smashing Pumpkins song lyric.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::SmashingPumpkins.lyric #=> "Despite all my rage, I am still just a rat in a cage"
+        #   Faker::Music::SmashingPumpkins.lyric #=> "Breathin' underwater, and livin' under glass"
+        #
+        # @faker.version next
+        def lyric
+          fetch('smashing_pumpkins.lyric')
+        end
+
+        ##
+        # Produces the name of a song by the Smashing Pumpkins.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::SmashingPumpkins.song #=> "Stand Inside My Love"
+        #
+        # @faker.version next
+        def song
+          fetch('smashing_pumpkins.songs')
+        end
+      end
+    end
+  end
+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