hanami-mailer 1.3.0.beta1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edf954374f4e9a8c4a0a1527760dddc38cd4fd1ffb4111513566e1c9a882a33e
-  data.tar.gz: 58fb4113c25a774caf30b6290f7cd9f1602fe1e123ddb380f355481f9661f3bd
+  metadata.gz: 52f0c61d4de8af3cfa11ee5ba09337c5e1091f04f23ccf3c149a8e13c71bf71b
+  data.tar.gz: aa1009dd9bc9036c72e657763fc7d1892dc0769f2b3bf89f9ac5ed5e8299d0d7
 SHA512:
-  metadata.gz: bd07d7bd3b12582cf4b30d5d0a6d106e1d57b2ada08c28195aa879160dbbe839296bd60086b2756b190b0c5893a95a8f13b36af8467976e27abdb1411a9b9a55
-  data.tar.gz: 531c2b67149ecba1e3cee6a9ec735816c8a49485efe42bc884eac0716b934680f68e929ebfbf386a42ef6fe1b43b5df227aceeb79a6df2c986f0d07bc75ee09b
+  metadata.gz: 6559982652477d33fc96333a51a188580ef564152ba66b694f28ce7f01d5895b5a3e0da1549d98de197cd83d951735b6ad0ec2ce8a6f16559cdb41986f7e4967
+  data.tar.gz: a512a7528eca16fc7ff933884b5eadeb69a337ceee9539e1a9990847b9540e245ab21c35347af9fc9900f13d2dbb870950d23bae2b0f29e61413c064a3e050a7

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Hanami::Mailer
 Mail for Ruby applications
 
+## 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

data/hanami-mailer.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
   spec.required_ruby_version = '>= 2.3.0'
 
-  spec.add_dependency 'hanami-utils', '~> 1.3.beta'
+  spec.add_dependency 'hanami-utils', '~> 1.3'
   spec.add_dependency 'tilt',         '~> 2.0', '>= 2.0.1'
   spec.add_dependency 'mail',         '~> 2.6'
 

data/lib/hanami/mailer.rb

@@ -225,6 +225,7 @@ module Hanami
       mail.deliver
     rescue ArgumentError => e
       raise MissingDeliveryDataError if e.message =~ /SMTP (From|To) address/
+
       raise
     end
 
@@ -283,11 +284,12 @@ module Hanami
     # 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.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)

data/lib/hanami/mailer/dsl.rb

@@ -11,11 +11,12 @@ 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
+          @subject  = nil
         end
       end
 
@@ -319,6 +320,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/version.rb

@@ -1,6 +1,6 @@
 module Hanami
   module Mailer
     # @since 0.1.0
-    VERSION = '1.3.0.beta1'.freeze
+    VERSION = '1.3.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hanami-mailer
 version: !ruby/object:Gem::Version
-  version: 1.3.0.beta1
+  version: 1.3.0
 platform: ruby
 authors:
 - Luca Guidi
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-08-08 00:00:00.000000000 Z
+date: 2018-10-24 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.3.beta
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.beta
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
@@ -134,9 +134,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.7.7