faker 1.8.2 → 2.23.0

data/lib/faker/music/grateful_dead.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative 'music'
+
+module Faker
+  class Music
+    class GratefulDead < Base
+      class << self
+        ##
+        # Produces the name of a member of The Grateful Dead.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::GratefulDead.player #=> "Jerry Garcia"
+        #
+        # @faker.version 1.9.2
+        def player
+          fetch('grateful_dead.players')
+        end
+
+        ##
+        # Produces the name of a song by The Grateful Dead.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::GratefulDead.song #=> "Cassidy"
+        #
+        # @faker.version 1.9.2
+        def song
+          fetch('grateful_dead.songs')
+        end
+      end
+    end
+  end
+end

data/lib/faker/music/hiphop.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Faker
+  class Music
+    class Hiphop < Base
+      class << self
+        ##
+        # Produces the name of a Hip Hop Artist
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Hiphop.artist #=> "Lil Wayne"
+        #
+        # @faker.version next
+        def artist
+          fetch('music.hiphop.artist')
+        end
+
+        ##
+        # Produces the name of a Hip Hop Group
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Hiphop.groups #=> "OVO"
+        #
+        # @faker.version next
+        def groups
+          fetch('music.hiphop.groups')
+        end
+
+        ##
+        # Produces the name of a Hip Hop Subgenre
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::Hiphop.subgeneres #=> "Alternative"
+        #
+        # @faker.version next
+        def subgenres
+          fetch('music.hiphop.subgenres')
+        end
+      end
+    end
+  end
+end

data/lib/faker/music/music.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+module Faker
+  class Music < Base
+    class << self
+      NOTE_LETTERS = %w[C D E F G A B].freeze
+      ACCIDENTAL_SIGNS = ['b', '#', ''].freeze
+      KEY_TYPES = ['', 'm'].freeze
+      CHORD_TYPES = ['', 'maj', '6', 'maj7', 'm', 'm7', '-7', '7', 'dom7', 'dim', 'dim7', 'm7b5'].freeze
+
+      ##
+      # Produces the name of a key/note, using letter notation.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Music.key #=> "A#"
+      #
+      # @faker.version 1.6.4
+      def key
+        sample(keys) + sample(key_variants)
+      end
+
+      ##
+      # Produces the name of a chord, using letter notation.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Music.chord #=> "Adim7"
+      #
+      # @faker.version 1.6.4
+      def chord
+        key + sample(chord_types)
+      end
+
+      ##
+      # Produces the name of an instrument.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Music.instrument #=> "Acoustic Guitar"
+      #
+      # @faker.version 1.6.4
+      def instrument
+        fetch('music.instruments')
+      end
+
+      ##
+      # Produces an array of the letter names of musical notes, without accidentals.
+      #
+      # @return [Array<String>]
+      #
+      # @faker.version 1.6.4
+      def keys
+        NOTE_LETTERS
+      end
+
+      ##
+      # Produces an array of accidentals (with "natural" denoted as an empty string).
+      #
+      # @return [Array<String>]
+      #
+      # @faker.version 1.6.4
+      def key_variants
+        ACCIDENTAL_SIGNS
+      end
+
+      ##
+      # Produces an array of key types (with "major" denoted as an empty string).
+      #
+      # @return [Array<String>]
+      #
+      # @example
+      #   Faker::Music.key_types #=> ['', 'm']
+      #
+      # @faker.version 1.6.4
+      def key_types
+        KEY_TYPES
+      end
+
+      ##
+      # Produces an array of types of chords.
+      #
+      # @return [Array<String>]
+      #
+      # @faker.version 1.6.4
+      def chord_types
+        CHORD_TYPES
+      end
+
+      ##
+      # Produces the name of a band.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Music.band #=> "The Beatles"
+      #
+      # @faker.version 1.9.1
+      def band
+        fetch('music.bands')
+      end
+
+      ##
+      # Produces the name of an album.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Music.album #=> "Sgt. Pepper's Lonely Hearts Club"
+      #
+      # @faker.version 1.9.1
+      def album
+        fetch('music.albums')
+      end
+
+      ##
+      # Produces the name of a musical genre.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Music.genre #=> "Rock"
+      #
+      # @faker.version 1.9.1
+      def genre
+        fetch('music.genres')
+      end
+
+      ##
+      # Produces a name from Lou Bega's Mambo #5
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::Music.mambo #=> "Monica"
+      # @faker.version next
+      def mambo_no_5
+        fetch('music.mambo_no_5')
+      end
+    end
+  end
+end

data/lib/faker/music/opera.rb

@@ -0,0 +1,298 @@
+# frozen_string_literal: true
+
+module Faker
+  # 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
+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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+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.songs')
+        end
+      end
+    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