Module: Roda::RodaPlugins::ErrorEmail
- Defined in:
- lib/roda/plugins/error_email.rb
Overview
The error_email plugin adds an error_email
instance method that send an email related to the exception. This is most useful if you are also using the error_handler plugin:
plugin :error_email, to: '[email protected]', from: '[email protected]'
plugin :error_handler do |e|
error_email(e)
'Internal Server Error'
end
It is similar to the error_mail plugin, except that it uses net/smtp directly instead of using the mail library. If you are not already using the mail library in your application, it makes sense to use error_email instead of error_mail.
Options:
- :from
-
The From address to use in the email (required)
- :headers
-
A hash of additional headers to use in the email (default: empty hash)
- :host
-
The SMTP server to use to send the email (default: localhost)
- :prefix
-
A prefix to use in the email’s subject line (default: no prefix)
- :to
-
The To address to use in the email (required)
The subject of the error email shows the exception class and message. The body of the error email shows the backtrace of the error and the request environment, as well the request params and session variables (if any). You can also call error_email with a plain string instead of an exception, in which case the string is used as the subject, and no backtrace is included.
Note that emailing on every error as shown above is only appropriate for low traffic web applications. For high traffic web applications, use an error reporting service instead of this plugin.
Defined Under Namespace
Modules: InstanceMethods
Constant Summary collapse
- DEFAULTS =
{ :headers=>OPTS, :host=>'localhost', # :nocov: :emailer=>lambda{|h| Net::SMTP.start(h[:host]){|s| s.(h[:message], h[:from], h[:to])}}, # :nocov: :default_headers=>lambda do |h, e| subject = if e.respond_to?(:message) "#{e.class}: #{e.}" else e.to_s end {'From'=>h[:from], 'To'=>h[:to], 'Subject'=>"#{h[:prefix]}#{subject}"} end, :body=>lambda do |s, e| format = lambda{|h| h.map{|k, v| "#{k.inspect} => #{v.inspect}"}.sort.join("\n")} = String.new << <<END Path: #{s.request.path} END if e.respond_to?(:backtrace) << <<END Backtrace: #{e.backtrace.join("\n")} END end << <<END ENV: #{format[s.env]} END unless s.request.params.empty? << <<END Params: #{format[s.request.params]} END end if s.env['rack.session'] << <<END Session: #{format[s.session]} END end end }.freeze
Class Method Summary collapse
-
.configure(app, opts = OPTS) ⇒ Object
Set default opts for plugin.
Class Method Details
.configure(app, opts = OPTS) ⇒ Object
Set default opts for plugin. See ErrorEmail module RDoc for options.
99 100 101 102 103 104 105 106 107 108 109 |
# File 'lib/roda/plugins/error_email.rb', line 99 def self.configure(app, opts=OPTS) email_opts = app.opts[:error_email] ||= DEFAULTS email_opts = email_opts.merge(opts) email_opts[:headers] = email_opts[:headers].dup unless email_opts[:to] && email_opts[:from] raise RodaError, "must provide :to and :from options to error_email plugin" end app.opts[:error_email] = email_opts app.opts[:error_email][:headers].freeze app.opts[:error_email].freeze end |