Erubi

Erubi is a ERB template engine for ruby. It is a simplified fork of Erubis, using the same basic algorithm, with the following differences:

It is not designed with Erubis API compatibility in mind, though most Erubis ERB syntax works, with the following exceptions:

Installation

gem install erubi

Source Code

Source code is available on GitHub at github.com/jeremyevans/erubi

Usage

Erubi only has built in support for retrieving the generated source for a file:

require 'erubi'
eval(Erubi::Engine.new(File.read('filename.erb')).src)

Most users are will probably use Erubi via Rails or Tilt. Erubi is the default erb template handler in Tilt 2.0.6+ and will be the default template handler in Rails 5.1+.

Capturing

Erubi does not support capturing block output into the template by default. However, it comes with an erubi/capture_end file that supports capturing via <%|=, <%|==, <%| tags:

<%|= form do %>
  <input>
<%| end %>

This offers similar functionality to that offered by Rails' <%= tags, but without the corner cases with that approach (which are due to attempting to parse ruby code via a regexp). Similar to the <%= and <%== tags, <%|= captures by default and <%|== captures and escapes by default, but this can be reversed via the :escape_capture or :escape options.

To use the capture_end support with tilt:

require 'tilt'
require 'erubi/capture_end'
Tilt.new("filename.erb", :engine_class=>Erubi::CaptureEndEngine).render

Reporting Bugs

The bug tracker is located at github.com/jeremyevans/erubi/issues

License

MIT

Authors

Jeremy Evans <code@jeremyevans.net> kuwata-lab.com