Skip to Content Skip to Search

Instance Public methods

require_dependency(file_name, message = "No such file to load -- %s.rb")

Warning: This method is obsolete in :zeitwerk mode. In :zeitwerk mode semantics match Ruby's and you do not need to be defensive with load order. Just refer to classes and modules normally. If the constant name is dynamic, camelize if needed, and constantize.

In :classic mode, interprets a file using mechanism and marks its defined constants as autoloaded. file_name can be either a string or respond to to_path.

In :classic mode, use this method in code that absolutely needs a certain constant to be defined at that point. A typical use case is to make constant name resolution deterministic for constants with the same relative name in different namespaces whose evaluation would depend on load order otherwise.

Engines that do not control the mode in which their parent application runs should call require_dependency where needed in case the runtime mode is :classic.

# File activesupport/lib/active_support/dependencies.rb, line 282
def require_dependency(file_name, message = "No such file to load -- %s.rb")
  file_name = file_name.to_path if file_name.respond_to?(:to_path)
  unless file_name.is_a?(String)
    raise ArgumentError, "the file name must either be a String or implement #to_path -- you passed #{file_name.inspect}"

  Dependencies.depend_on(file_name, message)