hanami-mailer 1.2.0 → 1.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca5294eaa714cbda1a3a1de8de43014bdeb518360bea5d789f2501531696b06f
-  data.tar.gz: c41b1d7f558d2e7626fbaf3191bc462f1f8840fa7bc7e8f2c51403b134723bfb
+  metadata.gz: aaa9852dec3800b06a8282dd1ee9d7c3c74a0acdac120657de03283ba1925d6a
+  data.tar.gz: ff87640e34325a09d94657ff0358cb456ff1f96826111df68b4f628619f95525
 SHA512:
-  metadata.gz: adcf3b61c83c6a07d173c2cfe697e62609510dfd99290a48657f3413bcdc8518779dbc3963ef963fd2c6d431fecbc64053e8eba74e499b39c6e40ba2ceb4f8c3
-  data.tar.gz: f5df73cb6beb2d6fff287ec60f1acac8f02bf1e09b975937415ffd5928fc355425f37f9f437a305a4dd3afdc3f2b14c52bb1991a36d61dd284f0d069b2cd5e19
+  metadata.gz: f9a4c8d1f3463a2378f587ddcb20c24cf281afd4c033f725df476e4a0b12d67ddaba90618bc73d5bd9bc614263d8bc257eba0e9922a8e30ae9367a0b86e4686e
+  data.tar.gz: 1ee77f48da2d39f1669e901b0f57981ffa89026283b8c37070900fcc5fe65d192850b6c2774b851c901fc8a7567c45c27056dc996783fa9e03a8470dbbe11923

data/CHANGELOG.md

@@ -1,6 +1,28 @@
 # Hanami::Mailer
 Mail for Ruby applications
 
+## v1.3.3 - 2021-01-14
+### Added
+- [Luca Guidi] Official support for Ruby: MRI 3.0
+
+## v1.3.2 - 2020-02-03
+### Added
+- [Luca Guidi] Official support for Ruby: MRI 2.7
+- [glaszig] Added `Hanami::Mailer.return_path` and `#return_path` to specify `MAIL FROM` address
+
+## v1.3.1 - 2019-01-18
+### Added
+- [Luca Guidi] Official support for Ruby: MRI 2.6
+- [Luca Guidi] Support `bundler` 2.0+
+
+## v1.3.0 - 2018-10-24
+### Added
+- [Ben Bachhuber] Added support for `reply_to`
+
+## v1.3.0.beta1 - 2018-08-08
+### Added
+- [Luca Guidi] Official support for JRuby 9.2.0.0
+
 ## v1.2.0 - 2018-04-11
 
 ## v1.2.0.rc2 - 2018-04-06

data/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright © 2015-2017 Luca Guidi
+Copyright © 2015-2021 Luca Guidi
 
 MIT License
 

data/README.md

@@ -4,11 +4,10 @@ Mail for Ruby applications.
 
 ## Status
 
-[![Gem Version](http://img.shields.io/gem/v/hanami-mailer.svg)](https://badge.fury.io/rb/hanami-mailer)
-[![Build Status](http://img.shields.io/travis/hanami/mailer/master.svg)](https://travis-ci.org/hanami/mailer?branch=master)
-[![Coverage](http://img.shields.io/coveralls/hanami/mailer/master.svg)](https://coveralls.io/r/hanami/mailer)
-[![Code Climate](http://img.shields.io/codeclimate/github/hanami/mailer.svg)](https://codeclimate.com/github/hanami/mailer)
-[![Dependencies](http://img.shields.io/gemnasium/hanami/mailer.svg)](https://gemnasium.com/hanami/mailer)
+[![Gem Version](https://badge.fury.io/rb/hanami-mailer.svg)](https://badge.fury.io/rb/hanami-mailer)
+[![CI](https://github.com/hanami/mailer/workflows/ci/badge.svg?branch=master)](https://github.com/hanami/mailer/actions?query=workflow%3Aci+branch%3Amaster)
+[![Test Coverage](https://codecov.io/gh/hanami/mailer/branch/master/graph/badge.svg)](https://codecov.io/gh/hanami/mailer)
+[![Depfu](https://badges.depfu.com/badges/739c6e10eaf20d3ba4240d00828284db/overview.svg)](https://depfu.com/github/hanami/mailer?project=Bundler)
 [![Inline Docs](http://inch-ci.org/github/hanami/mailer.svg)](http://inch-ci.org/github/hanami/mailer)
 
 ## Contact
@@ -80,6 +79,7 @@ end.load!
 class WelcomeMailer
   include Hanami::Mailer
 
+  return_path 'bounce@sender.com'
   from 'noreply@sender.com'
   to   'noreply@recipient.com'
   cc   'cc@sender.com'
@@ -311,7 +311,7 @@ It supports a few options:
 ```ruby
 require 'hanami/mailer'
 
-Hanami::Maler.configure do
+Hanami::Mailer.configure do
   # Set the root path where to search for templates
   # Argument: String, Pathname, #to_pathname, defaults to the current directory
   #
@@ -326,6 +326,7 @@ Hanami::Maler.configure do
   # Argument: Symbol
   # Argument: Hash, optional configurations
   delivery_method :stmp
+end
 ```
 
 ### Attachments
@@ -414,6 +415,6 @@ __Hanami::Mailer__ uses [Semantic Versioning 2.0.0](http://semver.org)
 
 ## Copyright
 
-Copyright © 2015-2017 Luca Guidi – Released under MIT License
+Copyright © 2015-2021 Luca Guidi – Released under MIT License
 
 This project was formerly known as Lotus (`lotus-mailer`).

data/hanami-mailer.gemspec

@@ -1,29 +1,32 @@
-lib = File.expand_path('../lib', __FILE__)
+# frozen_string_literal: true
+
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'hanami/mailer/version'
+require "hanami/mailer/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = 'hanami-mailer'
+  spec.name          = "hanami-mailer"
   spec.version       = Hanami::Mailer::VERSION
-  spec.authors       = ['Luca Guidi']
-  spec.email         = ['me@lucaguidi.com']
+  spec.authors       = ["Luca Guidi"]
+  spec.email         = ["me@lucaguidi.com"]
 
-  spec.summary       = 'Mail for Ruby applications.'
-  spec.description   = 'Mail for Ruby applications and Hanami mailers'
-  spec.homepage      = 'http://hanamirb.org'
-  spec.license       = 'MIT'
+  spec.summary       = "Mail for Ruby applications."
+  spec.description   = "Mail for Ruby applications and Hanami mailers"
+  spec.homepage      = "http://hanamirb.org"
+  spec.license       = "MIT"
 
-  spec.files         = `git ls-files -- lib/* CHANGELOG.md LICENSE.md README.md hanami-mailer.gemspec`.split($/) # rubocop:disable Style/SpecialGlobalVars
-  spec.bindir        = 'exe'
+  spec.files         = `git ls-files -- lib/* CHANGELOG.md LICENSE.md README.md hanami-mailer.gemspec`.split($/)
+  spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ['lib']
-  spec.required_ruby_version = '>= 2.3.0'
+  spec.require_paths = ["lib"]
+  spec.required_ruby_version = ">= 2.3.0"
 
-  spec.add_dependency 'hanami-utils', '~> 1.2'
-  spec.add_dependency 'tilt',         '~> 2.0', '>= 2.0.1'
-  spec.add_dependency 'mail',         '~> 2.6'
+  spec.add_dependency "hanami-utils", "~> 1.3"
+  spec.add_dependency "tilt",         "~> 2.0", ">= 2.0.1"
+  spec.add_dependency "mail",         "~> 2.6"
 
-  spec.add_development_dependency 'bundler'
-  spec.add_development_dependency 'rake',  '~> 12'
-  spec.add_development_dependency 'rspec', '~> 3.7'
+  spec.add_development_dependency "bundler", ">= 1.6", "< 3"
+  spec.add_development_dependency "rake",  "~> 13"
+  spec.add_development_dependency "rspec", "~> 3.7"
+  spec.add_development_dependency "rubocop", "0.81" # rubocop 0.81+ removed support for Ruby 2.3
 end

data/lib/hanami-mailer.rb

@@ -1 +1,3 @@
-require 'hanami/mailer' # rubocop:disable Naming/FileName
+# frozen_string_literal: true
+
+require "hanami/mailer"

data/lib/hanami/mailer.rb

@@ -1,8 +1,10 @@
-require 'hanami/utils/class_attribute'
-require 'hanami/mailer/version'
-require 'hanami/mailer/configuration'
-require 'hanami/mailer/dsl'
-require 'mail'
+# frozen_string_literal: true
+
+require "hanami/utils/class_attribute"
+require "hanami/mailer/version"
+require "hanami/mailer/configuration"
+require "hanami/mailer/dsl"
+require "mail"
 
 # Hanami
 #
@@ -34,8 +36,8 @@ module Hanami
     # @since 0.1.0
     # @api private
     CONTENT_TYPES = {
-      html: 'text/html',
-      txt:  'text/plain'
+      html: "text/html",
+      txt: "text/plain"
     }.freeze
 
     include Utils::ClassAttribute
@@ -181,10 +183,17 @@ module Hanami
       #   invoice = Invoice.new
       #   user    = User.new(name: 'L', email: 'user@example.com')
       #
-      #   Billing::Invoice.deliver(invoice: invoice, user: user)                      # Deliver both text, HTML parts and the attachment
-      #   Billing::Invoice.deliver(invoice: invoice, user: user, format: :txt)        # Deliver only the text part and the attachment
-      #   Billing::Invoice.deliver(invoice: invoice, user: user, format: :html)       # Deliver only the text part and the attachment
-      #   Billing::Invoice.deliver(invoice: invoice, user: user, charset: 'iso-8859') # Deliver both the parts with "iso-8859"
+      #   # Deliver both text, HTML parts and the attachment
+      #   Billing::Invoice.deliver(invoice: invoice, user: user)
+      #
+      #   # Deliver only the text part and the attachment
+      #   Billing::Invoice.deliver(invoice: invoice, user: user, format: :txt)
+      #
+      #   # Deliver only the text part and the attachment
+      #   Billing::Invoice.deliver(invoice: invoice, user: user, format: :html)
+      #
+      #   # Deliver both the parts with "iso-8859"
+      #   Billing::Invoice.deliver(invoice: invoice, user: user, charset: "iso-8859")
       def deliver(locals = {})
         new(locals).deliver
       end
@@ -223,8 +232,9 @@ module Hanami
     # @api private
     def deliver
       mail.deliver
-    rescue ArgumentError => e
-      raise MissingDeliveryDataError if e.message =~ /SMTP (From|To) address/
+    rescue ArgumentError => exception
+      raise MissingDeliveryDataError if exception.message =~ /SMTP (From|To) address/
+
       raise
     end
 
@@ -279,15 +289,15 @@ module Hanami
 
     private
 
-    # rubocop:disable Metrics/MethodLength
-    # rubocop:disable Metrics/AbcSize
     def build
       Mail.new.tap do |m|
-        m.from    = __dsl(:from)
-        m.to      = __dsl(:to)
-        m.cc      = __dsl(:cc)
-        m.bcc     = __dsl(:bcc)
-        m.subject = __dsl(:subject)
+        m.return_path = __dsl(:return_path)
+        m.from     = __dsl(:from)
+        m.to       = __dsl(:to)
+        m.cc       = __dsl(:cc)
+        m.bcc      = __dsl(:bcc)
+        m.reply_to = __dsl(:reply_to)
+        m.subject  = __dsl(:subject)
 
         m.charset   = charset
         m.html_part = __part(:html)
@@ -296,8 +306,6 @@ module Hanami
         m.delivery_method(*Hanami::Mailer.configuration.delivery_method)
       end
     end
-    # rubocop:enable Metrics/MethodLength
-    # rubocop:enable Metrics/AbcSize
 
     # @api private
     # @since 0.1.0

data/lib/hanami/mailer/configuration.rb

@@ -1,5 +1,7 @@
-require 'set'
-require 'hanami/utils/kernel'
+# frozen_string_literal: true
+
+require "set"
+require "hanami/utils/kernel"
 
 module Hanami
   module Mailer
@@ -11,7 +13,7 @@ module Hanami
       #
       # @since 0.1.0
       # @api private
-      DEFAULT_ROOT = '.'.freeze
+      DEFAULT_ROOT = "."
 
       # Default delivery method
       #
@@ -23,7 +25,7 @@ module Hanami
       #
       # @since 0.1.0
       # @api private
-      DEFAULT_CHARSET = 'UTF-8'.freeze
+      DEFAULT_CHARSET = "UTF-8"
 
       # @since 0.1.0
       # @api private
@@ -144,10 +146,10 @@ module Hanami
       #
       # @see Hanami::Mailer.configure
       def prepare(&blk)
-        if block_given? # rubocop:disable Style/GuardClause
+        if block_given?
           @modules.push(blk)
         else
-          raise ArgumentError.new('Please provide a block')
+          raise ArgumentError.new("Please provide a block")
         end
       end
 
@@ -191,7 +193,7 @@ module Hanami
         @modules = []
       end
 
-      alias unload! reset!
+      alias_method :unload!, :reset!
 
       # Copy the configuration for the given mailer
       #

data/lib/hanami/mailer/dsl.rb

@@ -1,5 +1,7 @@
-require 'hanami/mailer/rendering/template_name'
-require 'hanami/mailer/rendering/templates_finder'
+# frozen_string_literal: true
+
+require "hanami/mailer/rendering/template_name"
+require "hanami/mailer/rendering/templates_finder"
 
 module Hanami
   module Mailer
@@ -11,11 +13,13 @@ module Hanami
       # @api private
       def self.extended(base)
         base.class_eval do
-          @from    = nil
-          @to      = nil
-          @cc      = nil
-          @bcc     = nil
-          @subject = nil
+          @from        = nil
+          @to          = nil
+          @cc          = nil
+          @bcc         = nil
+          @reply_to    = nil
+          @return_path = nil
+          @subject     = nil
         end
       end
 
@@ -85,6 +89,63 @@ module Hanami
         end
       end
 
+      # Sets the MAIL FROM address for mail messages.
+      # This lets you specify a "bounce address" different from the sender
+      # address specified with `from`.
+      #
+      # It accepts a hardcoded value as a string, or a symbol that represents
+      # an instance method for more complex logic.
+      #
+      # This value is optional.
+      #
+      # When a value is given, specify the MAIL FROM address of the email
+      # Otherwise, it returns the MAIL FROM address of the email
+      #
+      # This is part of a DSL, for this reason when this method is called with
+      # an argument, it will set the corresponding class variable. When
+      # called without, it will return the already set value, or the default.
+      #
+      # @overload return_path(value)
+      #   Sets the MAIL FROM address
+      #   @param value [String, Symbol] the hardcoded value or method name
+      #   @return [NilClass]
+      #
+      # @overload return_path
+      #   Returns the MAIL FROM address
+      #   @return [String, Symbol] the MAIL FROM address
+      #
+      # @since 1.3.2
+      #
+      # @example Hardcoded value (String)
+      #   require 'hanami/mailer'
+      #
+      #   class WelcomeMailer
+      #     include Hanami::Mailer
+      #
+      #     return_path "bounce@example.com"
+      #   end
+      #
+      # @example Method (Symbol)
+      #   require 'hanami/mailer'
+      #
+      #   class WelcomeMailer
+      #     include Hanami::Mailer
+      #     return_path :bounce_address
+      #
+      #     private
+      #
+      #     def bounce_address
+      #       "bounce@example.com"
+      #     end
+      #   end
+      def return_path(value = nil)
+        if value.nil?
+          @return_path
+        else
+          @return_path = value
+        end
+      end
+
       # Sets the sender for mail messages
       #
       # It accepts a hardcoded value as a string, or a symbol that represents
@@ -319,6 +380,95 @@ module Hanami
         end
       end
 
+      # Sets the reply_to for mail messages
+      #
+      # It accepts a hardcoded value as a string or array of strings.
+      # For dynamic values, you can specify a symbol that represents an instance
+      # method.
+      #
+      # This value is optional.
+      #
+      # When a value is given, it specifies the reply_to for the email.
+      # When a value is not given, it returns the reply_to of the email.
+      #
+      # This is part of a DSL, for this reason when this method is called with
+      # an argument, it will set the corresponding class variable. When
+      # called without, it will return the already set value, or the default.
+      #
+      # @overload reply_to(value)
+      #   Sets the reply_to
+      #   @param value [String, Array, Symbol] the hardcoded value or method name
+      #   @return [NilClass]
+      #
+      # @overload reply_to
+      #   Returns the reply_to
+      #   @return [String, Array, Symbol] the recipient
+      #
+      # @since 1.3.0
+      #
+      # @example Hardcoded value (String)
+      #   require 'hanami/mailer'
+      #
+      #   class WelcomeMailer
+      #     include Hanami::Mailer
+      #
+      #     to "user@example.com"
+      #     reply_to "other.user@example.com"
+      #   end
+      #
+      # @example Hardcoded value (Array)
+      #   require 'hanami/mailer'
+      #
+      #   class WelcomeMailer
+      #     include Hanami::Mailer
+      #
+      #     to ["user-1@example.com", "user-2@example.com"]
+      #     reply_to ["other.user-1@example.com", "other.user-2@example.com"]
+      #   end
+      #
+      # @example Method (Symbol)
+      #   require 'hanami/mailer'
+      #
+      #   class WelcomeMailer
+      #     include Hanami::Mailer
+      #     to "user@example.com"
+      #     reply_to :email_address
+      #
+      #     private
+      #
+      #     def email_address
+      #       user.email
+      #     end
+      #   end
+      #
+      #   other_user = User.new(name: 'L')
+      #   WelcomeMailer.deliver(user: other_user)
+      #
+      # @example Method that returns a collection of recipients
+      #   require 'hanami/mailer'
+      #
+      #   class WelcomeMailer
+      #     include Hanami::Mailer
+      #     to "user@example.com"
+      #     reply_to :recipients
+      #
+      #     private
+      #
+      #     def recipients
+      #       users.map(&:email)
+      #     end
+      #   end
+      #
+      #   other_users = [User.new(name: 'L'), User.new(name: 'MG')]
+      #   WelcomeMailer.deliver(users: other_users)
+      def reply_to(value = nil)
+        if value.nil?
+          @reply_to
+        else
+          @reply_to = value
+        end
+      end
+
       # Sets the recipient for mail messages
       #
       # It accepts a hardcoded value as a string or array of strings.

data/lib/hanami/mailer/rendering/template_name.rb

@@ -1,4 +1,6 @@
-require 'hanami/utils/string'
+# frozen_string_literal: true
+
+require "hanami/utils/string"
 
 module Hanami
   module Mailer
@@ -10,7 +12,7 @@ module Hanami
       class TemplateName
         # @since 0.1.0
         # @api private
-        NAMESPACE_SEPARATOR = '::'.freeze
+        NAMESPACE_SEPARATOR = "::"
 
         # @since 0.1.0
         # @api private
@@ -45,7 +47,7 @@ module Hanami
         # @since 0.1.0
         # @api private
         def replace!(token)
-          @name.gsub!(/\A#{token}#{NAMESPACE_SEPARATOR}/, '')
+          @name = @name.gsub(/\A#{token}#{NAMESPACE_SEPARATOR}/, "")
         end
       end
     end

data/lib/hanami/mailer/rendering/templates_finder.rb

@@ -1,4 +1,6 @@
-require 'hanami/mailer/template'
+# frozen_string_literal: true
+
+require "hanami/mailer/template"
 
 module Hanami
   module Mailer
@@ -14,19 +16,19 @@ module Hanami
         #
         # @api private
         # @since 0.1.0
-        FORMAT    = '*'.freeze
+        FORMAT    = "*"
 
         # Default template engines
         #
         # @api private
         # @since 0.1.0
-        ENGINES   = '*'.freeze
+        ENGINES   = "*"
 
         # Recursive pattern
         #
         # @api private
         # @since 0.1.0
-        RECURSIVE = '**'.freeze
+        RECURSIVE = "**"
 
         # Initialize a finder
         #
@@ -72,7 +74,7 @@ module Hanami
           templates = Hash[]
           _find.map do |template|
             name = File.basename(template)
-            format = (name.split('.')[-2]).to_sym
+            format = (name.split(".")[-2]).to_sym
             templates[format] = Mailer::Template.new(template)
           end
           templates

data/lib/hanami/mailer/template.rb

@@ -1,4 +1,6 @@
-require 'tilt'
+# frozen_string_literal: true
+
+require "tilt"
 
 module Hanami
   module Mailer
@@ -9,8 +11,8 @@ module Hanami
     #
     # TODO this is identical to Hanami::View, consider to move into Hanami::Utils
     class Template
-      def initialize(template)
-        @_template = Tilt.new(template)
+      def initialize(template, encoding = Encoding::UTF_8)
+        @_template = Tilt.new(template, default_encoding: encoding)
       end
 
       # Render the template within the context of the given scope.

data/lib/hanami/mailer/version.rb

@@ -1,6 +1,8 @@
+# frozen_string_literal: true
+
 module Hanami
   module Mailer
     # @since 0.1.0
-    VERSION = '1.2.0'.freeze
+    VERSION = "1.3.3"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hanami-mailer
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.3
 platform: ruby
 authors:
 - Luca Guidi
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2018-04-11 00:00:00.000000000 Z
+date: 2021-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hanami-utils
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
@@ -64,28 +64,34 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12'
+        version: '13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12'
+        version: '13'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -100,6 +106,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.81'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.81'
 description: Mail for Ruby applications and Hanami mailers
 email:
 - me@lucaguidi.com
@@ -123,7 +143,7 @@ homepage: http://hanamirb.org
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -138,9 +158,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.2.4
+signing_key:
 specification_version: 4
 summary: Mail for Ruby applications.
 test_files: []