class Rails::Paths::Root

Parent:
Object

This object is an extended hash that behaves as root of the Rails::Paths system. It allows you to collect information about how you want to structure your application paths by a Hash like API. It requires you to give a physical path on initialization.

root = Root.new "/rails"
root.add "app/controllers", eager_load: true

The command above creates a new root object and add “app/controllers” as a path. This means we can get a Rails::Paths::Path object back like below:

path = root["app/controllers"]
path.eager_load?               # => true
path.is_a?(Rails::Paths::Path) # => true

The Path object is simply an enumerable and allows you to easily add extra paths:

path.is_a?(Enumerable) # => true
path.to_ary.inspect    # => ["app/controllers"]

path << "lib/controllers"
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 :with as option.

root.add "config/routes", with: "config/routes.rb"
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:

root = Root.new "/rails"
root.add "app/controllers"

root["app/controllers"].expanded # => ["/rails/app/controllers"]
root["app/controllers"].existent # => ["/rails/app/controllers"]

Check the Rails::Paths::Path documentation for more information.

Attributes

path[RW]

Public Class Methods

new(path) Show source
# File railties/lib/rails/paths.rb, line 47
def initialize(path)
  @current = nil
  @path = path
  @root = {}
end

Public Instance Methods

[](path) Show source
# File railties/lib/rails/paths.rb, line 63
def [](path)
  @root[path]
end
[]=(path, value) Show source
# File railties/lib/rails/paths.rb, line 53
def []=(path, value)
  glob = self[path] ? self[path].glob : nil
  add(path, with: value, glob: glob)
end
add(path, options = {}) Show source
# File railties/lib/rails/paths.rb, line 58
def add(path, options = {})
  with = Array(options.fetch(:with, path))
  @root[path] = Path.new(self, path, with, options)
end
all_paths() Show source
# File railties/lib/rails/paths.rb, line 79
def all_paths
  values.tap { |v| v.uniq! }
end
autoload_once() Show source
# File railties/lib/rails/paths.rb, line 83
def autoload_once
  filter_by { |p| p.autoload_once? }
end
autoload_paths() Show source
# File railties/lib/rails/paths.rb, line 91
def autoload_paths
  filter_by { |p| p.autoload? }
end
eager_load() Show source
# File railties/lib/rails/paths.rb, line 87
def eager_load
  filter_by { |p| p.eager_load? }
end
keys() Show source
# File railties/lib/rails/paths.rb, line 71
def keys
  @root.keys
end
load_paths() Show source
# File railties/lib/rails/paths.rb, line 95
def load_paths
  filter_by { |p| p.load_path? }
end
values() Show source
# File railties/lib/rails/paths.rb, line 67
def values
  @root.values
end
values_at(*list) Show source
# File railties/lib/rails/paths.rb, line 75
def values_at(*list)
  @root.values_at(*list)
end

© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.