Class: ERB::Compiler
- Inherits:
-
Object
- Object
- ERB::Compiler
- Defined in:
- lib/erb.rb
Overview
ERB::Compiler
Compiles ERB templates into Ruby code; the compiled code produces the template result when evaluated. ERB::Compiler provides hooks to define how generated output is handled.
Internally ERB does something like this to generate the code returned by ERB#src:
compiler = ERB::Compiler.new('<>')
compiler.pre_cmd = ["_erbout=''"]
compiler.put_cmd = "_erbout.concat"
compiler.insert_cmd = "_erbout.concat"
compiler.post_cmd = ["_erbout"]
code, enc = compiler.compile("Got <%= obj %>!\n")
puts code
Generates:
#coding:UTF-8
_erbout=''; _erbout.concat "Got "; _erbout.concat(( obj ).to_s); _erbout.concat "!\n"; _erbout
By default the output is sent to the print method. For example:
compiler = ERB::Compiler.new('<>')
code, enc = compiler.compile("Got <%= obj %>!\n")
puts code
Generates:
#coding:UTF-8
print "Got "; print(( obj ).to_s); print "!\n"
Evaluation
The compiled code can be used in any context where the names in the code correctly resolve. Using the last example, each of these print 'Got It!'
Evaluate using a variable:
obj = 'It'
eval code
Evaluate using an input:
mod = Module.new
mod.module_eval %{
def get(obj)
#{code}
end
}
extend mod
get('It')
Evaluate using an accessor:
klass = Class.new Object
klass.class_eval %{
attr_accessor :obj
def initialize(obj)
@obj = obj
end
def get_it
#{code}
end
}
klass.new('It').get_it
Good! See also ERB#def_method, ERB#def_module, and ERB#def_class.
Defined Under Namespace
Classes: Buffer, PercentLine, Scanner, SimpleScanner, TrimScanner
Instance Attribute Summary collapse
-
#insert_cmd ⇒ Object
The command to handle text that is inserted prior to a newline.
-
#percent ⇒ Object
readonly
Returns the value of attribute percent.
-
#post_cmd ⇒ Object
An array of commands appended to compiled code.
-
#pre_cmd ⇒ Object
An array of commands prepended to compiled code.
-
#put_cmd ⇒ Object
The command to handle text that ends with a newline.
-
#trim_mode ⇒ Object
readonly
Returns the value of attribute trim_mode.
Instance Method Summary collapse
-
#compile(s) ⇒ Object
Compiles an ERB template into Ruby code.
-
#content_dump(s) ⇒ Object
:nodoc:.
-
#initialize(trim_mode) ⇒ Compiler
constructor
Construct a new compiler using the trim_mode.
-
#make_scanner(src) ⇒ Object
:nodoc:.
-
#prepare_trim_mode(mode) ⇒ Object
:nodoc:.
Constructor Details
#initialize(trim_mode) ⇒ Compiler
Construct a new compiler using the trim_mode. See ERB#new for available trim modes.
680 681 682 683 684 685 686 |
# File 'lib/erb.rb', line 680 def initialize(trim_mode) @percent, @trim_mode = prepare_trim_mode(trim_mode) @put_cmd = 'print' @insert_cmd = @put_cmd @pre_cmd = [] @post_cmd = [] end |
Instance Attribute Details
#insert_cmd ⇒ Object
The command to handle text that is inserted prior to a newline
693 694 695 |
# File 'lib/erb.rb', line 693 def insert_cmd @insert_cmd end |
#percent ⇒ Object (readonly)
Returns the value of attribute percent
687 688 689 |
# File 'lib/erb.rb', line 687 def percent @percent end |
#post_cmd ⇒ Object
An array of commands appended to compiled code
699 700 701 |
# File 'lib/erb.rb', line 699 def post_cmd @post_cmd end |
#pre_cmd ⇒ Object
An array of commands prepended to compiled code
696 697 698 |
# File 'lib/erb.rb', line 696 def pre_cmd @pre_cmd end |
#put_cmd ⇒ Object
The command to handle text that ends with a newline
690 691 692 |
# File 'lib/erb.rb', line 690 def put_cmd @put_cmd end |
#trim_mode ⇒ Object (readonly)
Returns the value of attribute trim_mode
687 688 689 |
# File 'lib/erb.rb', line 687 def trim_mode @trim_mode end |
Instance Method Details
#compile(s) ⇒ Object
Compiles an ERB template into Ruby code. Returns an array of the code and encoding like ["code", Encoding].
585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 |
# File 'lib/erb.rb', line 585 def compile(s) enc = s.encoding raise ArgumentError, "#{enc} is not ASCII compatible" if enc.dummy? s = s.dup.force_encoding("ASCII-8BIT") # don't use constant Enoding::ASCII_8BIT for miniruby enc = detect_magic_comment(s) || enc out = Buffer.new(self, enc) content = '' scanner = make_scanner(s) scanner.scan do |token| next if token.nil? next if token == '' if scanner.stag.nil? case token when PercentLine out.push("#{@put_cmd} #{content_dump(content)}") if content.size > 0 content = '' out.push(token.to_s) out.cr when :cr out.cr when '<%', '<%=', '<%#' scanner.stag = token out.push("#{@put_cmd} #{content_dump(content)}") if content.size > 0 content = '' when "\n" content << "\n" out.push("#{@put_cmd} #{content_dump(content)}") content = '' when '<%%' content << '<%' else content << token end else case token when '%>' case scanner.stag when '<%' if content[-1] == ?\n content.chop! out.push(content) out.cr else out.push(content) end when '<%=' out.push("#{@insert_cmd}((#{content}).to_s)") when '<%#' # out.push("# #{content_dump(content)}") end scanner.stag = nil content = '' when '%%>' content << '%>' else content << token end end end out.push("#{@put_cmd} #{content_dump(content)}") if content.size > 0 out.close return out.script, enc end |
#content_dump(s) ⇒ Object
:nodoc:
574 575 576 577 578 579 580 581 |
# File 'lib/erb.rb', line 574 def content_dump(s) # :nodoc: n = s.count("\n") if n > 0 s.dump + "\n" * n else s.dump end end |
#make_scanner(src) ⇒ Object
:nodoc:
674 675 676 |
# File 'lib/erb.rb', line 674 def make_scanner(src) # :nodoc: Scanner.make_scanner(src, @trim_mode, @percent) end |
#prepare_trim_mode(mode) ⇒ Object
:nodoc:
650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 |
# File 'lib/erb.rb', line 650 def prepare_trim_mode(mode) # :nodoc: case mode when 1 return [false, '>'] when 2 return [false, '<>'] when 0 return [false, nil] when String perc = mode.include?('%') if mode.include?('-') return [perc, '-'] elsif mode.include?('<>') return [perc, '<>'] elsif mode.include?('>') return [perc, '>'] else [perc, nil] end else return [false, nil] end end |