1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
rails--rails/railties/lib/rails/paths.rb

226 lines
5.9 KiB
Ruby
Raw Normal View History

module Rails
2010-01-23 16:30:17 -05:00
module Paths
# This object is an extended hash that behaves as root of the <tt>Rails::Paths</tt> system.
# It allows you to collect information about how you want to structure your application
# paths through a Hash-like API. It requires you to give a physical path on initialization.
#
2011-05-25 04:38:51 -04:00
# root = Root.new "/rails"
# root.add "app/controllers", eager_load: true
#
# The above command creates a new root object and adds "app/controllers" as a path.
# This means we can get a <tt>Rails::Paths::Path</tt> object back like below:
#
# path = root["app/controllers"]
# path.eager_load? # => true
2011-05-04 14:08:21 -04:00
# path.is_a?(Rails::Paths::Path) # => true
#
2012-03-26 20:25:44 -04:00
# The +Path+ object is simply an enumerable and allows you to easily add extra paths:
#
2012-03-26 20:25:44 -04:00
# path.is_a?(Enumerable) # => true
# path.to_ary.inspect # => ["app/controllers"]
#
# path << "lib/controllers"
2012-03-26 20:25:44 -04:00
# path.to_ary.inspect # => ["app/controllers", "lib/controllers"]
#
# Notice that when you add a path using +add+, the path object created already
# contains the path with the same path value given to +add+. In some situations,
# you may not want this behavior, so you can give <tt>:with</tt> as option.
#
2012-10-14 06:03:39 -04:00
# root.add "config/routes", with: "config/routes.rb"
2011-05-04 14:08:21 -04:00
# root["config/routes"].inspect # => ["config/routes.rb"]
#
# The +add+ method accepts the following options as arguments:
# eager_load, autoload, autoload_once, and glob.
#
# Finally, the +Path+ object also provides a few helpers:
#
2011-05-25 04:38:51 -04:00
# root = Root.new "/rails"
# root.add "app/controllers"
#
2011-05-04 14:08:21 -04:00
# root["app/controllers"].expanded # => ["/rails/app/controllers"]
# root["app/controllers"].existent # => ["/rails/app/controllers"]
#
# Check the <tt>Rails::Paths::Path</tt> documentation for more information.
2012-03-26 20:56:16 -04:00
class Root
attr_accessor :path
def initialize(path)
@path = path
2012-03-26 20:56:16 -04:00
@root = {}
end
def []=(path, value)
glob = self[path] ? self[path].glob : nil
2012-10-14 06:03:39 -04:00
add(path, with: value, glob: glob)
end
def add(path, options = {})
with = Array(options.fetch(:with, path))
2013-01-02 10:03:23 -05:00
@root[path] = Path.new(self, path, with, options)
2012-03-26 20:56:16 -04:00
end
def [](path)
@root[path]
end
def values
@root.values
end
def keys
@root.keys
end
def values_at(*list)
@root.values_at(*list)
end
2010-01-24 03:00:18 -05:00
def all_paths
values.tap(&:uniq!)
end
def autoload_once
filter_by(&:autoload_once?)
end
2010-01-24 03:00:18 -05:00
def eager_load
filter_by(&:eager_load?)
end
def autoload_paths
filter_by(&:autoload?)
end
def load_paths
filter_by(&:load_path?)
end
private
2010-01-24 03:00:18 -05:00
2013-10-22 13:35:32 -04:00
def filter_by(&block)
all_paths.find_all(&block).flat_map { |path|
paths = path.existent
paths - path.children.flat_map { |p| yield(p) ? [] : p.existent }
2013-10-22 13:35:32 -04:00
}.uniq
2010-01-24 03:00:18 -05:00
end
end
2012-03-26 20:25:44 -04:00
class Path
include Enumerable
attr_accessor :glob
def initialize(root, current, paths, options = {})
2012-03-26 20:25:44 -04:00
@paths = paths
@current = current
@root = root
@glob = options[:glob]
options[:autoload_once] ? autoload_once! : skip_autoload_once!
options[:eager_load] ? eager_load! : skip_eager_load!
options[:autoload] ? autoload! : skip_autoload!
options[:load_path] ? load_path! : skip_load_path!
2009-11-06 20:21:39 -05:00
end
def absolute_current # :nodoc:
2015-08-04 11:53:15 -04:00
File.expand_path(@current, @root.path)
end
def children
keys = @root.keys.find_all { |k|
k.start_with?(@current) && k != @current
}
@root.values_at(*keys.sort)
end
def first
expanded.first
end
def last
expanded.last
end
%w(autoload_once eager_load autoload load_path).each do |m|
class_eval <<-RUBY, __FILE__, __LINE__ + 1
def #{m}! # def eager_load!
@#{m} = true # @eager_load = true
2011-05-04 14:12:29 -04:00
end # end
#
def skip_#{m}! # def skip_eager_load!
@#{m} = false # @eager_load = false
2011-05-04 14:12:29 -04:00
end # end
#
def #{m}? # def eager_load?
@#{m} # @eager_load
2011-05-04 14:12:29 -04:00
end # end
RUBY
end
2012-03-26 20:25:44 -04:00
def each(&block)
@paths.each(&block)
2012-03-26 20:25:44 -04:00
end
def <<(path)
@paths << path
end
alias :push :<<
def concat(paths)
@paths.concat paths
end
def unshift(*paths)
@paths.unshift(*paths)
2012-03-26 20:25:44 -04:00
end
def to_ary
@paths
end
def extensions # :nodoc:
$1.split(",") if @glob =~ /\{([\S]+)\}/
2015-08-04 11:53:15 -04:00
end
# Expands all paths against the root and return all unique values.
def expanded
raise "You need to set a path root" unless @root.path
result = []
each do |p|
2010-01-22 10:24:44 -05:00
path = File.expand_path(p, @root.path)
if @glob && File.directory?(path)
Dir.chdir(path) do
result.concat(Dir.glob(@glob).map { |file| File.join path, file }.sort)
end
else
result << path
end
end
2010-01-22 10:24:44 -05:00
result.uniq!
result
end
# Returns all expanded paths but only if they exist in the filesystem.
def existent
expanded.select do |f|
does_exist = File.exist?(f)
if !does_exist && File.symlink?(f)
raise "File #{f.inspect} is a symlink that does not point to a valid file"
end
does_exist
end
end
def existent_directories
expanded.select { |d| File.directory?(d) }
end
alias to_a expanded
end
end
2010-10-06 11:50:31 -04:00
end