Sha256: 16cb330b5ceb81c391d5981c715f0626122fcdded50241185fe5db278fe74b8b

Contents?: true

Size: 1.96 KB

Versions: 142

Compression:

Stored size: 1.96 KB

Contents

# frozen_string_literal: true

module ActionMailer
  # 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.
    def mailer
      @_controller
    end

    # Access the message instance.
    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'
    #
    #   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

      indentation = " " * indent
      sentences.map! { |sentence|
        "#{indentation}#{sentence.join(' ')}"
      }.join "\n"
    end
  end
end

Version data entries

142 entries across 138 versions & 11 rubygems

Version Path
blacklight-spotlight-3.6.0.beta8 vendor/bundle/ruby/3.2.0/gems/actionmailer-7.0.8.4/lib/action_mailer/mail_helper.rb
cm-admin-1.5.22 vendor/bundle/ruby/3.3.0/gems/actionmailer-7.0.5.1/lib/action_mailer/mail_helper.rb
cm-admin-1.5.21 vendor/bundle/ruby/3.3.0/gems/actionmailer-7.0.5.1/lib/action_mailer/mail_helper.rb
cm-admin-1.5.20 vendor/bundle/ruby/3.3.0/gems/actionmailer-7.0.5.1/lib/action_mailer/mail_helper.rb
actionmailer-7.0.8.4 lib/action_mailer/mail_helper.rb
actionmailer-6.1.7.8 lib/action_mailer/mail_helper.rb
actionmailer-7.0.8.1 lib/action_mailer/mail_helper.rb
actionmailer-6.1.7.7 lib/action_mailer/mail_helper.rb
scrapbook-0.3.2 vendor/ruby/2.7.0/gems/actionmailer-7.0.2.3/lib/action_mailer/mail_helper.rb
scrapbook-0.3.2 vendor/ruby/2.7.0/gems/actionmailer-7.0.3.1/lib/action_mailer/mail_helper.rb
scrapbook-0.3.2 vendor/ruby/2.7.0/gems/actionmailer-6.1.6.1/lib/action_mailer/mail_helper.rb
actionmailer-7.0.8 lib/action_mailer/mail_helper.rb
actionmailer-7.0.7.2 lib/action_mailer/mail_helper.rb
actionmailer-6.1.7.6 lib/action_mailer/mail_helper.rb
actionmailer-7.0.7.1 lib/action_mailer/mail_helper.rb
actionmailer-6.1.7.5 lib/action_mailer/mail_helper.rb
actionmailer-7.0.7 lib/action_mailer/mail_helper.rb
actionmailer-7.0.6 lib/action_mailer/mail_helper.rb
actionmailer-7.0.5.1 lib/action_mailer/mail_helper.rb
actionmailer-6.1.7.4 lib/action_mailer/mail_helper.rb