2009-03-21 07:00:38 -04:00
|
|
|
require 'set'
|
2009-04-22 19:41:06 -04:00
|
|
|
require 'thread'
|
2010-02-14 13:47:50 -05:00
|
|
|
require 'pathname'
|
2009-03-29 02:50:31 -04:00
|
|
|
require 'active_support/core_ext/module/aliasing'
|
|
|
|
require 'active_support/core_ext/module/attribute_accessors'
|
|
|
|
require 'active_support/core_ext/module/introspection'
|
2010-02-14 14:18:34 -05:00
|
|
|
require 'active_support/core_ext/module/anonymous'
|
2009-04-22 20:41:28 -04:00
|
|
|
require 'active_support/core_ext/object/blank'
|
|
|
|
require 'active_support/core_ext/load_error'
|
|
|
|
require 'active_support/core_ext/name_error'
|
|
|
|
require 'active_support/core_ext/string/starts_ends_with'
|
|
|
|
require 'active_support/inflector'
|
2009-03-21 07:00:38 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
module ActiveSupport #:nodoc:
|
|
|
|
module Dependencies #:nodoc:
|
|
|
|
extend self
|
|
|
|
|
|
|
|
# Should we turn on Ruby warnings on the first load of dependent files?
|
|
|
|
mattr_accessor :warnings_on_first_load
|
|
|
|
self.warnings_on_first_load = false
|
|
|
|
|
|
|
|
# All files ever loaded.
|
|
|
|
mattr_accessor :history
|
|
|
|
self.history = Set.new
|
|
|
|
|
|
|
|
# All files currently loaded.
|
|
|
|
mattr_accessor :loaded
|
|
|
|
self.loaded = Set.new
|
|
|
|
|
|
|
|
# Should we load files or require them?
|
|
|
|
mattr_accessor :mechanism
|
2009-03-26 22:10:13 -04:00
|
|
|
self.mechanism = ENV['NO_RELOAD'] ? :require : :load
|
2008-06-03 14:32:53 -04:00
|
|
|
|
|
|
|
# The set of directories from which we may automatically load files. Files
|
|
|
|
# under these directories will be reloaded on each request in development mode,
|
2010-06-22 17:17:20 -04:00
|
|
|
# unless the directory also appears in autoload_once_paths.
|
|
|
|
mattr_accessor :autoload_paths
|
|
|
|
self.autoload_paths = []
|
2008-06-03 14:32:53 -04:00
|
|
|
|
|
|
|
# The set of directories from which automatically loaded constants are loaded
|
2010-06-22 17:17:20 -04:00
|
|
|
# only once. All directories in this set must also be present in +autoload_paths+.
|
|
|
|
mattr_accessor :autoload_once_paths
|
|
|
|
self.autoload_once_paths = []
|
2008-06-03 14:32:53 -04:00
|
|
|
|
|
|
|
# An array of qualified constant names that have been loaded. Adding a name to
|
|
|
|
# this array will cause it to be unloaded the next time Dependencies are cleared.
|
|
|
|
mattr_accessor :autoloaded_constants
|
|
|
|
self.autoloaded_constants = []
|
|
|
|
|
2010-06-04 20:28:04 -04:00
|
|
|
mattr_accessor :references
|
|
|
|
self.references = {}
|
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# An array of constant names that need to be unloaded on every request. Used
|
|
|
|
# to allow arbitrary constants to be marked for unloading.
|
|
|
|
mattr_accessor :explicitly_unloadable_constants
|
|
|
|
self.explicitly_unloadable_constants = []
|
|
|
|
|
2008-08-18 23:38:58 -04:00
|
|
|
# The logger is used for generating information on the action run-time (including benchmarking) if available.
|
|
|
|
# Can be set to nil for no logging. Compatible with both Ruby's own Logger and Log4r loggers.
|
|
|
|
mattr_accessor :logger
|
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Set to true to enable logging of const_missing and file loads
|
|
|
|
mattr_accessor :log_activity
|
|
|
|
self.log_activity = false
|
|
|
|
|
2010-08-02 16:55:55 -04:00
|
|
|
# The WatchStack keeps a stack of the modules being watched as files are loaded.
|
2010-09-05 10:23:39 -04:00
|
|
|
# If a file in the process of being loaded (parent.rb) triggers the load of
|
|
|
|
# another file (child.rb) the stack will ensure that child.rb handles the new
|
2010-08-02 16:55:55 -04:00
|
|
|
# constants.
|
|
|
|
#
|
|
|
|
# If child.rb is being autoloaded, its constants will be added to
|
|
|
|
# autoloaded_constants. If it was being `require`d, they will be discarded.
|
|
|
|
#
|
|
|
|
# This is handled by walking back up the watch stack and adding the constants
|
|
|
|
# found by child.rb to the list of original constants in parent.rb
|
|
|
|
class WatchStack < Hash
|
|
|
|
# @watching is a stack of lists of constants being watched. For instance,
|
|
|
|
# if parent.rb is autoloaded, the stack will look like [[Object]]. If parent.rb
|
|
|
|
# then requires namespace/child.rb, the stack will look like [[Object], [Namespace]].
|
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
def initialize
|
2010-08-02 16:55:55 -04:00
|
|
|
@watching = []
|
|
|
|
super { |h,k| h[k] = [] }
|
2010-02-14 13:47:50 -05:00
|
|
|
end
|
|
|
|
|
2010-09-13 16:53:39 -04:00
|
|
|
# return a list of new constants found since the last call to watch_namespaces
|
2010-08-02 16:55:55 -04:00
|
|
|
def new_constants
|
|
|
|
constants = []
|
2010-02-14 13:47:50 -05:00
|
|
|
|
2010-08-02 16:55:55 -04:00
|
|
|
# Grab the list of namespaces that we're looking for new constants under
|
|
|
|
@watching.last.each do |namespace|
|
2010-09-13 16:53:39 -04:00
|
|
|
# Retrieve the constants that were present under the namespace when watch_namespaces
|
2010-08-02 16:55:55 -04:00
|
|
|
# was originally called
|
|
|
|
original_constants = self[namespace].last
|
2010-02-14 13:47:50 -05:00
|
|
|
|
2010-08-02 16:55:55 -04:00
|
|
|
mod = Inflector.constantize(namespace) if Dependencies.qualified_const_defined?(namespace)
|
2010-02-14 13:47:50 -05:00
|
|
|
next unless mod.is_a?(Module)
|
|
|
|
|
2010-08-02 16:55:55 -04:00
|
|
|
# Get a list of the constants that were added
|
|
|
|
new_constants = mod.local_constant_names - original_constants
|
|
|
|
|
|
|
|
# self[namespace] returns an Array of the constants that are being evaluated
|
|
|
|
# for that namespace. For instance, if parent.rb requires child.rb, the first
|
|
|
|
# element of self[Object] will be an Array of the constants that were present
|
|
|
|
# before parent.rb was required. The second element will be an Array of the
|
|
|
|
# constants that were present before child.rb was required.
|
2010-08-17 19:50:19 -04:00
|
|
|
self[namespace].each do |namespace_constants|
|
|
|
|
namespace_constants.concat(new_constants)
|
2010-07-26 03:59:54 -04:00
|
|
|
end
|
2010-02-14 13:47:50 -05:00
|
|
|
|
2010-08-02 16:55:55 -04:00
|
|
|
# Normalize the list of new constants, and add them to the list we will return
|
2010-02-19 13:10:45 -05:00
|
|
|
new_constants.each do |suffix|
|
2010-08-02 16:55:55 -04:00
|
|
|
constants << ([namespace, suffix] - ["Object"]).join("::")
|
2010-02-14 13:47:50 -05:00
|
|
|
end
|
2010-02-19 13:10:45 -05:00
|
|
|
end
|
|
|
|
constants
|
2010-08-02 16:55:55 -04:00
|
|
|
ensure
|
2010-09-13 16:53:39 -04:00
|
|
|
# A call to new_constants is always called after a call to watch_namespaces
|
2010-08-02 16:55:55 -04:00
|
|
|
pop_modules(@watching.pop)
|
2010-02-14 13:47:50 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
# Add a set of modules to the watch stack, remembering the initial constants
|
2010-08-02 16:55:55 -04:00
|
|
|
def watch_namespaces(namespaces)
|
|
|
|
watching = []
|
|
|
|
namespaces.map do |namespace|
|
|
|
|
module_name = Dependencies.to_constant_name(namespace)
|
|
|
|
original_constants = Dependencies.qualified_const_defined?(module_name) ?
|
|
|
|
Inflector.constantize(module_name).local_constant_names : []
|
|
|
|
|
|
|
|
watching << module_name
|
|
|
|
self[module_name] << original_constants
|
2010-02-14 13:47:50 -05:00
|
|
|
end
|
2010-08-02 16:55:55 -04:00
|
|
|
@watching << watching
|
2010-02-14 13:47:50 -05:00
|
|
|
end
|
|
|
|
|
2010-08-02 16:55:55 -04:00
|
|
|
def pop_modules(modules)
|
|
|
|
modules.each { |mod| self[mod].pop }
|
2010-02-14 13:47:50 -05:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# An internal stack used to record which constants are loaded by any block.
|
|
|
|
mattr_accessor :constant_watch_stack
|
2010-02-14 13:47:50 -05:00
|
|
|
self.constant_watch_stack = WatchStack.new
|
2009-01-29 01:31:07 -05:00
|
|
|
|
2008-07-19 18:32:22 -04:00
|
|
|
# Module includes this module
|
|
|
|
module ModuleConstMissing #:nodoc:
|
2010-02-14 13:47:50 -05:00
|
|
|
def self.append_features(base)
|
2008-07-19 18:32:22 -04:00
|
|
|
base.class_eval do
|
2010-02-14 13:47:50 -05:00
|
|
|
# Emulate #exclude via an ivar
|
2010-02-19 14:28:20 -05:00
|
|
|
return if defined?(@_const_missing) && @_const_missing
|
2010-02-14 14:35:05 -05:00
|
|
|
@_const_missing = instance_method(:const_missing)
|
2010-02-14 13:47:50 -05:00
|
|
|
remove_method(:const_missing)
|
2008-07-24 12:58:26 -04:00
|
|
|
end
|
2010-02-14 13:47:50 -05:00
|
|
|
super
|
2008-07-24 12:58:26 -04:00
|
|
|
end
|
2008-07-19 18:32:22 -04:00
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
def self.exclude_from(base)
|
2008-07-24 12:58:26 -04:00
|
|
|
base.class_eval do
|
2010-02-14 13:47:50 -05:00
|
|
|
define_method :const_missing, @_const_missing
|
|
|
|
@_const_missing = nil
|
2008-07-19 18:32:22 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2008-07-24 12:58:26 -04:00
|
|
|
# Use const_missing to autoload associations so we don't have to
|
|
|
|
# require_association when using single-table inheritance.
|
2010-02-14 13:47:50 -05:00
|
|
|
def const_missing(const_name, nesting = nil)
|
|
|
|
klass_name = name.presence || "Object"
|
|
|
|
|
2010-10-16 23:12:19 -04:00
|
|
|
unless nesting
|
2010-02-14 13:47:50 -05:00
|
|
|
# We'll assume that the nesting of Foo::Bar is ["Foo::Bar", "Foo"]
|
|
|
|
# even though it might not be, such as in the case of
|
|
|
|
# class Foo::Bar; Baz; end
|
|
|
|
nesting = []
|
|
|
|
klass_name.to_s.scan(/::|$/) { nesting.unshift $` }
|
|
|
|
end
|
2008-07-24 12:58:26 -04:00
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
# If there are multiple levels of nesting to search under, the top
|
|
|
|
# level is the one we want to report as the lookup fail.
|
|
|
|
error = nil
|
2008-07-19 18:32:22 -04:00
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
nesting.each do |namespace|
|
2008-07-19 18:32:22 -04:00
|
|
|
begin
|
2010-06-11 13:33:43 -04:00
|
|
|
return Dependencies.load_missing_constant Inflector.constantize(namespace), const_name
|
2010-02-14 13:47:50 -05:00
|
|
|
rescue NoMethodError then raise
|
2008-07-19 18:32:22 -04:00
|
|
|
rescue NameError => e
|
2010-02-14 13:47:50 -05:00
|
|
|
error ||= e
|
2008-07-19 18:32:22 -04:00
|
|
|
end
|
|
|
|
end
|
2010-02-14 13:47:50 -05:00
|
|
|
|
|
|
|
# Raise the first error for this set. If this const_missing came from an
|
|
|
|
# earlier const_missing, this will result in the real error bubbling
|
|
|
|
# all the way up
|
|
|
|
raise error
|
|
|
|
end
|
|
|
|
|
|
|
|
def unloadable(const_desc = self)
|
|
|
|
super(const_desc)
|
2008-07-19 18:32:22 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Object includes this module
|
|
|
|
module Loadable #:nodoc:
|
2010-02-14 13:47:50 -05:00
|
|
|
def self.exclude_from(base)
|
|
|
|
base.class_eval { define_method(:load, Kernel.instance_method(:load)) }
|
2008-07-24 12:58:26 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
def require_or_load(file_name)
|
|
|
|
Dependencies.require_or_load(file_name)
|
|
|
|
end
|
|
|
|
|
2009-06-10 15:12:15 -04:00
|
|
|
def require_dependency(file_name, message = "No such file to load -- %s")
|
2010-02-14 15:13:37 -05:00
|
|
|
unless file_name.is_a?(String)
|
|
|
|
raise ArgumentError, "the file name must be a String -- you passed #{file_name.inspect}"
|
|
|
|
end
|
|
|
|
|
2009-06-10 15:12:15 -04:00
|
|
|
Dependencies.depend_on(file_name, false, message)
|
2008-07-24 12:58:26 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
def require_association(file_name)
|
|
|
|
Dependencies.associate_with(file_name)
|
|
|
|
end
|
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
def load_dependency(file)
|
2008-11-11 00:39:05 -05:00
|
|
|
if Dependencies.load?
|
2010-02-14 13:47:50 -05:00
|
|
|
Dependencies.new_constants_in(Object) { yield }.presence
|
2008-11-11 00:39:05 -05:00
|
|
|
else
|
2010-02-14 13:47:50 -05:00
|
|
|
yield
|
2008-11-11 00:39:05 -05:00
|
|
|
end
|
2008-07-19 18:32:22 -04:00
|
|
|
rescue Exception => exception # errors from loading file
|
|
|
|
exception.blame_file! file
|
|
|
|
raise
|
|
|
|
end
|
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
def load(file, *)
|
|
|
|
load_dependency(file) { super }
|
|
|
|
end
|
|
|
|
|
|
|
|
def require(file, *)
|
|
|
|
load_dependency(file) { super }
|
2008-07-19 18:32:22 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
# Mark the given constant as unloadable. Unloadable constants are removed each
|
|
|
|
# time dependencies are cleared.
|
|
|
|
#
|
|
|
|
# Note that marking a constant for unloading need only be done once. Setup
|
|
|
|
# or init scripts may list each unloadable constant that may need unloading;
|
|
|
|
# each constant will be removed for every subsequent clear, as opposed to for
|
|
|
|
# the first clear.
|
|
|
|
#
|
|
|
|
# The provided constant descriptor may be a (non-anonymous) module or class,
|
|
|
|
# or a qualified constant name as a string or symbol.
|
|
|
|
#
|
|
|
|
# Returns true if the constant was not previously marked for unloading, false
|
|
|
|
# otherwise.
|
|
|
|
def unloadable(const_desc)
|
|
|
|
Dependencies.mark_for_unload const_desc
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Exception file-blaming
|
|
|
|
module Blamable #:nodoc:
|
|
|
|
def blame_file!(file)
|
|
|
|
(@blamed_files ||= []).unshift file
|
|
|
|
end
|
|
|
|
|
|
|
|
def blamed_files
|
|
|
|
@blamed_files ||= []
|
|
|
|
end
|
|
|
|
|
|
|
|
def describe_blame
|
|
|
|
return nil if blamed_files.empty?
|
|
|
|
"This error occurred while loading the following files:\n #{blamed_files.join "\n "}"
|
|
|
|
end
|
|
|
|
|
|
|
|
def copy_blame!(exc)
|
|
|
|
@blamed_files = exc.blamed_files.clone
|
|
|
|
self
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2008-07-24 12:58:26 -04:00
|
|
|
def hook!
|
2010-02-14 13:47:50 -05:00
|
|
|
Object.class_eval { include Loadable }
|
|
|
|
Module.class_eval { include ModuleConstMissing }
|
|
|
|
Exception.class_eval { include Blamable }
|
2008-07-24 12:58:26 -04:00
|
|
|
true
|
|
|
|
end
|
|
|
|
|
|
|
|
def unhook!
|
2010-02-14 13:47:50 -05:00
|
|
|
ModuleConstMissing.exclude_from(Module)
|
|
|
|
Loadable.exclude_from(Object)
|
2008-07-24 12:58:26 -04:00
|
|
|
true
|
2008-07-19 18:32:22 -04:00
|
|
|
end
|
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
def load?
|
|
|
|
mechanism == :load
|
|
|
|
end
|
2005-11-23 16:31:51 -05:00
|
|
|
|
2009-06-10 15:12:15 -04:00
|
|
|
def depend_on(file_name, swallow_load_errors = false, message = "No such file to load -- %s.rb")
|
2010-08-10 10:18:58 -04:00
|
|
|
path = search_for_file(file_name)
|
|
|
|
require_or_load(path || file_name)
|
|
|
|
rescue LoadError => load_error
|
|
|
|
unless swallow_load_errors
|
|
|
|
if file_name = load_error.message[/ -- (.*?)(\.rb)?$/, 1]
|
|
|
|
raise LoadError.new(message % file_name).copy_blame!(load_error)
|
2009-06-10 15:12:15 -04:00
|
|
|
end
|
2010-08-10 10:18:58 -04:00
|
|
|
raise
|
2009-06-10 15:12:15 -04:00
|
|
|
end
|
2008-06-03 14:32:53 -04:00
|
|
|
end
|
2005-11-21 02:06:33 -05:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
def associate_with(file_name)
|
|
|
|
depend_on(file_name, true)
|
|
|
|
end
|
2005-11-23 16:31:51 -05:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
def clear
|
|
|
|
log_call
|
|
|
|
loaded.clear
|
|
|
|
remove_unloadable_constants!
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
def require_or_load(file_name, const_path = nil)
|
|
|
|
log_call file_name, const_path
|
|
|
|
file_name = $1 if file_name =~ /^(.*)\.rb$/
|
|
|
|
expanded = File.expand_path(file_name)
|
|
|
|
return if loaded.include?(expanded)
|
2008-05-31 16:33:38 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Record that we've seen this file *before* loading it to avoid an
|
|
|
|
# infinite loop with mutual dependencies.
|
|
|
|
loaded << expanded
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
begin
|
|
|
|
if load?
|
|
|
|
log "loading #{file_name}"
|
|
|
|
|
|
|
|
# Enable warnings iff this file has not been loaded before and
|
|
|
|
# warnings_on_first_load is set.
|
|
|
|
load_args = ["#{file_name}.rb"]
|
|
|
|
load_args << const_path unless const_path.nil?
|
|
|
|
|
|
|
|
if !warnings_on_first_load or history.include?(expanded)
|
|
|
|
result = load_file(*load_args)
|
|
|
|
else
|
|
|
|
enable_warnings { result = load_file(*load_args) }
|
|
|
|
end
|
2005-11-24 00:43:27 -05:00
|
|
|
else
|
2008-06-03 14:32:53 -04:00
|
|
|
log "requiring #{file_name}"
|
|
|
|
result = require file_name
|
2005-11-24 00:43:27 -05:00
|
|
|
end
|
2008-06-03 14:32:53 -04:00
|
|
|
rescue Exception
|
|
|
|
loaded.delete expanded
|
|
|
|
raise
|
2005-11-23 16:31:51 -05:00
|
|
|
end
|
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Record history *after* loading so first load gets warnings.
|
|
|
|
history << expanded
|
|
|
|
return result
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Is the provided constant path defined?
|
|
|
|
def qualified_const_defined?(path)
|
2010-02-14 13:47:50 -05:00
|
|
|
names = path.sub(/^::/, '').to_s.split('::')
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
names.inject(Object) do |mod, name|
|
2010-02-14 13:47:50 -05:00
|
|
|
return false unless local_const_defined?(mod, name)
|
2008-06-03 14:32:53 -04:00
|
|
|
mod.const_get name
|
|
|
|
end
|
2006-08-16 13:50:52 -04:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
if Module.method(:const_defined?).arity == 1
|
|
|
|
# Does this module define this constant?
|
2010-06-11 06:15:34 -04:00
|
|
|
# Wrapper to accommodate changing Module#const_defined? in Ruby 1.9
|
2010-02-14 13:47:50 -05:00
|
|
|
def local_const_defined?(mod, const)
|
2008-06-03 14:32:53 -04:00
|
|
|
mod.const_defined?(const)
|
|
|
|
end
|
|
|
|
else
|
2010-02-14 13:47:50 -05:00
|
|
|
def local_const_defined?(mod, const) #:nodoc:
|
2008-06-03 14:32:53 -04:00
|
|
|
mod.const_defined?(const, false)
|
|
|
|
end
|
2008-05-01 16:34:07 -04:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Given +path+, a filesystem path to a ruby file, return an array of constant
|
|
|
|
# paths which would cause Dependencies to attempt to load this file.
|
2010-06-22 17:17:20 -04:00
|
|
|
def loadable_constants_for_path(path, bases = autoload_paths)
|
2010-06-23 19:04:41 -04:00
|
|
|
path = $1 if path =~ /\A(.*)\.rb\Z/
|
|
|
|
expanded_path = File.expand_path(path)
|
|
|
|
paths = []
|
|
|
|
|
|
|
|
bases.each do |root|
|
|
|
|
expanded_root = File.expand_path(root)
|
|
|
|
next unless %r{\A#{Regexp.escape(expanded_root)}(/|\\)} =~ expanded_path
|
|
|
|
|
|
|
|
nesting = expanded_path[(expanded_root.size)..-1]
|
|
|
|
nesting = nesting[1..-1] if nesting && nesting[0] == ?/
|
|
|
|
next if nesting.blank?
|
2010-02-14 13:47:50 -05:00
|
|
|
|
|
|
|
paths << nesting.camelize
|
2010-06-23 19:04:41 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
paths.uniq!
|
|
|
|
paths
|
2006-08-08 17:21:04 -04:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2010-06-22 17:17:20 -04:00
|
|
|
# Search for a file in autoload_paths matching the provided suffix.
|
2010-08-04 13:17:00 -04:00
|
|
|
def search_for_file(path_suffix)
|
|
|
|
path_suffix = path_suffix.sub(/(\.rb)?$/, ".rb")
|
2010-02-14 13:47:50 -05:00
|
|
|
|
2010-06-22 17:17:20 -04:00
|
|
|
autoload_paths.each do |root|
|
2008-06-03 14:32:53 -04:00
|
|
|
path = File.join(root, path_suffix)
|
|
|
|
return path if File.file? path
|
|
|
|
end
|
|
|
|
nil # Gee, I sure wish we had first_match ;-)
|
2006-08-08 17:21:04 -04:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Does the provided path_suffix correspond to an autoloadable module?
|
|
|
|
# Instead of returning a boolean, the autoload base for this module is returned.
|
|
|
|
def autoloadable_module?(path_suffix)
|
2010-06-22 17:17:20 -04:00
|
|
|
autoload_paths.each do |load_path|
|
2008-06-03 14:32:53 -04:00
|
|
|
return load_path if File.directory? File.join(load_path, path_suffix)
|
|
|
|
end
|
|
|
|
nil
|
2006-11-01 18:21:13 -05:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
def load_once_path?(path)
|
2010-06-22 17:17:20 -04:00
|
|
|
autoload_once_paths.any? { |base| path.starts_with? base }
|
2008-06-03 14:32:53 -04:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Attempt to autoload the provided module name by searching for a directory
|
|
|
|
# matching the expect path suffix. If found, the module is created and assigned
|
|
|
|
# to +into+'s constants with the name +const_name+. Provided that the directory
|
|
|
|
# was loaded from a reloadable base path, it is added to the set of constants
|
|
|
|
# that are to be unloaded.
|
|
|
|
def autoload_module!(into, const_name, qualified_name, path_suffix)
|
|
|
|
return nil unless base_path = autoloadable_module?(path_suffix)
|
|
|
|
mod = Module.new
|
|
|
|
into.const_set const_name, mod
|
2010-06-22 17:17:20 -04:00
|
|
|
autoloaded_constants << qualified_name unless autoload_once_paths.include?(base_path)
|
2008-06-03 14:32:53 -04:00
|
|
|
return mod
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Load the file at the provided path. +const_paths+ is a set of qualified
|
|
|
|
# constant names. When loading the file, Dependencies will watch for the
|
|
|
|
# addition of these constants. Each that is defined will be marked as
|
|
|
|
# autoloaded, and will be removed when Dependencies.clear is next called.
|
|
|
|
#
|
|
|
|
# If the second parameter is left off, then Dependencies will construct a set
|
|
|
|
# of names that the file at +path+ may define. See
|
|
|
|
# +loadable_constants_for_path+ for more details.
|
|
|
|
def load_file(path, const_paths = loadable_constants_for_path(path))
|
|
|
|
log_call path, const_paths
|
|
|
|
const_paths = [const_paths].compact unless const_paths.is_a? Array
|
|
|
|
parent_paths = const_paths.collect { |const_path| /(.*)::[^:]+\Z/ =~ const_path ? $1 : :Object }
|
|
|
|
|
|
|
|
result = nil
|
|
|
|
newly_defined_paths = new_constants_in(*parent_paths) do
|
2010-02-14 13:47:50 -05:00
|
|
|
result = Kernel.load path
|
2006-09-05 18:36:28 -04:00
|
|
|
end
|
2007-09-27 07:01:20 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
autoloaded_constants.concat newly_defined_paths unless load_once_path?(path)
|
|
|
|
autoloaded_constants.uniq!
|
|
|
|
log "loading #{path} defined #{newly_defined_paths * ', '}" unless newly_defined_paths.empty?
|
|
|
|
return result
|
|
|
|
end
|
2007-09-27 07:01:20 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Return the constant path for the provided parent and constant name.
|
|
|
|
def qualified_name_for(mod, name)
|
|
|
|
mod_name = to_constant_name mod
|
2010-02-14 13:47:50 -05:00
|
|
|
mod_name == "Object" ? name.to_s : "#{mod_name}::#{name}"
|
2006-08-16 23:35:36 -04:00
|
|
|
end
|
2007-12-14 21:12:39 -05:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Load the constant named +const_name+ which is missing from +from_mod+. If
|
|
|
|
# it is not possible to load the constant into from_mod, try its parent module
|
|
|
|
# using const_missing.
|
|
|
|
def load_missing_constant(from_mod, const_name)
|
|
|
|
log_call from_mod, const_name
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
unless qualified_const_defined?(from_mod.name) && Inflector.constantize(from_mod.name).equal?(from_mod)
|
2008-06-03 14:32:53 -04:00
|
|
|
raise ArgumentError, "A copy of #{from_mod} has been removed from the module tree but is still active!"
|
|
|
|
end
|
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
raise ArgumentError, "#{from_mod} is not missing constant #{const_name}!" if local_const_defined?(from_mod, const_name)
|
2008-06-03 14:32:53 -04:00
|
|
|
|
|
|
|
qualified_name = qualified_name_for from_mod, const_name
|
|
|
|
path_suffix = qualified_name.underscore
|
2010-02-27 14:51:19 -05:00
|
|
|
|
2010-02-27 15:18:28 -05:00
|
|
|
trace = caller.reject {|l| l =~ %r{#{Regexp.escape(__FILE__)}}}
|
2008-06-03 14:32:53 -04:00
|
|
|
name_error = NameError.new("uninitialized constant #{qualified_name}")
|
2010-02-27 14:51:19 -05:00
|
|
|
name_error.set_backtrace(trace)
|
2008-06-03 14:32:53 -04:00
|
|
|
|
|
|
|
file_path = search_for_file(path_suffix)
|
2010-02-14 13:47:50 -05:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
if file_path && ! loaded.include?(File.expand_path(file_path)) # We found a matching file to load
|
|
|
|
require_or_load file_path
|
2010-02-14 13:47:50 -05:00
|
|
|
raise LoadError, "Expected #{file_path} to define #{qualified_name}" unless local_const_defined?(from_mod, const_name)
|
2008-06-03 14:32:53 -04:00
|
|
|
return from_mod.const_get(const_name)
|
|
|
|
elsif mod = autoload_module!(from_mod, const_name, qualified_name, path_suffix)
|
|
|
|
return mod
|
|
|
|
elsif (parent = from_mod.parent) && parent != from_mod &&
|
2010-02-14 13:47:50 -05:00
|
|
|
! from_mod.parents.any? { |p| local_const_defined?(p, const_name) }
|
2008-06-03 14:32:53 -04:00
|
|
|
# If our parents do not have a constant named +const_name+ then we are free
|
|
|
|
# to attempt to load upwards. If they do have such a constant, then this
|
|
|
|
# const_missing must be due to from_mod::const_name, which should not
|
|
|
|
# return constants from from_mod's parents.
|
|
|
|
begin
|
|
|
|
return parent.const_missing(const_name)
|
|
|
|
rescue NameError => e
|
|
|
|
raise unless e.missing_name? qualified_name_for(parent, const_name)
|
|
|
|
raise name_error
|
|
|
|
end
|
|
|
|
else
|
2006-08-08 17:21:04 -04:00
|
|
|
raise name_error
|
|
|
|
end
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Remove the constants that have been autoloaded, and those that have been
|
2010-09-01 09:12:06 -04:00
|
|
|
# marked for unloading. Before each constant is removed a callback is sent
|
|
|
|
# to its class/module if it implements +before_remove_const+.
|
|
|
|
#
|
|
|
|
# The callback implementation should be restricted to cleaning up caches, etc.
|
|
|
|
# as the enviroment will be in an inconsistent state, e.g. other constants
|
|
|
|
# may have already been unloaded and not accessible.
|
2008-06-03 14:32:53 -04:00
|
|
|
def remove_unloadable_constants!
|
|
|
|
autoloaded_constants.each { |const| remove_constant const }
|
|
|
|
autoloaded_constants.clear
|
2010-06-06 01:02:49 -04:00
|
|
|
Reference.clear!
|
2008-06-03 14:32:53 -04:00
|
|
|
explicitly_unloadable_constants.each { |const| remove_constant const }
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2010-06-04 20:28:04 -04:00
|
|
|
class Reference
|
2010-06-06 01:02:49 -04:00
|
|
|
@@constants = Hash.new { |h, k| h[k] = Inflector.constantize(k) }
|
|
|
|
|
2010-06-05 23:33:53 -04:00
|
|
|
attr_reader :name
|
|
|
|
|
2010-06-06 01:02:49 -04:00
|
|
|
def initialize(name)
|
|
|
|
@name = name.to_s
|
|
|
|
@@constants[@name] = name if name.respond_to?(:name)
|
2010-06-04 20:28:04 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
def get
|
2010-06-06 01:02:49 -04:00
|
|
|
@@constants[@name]
|
2010-06-04 20:28:04 -04:00
|
|
|
end
|
|
|
|
|
2010-06-06 01:02:49 -04:00
|
|
|
def self.clear!
|
|
|
|
@@constants.clear
|
2010-06-04 20:28:04 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def ref(name)
|
2010-06-05 23:33:53 -04:00
|
|
|
references[name] ||= Reference.new(name)
|
|
|
|
end
|
|
|
|
|
|
|
|
def constantize(name)
|
|
|
|
ref(name).get
|
2010-06-04 20:28:04 -04:00
|
|
|
end
|
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Determine if the given constant has been automatically loaded.
|
|
|
|
def autoloaded?(desc)
|
|
|
|
# No name => anonymous module.
|
2010-02-12 13:50:00 -05:00
|
|
|
return false if desc.is_a?(Module) && desc.anonymous?
|
2008-06-03 14:32:53 -04:00
|
|
|
name = to_constant_name desc
|
|
|
|
return false unless qualified_const_defined? name
|
|
|
|
return autoloaded_constants.include?(name)
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Will the provided constant descriptor be unloaded?
|
|
|
|
def will_unload?(const_desc)
|
2008-06-27 20:19:24 -04:00
|
|
|
autoloaded?(const_desc) ||
|
2008-06-03 14:32:53 -04:00
|
|
|
explicitly_unloadable_constants.include?(to_constant_name(const_desc))
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Mark the provided constant name for unloading. This constant will be
|
|
|
|
# unloaded on each request, not just the next one.
|
|
|
|
def mark_for_unload(const_desc)
|
|
|
|
name = to_constant_name const_desc
|
|
|
|
if explicitly_unloadable_constants.include? name
|
|
|
|
return false
|
|
|
|
else
|
|
|
|
explicitly_unloadable_constants << name
|
|
|
|
return true
|
|
|
|
end
|
2006-10-15 19:32:31 -04:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Run the provided block and detect the new constants that were loaded during
|
|
|
|
# its execution. Constants may only be regarded as 'new' once -- so if the
|
|
|
|
# block calls +new_constants_in+ again, then the constants defined within the
|
|
|
|
# inner call will not be reported in this one.
|
|
|
|
#
|
|
|
|
# If the provided block does not run to completion, and instead raises an
|
|
|
|
# exception, any new constants are regarded as being only partially defined
|
|
|
|
# and will be removed immediately.
|
|
|
|
def new_constants_in(*descs)
|
|
|
|
log_call(*descs)
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2010-08-02 16:55:55 -04:00
|
|
|
constant_watch_stack.watch_namespaces(descs)
|
2008-06-03 14:32:53 -04:00
|
|
|
aborting = true
|
2010-08-02 16:55:55 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
begin
|
|
|
|
yield # Now yield to the code that is to define new constants.
|
|
|
|
aborting = false
|
|
|
|
ensure
|
2010-08-02 16:55:55 -04:00
|
|
|
new_constants = constant_watch_stack.new_constants
|
2008-06-03 14:32:53 -04:00
|
|
|
|
|
|
|
log "New constants: #{new_constants * ', '}"
|
2010-02-14 13:47:50 -05:00
|
|
|
return new_constants unless aborting
|
2008-06-03 14:32:53 -04:00
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
log "Error during loading, removing partially loaded constants "
|
|
|
|
new_constants.each {|c| remove_constant(c) }.clear
|
2008-06-03 14:32:53 -04:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
return []
|
2006-11-07 15:45:36 -05:00
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
class LoadingModule #:nodoc:
|
|
|
|
# Old style environment.rb referenced this method directly. Please note, it doesn't
|
|
|
|
# actually *do* anything any more.
|
|
|
|
def self.root(*args)
|
2008-12-15 12:49:08 -05:00
|
|
|
if defined?(Rails) && Rails.logger
|
2008-12-10 19:07:02 -05:00
|
|
|
Rails.logger.warn "Your environment.rb uses the old syntax, it may not continue to work in future releases."
|
|
|
|
Rails.logger.warn "For upgrade instructions please see: http://manuals.rubyonrails.com/read/book/19"
|
2008-06-03 14:32:53 -04:00
|
|
|
end
|
2006-11-01 18:21:13 -05:00
|
|
|
end
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
# Convert the provided const desc to a qualified constant name (as a string).
|
|
|
|
# A module, class, symbol, or string may be provided.
|
|
|
|
def to_constant_name(desc) #:nodoc:
|
2010-07-22 23:36:34 -04:00
|
|
|
case desc
|
2010-02-14 13:47:50 -05:00
|
|
|
when String then desc.sub(/^::/, '')
|
2008-06-03 14:32:53 -04:00
|
|
|
when Symbol then desc.to_s
|
|
|
|
when Module
|
2010-02-14 13:47:50 -05:00
|
|
|
desc.name.presence ||
|
|
|
|
raise(ArgumentError, "Anonymous modules have no name to be referenced by")
|
2008-06-03 14:32:53 -04:00
|
|
|
else raise TypeError, "Not a valid constant descriptor: #{desc.inspect}"
|
2006-04-02 23:06:23 -04:00
|
|
|
end
|
|
|
|
end
|
2006-08-08 17:21:04 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
def remove_constant(const) #:nodoc:
|
|
|
|
return false unless qualified_const_defined? const
|
2007-09-27 07:01:20 -04:00
|
|
|
|
2010-02-14 13:47:50 -05:00
|
|
|
# Normalize ::Foo, Foo, Object::Foo, and ::Object::Foo to Object::Foo
|
|
|
|
names = const.to_s.sub(/^::(Object)?/, 'Object::').split("::")
|
|
|
|
to_remove = names.pop
|
|
|
|
parent = Inflector.constantize(names * '::')
|
2007-09-27 07:01:20 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
log "removing constant #{const}"
|
2010-09-05 10:23:39 -04:00
|
|
|
constantized = constantize(const)
|
|
|
|
constantized.before_remove_const if constantized.respond_to?(:before_remove_const)
|
2010-02-14 13:47:50 -05:00
|
|
|
parent.instance_eval { remove_const to_remove }
|
2010-06-04 20:28:04 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
return true
|
2006-10-15 19:32:31 -04:00
|
|
|
end
|
2007-09-27 07:01:20 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
protected
|
|
|
|
def log_call(*args)
|
2010-09-05 10:27:16 -04:00
|
|
|
if log_activity?
|
2008-06-25 22:21:53 -04:00
|
|
|
arg_str = args.collect { |arg| arg.inspect } * ', '
|
2008-06-03 14:32:53 -04:00
|
|
|
/in `([a-z_\?\!]+)'/ =~ caller(1).first
|
|
|
|
selector = $1 || '<unknown>'
|
|
|
|
log "called #{selector}(#{arg_str})"
|
|
|
|
end
|
|
|
|
end
|
2008-03-30 01:02:25 -04:00
|
|
|
|
2008-06-03 14:32:53 -04:00
|
|
|
def log(msg)
|
2010-09-05 10:27:16 -04:00
|
|
|
logger.debug "Dependencies: #{msg}" if log_activity?
|
|
|
|
end
|
|
|
|
|
|
|
|
def log_activity?
|
|
|
|
logger && log_activity
|
2008-06-03 14:32:53 -04:00
|
|
|
end
|
2006-08-12 23:29:04 -04:00
|
|
|
end
|
2004-12-29 16:03:21 -05:00
|
|
|
end
|
|
|
|
|
2008-07-24 12:58:26 -04:00
|
|
|
ActiveSupport::Dependencies.hook!
|