faker 3.7.1 → 3.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 78d4c5b5bfa5fdebf9bf09a55173557109e4e55ca1fdd6458a065157d5d3a380
-  data.tar.gz: cdd36c405854936c9281c0c181194c12765956d36b2ff91a20520f308c4a1a71
+  metadata.gz: 38a9d198febc038719036f12b99ba3b7f72a88bcc63335ff7246823732880d95
+  data.tar.gz: 7a01cb7591744939b8704abdf2f40e953eddb01307faea36b6a8ca000db9454d
 SHA512:
-  metadata.gz: c09170d534ec923fd18fca0c4d21e6f1c76c85f9fe83b7d98b3e8695263c3f446ff6f0576e52b0f99b7ac75381b2c7585b80b9a29d9bb29200465267fbfe7337
-  data.tar.gz: e2cdc970656cc8abddc2bacf5219262be2fd4ae4a22dcaaf3279028fb7d67fa0f4b5db149f63ca72337e4022a50a51c38074960a390beb69ec05cf62860cc2e2
+  metadata.gz: c2305eff5122ee4e9754333e8c11488a6fd2c6efc6985e8cf05f80118c2ae079aab1c0e81eee20414a6fa2cc156bf2c0a8d542792ff96d18dfaafa06965aac3d
+  data.tar.gz: 7f07790d5f5b8e4b3815fa0a9c32d28098bcf7f46f2b8d3c87e60600e61f0435b3c7bcf3260fc7b377e7765b29cc254c867530c455ab657bb869a825bd82e393

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [v3.8.0](https://github.com/faker-ruby/faker/tree/v3.8.0) (2026-04-16)
+
+* Add Lazy loading config by @stefannibrasil and @thdaraujo in https://github.com/faker-ruby/faker/pull/3244
+
+### Enabling lazy load
+
+This version introduces lazy loading. It means users will only pay for what they use. Faker [loads 2x faster](https://github.com/faker-ruby/faker/blob/main/experiments/lazy_load.md) when it's enabled.
+
+Lazy loading the generators is disabled by default. To enable it, choose one of the configuration options below:
+
+#### 1 - Set lazy load as a Faker Config
+
+`Faker::Config.lazy_loading = true`
+
+#### 2 - Set lazy load as an environment variable
+
+`FAKER_LAZY_LOAD = 1`
+
+We hope you get to see the improvement by enabling it. Please file a bug report for any issues!
+
+Thanks to @jeremyevans for the mentoring, and to @thdaraujo for pairing and code reviews.
+
+**Full Changelog**: https://github.com/faker-ruby/faker/compare/v3.7.1...v3.8.0
+
+-----------------------
+
 ## [v3.7.1](https://github.com/faker-ruby/faker/tree/v3.7.1) (2026-04-14)
 
 Thanks to all contributors!
@@ -26,6 +52,8 @@ Thanks to all contributors!
 
 **Full Changelog**: https://github.com/faker-ruby/faker/compare/v3.6.1...v3.7.1
 
+--------------------------------
+
 ## [v3.6.1](https://github.com/faker-ruby/faker/tree/v3.6.1) (2026-03-04)
 
 It's almost Spring time in the Northern hemisphere 🌸 

data/lib/faker/blockchain.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Blockchain
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/books.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Books
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/creature.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Creature
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/default/html.rb

@@ -14,7 +14,7 @@ module Faker
       # @faker.version 3.2.1
       def heading
         level = rand(1..6)
-        "<h#{level}>#{Lorem.word.capitalize}</h#{level}>"
+        "<h#{level}>#{Faker::Lorem.word.capitalize}</h#{level}>"
       end
 
       ##
@@ -97,7 +97,7 @@ module Faker
       #
       # @faker.version 3.2.1
       def code
-        "<code>#{Lorem.sentence(word_count: 1)}</code>"
+        "<code>#{Faker::Lorem.sentence(word_count: 1)}</code>"
       end
 
       ##
@@ -165,7 +165,7 @@ module Faker
       #   Faker::HTML.element(tag: 'div', content: "This is a div with XSS attributes.", attributes: {class: 'xss', onclick: "alert('XSS')"}) #=> "<div class=\"xss\" onclick=\"alert('XSS')\">This is a div with XSS attributes.</div>"
       #
       # @faker.version 3.2.1
-      def element(tag: 'div', content: Lorem.sentence(word_count: 3), attributes: { class: Lorem.word, onclick: "#{Lorem.word}()" })
+      def element(tag: 'div', content: Faker::Lorem.sentence(word_count: 3), attributes: { class: Faker::Lorem.word, onclick: "#{Faker::Lorem.word}()" })
         attribute_string = attributes.map { |key, value| "#{key}=\"#{value}\"" }.join(' ')
         "<#{tag} #{attribute_string}>#{content}</#{tag}>"
       end

data/lib/faker/default/lorem.rb

@@ -58,7 +58,7 @@ module Faker
       #
       # @faker.version 2.1.3
       def character
-        sample(Types::CHARACTERS)
+        sample(Faker::Types::CHARACTERS)
       end
 
       ##
@@ -78,7 +78,7 @@ module Faker
       #
       # @faker.version 2.1.3
       def characters(number: 255, min_alpha: 0, min_numeric: 0)
-        Alphanumeric.alphanumeric(number: number, min_alpha: min_alpha, min_numeric: min_numeric)
+        Faker::Alphanumeric.alphanumeric(number: number, min_alpha: min_alpha, min_numeric: min_numeric)
       end
 
       ##

data/lib/faker/default/markdown.rb

@@ -13,7 +13,7 @@ module Faker
       #
       # @faker.version 1.8.0
       def headers
-        "#{fetch('markdown.headers')} #{Lorem.word.capitalize}"
+        "#{fetch('markdown.headers')} #{Faker::Lorem.word.capitalize}"
       end
 
       ##
@@ -95,7 +95,7 @@ module Faker
       #
       # @faker.version 1.8.0
       def block_code
-        "```ruby\n#{Lorem.sentence(word_count: 1)}\n```"
+        "```ruby\n#{Faker::Lorem.sentence(word_count: 1)}\n```"
       end
 
       ##
@@ -110,7 +110,7 @@ module Faker
       def table
         table = []
         3.times do
-          table << "#{Lorem.word} | #{Lorem.word} | #{Lorem.word}"
+          table << "#{Faker::Lorem.word} | #{Faker::Lorem.word} | #{Faker::Lorem.word}"
         end
         table.insert(1, '---- | ---- | ----')
         table.join("\n")

data/lib/faker/default/omniauth.rb

@@ -11,8 +11,8 @@ module Faker
     def initialize(name: nil, email: nil)
       super()
 
-      @name = name || "#{Name.first_name} #{Name.last_name}"
-      @email = email || Internet.email(name: self.name)
+      @name = name || "#{Faker::Name.first_name} #{Faker::Name.last_name}"
+      @email = email || Faker::Internet.email(name: self.name)
       @first_name, @last_name = self.name.split
     end
 
@@ -27,8 +27,8 @@ module Faker
       # @return [Hash] An auth hash in the format provided by omniauth-google.
       #
       # @faker.version 1.8.0
-      def google(name: nil, email: nil, uid: Number.number(digits: 9).to_s)
-        auth = Omniauth.new(name: name, email: email)
+      def google(name: nil, email: nil, uid: Faker::Number.number(digits: 9).to_s)
+        auth = new(name: name, email: email)
         {
           provider: 'google_oauth2',
           uid: uid,
@@ -40,9 +40,9 @@ module Faker
             image: image
           },
           credentials: {
-            token: Crypto.md5,
-            refresh_token: Crypto.md5,
-            expires_at: Time.forward.to_i,
+            token: Faker::Crypto.md5,
+            refresh_token: Faker::Crypto.md5,
+            expires_at: Faker::Time.forward.to_i,
             expires: true
           },
           extra: {
@@ -56,20 +56,20 @@ module Faker
               profile: "https://plus.google.com/#{uid}",
               picture: image,
               gender: gender,
-              birthday: Date.backward(days: 36_400).strftime('%Y-%m-%d'),
+              birthday: Faker::Date.backward(days: 36_400).strftime('%Y-%m-%d'),
               locale: 'en',
-              hd: "#{Company.name.downcase}.com"
+              hd: "#{Faker::Company.name.downcase}.com"
             },
             id_info: {
               iss: 'accounts.google.com',
-              at_hash: Crypto.md5,
+              at_hash: Faker::Crypto.md5,
               email_verified: true,
-              sub: Number.number(digits: 28).to_s,
+              sub: Faker::Number.number(digits: 28).to_s,
               azp: 'APP_ID',
               email: auth.email,
               aud: 'APP_ID',
-              iat: Time.forward.to_i,
-              exp: Time.forward.to_i,
+              iat: Faker::Time.forward.to_i,
+              exp: Faker::Time.forward.to_i,
               openid_id: "https://www.google.com/accounts/o8/id?id=#{uid}"
             }
           }
@@ -87,8 +87,8 @@ module Faker
       # @return [Hash] An auth hash in the format provided by omniauth-facebook.
       #
       # @faker.version 1.8.0
-      def facebook(name: nil, email: nil, username: nil, uid: Number.number(digits: 7).to_s)
-        auth = Omniauth.new(name: name, email: email)
+      def facebook(name: nil, email: nil, username: nil, uid: Faker::Number.number(digits: 7).to_s)
+        auth = new(name: name, email: email)
         username ||= "#{auth.first_name.downcase[0]}#{auth.last_name.downcase}"
         {
           provider: 'facebook',
@@ -102,7 +102,7 @@ module Faker
             verified: random_boolean
           },
           credentials: {
-            token: Crypto.md5,
+            token: Faker::Crypto.md5,
             expires_at: Time.forward.to_i,
             expires: true
           },
@@ -115,7 +115,7 @@ module Faker
               link: "http://www.facebook.com/#{username}",
               username: username,
               location: {
-                id: Number.number(digits: 9).to_s,
+                id: Faker::Number.number(digits: 9).to_s,
                 name: city_state
               },
               gender: gender,
@@ -123,7 +123,7 @@ module Faker
               timezone: timezone,
               locale: 'en_US',
               verified: random_boolean,
-              updated_time: Time.backward.iso8601
+              updated_time: Faker::Time.backward.iso8601
             }
           }
         }
@@ -139,11 +139,11 @@ module Faker
       # @return [Hash] An auth hash in the format provided by omniauth-twitter.
       #
       # @faker.version 1.8.0
-      def twitter(name: nil, nickname: nil, uid: Number.number(digits: 6).to_s)
-        auth = Omniauth.new(name: name)
+      def twitter(name: nil, nickname: nil, uid: Faker::Number.number(digits: 6).to_s)
+        auth = new(name: name)
         nickname ||= auth.name.downcase.delete(' ')
         location = city_state
-        description = Lorem.sentence
+        description = Faker::Lorem.sentence
         {
           provider: 'twitter',
           uid: uid,
@@ -159,26 +159,26 @@ module Faker
             }
           },
           credentials: {
-            token: Crypto.md5,
-            secret: Crypto.md5
+            token: Faker::Crypto.md5,
+            secret: Faker::Crypto.md5
           },
           extra: {
             access_token: '',
             raw_info: {
               name: auth.name,
               listed_count: random_number_from_range(1..10),
-              profile_sidebar_border_color: Color.hex_color,
+              profile_sidebar_border_color: Faker::Color.hex_color,
               url: nil,
               lang: 'en',
               statuses_count: random_number_from_range(1..1000),
               profile_image_url: image,
               profile_background_image_url_https: image,
               location: location,
-              time_zone: Address.city,
+              time_zone: Faker::Address.city,
               follow_request_sent: random_boolean,
               id: uid,
               profile_background_tile: random_boolean,
-              profile_sidebar_fill_color: Color.hex_color,
+              profile_sidebar_fill_color: Faker::Color.hex_color,
               followers_count: random_number_from_range(1..10_000),
               default_profile_image: random_boolean,
               screen_name: '',
@@ -186,7 +186,7 @@ module Faker
               utc_offset: timezone,
               verified: random_boolean,
               favourites_count: random_number_from_range(1..10),
-              profile_background_color: Color.hex_color,
+              profile_background_color: Faker::Color.hex_color,
               is_translator: random_boolean,
               friends_count: random_number_from_range(1..10_000),
               notifications: random_boolean,
@@ -194,8 +194,8 @@ module Faker
               profile_background_image_url: image,
               protected: random_boolean,
               description: description,
-              profile_link_color: Color.hex_color,
-              created_at: Time.backward.strftime('%a %b %d %H:%M:%S %z %Y'),
+              profile_link_color: Faker::Color.hex_color,
+              created_at: Faker::Time.backward.strftime('%a %b %d %H:%M:%S %z %Y'),
               id_str: uid,
               profile_image_url_https: image,
               default_profile: random_boolean,
@@ -222,15 +222,15 @@ module Faker
       # @return [Hash] An auth hash in the format provided by omniauth-linkedin.
       #
       # @faker.version 1.8.0
-      def linkedin(name: nil, email: nil, uid: Number.number(digits: 6).to_s)
+      def linkedin(name: nil, email: nil, uid: Faker::Number.number(digits: 6).to_s)
         auth = Omniauth.new(name: name, email: email)
         first_name = auth.first_name.downcase
         last_name = auth.last_name.downcase
         location = city_state
-        description = Lorem.sentence
-        token = Crypto.md5
-        secret = Crypto.md5
-        industry = Commerce.department
+        description = Faker::Lorem.sentence
+        token = Faker::Crypto.md5
+        secret = Faker::Crypto.md5
+        industry = Faker::Commerce.department
         url = "http://www.linkedin.com/in/#{first_name}#{last_name}"
         {
           provider: 'linkedin',
@@ -244,7 +244,7 @@ module Faker
             location: location,
             description: description,
             image: image,
-            phone: PhoneNumber.phone_number,
+            phone: Faker::PhoneNumber.phone_number,
             headline: description,
             industry: industry,
             urls: {
@@ -275,7 +275,7 @@ module Faker
               industry: industry,
               lastName: auth.last_name,
               location: {
-                country: { code: Address.country_code.downcase },
+                country: { code: Faker::Address.country_code.downcase },
                 name: city_state.split(', ').first
               },
               pictureUrl: image,
@@ -295,8 +295,8 @@ module Faker
       # @return [Hash] An auth hash in the format provided by omniauth-github.
       #
       # @faker.version 1.8.0
-      def github(name: nil, email: nil, uid: Number.number(digits: 8).to_s)
-        auth = Omniauth.new(name: name, email: email)
+      def github(name: nil, email: nil, uid: Faker::Number.number(digits: 8).to_s)
+        auth = new(name: name, email: email)
         login = auth.name.downcase.tr(' ', '-')
         html_url = "https://github.com/#{login}"
         api_url = "https://api.github.com/users/#{login}"
@@ -346,8 +346,8 @@ module Faker
               public_gists: random_number_from_range(1..1000),
               followers: random_number_from_range(1..1000),
               following: random_number_from_range(1..1000),
-              created_at: Time.backward(days: 36_400).iso8601,
-              updated_at: Time.backward(days: 2).iso8601
+              created_at: Faker::Time.backward(days: 36_400).iso8601,
+              updated_at: Faker::Time.backward(days: 2).iso8601
             }
           }
         }
@@ -364,8 +364,8 @@ module Faker
       #
       # @faker.version 2.3.0
       def apple(name: nil, email: nil, uid: nil)
-        uid ||= "#{Number.number(digits: 6)}.#{Number.hexadecimal(digits: 32)}.#{Number.number(digits: 4)}"
-        auth = Omniauth.new(name: name, email: email)
+        uid ||= "#{Faker::Number.number(digits: 6)}.#{Faker::Number.hexadecimal(digits: 32)}.#{Faker::Number.number(digits: 4)}"
+        auth = new(name: name, email: email)
         {
           provider: 'apple',
           uid: uid,
@@ -376,20 +376,20 @@ module Faker
             last_name: auth.last_name
           },
           credentials: {
-            token: Crypto.md5,
-            refresh_token: Crypto.md5,
-            expires_at: Time.forward.to_i,
+            token: Faker::Crypto.md5,
+            refresh_token: Faker::Crypto.md5,
+            expires_at: Faker::Time.forward.to_i,
             expires: true
           },
           extra: {
             raw_info: {
               iss: 'https://appleid.apple.com',
               aud: 'CLIENT_ID',
-              exp: Time.forward.to_i,
-              iat: Time.forward.to_i,
+              exp: Faker::Time.forward.to_i,
+              iat: Faker::Time.forward.to_i,
               sub: uid,
-              at_hash: Crypto.md5,
-              auth_time: Time.forward.to_i,
+              at_hash: Faker::Crypto.md5,
+              auth_time: Faker::Time.forward.to_i,
               email: auth.email,
               email_verified: true
             }
@@ -408,8 +408,8 @@ module Faker
       #
       # @faker.version next
       def auth0(name: nil, email: nil, uid: nil)
-        uid ||= "auth0|#{Number.hexadecimal(digits: 24)}"
-        auth = Omniauth.new(name: name, email: email)
+        uid ||= "auth0|#{Faker::Number.hexadecimal(digits: 24)}"
+        auth = new(name: name, email: email)
         {
           provider: 'auth0',
           uid: uid,
@@ -423,9 +423,9 @@ module Faker
             expires_at: Time.forward.to_i,
             expires: true,
             token_type: 'Bearer',
-            id_token: Crypto.sha256,
-            token: Crypto.md5,
-            refresh_token: Crypto.md5
+            id_token: Faker::Crypto.sha256,
+            token: Faker::Crypto.md5,
+            refresh_token: Faker::Crypto.md5
           },
           extra: {
             raw_info: {
@@ -434,8 +434,8 @@ module Faker
               iss: 'https://auth0.com/',
               sub: uid,
               aud: 'Auth012345',
-              iat: Time.forward.to_i,
-              exp: Time.forward.to_i
+              iat: Faker::Time.forward.to_i,
+              exp: Faker::Time.forward.to_i
             }
           }
         }
@@ -452,11 +452,11 @@ module Faker
       end
 
       def image
-        Placeholdit.image
+        Faker::Placeholdit.image
       end
 
       def city_state
-        "#{Address.city}, #{Address.state}"
+        "#{Faker::Address.city}, #{Faker::Address.state}"
       end
 
       def random_number_from_range(range)

data/lib/faker/default.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Default
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/fantasy.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Fantasy
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/games.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Games
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/{default/internet.rb → internet.rb}

@@ -2,6 +2,10 @@
 
 module Faker
   class Internet < Base
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+
     # Private, Host, and Link-Local network address blocks as defined in https://en.wikipedia.org/wiki/IPv4#Special-use_addresses
     PRIVATE_IPV4_ADDRESS_RANGES = [
       [10..10,   0..255,   0..255, 1..255], # 10.0.0.0/8     - Used for local communications within a private network
@@ -93,8 +97,8 @@ module Faker
           end
 
           sample([
-                   Char.prepare(Name.first_name),
-                   [Name.first_name, Name.last_name].map do |name|
+                   Char.prepare(Faker::Name.first_name),
+                   [Faker::Name.first_name, Faker::Name.last_name].map do |name|
                      Char.prepare(name)
                    end.join(sample(separators))
                  ])
@@ -235,7 +239,7 @@ module Faker
       # @example
       #   Faker::Internet.domain_word   #=> "senger"
       def domain_word
-        with_locale(:en) { Char.prepare(Company.name.split.first) }
+        with_locale(:en) { Char.prepare(Faker::Company.name.split.first) }
       end
 
       ## Returns the domain suffix e.g. com, org, co, biz, info etc.

data/lib/faker/japanese_media.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class JapaneseMedia
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/locations.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Locations
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/movies.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Movies
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/music/bossa_nova.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'music'
-
 module Faker
   class Music
     class BossaNova < Base

data/lib/faker/music/grateful_dead.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'music'
-
 module Faker
   class Music
     class GratefulDead < Base

data/lib/faker/music/pearl_jam.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'music'
-
 module Faker
   class Music
     class PearlJam < Base

data/lib/faker/music/rush.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'music'
-
 module Faker
   class Music
     class Rush < Base

data/lib/faker/music/smashing_pumpkins.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'music'
-
 module Faker
   class Music
     class SmashingPumpkins < Base

data/lib/faker/{music/music.rb → music.rb}

@@ -2,6 +2,10 @@
 
 module Faker
   class Music < Base
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+
     class << self
       NOTE_LETTERS = %w[C D E F G A B].freeze
       ACCIDENTAL_SIGNS = ['b', '#', ''].freeze

data/lib/faker/quotes.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Quotes
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/religion/bible.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Faker
-  module Religion
+  class Religion
     class Bible < Base
       flexible :bible
 

data/lib/faker/religion.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Religion
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/sports.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Sports
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/travel.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class Travel
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/tv_shows.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Faker
+  class TvShows
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Faker # :nodoc:
-  VERSION = '3.7.1'
+  VERSION = '3.8.0'
 end

data/lib/faker.rb

@@ -38,6 +38,18 @@ module Faker
       def random
         Thread.current[:faker_config_random] || Random
       end
+
+      def lazy_loading?
+        if ENV.key?('FAKER_LAZY_LOAD') && !ENV['FAKER_LAZY_LOAD'].nil?
+          %w[true TRUE 1].include?(ENV.fetch('FAKER_LAZY_LOAD', nil))
+        else
+          Thread.current[:faker_lazy_loading] == true
+        end
+      end
+
+      def lazy_loading=(value)
+        Thread.current[:faker_lazy_loading] = value
+      end
     end
   end
 
@@ -275,7 +287,47 @@ module Faker
       end
     end
   end
+
+  if Faker::Config.lazy_loading?
+    def self.load_path(*constants)
+      constants.map do |class_name|
+        class_name
+          .to_s
+          .gsub('::', '/')
+          .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+          .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+          .tr('-', '_')
+          .downcase
+      end.join('/')
+    end
+
+    def self.lazy_load(klass)
+      def klass.const_missing(class_name)
+        load_path = case class_name
+                    when :DnD
+                      Faker.load_path('faker/games/dnd')
+                    else
+                      Faker.load_path(name, class_name)
+                    end
+
+        begin
+          require(load_path)
+        rescue LoadError
+          require(load_path.gsub('faker/', 'faker/default/'))
+        end
+
+        const_get(class_name)
+      end
+    end
+
+    lazy_load(self)
+  end
 end
 
-# require faker objects
-Dir.glob(File.join(mydir, 'faker', '/**/*.rb')).each { |file| require file }
+unless Faker::Config.lazy_loading?
+  rb_files = []
+  rb_files << File.join(mydir, 'faker', '*.rb')
+  rb_files << File.join(mydir, 'faker', '/**/*.rb')
+
+  Dir.glob(rb_files).each { |file| require file }
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: faker
 version: !ruby/object:Gem::Version
-  version: 3.7.1
+  version: 3.8.0
 platform: ruby
 authors:
 - Benjamin Curtis
@@ -45,20 +45,23 @@ files:
 - README.md
 - bin/faker
 - lib/faker.rb
+- lib/faker/blockchain.rb
 - lib/faker/blockchain/aeternity.rb
 - lib/faker/blockchain/bitcoin.rb
 - lib/faker/blockchain/ethereum.rb
 - lib/faker/blockchain/tezos.rb
-- lib/faker/books/book.rb
+- lib/faker/books.rb
 - lib/faker/books/culture_series.rb
 - lib/faker/books/dune.rb
 - lib/faker/books/lovecraft.rb
 - lib/faker/books/the_kingkiller_chronicle.rb
+- lib/faker/creature.rb
 - lib/faker/creature/animal.rb
 - lib/faker/creature/bird.rb
 - lib/faker/creature/cat.rb
 - lib/faker/creature/dog.rb
 - lib/faker/creature/horse.rb
+- lib/faker/default.rb
 - lib/faker/default/address.rb
 - lib/faker/default/adjective.rb
 - lib/faker/default/alphanumeric.rb
@@ -71,6 +74,7 @@ files:
 - lib/faker/default/barcode.rb
 - lib/faker/default/beer.rb
 - lib/faker/default/blood.rb
+- lib/faker/default/book.rb
 - lib/faker/default/boolean.rb
 - lib/faker/default/business.rb
 - lib/faker/default/camera.rb
@@ -105,6 +109,7 @@ files:
 - lib/faker/default/finance.rb
 - lib/faker/default/food.rb
 - lib/faker/default/funny_name.rb
+- lib/faker/default/game.rb
 - lib/faker/default/gender.rb
 - lib/faker/default/greek_philosophers.rb
 - lib/faker/default/hacker.rb
@@ -114,8 +119,6 @@ files:
 - lib/faker/default/html.rb
 - lib/faker/default/id_number.rb
 - lib/faker/default/industry_segments.rb
-- lib/faker/default/internet.rb
-- lib/faker/default/internet_http.rb
 - lib/faker/default/invoice.rb
 - lib/faker/default/job.rb
 - lib/faker/default/json.rb
@@ -127,6 +130,7 @@ files:
 - lib/faker/default/measurement.rb
 - lib/faker/default/military.rb
 - lib/faker/default/mountain.rb
+- lib/faker/default/movie.rb
 - lib/faker/default/name.rb
 - lib/faker/default/nation.rb
 - lib/faker/default/national_health_service.rb
@@ -136,14 +140,15 @@ files:
 - lib/faker/default/phone_number.rb
 - lib/faker/default/placeholdit.rb
 - lib/faker/default/programming_language.rb
+- lib/faker/default/quote.rb
 - lib/faker/default/relationship.rb
-- lib/faker/default/religion.rb
 - lib/faker/default/restaurant.rb
 - lib/faker/default/science.rb
 - lib/faker/default/slack_emoji.rb
 - lib/faker/default/source.rb
 - lib/faker/default/south_africa.rb
 - lib/faker/default/space.rb
+- lib/faker/default/sport.rb
 - lib/faker/default/string.rb
 - lib/faker/default/stripe.rb
 - lib/faker/default/subscription.rb
@@ -159,7 +164,9 @@ files:
 - lib/faker/default/vulnerability_identifier.rb
 - lib/faker/default/world_cup.rb
 - lib/faker/default/x.rb
+- lib/faker/fantasy.rb
 - lib/faker/fantasy/tolkien.rb
+- lib/faker/games.rb
 - lib/faker/games/clash_of_clans.rb
 - lib/faker/games/control.rb
 - lib/faker/games/dnd.rb
@@ -167,7 +174,6 @@ files:
 - lib/faker/games/elder_scrolls.rb
 - lib/faker/games/fallout.rb
 - lib/faker/games/final_fantasy_xiv.rb
-- lib/faker/games/game.rb
 - lib/faker/games/half_life.rb
 - lib/faker/games/heroes.rb
 - lib/faker/games/heroes_of_the_storm.rb
@@ -186,6 +192,9 @@ files:
 - lib/faker/games/witcher.rb
 - lib/faker/games/world_of_warcraft.rb
 - lib/faker/games/zelda.rb
+- lib/faker/internet.rb
+- lib/faker/internet/http.rb
+- lib/faker/japanese_media.rb
 - lib/faker/japanese_media/conan.rb
 - lib/faker/japanese_media/cowboy_bebop.rb
 - lib/faker/japanese_media/doraemon.rb
@@ -196,7 +205,9 @@ files:
 - lib/faker/japanese_media/one_piece.rb
 - lib/faker/japanese_media/studio_ghibli.rb
 - lib/faker/japanese_media/sword_art_online.rb
+- lib/faker/locations.rb
 - lib/faker/locations/australia.rb
+- lib/faker/movies.rb
 - lib/faker/movies/avatar.rb
 - lib/faker/movies/back_to_the_future.rb
 - lib/faker/movies/departed.rb
@@ -208,16 +219,15 @@ files:
 - lib/faker/movies/how_to_train_your_dragon.rb
 - lib/faker/movies/lebowski.rb
 - lib/faker/movies/lord_of_the_rings.rb
-- lib/faker/movies/movie.rb
 - lib/faker/movies/princess_bride.rb
 - lib/faker/movies/star_wars.rb
 - lib/faker/movies/the_room.rb
 - lib/faker/movies/tron.rb
 - lib/faker/movies/v_for_vendetta.rb
+- lib/faker/music.rb
 - lib/faker/music/bossa_nova.rb
 - lib/faker/music/grateful_dead.rb
 - lib/faker/music/hiphop.rb
-- lib/faker/music/music.rb
 - lib/faker/music/opera.rb
 - lib/faker/music/pearl_jam.rb
 - lib/faker/music/phish.rb
@@ -226,19 +236,22 @@ files:
 - lib/faker/music/rush.rb
 - lib/faker/music/smashing_pumpkins.rb
 - lib/faker/music/umphreys_mcgee.rb
+- lib/faker/quotes.rb
 - lib/faker/quotes/chiquito.rb
-- lib/faker/quotes/quote.rb
 - lib/faker/quotes/rajnikanth.rb
 - lib/faker/quotes/shakespeare.rb
+- lib/faker/religion.rb
 - lib/faker/religion/bible.rb
+- lib/faker/sports.rb
 - lib/faker/sports/basketball.rb
 - lib/faker/sports/chess.rb
 - lib/faker/sports/football.rb
 - lib/faker/sports/mountaineering.rb
-- lib/faker/sports/sport.rb
 - lib/faker/sports/volleyball.rb
+- lib/faker/travel.rb
 - lib/faker/travel/airport.rb
 - lib/faker/travel/train_station.rb
+- lib/faker/tv_shows.rb
 - lib/faker/tv_shows/aqua_teen_hunger_force.rb
 - lib/faker/tv_shows/archer.rb
 - lib/faker/tv_shows/big_bang_theory.rb

data/lib/faker/default/religion.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-module Faker
-  module Religion
-  end
-end