Class: Tilt::Cache

Inherits:
Object
  • Object
show all
Defined in:
lib/tilt.rb

Overview

Note:

Tilt::Cache is a thin wrapper around Hash. It has the following limitations:

  • Not thread-safe.

  • Size is unbounded.

  • Keys are not copied defensively, and should not be modified after being passed to #fetch. More specifically, the values returned by key#hash and key#eql? should not change.

If this is too limiting for you, use a different cache implementation.

Extremely simple template cache implementation. Calling applications create a Tilt::Cache instance and use #fetch with any set of hashable arguments (such as those to Tilt.new):

cache = Tilt::Cache.new
cache.fetch(path, line, options) { Tilt.new(path, line, options) }

Subsequent invocations return the already loaded template object.

Instance Method Summary collapse

Constructor Details

#initializeCache

Returns a new instance of Cache.



92
93
94
# File 'lib/tilt.rb', line 92

def initialize
  @cache = {}
end

Instance Method Details

#clearObject

Clears the cache.



109
110
111
# File 'lib/tilt.rb', line 109

def clear
  @cache = {}
end

#fetch(*key) { ... } ⇒ Object

Caches a value for key, or returns the previously cached value. If a value has been previously cached for key then it is returned. Otherwise, block is yielded to and its return value which may be nil, is cached under key and returned.

Yields:

Yield Returns:

  • the value to cache for key



102
103
104
105
106
# File 'lib/tilt.rb', line 102

def fetch(*key)
  @cache.fetch(key) do
    @cache[key] = yield
  end
end