faker 2.11.0 → 3.4.2

data/lib/faker/movies/star_wars.rb

@@ -119,7 +119,7 @@ module Faker
         def wookiee_sentence
           sentence = sample(wookiee_words).capitalize
 
-          rand(0..10).times { sentence += ' ' + sample(wookiee_words) }
+          rand(0..10).times { sentence += " #{sample(wookiee_words)}" }
 
           sentence + sample(['.', '?', '!'])
         end
@@ -138,11 +138,7 @@ module Faker
         #     #=> "Aren't you a little short for a Stormtrooper?"
         #
         # @faker.version 1.6.2
-        def quote(legacy_character = NOT_GIVEN, character: nil)
-          warn_for_deprecated_arguments do |keywords|
-            keywords << :character if legacy_character != NOT_GIVEN
-          end
-
+        def quote(character: nil)
           quoted_characters = translate('faker.star_wars.quotes')
 
           if character.nil?
@@ -158,37 +154,109 @@ module Faker
             raise ArgumentError, "Character for quotes can be left blank or #{quoted_characters.keys.join(', ')}" unless quoted_characters.key?(character.to_sym)
           end
 
-          fetch('star_wars.quotes.' + character)
+          fetch("star_wars.quotes.#{character}")
         end
 
+        ##
+        # Generates numbers array
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.call_numbers  #=> ["Leader", "#"]
+        #
+        # @faker.version 1.6.2
         def call_numbers
           fetch_all('star_wars.call_numbers')
         end
 
+        ##
+        # Returns squadrons array
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.call_squadrons  #=> ["Rogue", "Red", "Gray", "Green", "Blue", "Gold", "Black", "Yellow", "Phoenix"]
+        #
+        # @faker.version 1.6.2
         def call_squadrons
           fetch_all('star_wars.call_squadrons')
         end
 
+        ##
+        # Returns all character names in movie
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.characters
+        #
+        # @faker.version 1.6.2
         def characters
           fetch_all('star_wars.characters')
         end
 
+        ##
+        # Returns droid list
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.droids
+        #
+        # @faker.versionn 1.6.2
         def droids
           fetch_all('star_wars.droids')
         end
 
+        ##
+        # Lists out all planet names
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.planets
+        #
+        # @faker.version 1.6.2
         def planets
           fetch_all('star_wars.planets')
         end
 
+        ##
+        # Returns name of all species
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.species
+        #
+        # @faker.version 1.6.2
         def species
           fetch_all('star_wars.species')
         end
 
+        ##
+        # Lists out all vehicles
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.vehicles
+        #
+        # @faker.version 1.6.2
         def vehicles
           fetch_all('star_wars.vehicles')
         end
 
+        ##
+        # All wookiee words
+        #
+        # @return [Array]
+        #
+        # @example
+        #   Faker::Movies::StarWars.wookiee_words
+        #
+        # @faker.version 1.6.2
         def wookiee_words
           fetch_all('star_wars.wookiee_words')
         end

data/lib/faker/movies/the_room.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Faker
+  class Movies
+    class TheRoom < Base
+      class << self
+        ##
+        # Produces an actor from The Room (2003).
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Room.actor #=> "Tommy Wiseau"
+        #
+        # @faker.version next
+        def actor
+          fetch('the_room.actors')
+        end
+
+        ##
+        # Produces a character from The Room (2003).
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Room.character #=> "Johnny"
+        #
+        # @faker.version next
+        def character
+          fetch('the_room.characters')
+        end
+
+        ##
+        # Produces a location from The Room (2003).
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Room.location #=> "Johnny's Apartment"
+        #
+        # @faker.version next
+        def location
+          fetch('the_room.locations')
+        end
+
+        ##
+        ##
+        # Produces a quote from The Room (2003).
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Room.quote
+        #     #=> "You're lying, I never hit you. You are tearing me apart, Lisa!"
+        #
+        # @faker.version next
+        def quote
+          fetch('the_room.quotes')
+        end
+      end
+    end
+  end
+end

data/lib/faker/movies/tron.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module Faker
+  class Movies
+    class Tron < Base
+      class << self
+        ##
+        # Produces a character from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.character #=> "Bit"
+        #
+        # @faker.version next
+        def character
+          sample(characters)
+        end
+
+        ##
+        # Produces a game from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.game #=> "Space Paranoids"
+        #
+        # @faker.version next
+        def game
+          sample(games)
+        end
+
+        ##
+        # Produces a location from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.location #=> "Flynn's Arcade"
+        #
+        # @faker.version next
+        def location
+          sample(locations)
+        end
+
+        ##
+        # Produces a program from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.program #=> "Clu"
+        #
+        # @faker.version next
+        def program
+          sample(programs)
+        end
+
+        ##
+        # Produces a quote from Tron.
+        #
+        # @param character [String] The name of a character to derive a quote from.
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.quote #=> "Greetings, Programs!"
+        #
+        # @example
+        #   Faker::Movies::Tron.quote(character: "mcp")
+        #     #=> "End of Line."
+        #
+        # @faker.version next
+        def quote(character: nil)
+          quoted_characters = translate('faker.tron.quotes')
+
+          if character.nil?
+            character = sample(quoted_characters.keys).to_s
+          else
+            character = character.to_s.downcase
+
+            # check alternate spellings, nicknames, titles of characters
+            translate('faker.tron.alternate_character_spellings').each do |k, v|
+              character = k.to_s if v.include?(character)
+            end
+
+            raise ArgumentError, "Character for quotes can be left blank or #{quoted_characters.keys.join(', ')}" unless quoted_characters.key?(character.to_sym)
+          end
+
+          fetch("tron.quotes.#{character}")
+        end
+
+        ##
+        # Produces a tagline from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.tagline #=> "The Electronic Gladiator"
+        #
+        # @faker.version next
+        def tagline
+          sample(taglines)
+        end
+
+        ##
+        # Produces a user from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.user #=> "Light Cycle"
+        #
+        # @faker.version next
+        def user
+          sample(users)
+        end
+
+        ##
+        # Produces a vehicle from Tron.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Movies::Tron.vehicle #=> "Light Cycle"
+        #
+        # @faker.version next
+        def vehicle
+          sample(vehicles)
+        end
+
+        def characters
+          translate('faker.tron.characters').values.flatten
+        end
+
+        def games
+          fetch_all('tron.games')
+        end
+
+        def locations
+          fetch_all('tron.locations')
+        end
+
+        def programs
+          fetch_all('tron.characters.programs')
+        end
+
+        def taglines
+          fetch_all('tron.taglines')
+        end
+
+        def users
+          fetch_all('tron.characters.users')
+        end
+
+        def vehicles
+          fetch_all('tron.vehicles')
+        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

@@ -128,6 +128,18 @@ module Faker
       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

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