tilt 2.0.9 → 2.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 628b7587af284142a071a75dec94e684b6972d16
-  data.tar.gz: a686e34c2f8d764a74e2760fe5af2fc22c27b66d
+  metadata.gz: 65edfb577c11890055c06be1af7c6cd1692d6bb1
+  data.tar.gz: 025cb576450017fe953040a197522416e98c7835
 SHA512:
-  metadata.gz: b802450ebc32e4d50d65af2bf827bf8e6b92d85787ea9507701d70e6c0e8df911fce4402e53e99e95029d11daa4bcbca6ed99f5c90fa0235d0051d7a290a6446
-  data.tar.gz: a2db67256a1c846deabd6520d943e101645ea25cb610d022e60f2755dbddddfd8197275c6783ed663f569538647553714a1151d6d660887caf8ae6662b008159
+  metadata.gz: f1bbd4f61540f418aed012bd34cca939a7a208f0dc73ec5283041a0611fb629d5941bf24ab2976e2038774599b5d5e8f29c7beb0fababdf91c6f2d4eb9628a0b
+  data.tar.gz: 32cb517066dc3550f33b201980884479dbd387864133267ac1563fcfa8500386bbcf204ca0fbb9c98bac8f910cc1af647ff9464839806b1d32a088865c0d6e52

data/lib/tilt.rb

@@ -4,7 +4,7 @@ require 'tilt/template'
 # Namespace for Tilt. This module is not intended to be included anywhere.
 module Tilt
   # Current version.
-  VERSION = '2.0.9'
+  VERSION = '2.0.10'
 
   @default_mapping = Mapping.new
 

data/lib/tilt/template.rb

@@ -166,7 +166,7 @@ module Tilt
     def evaluate(scope, locals, &block)
       locals_keys = locals.keys
       locals_keys.sort!{|x, y| x.to_s <=> y.to_s}
-      method = compiled_method(locals_keys)
+      method = compiled_method(locals_keys, scope.is_a?(Module) ? scope : scope.class)
       method.bind(scope).call(locals, &block)
     end
 
@@ -231,9 +231,9 @@ module Tilt
     end
 
     # The compiled method for the locals keys provided.
-    def compiled_method(locals_keys)
+    def compiled_method(locals_keys, scope_class=nil)
       LOCK.synchronize do
-        @compiled_method[locals_keys] ||= compile_template_method(locals_keys)
+        @compiled_method[[scope_class, locals_keys]] ||= compile_template_method(locals_keys, scope_class)
       end
     end
 
@@ -247,7 +247,7 @@ module Tilt
       end.join("\n")
     end
 
-    def compile_template_method(local_keys)
+    def compile_template_method(local_keys, scope_class=nil)
       source, offset = precompiled(local_keys)
       local_code = local_extraction(local_keys)
 
@@ -261,17 +261,12 @@ module Tilt
       method_source << <<-RUBY
         TOPOBJECT.class_eval do
           def #{method_name}(locals)
-            Thread.current[:tilt_vars] = [self, locals]
-            class << self
-              this, locals = Thread.current[:tilt_vars]
-              locals = locals
-              this.instance_eval do
-                #{local_code}
+            #{local_code}
       RUBY
       offset += method_source.count("\n")
       method_source << source
-      method_source << "\nend;end;end;end"
-      Object.class_eval(method_source, eval_file, line - offset)
+      method_source << "\nend;end;"
+      (scope_class || Object).class_eval(method_source, eval_file, line - offset)
       unbind_compiled_method(method_name)
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tilt
 version: !ruby/object:Gem::Version
-  version: 2.0.9
+  version: 2.0.10
 platform: ruby
 authors:
 - Ryan Tomayko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-28 00:00:00.000000000 Z
+date: 2019-09-23 00:00:00.000000000 Z
 dependencies: []
 description: Generic interface to multiple Ruby template engines
 email: r@tomayko.com
@@ -17,15 +17,8 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
 - COPYING
-- Gemfile
-- HACKING
-- README.md
-- Rakefile
 - bin/tilt
-- docs/TEMPLATES.md
-- docs/common.css
 - lib/tilt.rb
 - lib/tilt/asciidoc.rb
 - lib/tilt/babel.rb
@@ -65,60 +58,6 @@ files:
 - lib/tilt/typescript.rb
 - lib/tilt/wikicloth.rb
 - lib/tilt/yajl.rb
-- man/index.txt
-- man/tilt.1.ronn
-- test/markaby/locals.mab
-- test/markaby/markaby.mab
-- test/markaby/markaby_other_static.mab
-- test/markaby/render_twice.mab
-- test/markaby/scope.mab
-- test/markaby/yielding.mab
-- test/mytemplate.rb
-- test/test_helper.rb
-- test/tilt_asciidoctor_test.rb
-- test/tilt_babeltemplate.rb
-- test/tilt_blueclothtemplate_test.rb
-- test/tilt_buildertemplate_test.rb
-- test/tilt_cache_test.rb
-- test/tilt_coffeescripttemplate_test.rb
-- test/tilt_commonmarkertemplate_test.rb
-- test/tilt_compilesite_test.rb
-- test/tilt_creoletemplate_test.rb
-- test/tilt_csv_test.rb
-- test/tilt_erbtemplate_test.rb
-- test/tilt_erubistemplate_test.rb
-- test/tilt_erubitemplate_test.rb
-- test/tilt_etannitemplate_test.rb
-- test/tilt_hamltemplate_test.rb
-- test/tilt_kramdown_test.rb
-- test/tilt_lesstemplate_test.less
-- test/tilt_lesstemplate_test.rb
-- test/tilt_liquidtemplate_test.rb
-- test/tilt_livescripttemplate_test.rb
-- test/tilt_mapping_test.rb
-- test/tilt_markaby_test.rb
-- test/tilt_markdown_test.rb
-- test/tilt_marukutemplate_test.rb
-- test/tilt_metadata_test.rb
-- test/tilt_nokogiritemplate_test.rb
-- test/tilt_pandoctemplate_test.rb
-- test/tilt_prawntemplate.prawn
-- test/tilt_prawntemplate_test.rb
-- test/tilt_radiustemplate_test.rb
-- test/tilt_rdiscounttemplate_test.rb
-- test/tilt_rdoctemplate_test.rb
-- test/tilt_redcarpettemplate_test.rb
-- test/tilt_redclothtemplate_test.rb
-- test/tilt_rstpandoctemplate_test.rb
-- test/tilt_sasstemplate_test.rb
-- test/tilt_sigil_test.rb
-- test/tilt_stringtemplate_test.rb
-- test/tilt_template_test.rb
-- test/tilt_test.rb
-- test/tilt_typescript_test.rb
-- test/tilt_wikiclothtemplate_test.rb
-- test/tilt_yajltemplate_test.rb
-- tilt.gemspec
 homepage: http://github.com/rtomayko/tilt/
 licenses:
 - MIT
@@ -149,44 +88,4 @@ rubygems_version: 2.6.11
 signing_key: 
 specification_version: 2
 summary: Generic interface to multiple Ruby template engines
-test_files:
-- test/tilt_asciidoctor_test.rb
-- test/tilt_blueclothtemplate_test.rb
-- test/tilt_buildertemplate_test.rb
-- test/tilt_cache_test.rb
-- test/tilt_coffeescripttemplate_test.rb
-- test/tilt_commonmarkertemplate_test.rb
-- test/tilt_compilesite_test.rb
-- test/tilt_creoletemplate_test.rb
-- test/tilt_csv_test.rb
-- test/tilt_erbtemplate_test.rb
-- test/tilt_erubistemplate_test.rb
-- test/tilt_erubitemplate_test.rb
-- test/tilt_etannitemplate_test.rb
-- test/tilt_hamltemplate_test.rb
-- test/tilt_kramdown_test.rb
-- test/tilt_lesstemplate_test.rb
-- test/tilt_liquidtemplate_test.rb
-- test/tilt_livescripttemplate_test.rb
-- test/tilt_mapping_test.rb
-- test/tilt_markaby_test.rb
-- test/tilt_markdown_test.rb
-- test/tilt_marukutemplate_test.rb
-- test/tilt_metadata_test.rb
-- test/tilt_nokogiritemplate_test.rb
-- test/tilt_pandoctemplate_test.rb
-- test/tilt_prawntemplate_test.rb
-- test/tilt_radiustemplate_test.rb
-- test/tilt_rdiscounttemplate_test.rb
-- test/tilt_rdoctemplate_test.rb
-- test/tilt_redcarpettemplate_test.rb
-- test/tilt_redclothtemplate_test.rb
-- test/tilt_rstpandoctemplate_test.rb
-- test/tilt_sasstemplate_test.rb
-- test/tilt_sigil_test.rb
-- test/tilt_stringtemplate_test.rb
-- test/tilt_template_test.rb
-- test/tilt_test.rb
-- test/tilt_typescript_test.rb
-- test/tilt_wikiclothtemplate_test.rb
-- test/tilt_yajltemplate_test.rb
+test_files: []

data/CHANGELOG.md

@@ -1,132 +0,0 @@
-## master
-
-## 2.0.9 (2018-11-28)
-
-* Use new ERB API in Ruby 2.6 (#329, koic)
-* Support the new sassc gem (#336, jdickey, judofyr)
-
-## 2.0.8 (2017-07-24)
-
-* Register .tsx for TypeScript (#315, backus)
-* Use Haml 5's new API (#312, k0kubun)
-* Use correct parser options for CommonMarker (#320, rewritten)
-* Suppress warnings when no locals are used (#304, amatsuda)
-* Haml: Accept `outvar` (#317, k0kubun)
-
-## 2.0.7 (2017-03-19)
-
-* Do not modify BasicObject during template compilation on ruby 2.0+ (#309, jeremyevans)
-
-## 2.0.6 (2017-01-26)
-
-* Add support for LiveScript (#286, @Announcement Jacob Francis Powers)
-* Add support for Sigil (#302, winebarrel)
-* Add support for Erubi (#308, jeremyevans)
-* Add support for options in Liquid (#298, #299, laCour)
-* Always sort locals by strings (#307, jeremyevans)
-
-* Fix test warnings (#305, amatsuda)
-* Fix indentation (#293, yui-knk)
-* Use SVG badges in README (#294, vasinov)
-* Fix typo and trailing space (#295, #296, karloescota)
-
-## 2.0.5 (2016-06-02)
-
-* Add support for reST using Pandoc (#284, mfenner)
-* Make lazy loading thread-safe; remove warning (judofyr)
-
-## 2.0.4 (2016-05-16)
-
-* Fix regression in BuilderTemplate (#283, judofyr)
-
-## 2.0.3 (2016-05-12)
-
-* Add Pandoc support (#276, jmuheim)
-* Add CommonMark support (#282, raphink)
-* Add TypeScript support (#278, nghitran)
-* Work with frozen string literal (#274, jeremyevans)
-* Add MIME type for Babel (#273, SaitoWu)
-
-## 2.0.2 (2016-01-06)
-
-* Pass options to Redcarpet (#250, hughbien)
-* Haml: Improve error message on frozen self (judofyr)
-* Add basic support for Babel (judofyr)
-* Add support for .litcoffee (#243, judofyr, mr-vinn)
-* Document Tilt::Cache (#266, tommay)
-* Sort local keys for better caching (#257, jeremyevans)
-* Add more CSV options (#256, Juanmcuello)
-* Add Prawn template (kematzy)
-* Improve cache-miss performance in Tilt::Cache (#251, tommay)
-* Add man page (#241, josephholsten)
-* Support YAML/JSON data in bin/tilt (#241, josephholsten)
-
-## 2.0.1 (2014-03-21)
-
-* Fix Tilt::Mapping bug in Ruby 2.1.0 (9589652c569760298f2647f7a0f9ed4f85129f20)
-* Fix `tilt --list` (#223, Achrome)
-* Fix circular require (#221, amarshall)
-
-## 2.0.0 (2013-11-30)
-
-* Support Pathname in Template#new (#219, kabturek)
-* Add Mapping#templates_for (judofyr)
-* Support old-style #register (judofyr)
-* Add Handlebars as external template engine (#204, judofyr, jimothyGator)
-* Add org-ruby as external template engine (#207, judofyr, minad)
-* Documentation typo (#208, elgalu)
-
-## 2.0.0.beta1 (2013-07-16)
-
-* Documentation typo (#202, chip)
-* Use YARD for documentation (#189, judofyr)
-* Add Slim as an external template engine (judofyr)
-* Add Tilt.templates_for (#121, judofyr)
-* Add Tilt.current_template (#151, judofyr)
-* Avoid loading all files in tilt.rb (#160, #187, judofyr)
-* Implement lazily required templates classes (#178, #187, judofyr)
-* Move #allows_script and default_mime_type to metadata (#187, judofyr)
-* Introduce Tilt::Mapping (#187, judofyr)
-* Make template compilation thread-safe (#191, judofyr)
-
-## 1.4.1 (2013-05-08)
-
-* Support Arrays in pre/postambles (#193, jbwiv)
-
-## 1.4.0 (2013-05-01)
-
-* Better encoding support
-
-## 1.3.7 (2013-04-09)
-
-* Erubis: Check for the correct constant (#183, mattwildig)
-* Don't fail when BasicObject is defined in 1.8 (#182, technobrat, judofyr)
-
-## 1.3.6 (2013-03-17)
-
-* Accept Hash that implements #path as options (#180, lawso017)
-* Changed extension for CsvTemplate from '.csv' to '.rcsv' (#177, alexgb)
-
-## 1.3.5 (2013-03-06)
-
-* Fixed extension for PlainTemplate (judofyr)
-* Improved local variables regexp (#174, razorinc)
-* Added CHANGELOG.md
-
-## 1.3.4 (2013-02-28)
-
-* Support RDoc 4.0 (#168, judofyr)
-* Add mention of Org-Mode support (#165, aslakknutsen)
-* Add AsciiDoctorTemplate (#163, #164, aslakknutsen)
-* Add PlainTextTemplate (nathanaeljones)
-* Restrict locals to valid variable names (#158, thinkerbot)
-* ERB: Improve trim mode support (#156, ssimeonov)
-* Add CSVTemplate (#153, alexgb)
-* Remove special case for 1.9.1 (#147, guilleiguaran)
-* Add allows\_script? method to Template (#143, bhollis)
-* Default to using Redcarpet2 (#139, DAddYE)
-* Allow File/Tempfile as filenames (#134, jamesotron)
-* Add EtanniTemplate (#131, manveru)
-* Support RDoc 3.10 (#112, timfel)
-* Always compile templates; remove old source evaluator (rtomayko)
-* Less: Options are now being passed to the parser (#106, cowboyd)

data/Gemfile

@@ -1,70 +0,0 @@
-source 'https://rubygems.org'
-
-gemspec
-
-gem 'rake'
-gem 'minitest', '~> 5.0'
-
-group :development do
-  gem 'yard', '~> 0.9.0'
-  gem 'ronn', '~> 0.7.3'
-end
-
-can_execjs = (RUBY_VERSION >= '1.9.3')
-
-group :primary do
-  gem 'builder'
-  gem 'haml', '>= 4' if RUBY_VERSION >= '2.0.0'
-  gem 'erubis'
-  gem 'markaby'
-
-  if ENV['OLD_SASS']
-    gem 'sass'
-  else
-    gem 'sassc'
-  end
-
-  if can_execjs
-    gem 'less'
-    gem 'coffee-script'
-    gem 'livescript'
-    gem 'babel-transpiler'
-    gem 'typescript-node'
-  end
-end
-
-platform :mri do
-  gem 'duktape', '~> 1.3.0.6' if can_execjs
-end
-
-group :secondary do
-  gem 'creole'
-  gem 'kramdown'
-  gem 'rdoc'
-  gem 'radius'
-  gem 'asciidoctor', '>= 0.1.0'
-  gem 'liquid'
-  gem 'maruku'
-  gem 'pandoc-ruby'
-
-  if RUBY_VERSION > '1.9.3'
-    gem 'prawn', '>= 2.0.0'
-    gem 'pdf-reader', '~> 1.3.3'
-  end
-
-  gem 'nokogiri' if RUBY_VERSION > '1.9.2'
-
-  platform :ruby do
-    gem 'wikicloth'
-    gem 'yajl-ruby'
-    gem 'redcarpet' if RUBY_VERSION > '1.8.7'
-    gem 'rdiscount', '>= 2.1.6' if RUBY_VERSION != '1.9.2'
-    gem 'RedCloth'
-    gem 'commonmarker' if RUBY_VERSION > '1.9.3'
-  end
-
-  platform :mri do
-    gem 'bluecloth'
-  end
-end
-

data/HACKING

@@ -1,16 +0,0 @@
-Clone:
-
-    git clone git://github.com/rtomayko/tilt.git
-    cd tilt
-
-Install needed packages under ./vendor and run tests (requires bundler):
-
-    rake
-
-Run tests under your current gem environment. Do not install anything:
-
-    rake test
-
-Only install needed packages under ./vendor:
-
-    rake setup

data/README.md

@@ -1,233 +0,0 @@
-Tilt [![Build Status](https://secure.travis-ci.org/rtomayko/tilt.svg)](http://travis-ci.org/rtomayko/tilt) [![Inline docs](http://inch-ci.org/github/rtomayko/tilt.svg)](http://inch-ci.org/github/rtomayko/tilt) [![Security](https://hakiri.io/github/rtomayko/tilt/master.svg)](https://hakiri.io/github/rtomayko/tilt/master)
-====
-
-**NOTE** The following file documents the current release of Tilt (2.0). See
-https://github.com/rtomayko/tilt/tree/tilt-1 for documentation for Tilt 1.4.
-
-Tilt is a thin interface over a bunch of different Ruby template engines in
-an attempt to make their usage as generic as possible. This is useful for web
-frameworks, static site generators, and other systems that support multiple
-template engines but don't want to code for each of them individually.
-
-The following features are supported for all template engines (assuming the
-feature is relevant to the engine):
-
- * Custom template evaluation scopes / bindings
- * Ability to pass locals to template evaluation
- * Support for passing a block to template evaluation for "yield"
- * Backtraces with correct filenames and line numbers
- * Template file caching and reloading
- * Fast, method-based template source compilation
-
-The primary goal is to get all of the things listed above right for all
-template engines included in the distribution.
-
-Support for these template engines is included with the package:
-
-| Engine                  | File Extensions        | Required Libraries                         | Maintainer  |
-| ----------------------- | ---------------------- | ------------------------------------------ | ----------- |
-| Asciidoctor             | .ad, .adoc, .asciidoc  | asciidoctor (>= 0.1.0)                     | Community   |
-| ERB                     | .erb, .rhtml           | none (included ruby stdlib)                | Tilt team   |
-| InterpolatedString      | .str                   | none (included ruby core)                  | Tilt team   |
-| Erubi                   | .erb, .rhtml, .erubi   | erubi                                      | Community   |
-| Erubis                  | .erb, .rhtml, .erubis  | erubis                                     | Tilt team   |
-| Haml                    | .haml                  | haml                                       | Tilt team   |
-| Sass                    | .sass                  | haml (< 3.1) or sass (>= 3.1)              | Tilt team   |
-| Scss                    | .scss                  | haml (< 3.1) or sass (>= 3.1)              | Tilt team   |
-| Less CSS                | .less                  | less                                       | Tilt team   |
-| Builder                 | .builder               | builder                                    | Tilt team   |
-| Liquid                  | .liquid                | liquid                                     | Community   |
-| RDiscount               | .markdown, .mkd, .md   | rdiscount                                  | Community   |
-| Redcarpet               | .markdown, .mkd, .md   | redcarpet                                  | Community   |
-| BlueCloth               | .markdown, .mkd, .md   | bluecloth                                  | Community   |
-| Kramdown                | .markdown, .mkd, .md   | kramdown                                   | Community   |
-| Pandoc                  | .markdown, .mkd, .md   | pandoc                                     | Community   |
-| reStructuredText        | .rst                   | pandoc                                     | Community   |
-| Maruku                  | .markdown, .mkd, .md   | maruku                                     | Community   |
-| CommonMarker            | .markdown, .mkd, .md   | commonmarker                               | Community   |
-| RedCloth                | .textile               | redcloth                                   | Community   |
-| RDoc                    | .rdoc                  | rdoc                                       | Tilt team   |
-| Radius                  | .radius                | radius                                     | Community   |
-| Markaby                 | .mab                   | markaby                                    | Tilt team   |
-| Nokogiri                | .nokogiri              | nokogiri                                   | Community   |
-| CoffeeScript            | .coffee                | coffee-script (+ javascript)               | Tilt team   |
-| CoffeeScript (literate) | .litcoffee             | coffee-script (>= 1.5.0) (+ javascript)    | Tilt team   |
-| LiveScript              | .ls                    | livescript (+ javascript)                  | Tilt team   |
-| TypeScript              | .ts                    | typescript (+ javascript)                  | Tilt team   |
-| Creole (Wiki markup)    | .wiki, .creole         | creole                                     | Community   |
-| WikiCloth (Wiki markup) | .wiki, .mediawiki, .mw | wikicloth                                  | Community   |
-| Yajl                    | .yajl                  | yajl-ruby                                  | Community   |
-| CSV                     | .rcsv                  | none (Ruby >= 1.9), fastercsv (Ruby < 1.9) | Tilt team   |
-| Prawn                   | .prawn                 | prawn (>= 2.0.0)                           | Community   |
-| Babel                   | .es6, .babel, .jsx     | babel-transpiler                           | Tilt team   |
-| Opal                    | .rb                    | opal                                       | Community   |
-| Sigil                   | .sigil                 | sigil                                      | Community   |
-
-Every supported template engine has a *maintainer*. Note that this is the
-maintainer of the Tilt integration, not the maintainer of the template engine
-itself. The maintainer is responsible for providing an adequate integration and
-keeping backwards compatibility across Tilt version. Some integrations are
-maintained by the *community*, which is handled in the following way:
-
-- The Tilt team will liberally accept pull requests against the template
-  integration. It's up to the community as a whole to make sure the integration
-  stays consistent and backwards compatible over time.
-- Test failures in community-maintained integrations will not be prioritized by
-  the Tilt team and a new version of Tilt might be released even though these
-  tests are failing.
-- Anyone can become a maintainer for a template engine integration they care
-  about. Just open an issue and we'll figure it out.
-
-These template engines ship with their own Tilt integration:
-
-| Engine                | File Extensions  | Required Libraries  |
-| -------------------   | ---------------- | ------------------- |
-| Slim                  | .slim            | slim (>= 0.7)       |
-| Embedded JavaScript   |                  | sprockets           |
-| Embedded CoffeeScript |                  | sprockets           |
-| JST                   |                  | sprockets           |
-| Org-mode              | .org             | org-ruby (>= 0.6.2) |
-| Handlebars            | .hbs, handlebars | tilt-handlebars     |
-| Jbuilder              | .jbuilder        | tilt-jbuilder       |
-
-See [TEMPLATES.md][t] for detailed information on template engine
-options and supported features.
-
-[t]: http://github.com/rtomayko/tilt/blob/master/docs/TEMPLATES.md
-   "Tilt Template Engine Documentation"
-
-Basic Usage
------------
-
-Instant gratification:
-
-    require 'erb'
-    require 'tilt'
-    template = Tilt.new('templates/foo.erb')
-    => #<Tilt::ERBTemplate @file="templates/foo.erb" ...>
-    output = template.render
-    => "Hello world!"
-
-It's recommended that calling programs explicitly require template engine
-libraries (like 'erb' above) at load time. Tilt attempts to lazy require the
-template engine library the first time a template is created but this is
-prone to error in threaded environments.
-
-The {Tilt} module contains generic implementation classes for all supported
-template engines. Each template class adheres to the same interface for
-creation and rendering. In the instant gratification example, we let Tilt
-determine the template implementation class based on the filename, but
-{Tilt::Template} implementations can also be used directly:
-
-    require 'tilt/haml'
-    template = Tilt::HamlTemplate.new('templates/foo.haml')
-    output = template.render
-
-The `render` method takes an optional evaluation scope and locals hash
-arguments. Here, the template is evaluated within the context of the
-`Person` object with locals `x` and `y`:
-
-    require 'tilt/erb'
-    template = Tilt::ERBTemplate.new('templates/foo.erb')
-    joe = Person.find('joe')
-    output = template.render(joe, :x => 35, :y => 42)
-
-If no scope is provided, the template is evaluated within the context of an
-object created with `Object.new`.
-
-A single `Template` instance's `render` method may be called multiple times
-with different scope and locals arguments. Continuing the previous example,
-we render the same compiled template but this time in jane's scope:
-
-    jane = Person.find('jane')
-    output = template.render(jane, :x => 22, :y => nil)
-
-Blocks can be passed to `render` for templates that support running
-arbitrary ruby code (usually with some form of `yield`). For instance,
-assuming the following in `foo.erb`:
-
-    Hey <%= yield %>!
-
-The block passed to `render` is called on `yield`:
-
-    template = Tilt::ERBTemplate.new('foo.erb')
-    template.render { 'Joe' }
-    # => "Hey Joe!"
-
-Template Mappings
------------------
-
-The {Tilt::Mapping} class includes methods for associating template
-implementation classes with filename patterns and for locating/instantiating
-template classes based on those associations.
-
-The {Tilt} module has a global instance of `Mapping` that is populated with the
-table of template engines above.
-
-The {Tilt.register} method associates a filename pattern with a specific
-template implementation. To use ERB for files ending in a `.bar` extension:
-
-     >> Tilt.register Tilt::ERBTemplate, 'bar'
-     >> Tilt.new('views/foo.bar')
-     => #<Tilt::ERBTemplate @file="views/foo.bar" ...>
-
-Retrieving the template class for a file or file extension:
-
-     >> Tilt['foo.bar']
-     => Tilt::ERBTemplate
-     >> Tilt['haml']
-     => Tilt::HamlTemplate
-
-Retrieving a list of template classes for a file:
-
-    >> Tilt.templates_for('foo.bar')
-    => [Tilt::ERBTemplate]
-    >> Tilt.templates_for('foo.haml.bar')
-    => [Tilt::ERBTemplate, Tilt::HamlTemplate]
-
-The template class is determined by searching for a series of decreasingly
-specific name patterns. When creating a new template with
-`Tilt.new('views/foo.html.erb')`, we check for the following template
-mappings:
-
-  1. `views/foo.html.erb`
-  2. `foo.html.erb`
-  3. `html.erb`
-  4. `erb`
-
-Encodings
----------
-
-Tilt needs to know the encoding of the template in order to work properly:
-
-Tilt will use `Encoding.default_external` as the encoding when reading external
-files. If you're mostly working with one encoding (e.g. UTF-8) we *highly*
-recommend setting this option. When providing a custom reader block (`Tilt.new
-{ custom_string }`) you'll have ensure the string is properly encoded yourself.
-
-Most of the template engines in Tilt also allows you to override the encoding
-using the `:default_encoding`-option:
-
-```ruby
-tmpl = Tilt.new('hello.erb', :default_encoding => 'Big5')
-```
-
-Ultimately it's up to the template engine how to handle the encoding: It might
-respect `:default_encoding`, it might always assume it's UTF-8 (like
-CoffeeScript), or it can do its own encoding detection.
-
-Template Compilation
---------------------
-
-Tilt compiles generated Ruby source code produced by template engines and reuses
-it on subsequent template invocations. Benchmarks show this yields a 5x-10x
-performance increase over evaluating the Ruby source on each invocation.
-
-Template compilation is currently supported for these template engines:
-StringTemplate, ERB, Erubis, Haml, Nokogiri, Builder and Yajl.
-
-LICENSE
--------
-
-Tilt is Copyright (c) 2010 [Ryan Tomayko](http://tomayko.com/about) and
-distributed under the MIT license. See the `COPYING` file for more info.