Merge pull request #297 from Shopify/better-control-over-eager-loading

Move expensive resource initialization into an explicit `eager_load!` namespace method

CHANGELOG.md

@@ -27,6 +27,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 - Add `zip_prefixes` for Spain. [#295](https://github.com/Shopify/worldwide/pull/295)
+- Move expensive resource initialization into an explicit `eager_load!` namespace method
+[#297](https://github.com/Shopify/worldwide/pull/297)
 ---
 
 ## [1.12.1] - 2024-10-15

lib/worldwide.rb

@@ -39,11 +39,17 @@
 require "worldwide/util"
 require "worldwide/zip"
 
+require "worldwide/rails/railtie" if defined?(Rails::Railtie)
+
 module Worldwide
   @currencies_cache = {}
   @locales_cache = {}
 
   class << self
+    def eager_load!
+      Regions.instance
+    end
+
     def address(**kwargs)
       Address.new(**kwargs)
     end
@@ -109,6 +115,4 @@ def units
       Units
     end
   end
-
-  Regions.instance # eagerload
 end

lib/worldwide/rails/railtie.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "rails/railtie"
+
+module Worldwide
+  module Rails
+    class Railtie < ::Rails::Railtie
+      initializer "worldwide.setup" do |application|
+        application.config.eager_load_namespaces << Worldwide
+      end
+    end
+  end
+end