Exception: ActionView::Template::Error

Inherits:
ActionViewError show all
Defined in:
actionpack/lib/action_view/template/error.rb

Overview

The Template::Error exception is raised when the compilation or rendering of the template fails. This exception then gathers a bunch of intimate details and uses it to report a precise exception message.

Constant Summary

SOURCE_CODE_RADIUS =

:nodoc:

3

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (Error) initialize(template, assigns, original_exception)

A new instance of Error



60
61
62
63
64
 
# File 'actionpack/lib/action_view/template/error.rb', line 60

def initialize(template, assigns, original_exception)
  @template, @assigns, @original_exception = template, assigns.dup, original_exception
  @sub_templates = nil
  @backtrace = original_exception.backtrace
end

Instance Attribute Details

- (Object) backtrace (readonly)

Returns the value of attribute backtrace



58
59
60
 
# File 'actionpack/lib/action_view/template/error.rb', line 58

def backtrace
  @backtrace
end

- (Object) original_exception (readonly)

Returns the value of attribute original_exception



58
59
60
 
# File 'actionpack/lib/action_view/template/error.rb', line 58

def original_exception
  @original_exception
end

Instance Method Details

- (Object) annoted_source_code 



115
116
117
 
# File 'actionpack/lib/action_view/template/error.rb', line 115

def annoted_source_code
  source_extract(4)
end

- (Object) file_name 



66
67
68
 
# File 'actionpack/lib/action_view/template/error.rb', line 66

def file_name
  @template.identifier
end

- (Object) line_number 



107
108
109
110
111
112
113
 
# File 'actionpack/lib/action_view/template/error.rb', line 107

def line_number
  @line_number ||=
    if file_name
      regexp = /#{Regexp.escape File.basename(file_name)}:(\d+)/
      $1 if message =~ regexp || backtrace.find { |line| line =~ regexp }
    end
end

- (Object) message 



70
71
72
 
# File 'actionpack/lib/action_view/template/error.rb', line 70

def message
  original_exception.message
end

- (Object) source_extract(indentation = 0) 



83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'actionpack/lib/action_view/template/error.rb', line 83

def source_extract(indentation = 0)
  return unless num = line_number
  num = num.to_i

  source_code = @template.source.split("\n")

  start_on_line = [ num - SOURCE_CODE_RADIUS - 1, 0 ].max
  end_on_line   = [ num + SOURCE_CODE_RADIUS - 1, source_code.length].min

  indent = ' ' * indentation
  line_counter = start_on_line
  return unless source_code = source_code[start_on_line..end_on_line]

  source_code.sum do |line|
    line_counter += 1
    "#{indent}#{line_counter}: #{line}\n"
  end
end

- (Object) sub_template_message 



74
75
76
77
78
79
80
81
 
# File 'actionpack/lib/action_view/template/error.rb', line 74

def sub_template_message
  if @sub_templates
    "Trace of template inclusion: " +
    @sub_templates.collect { |template| template.inspect }.join(", ")
  else
    ""
  end
end

- (Object) sub_template_of(template_path) 



102
103
104
105
 
# File 'actionpack/lib/action_view/template/error.rb', line 102

def sub_template_of(template_path)
  @sub_templates ||= []
  @sub_templates << template_path
end