W3cubDocs

/Ruby on Rails 5.1

class Rails::Paths::Path

Parent:
Object
Included modules:
Enumerable

Attributes

glob[RW]

Public Class Methods

new(root, current, paths, options = {}) Show source
# File railties/lib/rails/paths.rb, line 113
def initialize(root, current, paths, options = {})
  @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!
end

Public Instance Methods

<<(path) Show source
# File railties/lib/rails/paths.rb, line 164
def <<(path)
  @paths << path
end
Also aliased as: push
children() Show source
# File railties/lib/rails/paths.rb, line 129
def children
  keys = @root.keys.find_all { |k|
    k.start_with?(@current) && k != @current
  }
  @root.values_at(*keys.sort)
end
concat(paths) Show source
# File railties/lib/rails/paths.rb, line 169
def concat(paths)
  @paths.concat paths
end
each(&block) Show source
# File railties/lib/rails/paths.rb, line 160
def each(&block)
  @paths.each(&block)
end
existent() Show source

Returns all expanded paths but only if they exist in the filesystem.

# File railties/lib/rails/paths.rb, line 207
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
existent_directories() Show source
# File railties/lib/rails/paths.rb, line 218
def existent_directories
  expanded.select { |d| File.directory?(d) }
end
expanded() Show source

Expands all paths against the root and return all unique values.

# File railties/lib/rails/paths.rb, line 186
def expanded
  raise "You need to set a path root" unless @root.path
  result = []

  each do |p|
    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

  result.uniq!
  result
end
Also aliased as: to_a
first() Show source
# File railties/lib/rails/paths.rb, line 136
def first
  expanded.first
end
last() Show source
# File railties/lib/rails/paths.rb, line 140
def last
  expanded.last
end
push(path)
Alias for: <<
to_a()
Alias for: expanded
to_ary() Show source
# File railties/lib/rails/paths.rb, line 177
def to_ary
  @paths
end
unshift(*paths) Show source
# File railties/lib/rails/paths.rb, line 173
def unshift(*paths)
  @paths.unshift(*paths)
end

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