module Sprockets::Caching

‘Caching` is an internal mixin whose public methods are exposed on the `Environment` and `Index` classes.

Protected Instance Methods

Source

# File lib/sprockets/caching.rb, line 9
def cache_asset(path)
  # If `cache` is not set, return fast
  if cache.nil?
    yield

  # Check cache for `path`
  elsif (asset = Asset.from_hash(self, cache_get_hash(path.to_s))) && asset.fresh?(self)
    asset

   # Otherwise yield block that slowly finds and builds the asset
  elsif asset = yield
    hash = {}
    asset.encode_with(hash)

    # Save the asset to its path
    cache_set_hash(path.to_s, hash)

    # Since path maybe a logical or full pathname, save the
    # asset its its full path too
    if path.to_s != asset.pathname.to_s
      cache_set_hash(asset.pathname.to_s, hash)
    end

    asset
  end
end

Cache helper method. Takes a ‘path` argument which maybe a logical path or fully expanded path. The `&block` is passed for finding and building the asset if its not in cache.