1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
rails--rails/actionmailer/lib/action_mailer/mail_helper.rb

73 lines
2 KiB
Ruby
Raw Normal View History

# frozen_string_literal: true
module ActionMailer
2013-05-15 00:36:07 -04:00
# Provides helper methods for ActionMailer::Base that can be used for easily
# formatting messages, accessing mailer or message instances, and the
# attachments list.
module MailHelper
# Take the text and format it, indented two spaces for each line, and
# wrapped at 72 columns:
#
# text = <<-TEXT
# This is
# the paragraph.
#
# * item1 * item2
# TEXT
#
# block_format text
# # => " This is the paragraph.\n\n * item1\n * item2\n"
def block_format(text)
formatted = text.split(/\n\r?\n/).collect { |paragraph|
format_paragraph(paragraph)
}.join("\n\n")
# Make list points stand on their own line
formatted.gsub!(/[ ]*([*]+) ([^*]*)/) { " #{$1} #{$2.strip}\n" }
formatted.gsub!(/[ ]*([#]+) ([^#]*)/) { " #{$1} #{$2.strip}\n" }
formatted
end
# Access the mailer instance.
2010-01-24 13:52:44 -05:00
def mailer
@_controller
end
# Access the message instance.
2010-01-24 13:52:44 -05:00
def message
@_message
end
# Access the message attachments list.
def attachments
mailer.attachments
end
# Returns +text+ wrapped at +len+ columns and indented +indent+ spaces.
# By default column length +len+ equals 72 characters and indent
# +indent+ equal two spaces.
#
# my_text = 'Here is a sample text with more than 40 characters'
#
2011-03-09 17:17:30 -05:00
# format_paragraph(my_text, 25, 4)
# # => " Here is a sample text with\n more than 40 characters"
def format_paragraph(text, len = 72, indent = 2)
sentences = [[]]
text.split.each do |word|
if sentences.first.present? && (sentences.last + [word]).join(" ").length > len
sentences << [word]
else
sentences.last << word
end
end
2013-05-12 23:50:19 -04:00
indentation = " " * indent
sentences.map! { |sentence|
2013-05-12 23:50:19 -04:00
"#{indentation}#{sentence.join(' ')}"
}.join "\n"
end
end
end