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

#initialize ⇒ Cache

Returns a new instance of Cache.



112
113
114
 
# File 'lib/tilt.rb', line 112

def initialize
  @cache = {}
end

Instance Method Details

#clear ⇒ Object

Clears the cache.



129
130
131
 
# File 'lib/tilt.rb', line 129

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



122
123
124
125
126
 
# File 'lib/tilt.rb', line 122

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