Class: Rails::Paths::Path

Inherits:

Array

• Object
• Array
• Rails::Paths::Path

show all

Defined in:

railties/lib/rails/paths.rb

Instance Attribute Summary (collapse)

• - (Object) glob

  Returns the value of attribute glob.

• - (Object) path readonly

  Returns the value of attribute path.

Instance Method Summary (collapse)

• - (Object) children
• - (Object) existent

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

• - (Object) existent_directories
• - (Object) expanded (also: #to_a)

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

• - (Object) first
• - (Path) initialize(root, current, *paths) constructor

  A new instance of Path.

• - (Object) last

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

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

105
106
107

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

def glob
  @glob
end

104
105
106

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

def path
  @path
end

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

189
190
191

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

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

193
194
195

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

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

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

127
128
129

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

def first
  expanded.first
end

131
132
133

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

def last
  expanded.last
end