Class: Rails::Paths::Path

Inherits:
Array show all
Defined in:
railties/lib/rails/paths.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Array

#as_json, #encode_json, #extract_options!, #fifth, #forty_two, #fourth, #from, #in_groups, #in_groups_of, #sample, #second, #split, #third, #to, #to_formatted_s, #to_param, #to_query, #to_sentence, #to_xml, #uniq_by, #uniq_by!, wrap

Constructor Details

#initialize(root, current, *paths) ⇒ Path


107
108
109
110
111
112
113
114
115
116
117
118
119
# File 'railties/lib/rails/paths.rb', line 107

def initialize(root, current, *paths)
  options = paths.last.is_a?(::Hash) ? paths.pop : {}
  super(paths.flatten)

  @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

Instance Attribute Details

#globObject

Returns the value of attribute glob


105
106
107
# File 'railties/lib/rails/paths.rb', line 105

def glob
  @glob
end

#pathObject (readonly)

Returns the value of attribute path


104
105
106
# File 'railties/lib/rails/paths.rb', line 104

def path
  @path
end

Instance Method Details

#childrenObject


121
122
123
124
125
# File 'railties/lib/rails/paths.rb', line 121

def children
  keys = @root.keys.select { |k| k.include?(@current) }
  keys.delete(@current)
  @root.values_at(*keys.sort)
end

#existentObject

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


189
190
191
# File 'railties/lib/rails/paths.rb', line 189

def existent
  expanded.select { |f| File.exists?(f) }
end

#existent_directoriesObject


193
194
195
# File 'railties/lib/rails/paths.rb', line 193

def existent_directories
  expanded.select { |d| File.directory?(d) }
end

#expandedObject Also known as: to_a

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


152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
# File 'railties/lib/rails/paths.rb', line 152

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
      if File.directory? path
        result.concat expand_dir(path, @glob)
      else
        # FIXME: I think we can remove this branch, but I'm not sure.
        # Say the filesystem has this file:
        #
        #   /tmp/foobar
        #
        # and someone adds this path:
        #
        #   /tmp/foo
        #
        # with a glob of "*", then this function will return
        #
        #   /tmp/foobar
        #
        # We need to figure out if that is desired behavior.
        result.concat expand_file(path, @glob)
      end
    else
      result << path
    end
  end

  result.uniq!
  result
end

#firstObject


127
128
129
# File 'railties/lib/rails/paths.rb', line 127

def first
  expanded.first
end

#lastObject


131
132
133
# File 'railties/lib/rails/paths.rb', line 131

def last
  expanded.last
end