module Sprockets::Trail

def append_path(path)

Paths at the beginning of the `Array` have a higher priority.

Append a `path` to the `paths` list. 
def append_path(path)
  expire_index!
  @trail.append_path(path)
end

def clear_paths

you want.
completely wipe the paths list and reappend them in the order
There is no mechanism for reordering paths, so its best to

Clear all paths and start fresh. 
def clear_paths
  expire_index!
  @trail.paths.dup.each { |path| @trail.remove_path(path) }
end

def extensions


# => [".js", ".css", ".coffee", ".sass", ...]

These extensions maybe omitted from logical path searches.

Returns an `Array` of extensions. 
def extensions
  trail.extensions.dup
end

def find_asset_in_path(logical_path, options = {}) 

def find_asset_in_path(logical_path, options = {})
  # Strip fingerprint on logical path if there is one.
  # Not sure how valuable this feature is...
  if fingerprint = attributes_for(logical_path).path_fingerprint
    pathname = resolve(logical_path.to_s.sub("-#{fingerprint}", ''))
  else
    pathname = resolve(logical_path)
  end
rescue FileNotFound
  nil
else
  # Build the asset for the actual pathname
  asset = build_asset(logical_path, pathname, options)
  # Double check request fingerprint against actual digest
  # Again, not sure if this code path is even reachable
  if fingerprint && fingerprint != asset.digest
    logger.error "Nonexistent asset #{logical_path} @ #{fingerprint}"
    asset = nil
  end
  asset
end

def paths

`prepend_path`, and `clear_paths`.
have no affect on the environment. See `append_path`,
Note that a copy of the `Array` is returned so mutating will

These paths will be used for asset logical path lookups.

Returns an `Array` of path `String`s. 
def paths
  trail.paths.dup
end

def prepend_path(path)

Paths at the end of the `Array` have the least priority.

Prepend a `path` to the `paths` list. 
def prepend_path(path)
  expire_index!
  @trail.prepend_path(path)
end

def resolve(logical_path, options = {})

A `FileNotFound` exception is raised if the file does not exist.

# => "/path/to/app/javascripts/application.js.coffee"
resolve("application.js")

searching the environment's paths.
Finds the expanded real path for a given logical path by 
def resolve(logical_path, options = {})
  # If a block is given, preform an iterable search
  if block_given?
    args = attributes_for(logical_path).search_paths + [options]
    trail.find(*args) do |path|
      yield Pathname.new(path)
    end
  else
    resolve(logical_path, options) do |pathname|
      return pathname
    end
    raise FileNotFound, "couldn't find file '#{logical_path}'"
  end
end

def root

useful set this to your applications root directory. (`Rails.root`)
All relative paths are expanded with root as its base. To be

Returns `Environment` root. 
def root
  trail.root.dup
end

def trail 

def trail
  @trail
end