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 through 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 above command creates a new root object and adds “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.

Methods

Attributes

[RW] path

Class Public methods

new(path)

📝 Source code 
# File railties/lib/rails/paths.rb, line 51
      def initialize(path)
        @path = path
        @root = {}
      end
🔎 See on GitHub

Instance Public methods

[](path)

📝 Source code 
# File railties/lib/rails/paths.rb, line 66
      def [](path)
        @root[path]
      end
🔎 See on GitHub

[]=(path, value)

📝 Source code 
# File railties/lib/rails/paths.rb, line 56
      def []=(path, value)
        glob = self[path] ? self[path].glob : nil
        add(path, with: value, glob: glob)
      end
🔎 See on GitHub

add(path, options = {})

📝 Source code 
# File railties/lib/rails/paths.rb, line 61
      def add(path, options = {})
        with = Array(options.fetch(:with, path))
        @root[path] = Path.new(self, path, with, options)
      end
🔎 See on GitHub

all_paths()

📝 Source code 
# File railties/lib/rails/paths.rb, line 82
      def all_paths
        values.tap(&:uniq!)
      end
🔎 See on GitHub

autoload_once()

📝 Source code 
# File railties/lib/rails/paths.rb, line 86
      def autoload_once
        filter_by(&:autoload_once?)
      end
🔎 See on GitHub

autoload_paths()

📝 Source code 
# File railties/lib/rails/paths.rb, line 94
      def autoload_paths
        filter_by(&:autoload?)
      end
🔎 See on GitHub

eager_load()

📝 Source code 
# File railties/lib/rails/paths.rb, line 90
      def eager_load
        filter_by(&:eager_load?)
      end
🔎 See on GitHub

keys()

📝 Source code 
# File railties/lib/rails/paths.rb, line 74
      def keys
        @root.keys
      end
🔎 See on GitHub

load_paths()

📝 Source code 
# File railties/lib/rails/paths.rb, line 98
      def load_paths
        filter_by(&:load_path?)
      end
🔎 See on GitHub

values()

📝 Source code 
# File railties/lib/rails/paths.rb, line 70
      def values
        @root.values
      end
🔎 See on GitHub

values_at(*list)

📝 Source code 
# File railties/lib/rails/paths.rb, line 78
      def values_at(*list)
        @root.values_at(*list)
      end
🔎 See on GitHub