Erubis徹底解説

RubyKaigi2009

Erubis

makoto kuwata <kwa@kuwata-lab.com>
http://www.kuwata-lab.com/

copyright(c) 2009 kuwata-lab.com all rights reserved.
1

‣

‣

2

Agenda

‣ Part 1. Erubis
‣ Part 2. eRuby
‣ Part 3.

3

Part 1. Erubis

4

Erubis

‣ pure Ruby eRuby
‣
• http://jp.rubyist.net/magazine/?0022-FasterThanC
‣
• HTML
•
• PHP, Java, JS, C, Perl, Scheme
• ...
5

Ruby program:
require 'rubygems' #
require 'erubis'
str = File.read('template.eruby')
eruby = Erubis::Eruby.new(str)
print eruby.result(binding())
command-line:
$ erubis template.eruby #
$ erubis -x template.eruby # Ruby
$ erubis -z template.eruby #

6

HTML
str =<<END <%= %>
<%= var %> <%== %>
<%== var %>
END
eruby = Erubis::Eruby.new(str, :escape=>true)
puts eruby.result(:var=>"<B&B>")

output:
<B&am;>
<B&B>
(choosability)

7

‣ <% %> [% %]
[% for x in @list %]
<li>[%= x %]</li>
[% end %] !
## Ruby
Erubis::Eruby.new(str, :pattern=>'[% %]')
## command-line
$ erubis -p '[% %]' ﬁle.eruby

8

Binding Hash Object
Hash Object
hash = { @title = "Example"
:title => "Example", @items = [1, 2, 3]
:items => [1, 2, 3], } erubis =
erubis = Erubis::Eruby.new(str)
Erubis::Eruby.new(str) puts erubis.evaluate(self)
puts erubis.result(hash)

<h1><%= title%></h1> <h1><%= @title%></h1>
<% for x in items %> <% for x in @items %>
<% end %> <% end %>
9

Enhancer
‣ Erubis module
## <%= %> HTML
module EscapeEnhancer
def add_expr(src, code, indicator)
if indicator == '='
src << " _buf<<escapeXml(#{code})"
elsif indicator == '=='
src << " _buf<<(#{code}).to_s;"
end
end Erubis
end

10

Enhancer (cont')

### Enhancer
### ( : print() )
module StdoutEnhancer _buf=""
def add_preamble(src) _buf=$stdout
src << "_buf = $stdout;"
end
def add_postamble(src)
src << "n""n"
end _buf.to_s
end "" ( )

11

Enhancer

include/extend
### Ruby
class MyEruby < Erubis::Eruby
include Erubis::EscapeEnhancer
include Erubis::PercentLineEnhancer
end
puts MyEruby.new(str).result(:items=>[1,2,3])

,
### command-line
$ erubis -E Escape,Percent ﬁle.eruby

12

Enhancer

‣ EscapeEnhancer : HTML

‣ PercentLineEnhancer : '%'

‣ InterporationEnhancer : _buf<<"#{ }"
‣ DeleteIndentEnhancer : HTML
‣ StdoutEnhancer : _buf="" _buf=$stdout

‣ ... (erubis -h )

13

‣ (
)

### command-line
$ erubis -c '{arr: [A, B, C]}' template.eruby # YAML
$ erubis -c '@arr=%w[A B C]' template.eruby # Ruby

<% for x in @arr %> <li>A</li>
<li><%= x %></li> <li>B</li>
<% end %> <li>C</li>

14

‣ *.yaml *.rb

$ erubis -f data.yaml template.eruby # YAML
$ erubis -f data.rb template.eruby # Ruby
data.yaml data.rb
title: Example @title = "Example"
items: @items =
- name: Foo [ {"name"=>"Foo"},
- name: Bar {"name"=>"Bar"}, ]

15

‣ <%=== %>

<%=== @var %> 2

### Ruby
$stderr.puts("*** debug: @var=#{@var.inspect}")

###
*** debug: @var=["A", "B", "C"]

16

‣ PHP, Java, JS, C, Perl,Scheme ( )

<% for (i=0; i<n; i++) { %> (C )
<li><%= "%d", i %> printf()
<% } %>

#line 1 "ﬁle.ec" (erubis -xl c ﬁle.ec )
for (i=0; i<n; i++) {
fputs("<li>", stdout); fprintf(stdout, "%d", i);
fputs("n", stdout); }

17

‣ Erubis
• HTML
•
• Enhancer
• /
•
• PHP, Java, JS, C, Perl, Scheme
18

Part 2. eRuby

19

‣ binding()

•
i=0 ### ﬁle.erb
str = File.read('ﬁle.erb') <% for i in 1..3 %>
ERB.new(str).result(binding) <li><%= i %></li>
p i #=> 3 <% end %>
!

20

‣ binding()

•
•

b = Bingind.new
b[:title] = "Example" …
b[:items] = [1, 2, 3]

21

ERB

‣( )
‣ Struct
• http://d.hatena.ne.jp/m_seki/20080528/1211909590

Foo = Struct.new(:title, :items)
class Foo
def env; binding(); end
end
ctx = Foo.new("Example", [1,2,3])
ERB.new(str).result(ctx.env)
22

Erubis

‣ Binding Hash

erubis.result(:items=>[1, 2, 3])

def result(b=TOPLEVEL_BINDING)
if b.is_a?(Hash)
s = b.collect{|k,v| "#{k}=b[#{k.inspect}];"}.join
b = binding()
eval s, b Binding
end
return eval(@src, b)
end
23

Erubis

‣ Binding Object
@items = [1, 2, 3]; <% for x in @items %>
erubis.evaluate(self) <% end %>

def evaluate(ctx) Hash
if ctx.is_a?(Hash)
hash = ctx; ctx = Object.new
hash.each {|k,v|
ctx.instance_variable_set("@#{k}", v) }
end
return ctx.instance_eval(@src)
end copyright(c) 2009 kuwata-lab.com all rights reserved.
24

ERB
1. 8.6 Erubis::Eruby

ERB
1. 8.7 Erubis::Eruby

ERB
1.9.1 Erubis::Eruby
0 10 20 30
(sec)

(by eval)
(eRuby→Ruby)
25

ERB

‣
‣
•
class Foo
extend ERB::DefMethod
def_erb_method('render', 'template.erb')
end
print Foo.new.render

26

Erubis

‣
• Ruby *.cache
•2 *.cache

eruby = Erubis::Eruby.load_ﬁle("ﬁle.eruby")
print eruby.result()
CGI

27

Erubis

‣ Proc
•
•

instance_eval
def evaluate(ctx) Proc
@proc ||= eval(@src)
ctx.instance_eval(@proc)
end

28

‣
• HTML

<ul>
<ul>
<% for x in @list %> <li>AAA</li>
<li><%= x %></li>
<% end %> <li>BBB</li>
</ul>
</ul>
29

ERB

‣ trim mode
• ">" : "%>"
• "<>" : "<%" "%>"
• "-" : "<%-" "-%>"
• "%" : "%"
• "%>", "%<>", "-" : "%" ">"/"<>"/"-"

ERB.new(str, nil, "%<>")

30

Erubis

‣
• <% %>
• <%= %>

<ul> <ul>
<% for x in @list %> AAA
<%= x %> BBB
<% end %> CCC
</ul> </ul>

31

ERB Erubis
eRuby
× ( )
( )

×
( ) ( )

× ( )
( )

32

‣

• [ruby-list:18894] eRuby (?)

‣

• <% %> <%= %>
•

33

‣ <%= %> HTML
!
• eRuby HTML

•
‣ ?

34

ERB

‣( )
‣
•
String
• http://www2a.biglobe.ne.jp/~seki/ruby/erbquote.html

35

Erubis

‣ Erubis
•
eruby = Erubis::Eruby.new(str, :escape=>true)
# or eruby = Erubis::EscapedEruby.new(str)
puts eruby.evaluate(ctx)

Hi <%= @name %>! #
Hi <%== @name %>! #

36

<% unless @items.blank? %>
<table>
<tbody>
<% @items.each do |item| %>
<tr class="item" id="item-<%=item.id%>">
<td class="item-id"><%= item.id %></td>
<td class="item-name">
<% if item.url && !item.url.empty? %>
<a href="<%= item.url %>"><%=item.name%></a>
<% else %>
<span><%=item.name%></span>
<% end %>
</td>
</tr> HTML Ruby
<% end %>
</tbody> end
</table> (do end 100 )
<% end %>

37

ERB

‣ ( erb -x )

$ erb -x foo.eruby
_erbout = ''; unless @items.blank? ;
_erbout.concat "n"
_erbout.concat "<table>n"
_erbout.concat " <tr class="record">n"

$ erb -x foo.eruby | ruby -wc
Syntax OK
38

Erubis

‣
• -x : Ruby
• -X : HTML
• -N : (number)
• -U : 1 (unique)
• -C : (compact)
• -z :
39

$ cat foo.eruby
<% unless @items.blank? %>
<table>
<% @items.each_with_index do|x, i| %>
<tr class="record">
<td><%= i +1 %></td>
<td><%=h x %></td>
</tr>
<% end %>
</table>
<% end %>

40

-x Ruby
$ erubis -x foo.eruby
_buf = ''; unless @items.blank?
_buf << '<table>
'; @items.each_with_index do|x, i|
_buf << ' <tr class="record">
<td>'; _buf << ( i +1 ).to_s; _buf << '</td>
<td>'; _buf << (h x ).to_s; _buf << '</td>
</tr>
'; end
_buf << '</table>
'; end
_buf.to_s

41

-X
$ erubis -X foo.eruby
_buf = ''; unless @items.blank?

@items.each_with_index do|x, i|

_buf << ( i +1 ).to_s;
_buf << (h x ).to_s;

end

end
_buf.to_s

42

-N (number)
$ erubis -XN foo.eruby
1: _buf = ''; unless @items.blank?
2:
3: @items.each_with_index do|x, i|
4:
5: _buf << ( i +1 ).to_s;
6: _buf << (h x ).to_s;
7:
8: end
9:
10: end
11: _buf.to_s

43

-U (uniq)
$ erubis -XNU foo.eruby


5: _buf << ( i +1 ).to_s;
6: _buf << (h x ).to_s;

8: end

10: end
11: _buf.to_s

44

-C (compact)
$ erubis -XNC foo.eruby
5: _buf << ( i +1 ).to_s;
6: _buf << (h x ).to_s;
8: end
10: end
11: _buf.to_s

45

<%= %>

<%= form_for :user do %>
<div>
<%= text_ﬁeld :name %>
</div>
<% end %> eRuby

46

<%= %>

<%= 10.times do %>
Hello
<% end %>

!
_buf = "";
_buf << ( 10.times do ).to_s;
_buf << " Hellon";
end
47

ERB+Rails

‣ (_erbout)
!

form_for()
… _erbout

<% form_for do %> _erbout = ""
Hello form_for do
<% end %> _erbout.concat("Hello")
end

48

Erubis+Merb

‣ Erubis

<%= form_for do %> @_buf << (form_for do;
Hello @_buf << "Hellon"
<% end =%> end);

49

‣ eRuby
‣ (kool!)
‣
• @_buf

‣

50

‣ eRuby
eRuby
•
•
•
•
• HTML
•
•

51

Part 3.

52

‣
<ul> print "<ul>n"
<% for x in @a %> for x in @a
<li><%=x%></li> print "<li>#{x}</li>n"
<% end %> end
</ul> print "</u>n"

53

<ul> s = File.read('foo.eruby')
<li><%=x%></li> e = Erubis::Eruby.new(s)
</ul> puts e.evaluate(:x=>1)

54

‣ ?

<%#ARGS: items, name='guest' %>
Hello <%= name %>!
<% for x in items %>
<li><%=x%></li>
<% end %>

55

‣ HTML
•
<html> <html>
<body>
<body> !( )
</body>
<h1><%=@title%></h1> </html>
<ul id="menulist">
<% for x in @items %> <h1><%=@title%></h1>
<li><%=x%></li> <ul id="menulist">
</ul>
<% end %>
</ul> <% for x in @items %>
</body> <li><%= x %></li>
</html> <% end %>
56

‣ Django

....
{% block pagetitle %}
<h1>{{title}}</h1>
{% endblock %}
.... (method override)

57

AOP

‣ AOP : Aspect Oriented Programming
• /

<table>
"for x in @a" •HTML
<tr>
<td> "print x"
</tr> •
"end"
</table>
( )

58

‣ HTML View
• …

‣ HTML String
(http://www.oiwa.jp/~yutaka/tdiary/20051229.html)
• /
• Python str unicode
• HTML+String
• HTML (SQL )

59

‣
‣

• AOP …

‣

60

‣
• http://jp.rubyist.net/magazine/?0024-TemplateSystem
‣
• http://jp.rubyist.net/magazine/?0024-TemplateSystem2
‣ Erubis
• http://www.kuwata-lab.com/erubis/
‣
• http://www.kuwata-lab.com/tenjin/

61

one more thing

62

Tenjin - template engine replacing eRuby

‣ ERB Erubis
• eRuby
•
‣ Tenjin :
• /
•
- ...
• http://www.kuwata-lab.com/tenjin/
63

thank you

64

Erubis徹底解説

More Related Content

Erubis徹底解説