2005-09-03 11:13:06 -04:00
|
|
|
require 'logger'
|
2005-11-07 03:09:38 -05:00
|
|
|
require 'set'
|
2007-03-18 09:35:16 -04:00
|
|
|
require 'pathname'
|
|
|
|
|
|
|
|
$LOAD_PATH.unshift File.dirname(__FILE__)
|
|
|
|
require 'railties_path'
|
|
|
|
require 'rails/version'
|
|
|
|
require 'rails/plugin/locator'
|
|
|
|
require 'rails/plugin/loader'
|
2007-03-01 19:20:32 -05:00
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
|
2005-10-13 22:51:33 -04:00
|
|
|
RAILS_ENV = (ENV['RAILS_ENV'] || 'development').dup unless defined?(RAILS_ENV)
|
2005-09-03 11:13:06 -04:00
|
|
|
|
|
|
|
module Rails
|
2005-10-15 20:17:09 -04:00
|
|
|
# The Initializer is responsible for processing the Rails configuration, such
|
|
|
|
# as setting the $LOAD_PATH, requiring the right frameworks, initializing
|
|
|
|
# logging, and more. It can be run either as a single command that'll just
|
|
|
|
# use the default configuration, like this:
|
2005-09-03 11:44:19 -04:00
|
|
|
#
|
|
|
|
# Rails::Initializer.run
|
|
|
|
#
|
2005-10-15 20:17:09 -04:00
|
|
|
# But normally it's more interesting to pass in a custom configuration
|
|
|
|
# through the block running:
|
2005-09-03 11:44:19 -04:00
|
|
|
#
|
|
|
|
# Rails::Initializer.run do |config|
|
2007-04-23 14:55:54 -04:00
|
|
|
# config.frameworks -= [ :action_mailer ]
|
2005-09-03 11:44:19 -04:00
|
|
|
# end
|
|
|
|
#
|
2005-10-15 20:17:09 -04:00
|
|
|
# This will use the default configuration options from Rails::Configuration,
|
|
|
|
# but allow for overwriting on select areas.
|
2005-09-03 11:13:06 -04:00
|
|
|
class Initializer
|
2005-10-15 20:17:09 -04:00
|
|
|
# The Configuration instance used by this Initializer instance.
|
2005-09-03 11:13:06 -04:00
|
|
|
attr_reader :configuration
|
2005-11-07 03:09:38 -05:00
|
|
|
|
|
|
|
# The set of loaded plugins.
|
|
|
|
attr_reader :loaded_plugins
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Runs the initializer. By default, this will invoke the #process method,
|
|
|
|
# which simply executes all of the initialization routines. Alternately,
|
|
|
|
# you can specify explicitly which initialization routine you want:
|
|
|
|
#
|
|
|
|
# Rails::Initializer.run(:set_load_path)
|
|
|
|
#
|
|
|
|
# This is useful if you only want the load path initialized, without
|
2006-11-13 01:23:58 -05:00
|
|
|
# incuring the overhead of completely loading the entire environment.
|
2005-09-03 11:13:06 -04:00
|
|
|
def self.run(command = :process, configuration = Configuration.new)
|
|
|
|
yield configuration if block_given?
|
2005-11-30 14:18:55 -05:00
|
|
|
initializer = new configuration
|
|
|
|
initializer.send(command)
|
|
|
|
initializer
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Create a new Initializer instance that references the given Configuration
|
|
|
|
# instance.
|
2005-09-03 11:13:06 -04:00
|
|
|
def initialize(configuration)
|
|
|
|
@configuration = configuration
|
2006-12-18 15:27:05 -05:00
|
|
|
@loaded_plugins = []
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2005-11-07 03:09:38 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Sequentially step through all of the available initialization routines,
|
|
|
|
# in order:
|
|
|
|
#
|
|
|
|
# * #set_load_path
|
|
|
|
# * #require_frameworks
|
|
|
|
# * #load_environment
|
|
|
|
# * #initialize_database
|
|
|
|
# * #initialize_logger
|
|
|
|
# * #initialize_framework_logging
|
|
|
|
# * #initialize_framework_views
|
|
|
|
# * #initialize_dependency_mechanism
|
|
|
|
# * #initialize_whiny_nils
|
2005-10-20 05:24:18 -04:00
|
|
|
# * #initialize_framework_settings
|
2005-10-15 20:17:09 -04:00
|
|
|
# * #load_environment
|
|
|
|
# * #load_plugins
|
2006-08-05 22:12:53 -04:00
|
|
|
# * #load_observers
|
2006-01-11 12:36:22 -05:00
|
|
|
# * #initialize_routing
|
2007-02-22 19:32:27 -05:00
|
|
|
# * #after_initialize
|
|
|
|
# * #load_application_initializers
|
2005-10-15 20:17:09 -04:00
|
|
|
#
|
|
|
|
# (Note that #load_environment is invoked twice, once at the start and
|
|
|
|
# once at the end, to support the legacy configuration style where the
|
|
|
|
# environment could overwrite the defaults directly, instead of via the
|
2006-11-13 01:23:58 -05:00
|
|
|
# Configuration instance.
|
2005-09-03 11:13:06 -04:00
|
|
|
def process
|
2006-03-19 13:55:31 -05:00
|
|
|
check_ruby_version
|
2005-09-03 11:13:06 -04:00
|
|
|
set_load_path
|
|
|
|
|
|
|
|
require_frameworks
|
2006-08-08 17:21:04 -04:00
|
|
|
set_autoload_paths
|
2005-09-13 05:58:16 -04:00
|
|
|
load_environment
|
2005-09-03 11:13:06 -04:00
|
|
|
|
2006-10-17 19:11:47 -04:00
|
|
|
initialize_encoding
|
2005-09-03 11:13:06 -04:00
|
|
|
initialize_database
|
|
|
|
initialize_logger
|
|
|
|
initialize_framework_logging
|
2005-09-03 11:44:19 -04:00
|
|
|
initialize_framework_views
|
2005-09-13 05:58:16 -04:00
|
|
|
initialize_dependency_mechanism
|
|
|
|
initialize_whiny_nils
|
2006-02-25 15:26:14 -05:00
|
|
|
initialize_temporary_directories
|
2005-10-20 05:24:18 -04:00
|
|
|
initialize_framework_settings
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
# Support for legacy configuration style where the environment
|
|
|
|
# could overwrite anything set from the defaults/global through
|
|
|
|
# the individual base class configurations.
|
|
|
|
load_environment
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-03-19 13:45:26 -05:00
|
|
|
add_support_load_paths
|
2005-10-05 14:31:30 -04:00
|
|
|
|
|
|
|
load_plugins
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-08-05 22:12:53 -04:00
|
|
|
# Observers are loaded after plugins in case Observers or observed models are modified by plugins.
|
|
|
|
load_observers
|
2005-11-10 05:45:39 -05:00
|
|
|
|
|
|
|
# Routing must be initialized after plugins to allow the former to extend the routes
|
|
|
|
initialize_routing
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-02-06 19:21:45 -05:00
|
|
|
# the framework is now fully initialized
|
|
|
|
after_initialize
|
2007-02-22 19:32:27 -05:00
|
|
|
|
|
|
|
load_application_initializers
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-03-19 13:55:31 -05:00
|
|
|
|
|
|
|
# Check for valid Ruby version
|
|
|
|
# This is done in an external file, so we can use it
|
|
|
|
# from the `rails` program as well without duplication.
|
2006-11-13 01:23:58 -05:00
|
|
|
def check_ruby_version
|
2006-03-19 13:55:31 -05:00
|
|
|
require 'ruby_version_check'
|
|
|
|
end
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Set the <tt>$LOAD_PATH</tt> based on the value of
|
|
|
|
# Configuration#load_paths. Duplicates are removed.
|
2005-09-03 11:13:06 -04:00
|
|
|
def set_load_path
|
2006-10-16 14:12:01 -04:00
|
|
|
load_paths = configuration.load_paths + configuration.framework_paths
|
|
|
|
load_paths.reverse_each { |dir| $LOAD_PATH.unshift(dir) if File.directory?(dir) }
|
2005-09-03 11:13:06 -04:00
|
|
|
$LOAD_PATH.uniq!
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-08-29 02:52:39 -04:00
|
|
|
# Set the paths from which Rails will automatically load source files, and
|
|
|
|
# the load_once paths.
|
2006-08-08 17:21:04 -04:00
|
|
|
def set_autoload_paths
|
2006-10-16 14:29:31 -04:00
|
|
|
Dependencies.load_paths = configuration.load_paths.uniq
|
2006-08-29 02:52:39 -04:00
|
|
|
Dependencies.load_once_paths = configuration.load_once_paths.uniq
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-08-29 02:52:39 -04:00
|
|
|
extra = Dependencies.load_once_paths - Dependencies.load_paths
|
|
|
|
unless extra.empty?
|
|
|
|
abort <<-end_error
|
2006-10-16 14:12:01 -04:00
|
|
|
load_once_paths must be a subset of the load_paths.
|
2006-08-29 02:52:39 -04:00
|
|
|
Extra items in load_once_paths: #{extra * ','}
|
|
|
|
end_error
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-08-29 02:52:39 -04:00
|
|
|
# Freeze the arrays so future modifications will fail rather than do nothing mysteriously
|
|
|
|
configuration.load_once_paths.freeze
|
2006-08-08 17:21:04 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Requires all frameworks specified by the Configuration#frameworks
|
|
|
|
# list. By default, all frameworks (ActiveRecord, ActiveSupport,
|
2007-06-23 13:23:52 -04:00
|
|
|
# ActionPack, ActionMailer, and ActiveResource) are loaded.
|
2005-09-03 11:13:06 -04:00
|
|
|
def require_frameworks
|
|
|
|
configuration.frameworks.each { |framework| require(framework.to_s) }
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-03-19 13:45:26 -05:00
|
|
|
# Add the load paths used by support functions such as the info controller
|
|
|
|
def add_support_load_paths
|
2005-11-05 13:04:52 -05:00
|
|
|
end
|
2005-11-07 03:09:38 -05:00
|
|
|
|
|
|
|
# Loads all plugins in <tt>config.plugin_paths</tt>. <tt>plugin_paths</tt>
|
|
|
|
# defaults to <tt>vendor/plugins</tt> but may also be set to a list of
|
|
|
|
# paths, such as
|
2007-06-23 13:30:31 -04:00
|
|
|
# config.plugin_paths = ["#{RAILS_ROOT}/lib/plugins", "#{RAILS_ROOT}/vendor/plugins"]
|
2005-10-15 20:17:09 -04:00
|
|
|
#
|
2005-11-07 03:09:38 -05:00
|
|
|
# Each plugin discovered in <tt>plugin_paths</tt> is initialized:
|
|
|
|
# * add its +lib+ directory, if present, to the beginning of the load path
|
|
|
|
# * evaluate <tt>init.rb</tt> if present
|
2005-10-15 20:17:09 -04:00
|
|
|
#
|
|
|
|
# After all plugins are loaded, duplicates are removed from the load path.
|
2007-03-02 18:39:29 -05:00
|
|
|
# If an array of plugin names is specified in config.plugins, only those plugins will be loaded
|
|
|
|
# and they plugins will be loaded in that order. Otherwise, plugins are loaded in alphabetical
|
2006-12-18 15:27:05 -05:00
|
|
|
# order.
|
2005-10-05 14:25:15 -04:00
|
|
|
def load_plugins
|
2007-03-02 18:39:29 -05:00
|
|
|
configuration.plugin_locators.each do |locator|
|
|
|
|
locator.new(self).each do |plugin|
|
|
|
|
plugin.load
|
|
|
|
end
|
2007-03-01 19:20:32 -05:00
|
|
|
end
|
2007-03-02 21:53:06 -05:00
|
|
|
ensure_all_registered_plugins_are_loaded!
|
2007-03-18 09:35:16 -04:00
|
|
|
$LOAD_PATH.uniq!
|
2005-10-05 14:25:15 -04:00
|
|
|
end
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Loads the environment specified by Configuration#environment_path, which
|
|
|
|
# is typically one of development, testing, or production.
|
2005-09-13 05:58:16 -04:00
|
|
|
def load_environment
|
|
|
|
silence_warnings do
|
2007-04-29 03:35:22 -04:00
|
|
|
return if @environment_loaded
|
|
|
|
@environment_loaded = true
|
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
config = configuration
|
2005-10-23 09:39:24 -04:00
|
|
|
constants = self.class.constants
|
2007-03-27 10:04:06 -04:00
|
|
|
|
2006-08-14 21:28:06 -04:00
|
|
|
eval(IO.read(configuration.environment_path), binding, configuration.environment_path)
|
2007-03-27 10:04:06 -04:00
|
|
|
|
2005-10-23 09:39:24 -04:00
|
|
|
(self.class.constants - constants).each do |const|
|
|
|
|
Object.const_set(const, self.class.const_get(const))
|
|
|
|
end
|
2005-09-13 05:58:16 -04:00
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-08-05 22:12:53 -04:00
|
|
|
|
|
|
|
def load_observers
|
2007-05-23 03:05:51 -04:00
|
|
|
if configuration.frameworks.include?(:active_record)
|
|
|
|
ActiveRecord::Base.instantiate_observers
|
|
|
|
end
|
2006-08-05 22:12:53 -04:00
|
|
|
end
|
|
|
|
|
2006-10-17 19:11:47 -04:00
|
|
|
# This initialzation sets $KCODE to 'u' to enable the multibyte safe operations.
|
2006-11-13 01:23:58 -05:00
|
|
|
# Plugin authors supporting other encodings should override this behaviour and
|
2006-10-17 19:11:47 -04:00
|
|
|
# set the relevant +default_charset+ on ActionController::Base
|
|
|
|
def initialize_encoding
|
|
|
|
$KCODE='u'
|
|
|
|
end
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# This initialization routine does nothing unless <tt>:active_record</tt>
|
|
|
|
# is one of the frameworks to load (Configuration#frameworks). If it is,
|
|
|
|
# this sets the database configuration from Configuration#database_configuration
|
|
|
|
# and then establishes the connection.
|
2005-09-03 11:13:06 -04:00
|
|
|
def initialize_database
|
2007-05-23 03:05:51 -04:00
|
|
|
if configuration.frameworks.include?(:active_record)
|
|
|
|
ActiveRecord::Base.configurations = configuration.database_configuration
|
|
|
|
ActiveRecord::Base.establish_connection
|
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# If the +RAILS_DEFAULT_LOGGER+ constant is already set, this initialization
|
|
|
|
# routine does nothing. If the constant is not set, and Configuration#logger
|
|
|
|
# is not +nil+, this also does nothing. Otherwise, a new logger instance
|
|
|
|
# is created at Configuration#log_path, with a default log level of
|
|
|
|
# Configuration#log_level.
|
|
|
|
#
|
|
|
|
# If the log could not be created, the log will be set to output to
|
|
|
|
# +STDERR+, with a log level of +WARN+.
|
2005-09-03 11:13:06 -04:00
|
|
|
def initialize_logger
|
2005-09-05 08:36:40 -04:00
|
|
|
# if the environment has explicitly defined a logger, use it
|
|
|
|
return if defined?(RAILS_DEFAULT_LOGGER)
|
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
unless logger = configuration.logger
|
|
|
|
begin
|
|
|
|
logger = Logger.new(configuration.log_path)
|
|
|
|
logger.level = Logger.const_get(configuration.log_level.to_s.upcase)
|
|
|
|
rescue StandardError
|
|
|
|
logger = Logger.new(STDERR)
|
|
|
|
logger.level = Logger::WARN
|
|
|
|
logger.warn(
|
|
|
|
"Rails Error: Unable to access log file. Please ensure that #{configuration.log_path} exists and is chmod 0666. " +
|
|
|
|
"The log level has been raised to WARN and the output directed to STDERR until the problem is fixed."
|
|
|
|
)
|
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-11 00:58:27 -04:00
|
|
|
silence_warnings { Object.const_set "RAILS_DEFAULT_LOGGER", logger }
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Sets the logger for ActiveRecord, ActionController, and ActionMailer
|
|
|
|
# (but only for those frameworks that are to be loaded). If the framework's
|
|
|
|
# logger is already set, it is not changed, otherwise it is set to use
|
|
|
|
# +RAILS_DEFAULT_LOGGER+.
|
2005-09-03 11:13:06 -04:00
|
|
|
def initialize_framework_logging
|
2005-09-22 10:11:13 -04:00
|
|
|
for framework in ([ :active_record, :action_controller, :action_mailer ] & configuration.frameworks)
|
|
|
|
framework.to_s.camelize.constantize.const_get("Base").logger ||= RAILS_DEFAULT_LOGGER
|
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2007-02-04 17:41:37 -05:00
|
|
|
# Sets +ActionController::BaseEview_paths+ and +ActionMailer::Base#template_root+
|
2005-10-15 20:17:09 -04:00
|
|
|
# (but only for those frameworks that are to be loaded). If the framework's
|
2007-02-04 17:41:37 -05:00
|
|
|
# paths have already been set, it is not changed, otherwise it is
|
2005-10-15 20:17:09 -04:00
|
|
|
# set to use Configuration#view_path.
|
2005-09-03 11:13:06 -04:00
|
|
|
def initialize_framework_views
|
2007-02-04 17:56:36 -05:00
|
|
|
ActionMailer::Base.template_root ||= configuration.view_path if configuration.frameworks.include?(:action_mailer)
|
|
|
|
ActionController::Base.view_paths = [configuration.view_path] if configuration.frameworks.include?(:action_controller) && ActionController::Base.view_paths.empty?
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# If ActionController is not one of the loaded frameworks (Configuration#frameworks)
|
|
|
|
# this does nothing. Otherwise, it loads the routing definitions and sets up
|
|
|
|
# loading module used to lazily load controllers (Configuration#controller_paths).
|
2005-09-03 11:13:06 -04:00
|
|
|
def initialize_routing
|
|
|
|
return unless configuration.frameworks.include?(:action_controller)
|
2006-08-14 21:28:06 -04:00
|
|
|
ActionController::Routing.controller_paths = configuration.controller_paths
|
2005-09-03 11:13:06 -04:00
|
|
|
ActionController::Routing::Routes.reload
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Sets the dependency loading mechanism based on the value of
|
|
|
|
# Configuration#cache_classes.
|
2005-09-13 05:58:16 -04:00
|
|
|
def initialize_dependency_mechanism
|
|
|
|
Dependencies.mechanism = configuration.cache_classes ? :require : :load
|
2005-09-12 13:30:40 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Loads support for "whiny nil" (noisy warnings when methods are invoked
|
|
|
|
# on +nil+ values) if Configuration#whiny_nils is true.
|
2005-09-13 05:58:16 -04:00
|
|
|
def initialize_whiny_nils
|
|
|
|
require('active_support/whiny_nil') if configuration.whiny_nils
|
|
|
|
end
|
2005-09-12 13:49:07 -04:00
|
|
|
|
2006-02-25 15:26:14 -05:00
|
|
|
def initialize_temporary_directories
|
|
|
|
if configuration.frameworks.include?(:action_controller)
|
2007-03-18 09:35:16 -04:00
|
|
|
session_path = "#{configuration.root_path}/tmp/sessions/"
|
2006-02-25 15:26:14 -05:00
|
|
|
ActionController::Base.session_options[:tmpdir] = File.exist?(session_path) ? session_path : Dir::tmpdir
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2007-03-18 09:35:16 -04:00
|
|
|
cache_path = "#{configuration.root_path}/tmp/cache/"
|
2006-02-25 15:26:14 -05:00
|
|
|
if File.exist?(cache_path)
|
|
|
|
ActionController::Base.fragment_cache_store = :file_store, cache_path
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2006-02-06 19:21:45 -05:00
|
|
|
# Initializes framework-specific settings for each of the loaded frameworks
|
2005-10-15 20:17:09 -04:00
|
|
|
# (Configuration#frameworks). The available settings map to the accessors
|
|
|
|
# on each of the corresponding Base classes.
|
2005-10-20 05:24:18 -04:00
|
|
|
def initialize_framework_settings
|
2005-09-13 05:58:16 -04:00
|
|
|
configuration.frameworks.each do |framework|
|
|
|
|
base_class = framework.to_s.camelize.constantize.const_get("Base")
|
2005-09-12 13:49:07 -04:00
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
configuration.send(framework).each do |setting, value|
|
|
|
|
base_class.send("#{setting}=", value)
|
|
|
|
end
|
2005-09-12 13:49:07 -04:00
|
|
|
end
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
|
|
|
# Fires the user-supplied after_initialize block (Configuration#after_initialize)
|
2006-02-06 19:21:45 -05:00
|
|
|
def after_initialize
|
|
|
|
configuration.after_initialize_block.call if configuration.after_initialize_block
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2007-02-22 19:32:27 -05:00
|
|
|
def load_application_initializers
|
2007-05-22 15:09:32 -04:00
|
|
|
Dir["#{configuration.root_path}/config/initializers/**/*.rb"].sort.each do |initializer|
|
2007-02-22 19:32:27 -05:00
|
|
|
load(initializer)
|
|
|
|
end
|
|
|
|
end
|
2007-03-18 09:35:16 -04:00
|
|
|
|
2007-03-02 21:53:06 -05:00
|
|
|
private
|
|
|
|
def ensure_all_registered_plugins_are_loaded!
|
|
|
|
unless configuration.plugins.nil?
|
|
|
|
unless loaded_plugins == configuration.plugins
|
|
|
|
missing_plugins = configuration.plugins - loaded_plugins
|
|
|
|
raise LoadError, "Could not locate the following plugins: #{missing_plugins.to_sentence}"
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2005-11-07 03:09:38 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The Configuration class holds all the parameters for the Initializer and
|
|
|
|
# ships with defaults that suites most Rails applications. But it's possible
|
|
|
|
# to overwrite everything. Usually, you'll create an Configuration file
|
|
|
|
# implicitly through the block running on the Initializer, but it's also
|
|
|
|
# possible to create the Configuration instance in advance and pass it in
|
|
|
|
# like this:
|
2005-09-03 11:44:19 -04:00
|
|
|
#
|
|
|
|
# config = Rails::Configuration.new
|
|
|
|
# Rails::Initializer.run(:process, config)
|
2005-09-03 11:13:06 -04:00
|
|
|
class Configuration
|
2007-03-18 09:35:16 -04:00
|
|
|
# The application's base directory.
|
|
|
|
attr_reader :root_path
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# A stub for setting options on ActionController::Base
|
|
|
|
attr_accessor :action_controller
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# A stub for setting options on ActionMailer::Base
|
|
|
|
attr_accessor :action_mailer
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# A stub for setting options on ActionView::Base
|
|
|
|
attr_accessor :action_view
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# A stub for setting options on ActiveRecord::Base
|
|
|
|
attr_accessor :active_record
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2007-04-23 14:55:54 -04:00
|
|
|
# A stub for setting options on ActiveRecord::Base
|
|
|
|
attr_accessor :active_resource
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Whether or not classes should be cached (set to false if you want
|
|
|
|
# application classes to be reloaded on each request)
|
|
|
|
attr_accessor :cache_classes
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The list of paths that should be searched for controllers. (Defaults
|
|
|
|
# to <tt>app/controllers</tt> and <tt>components</tt>.)
|
|
|
|
attr_accessor :controller_paths
|
|
|
|
|
|
|
|
# The path to the database configuration file to use. (Defaults to
|
|
|
|
# <tt>config/database.yml</tt>.)
|
|
|
|
attr_accessor :database_configuration_file
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The list of rails framework components that should be loaded. (Defaults
|
|
|
|
# to <tt>:active_record</tt>, <tt>:action_controller</tt>,
|
|
|
|
# <tt>:action_view</tt>, <tt>:action_mailer</tt>, and
|
2007-06-23 13:23:52 -04:00
|
|
|
# <tt>:active_resource</tt>).
|
2005-10-15 20:17:09 -04:00
|
|
|
attr_accessor :frameworks
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# An array of additional paths to prepend to the load path. By default,
|
|
|
|
# all +app+, +lib+, +vendor+ and mock paths are included in this list.
|
|
|
|
attr_accessor :load_paths
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-08-29 02:52:39 -04:00
|
|
|
# An array of paths from which Rails will automatically load from only once.
|
2006-10-16 14:12:01 -04:00
|
|
|
# All elements of this array must also be in +load_paths+.
|
2006-08-29 02:52:39 -04:00
|
|
|
attr_accessor :load_once_paths
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The log level to use for the default Rails logger. In production mode,
|
|
|
|
# this defaults to <tt>:info</tt>. In development mode, it defaults to
|
|
|
|
# <tt>:debug</tt>.
|
|
|
|
attr_accessor :log_level
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The path to the log file to use. Defaults to log/#{environment}.log
|
|
|
|
# (e.g. log/development.log or log/production.log).
|
|
|
|
attr_accessor :log_path
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The specific logger to use. By default, a logger will be created and
|
|
|
|
# initialized using #log_path and #log_level, but a programmer may
|
|
|
|
# specifically set the logger to use via this accessor and it will be
|
|
|
|
# used directly.
|
|
|
|
attr_accessor :logger
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The root of the application's views. (Defaults to <tt>app/views</tt>.)
|
|
|
|
attr_accessor :view_path
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Set to +true+ if you want to be warned (noisily) when you try to invoke
|
|
|
|
# any method of +nil+. Set to +false+ for the standard Ruby behavior.
|
|
|
|
attr_accessor :whiny_nils
|
2006-10-17 16:27:03 -04:00
|
|
|
|
2006-12-18 15:27:05 -05:00
|
|
|
# The list of plugins to load. If this is set to <tt>nil</tt>, all plugins will
|
|
|
|
# be loaded. If this is set to <tt>[]</tt>, no plugins will be loaded. Otherwise,
|
|
|
|
# plugins will be loaded in the order specified.
|
2006-10-17 16:27:03 -04:00
|
|
|
attr_accessor :plugins
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-11-07 03:09:38 -05:00
|
|
|
# The path to the root of the plugins directory. By default, it is in
|
|
|
|
# <tt>vendor/plugins</tt>.
|
|
|
|
attr_accessor :plugin_paths
|
2007-03-18 09:35:16 -04:00
|
|
|
|
2007-03-02 18:39:29 -05:00
|
|
|
# The classes that handle finding the desired plugins that you'd like to load for
|
|
|
|
# your application. By default it is the Rails::Plugin::FileSystemLocator which finds
|
|
|
|
# plugins to load in <tt>vendor/plugins</tt>. You can hook into gem location by subclassing
|
|
|
|
# Rails::Plugin::Locator and adding it onto the list of <tt>plugin_locators</tt>.
|
|
|
|
attr_accessor :plugin_locators
|
2007-03-18 09:35:16 -04:00
|
|
|
|
|
|
|
# The class that handles loading each plugin. Defaults to Rails::Plugin::Loader, but
|
2007-03-01 19:20:32 -05:00
|
|
|
# a sub class would have access to fine grained modification of the loading behavior. See
|
|
|
|
# the implementation of Rails::Plugin::Loader for more details.
|
|
|
|
attr_accessor :plugin_loader
|
2007-04-29 03:35:22 -04:00
|
|
|
|
|
|
|
# Deprecated options:
|
|
|
|
def breakpoint_server(_ = nil)
|
|
|
|
$stderr.puts %(
|
|
|
|
*******************************************************************
|
|
|
|
* config.breakpoint_server has been deprecated and has no effect. *
|
|
|
|
*******************************************************************
|
|
|
|
)
|
|
|
|
end
|
|
|
|
alias_method :breakpoint_server=, :breakpoint_server
|
2005-11-07 03:09:38 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Create a new Configuration instance, initialized with the default
|
|
|
|
# values.
|
2005-09-03 11:13:06 -04:00
|
|
|
def initialize
|
2007-03-18 09:35:16 -04:00
|
|
|
set_root_path!
|
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
self.frameworks = default_frameworks
|
|
|
|
self.load_paths = default_load_paths
|
2006-08-29 02:52:39 -04:00
|
|
|
self.load_once_paths = default_load_once_paths
|
2005-09-13 05:58:16 -04:00
|
|
|
self.log_path = default_log_path
|
|
|
|
self.log_level = default_log_level
|
|
|
|
self.view_path = default_view_path
|
|
|
|
self.controller_paths = default_controller_paths
|
|
|
|
self.cache_classes = default_cache_classes
|
|
|
|
self.whiny_nils = default_whiny_nils
|
2006-10-17 16:27:03 -04:00
|
|
|
self.plugins = default_plugins
|
2005-11-07 03:09:38 -05:00
|
|
|
self.plugin_paths = default_plugin_paths
|
2007-03-02 18:39:29 -05:00
|
|
|
self.plugin_locators = default_plugin_locators
|
2007-03-01 19:20:32 -05:00
|
|
|
self.plugin_loader = default_plugin_loader
|
2005-09-03 11:13:06 -04:00
|
|
|
self.database_configuration_file = default_database_configuration_file
|
2005-11-07 03:09:38 -05:00
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
for framework in default_frameworks
|
2006-04-30 16:36:37 -04:00
|
|
|
self.send("#{framework}=", Rails::OrderedOptions.new)
|
2005-09-13 05:58:16 -04:00
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2007-03-18 09:35:16 -04:00
|
|
|
# Set the root_path to RAILS_ROOT and canonicalize it.
|
|
|
|
def set_root_path!
|
|
|
|
raise 'RAILS_ROOT is not set' unless defined?(::RAILS_ROOT)
|
|
|
|
raise 'RAILS_ROOT is not a directory' unless File.directory?(::RAILS_ROOT)
|
|
|
|
|
|
|
|
@root_path =
|
|
|
|
# Pathname is incompatible with Windows, but Windows doesn't have
|
|
|
|
# real symlinks so File.expand_path is safe.
|
|
|
|
if RUBY_PLATFORM =~ /(:?mswin|mingw)/
|
|
|
|
File.expand_path(::RAILS_ROOT)
|
|
|
|
|
|
|
|
# Otherwise use Pathname#realpath which respects symlinks.
|
|
|
|
else
|
|
|
|
Pathname.new(::RAILS_ROOT).realpath.to_s
|
|
|
|
end
|
2007-04-16 17:55:59 -04:00
|
|
|
|
|
|
|
Object.const_set(:RELATIVE_RAILS_ROOT, ::RAILS_ROOT.dup) unless defined?(::RELATIVE_RAILS_ROOT)
|
2007-03-29 01:44:44 -04:00
|
|
|
::RAILS_ROOT.replace @root_path
|
2007-03-18 09:35:16 -04:00
|
|
|
end
|
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Loads and returns the contents of the #database_configuration_file. The
|
|
|
|
# contents of the file are processed via ERB before being sent through
|
|
|
|
# YAML::load.
|
2005-09-03 11:13:06 -04:00
|
|
|
def database_configuration
|
2005-09-30 03:20:57 -04:00
|
|
|
YAML::load(ERB.new(IO.read(database_configuration_file)).result)
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# The path to the current environment's file (development.rb, etc.). By
|
|
|
|
# default the file is at <tt>config/environments/#{environment}.rb</tt>.
|
2005-09-13 05:58:16 -04:00
|
|
|
def environment_path
|
2005-11-07 03:09:38 -05:00
|
|
|
"#{root_path}/config/environments/#{environment}.rb"
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2005-10-05 14:25:15 -04:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Return the currently selected environment. By default, it returns the
|
|
|
|
# value of the +RAILS_ENV+ constant.
|
2005-09-03 11:13:06 -04:00
|
|
|
def environment
|
|
|
|
::RAILS_ENV
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-02-06 19:21:45 -05:00
|
|
|
# Sets a block which will be executed after rails has been fully initialized.
|
2006-11-13 01:23:58 -05:00
|
|
|
# Useful for per-environment configuration which depends on the framework being
|
2006-02-06 19:21:45 -05:00
|
|
|
# fully initialized.
|
|
|
|
def after_initialize(&after_initialize_block)
|
|
|
|
@after_initialize_block = after_initialize_block
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-02-06 19:21:45 -05:00
|
|
|
# Returns the block set in Configuration#after_initialize
|
|
|
|
def after_initialize_block
|
|
|
|
@after_initialize_block
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-08-05 23:22:38 -04:00
|
|
|
# Add a preparation callback that will run before every request in development
|
|
|
|
# mode, or before the first request in production.
|
2006-11-13 01:23:58 -05:00
|
|
|
#
|
2006-08-05 23:22:38 -04:00
|
|
|
# See Dispatcher#to_prepare.
|
|
|
|
def to_prepare(&callback)
|
2006-12-26 18:56:00 -05:00
|
|
|
require 'dispatcher' unless defined?(::Dispatcher)
|
2006-08-05 23:22:38 -04:00
|
|
|
Dispatcher.to_prepare(&callback)
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-08-14 21:28:06 -04:00
|
|
|
def builtin_directories
|
|
|
|
# Include builtins only in the development environment.
|
|
|
|
(environment == 'development') ? Dir["#{RAILTIES_PATH}/builtin/*/"] : []
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-10-16 14:12:01 -04:00
|
|
|
def framework_paths
|
|
|
|
# TODO: Don't include dirs for frameworks that are not used
|
|
|
|
%w(
|
|
|
|
railties
|
|
|
|
railties/lib
|
|
|
|
actionpack/lib
|
|
|
|
activesupport/lib
|
|
|
|
activerecord/lib
|
2007-04-23 14:55:54 -04:00
|
|
|
activeresource/lib
|
2006-10-16 14:12:01 -04:00
|
|
|
actionmailer/lib
|
|
|
|
).map { |dir| "#{framework_root_path}/#{dir}" }.select { |dir| File.directory?(dir) }
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
private
|
2006-01-29 23:08:05 -05:00
|
|
|
def framework_root_path
|
|
|
|
defined?(::RAILS_FRAMEWORK_ROOT) ? ::RAILS_FRAMEWORK_ROOT : "#{root_path}/vendor/rails"
|
|
|
|
end
|
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
def default_frameworks
|
2007-04-23 14:55:54 -04:00
|
|
|
[ :active_record, :action_controller, :action_view, :action_mailer, :active_resource ]
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
def default_load_paths
|
2005-11-07 03:09:38 -05:00
|
|
|
paths = ["#{root_path}/test/mocks/#{environment}"]
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-02-03 15:29:39 -05:00
|
|
|
# Add the app's controller directory
|
|
|
|
paths.concat(Dir["#{root_path}/app/controllers/"])
|
2005-09-03 11:13:06 -04:00
|
|
|
|
2006-09-07 12:53:58 -04:00
|
|
|
# Then components subdirectories.
|
2005-11-07 03:09:38 -05:00
|
|
|
paths.concat(Dir["#{root_path}/components/[_a-z]*"])
|
2005-09-03 11:13:06 -04:00
|
|
|
|
|
|
|
# Followed by the standard includes.
|
|
|
|
paths.concat %w(
|
2006-11-13 01:23:58 -05:00
|
|
|
app
|
|
|
|
app/models
|
2005-10-28 18:01:11 -04:00
|
|
|
app/controllers
|
|
|
|
app/helpers
|
|
|
|
app/services
|
2006-11-13 01:23:58 -05:00
|
|
|
components
|
|
|
|
config
|
|
|
|
lib
|
|
|
|
vendor
|
2005-11-07 03:09:38 -05:00
|
|
|
).map { |dir| "#{root_path}/#{dir}" }.select { |dir| File.directory?(dir) }
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-10-16 14:19:21 -04:00
|
|
|
paths.concat builtin_directories
|
2006-08-29 02:52:39 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2006-12-27 17:18:38 -05:00
|
|
|
# Doesn't matter since plugins aren't in load_paths yet.
|
2006-08-29 02:52:39 -04:00
|
|
|
def default_load_once_paths
|
2006-12-27 17:18:38 -05:00
|
|
|
[]
|
2006-08-08 17:21:04 -04:00
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
|
|
|
|
def default_log_path
|
2005-11-07 03:09:38 -05:00
|
|
|
File.join(root_path, 'log', "#{environment}.log")
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
def default_log_level
|
2005-09-12 14:05:46 -04:00
|
|
|
environment == 'production' ? :info : :debug
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
def default_database_configuration_file
|
2005-11-07 03:09:38 -05:00
|
|
|
File.join(root_path, 'config', 'database.yml')
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
def default_view_path
|
2005-11-07 03:09:38 -05:00
|
|
|
File.join(root_path, 'app', 'views')
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-03 11:13:06 -04:00
|
|
|
def default_controller_paths
|
2007-03-18 09:35:16 -04:00
|
|
|
paths = [File.join(root_path, 'app', 'controllers')]
|
2006-08-14 21:28:06 -04:00
|
|
|
paths.concat builtin_directories
|
|
|
|
paths
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
def default_dependency_mechanism
|
|
|
|
:load
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
def default_cache_classes
|
|
|
|
false
|
|
|
|
end
|
2006-11-13 01:23:58 -05:00
|
|
|
|
2005-09-13 05:58:16 -04:00
|
|
|
def default_whiny_nils
|
|
|
|
false
|
|
|
|
end
|
2005-11-07 03:09:38 -05:00
|
|
|
|
2006-10-17 16:27:03 -04:00
|
|
|
def default_plugins
|
2006-12-18 15:27:05 -05:00
|
|
|
nil
|
2006-10-17 16:27:03 -04:00
|
|
|
end
|
|
|
|
|
2005-11-07 03:09:38 -05:00
|
|
|
def default_plugin_paths
|
|
|
|
["#{root_path}/vendor/plugins"]
|
|
|
|
end
|
2007-03-18 09:35:16 -04:00
|
|
|
|
2007-03-02 18:39:29 -05:00
|
|
|
def default_plugin_locators
|
|
|
|
[Plugin::FileSystemLocator]
|
|
|
|
end
|
2007-03-18 09:35:16 -04:00
|
|
|
|
2007-03-01 19:20:32 -05:00
|
|
|
def default_plugin_loader
|
|
|
|
Plugin::Loader
|
|
|
|
end
|
2005-09-03 11:13:06 -04:00
|
|
|
end
|
2005-09-05 08:36:40 -04:00
|
|
|
end
|
2005-09-30 03:20:57 -04:00
|
|
|
|
2005-10-15 20:17:09 -04:00
|
|
|
# Needs to be duplicated from Active Support since its needed before Active
|
2006-04-30 16:36:37 -04:00
|
|
|
# Support is available. Here both Options and Hash are namespaced to prevent
|
|
|
|
# conflicts with other implementations AND with the classes residing in ActiveSupport.
|
|
|
|
class Rails::OrderedOptions < Array #:nodoc:
|
|
|
|
def []=(key, value)
|
|
|
|
key = key.to_sym
|
|
|
|
|
2005-09-30 03:20:57 -04:00
|
|
|
if pair = find_pair(key)
|
|
|
|
pair.pop
|
|
|
|
pair << value
|
|
|
|
else
|
|
|
|
self << [key, value]
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2006-02-25 20:56:09 -05:00
|
|
|
def [](key)
|
2006-04-30 16:36:37 -04:00
|
|
|
pair = find_pair(key.to_sym)
|
|
|
|
pair ? pair.last : nil
|
2006-02-25 20:56:09 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
def method_missing(name, *args)
|
|
|
|
if name.to_s =~ /(.*)=$/
|
|
|
|
self[$1.to_sym] = args.first
|
|
|
|
else
|
|
|
|
self[name]
|
|
|
|
end
|
|
|
|
end
|
2006-04-30 16:36:37 -04:00
|
|
|
|
|
|
|
private
|
|
|
|
def find_pair(key)
|
|
|
|
self.each { |i| return i if i.first == key }
|
|
|
|
return false
|
|
|
|
end
|
2007-05-23 03:05:51 -04:00
|
|
|
end
|