actionmailer 8.0.3 → 8.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da328b9ee25491a6136f83ba88a3a0ce79a9ec9a166ed9befc7a57ec6e10fd04
-  data.tar.gz: 98ac1193d8753bc37b7b651f7391ae10d5f2b94d9c3912b5f84840f89e54ae5d
+  metadata.gz: 88f1f6c224f50cb6b6f9d696849cee934e66006b8e4737d40399803ec7585bf9
+  data.tar.gz: e85c8a33fba53b30abb08dea2040f7aef1230cfb4c96b09b4c5a72f826eef92a
 SHA512:
-  metadata.gz: 7d0fe5196895c6235bc58cc1423d27005c1fa78a8c72298207e77cd7477f6fbcdd4c34d8c42003f071802a91d70e3d449435d04f073c4a500d9f17e7ac0fcb0c
-  data.tar.gz: 9ea54f969749e637bdea916974d0cedeaccaaa2faaa4e097aa0786456c7d89d345ce077f4352b0675278f23167c93a6e0c50a02f317fbf4994042d7be0c85710
+  metadata.gz: 66634214e536663cfc491fb82d1aeda9967e7a3915ec99b411695cdf4bfd9ef60ded5761187645497bfc312526dc2fc7678d0a86d098ba9a623f3fdd04279537
+  data.tar.gz: 2a809be068e48230d06c1cf37648de4956f0fbbd0078e344f5c32d4f38303d1dda9c4554a5f54e0cb9d8efe39f1f903fe52087fcf709eb76f23df699a8b230fa

data/CHANGELOG.md

@@ -1,44 +1,25 @@
-## Rails 8.0.3 (September 22, 2025) ##
+## Rails 8.1.0 (October 22, 2025) ##
 
-*   No changes.
+*   Add structured events for Action Mailer:
+    - `action_mailer.delivered`
+    - `action_mailer.processed`
 
+    *Gannon McGibbon*
 
-## Rails 8.0.2.1 (August 13, 2025) ##
+*   Add `deliver_all_later` to enqueue multiple emails at once.
 
-*   No changes.
+    ```ruby
+    user_emails = User.all.map { |user| Notifier.welcome(user) }
+    ActionMailer.deliver_all_later(user_emails)
 
+    # use a custom queue
+    ActionMailer.deliver_all_later(user_emails, queue: :my_queue)
+    ```
 
-## Rails 8.0.2 (March 12, 2025) ##
+    This can greatly reduce the number of round-trips to the queue datastore.
+    For queue adapters that do not implement the `enqueue_all` method, we
+    fall back to enqueuing email jobs indvidually.
 
-*   No changes.
+    *fatkodima*
 
-
-## Rails 8.0.1 (December 13, 2024) ##
-
-*   No changes.
-
-
-## Rails 8.0.0.1 (December 10, 2024) ##
-
-*   No changes.
-
-
-## Rails 8.0.0 (November 07, 2024) ##
-
-*   No changes.
-
-
-## Rails 8.0.0.rc2 (October 30, 2024) ##
-
-*   No changes.
-
-
-## Rails 8.0.0.rc1 (October 19, 2024) ##
-
-*   No changes.
-
-
-## Rails 8.0.0.beta1 (September 26, 2024) ##
-
-
-Please check [7-2-stable](https://github.com/rails/rails/blob/7-2-stable/actionmailer/CHANGELOG.md) for previous changes.
+Please check [8-0-stable](https://github.com/rails/rails/blob/8-0-stable/actionmailer/CHANGELOG.md) for previous changes.

data/lib/action_mailer/base.rb

@@ -7,6 +7,7 @@ require "active_support/core_ext/hash/except"
 require "active_support/core_ext/module/anonymous"
 
 require "action_mailer/log_subscriber"
+require "action_mailer/structured_event_subscriber"
 require "action_mailer/rescuable"
 
 module ActionMailer
@@ -930,7 +931,7 @@ module ActionMailer
       # If the subject has interpolations, you can pass them through the +interpolations+ parameter.
       def default_i18n_subject(interpolations = {}) # :doc:
         mailer_scope = self.class.mailer_name.tr("/", ".")
-        I18n.t(:subject, **interpolations.merge(scope: [mailer_scope, action_name], default: action_name.humanize))
+        I18n.t(:subject, **interpolations, scope: [mailer_scope, action_name], default: action_name.humanize)
       end
 
       # Emails do not support relative path links.

data/lib/action_mailer/form_builder.rb

@@ -23,7 +23,7 @@ module ActionMailer
       # in the views rendered by this mailer and its subclasses.
       #
       # ==== Parameters
-      # * <tt>builder</tt> - Default form builder, an instance of ActionView::Helpers::FormBuilder
+      # * <tt>builder</tt> - Default form builder. Accepts a subclass of ActionView::Helpers::FormBuilder
       def default_form_builder(builder)
         self._default_form_builder = builder
       end

data/lib/action_mailer/gem_version.rb

@@ -8,8 +8,8 @@ module ActionMailer
 
   module VERSION
     MAJOR = 8
-    MINOR = 0
-    TINY  = 3
+    MINOR = 1
+    TINY  = 0
     PRE   = nil
 
     STRING = [MAJOR, MINOR, TINY, PRE].compact.join(".")

data/lib/action_mailer/log_subscriber.rb

@@ -3,11 +3,7 @@
 require "active_support/log_subscriber"
 
 module ActionMailer
-  # = Action Mailer \LogSubscriber
-  #
-  # Implements the ActiveSupport::LogSubscriber for logging notifications when
-  # email is delivered or received.
-  class LogSubscriber < ActiveSupport::LogSubscriber
+  class LogSubscriber < ActiveSupport::LogSubscriber # :nodoc:
     # An email was delivered.
     def deliver(event)
       info do

data/lib/action_mailer/message_delivery.rb

@@ -3,6 +3,38 @@
 require "delegate"
 
 module ActionMailer
+  class << self
+    # Enqueue many emails at once to be delivered through Active Job.
+    # When the individual job runs, it will send the email using +deliver_now+.
+    def deliver_all_later(*deliveries, **options)
+      _deliver_all_later("deliver_now", *deliveries, **options)
+    end
+
+    # Enqueue many emails at once to be delivered through Active Job.
+    # When the individual job runs, it will send the email using +deliver_now!+.
+    # That means that the message will be sent bypassing checking +perform_deliveries+
+    # and +raise_delivery_errors+, so use with caution.
+    def deliver_all_later!(*deliveries, **options)
+      _deliver_all_later("deliver_now!", *deliveries, **options)
+    end
+
+    private
+      def _deliver_all_later(delivery_method, *deliveries, **options)
+        deliveries = deliveries.first if deliveries.first.is_a?(Array)
+
+        jobs = deliveries.map do |delivery|
+          mailer_class = delivery.mailer_class
+          delivery_job = mailer_class.delivery_job
+
+          delivery_job
+            .new(mailer_class.name, delivery.action.to_s, delivery_method, params: delivery.params, args: delivery.args)
+            .set(options)
+        end
+
+        ActiveJob.perform_all_later(jobs)
+      end
+  end
+
   # = Action Mailer \MessageDelivery
   #
   # The +ActionMailer::MessageDelivery+ class is used by
@@ -17,6 +49,8 @@ module ActionMailer
   #   Notifier.welcome(User.first).deliver_later # enqueue email delivery as a job through Active Job
   #   Notifier.welcome(User.first).message       # a Mail::Message object
   class MessageDelivery < Delegator
+    attr_reader :mailer_class, :action, :params, :args # :nodoc:
+
     def initialize(mailer_class, action, *args) # :nodoc:
       @mailer_class, @action, @args = mailer_class, action, args
 

data/lib/action_mailer/railtie.rb

@@ -73,12 +73,6 @@ module ActionMailer
       app.config.paths["test/mailers/previews"].concat(options.preview_paths)
     end
 
-    initializer "action_mailer.compile_config_methods" do
-      ActiveSupport.on_load(:action_mailer) do
-        config.compile_methods! if config.respond_to?(:compile_methods!)
-      end
-    end
-
     config.after_initialize do |app|
       options = app.config.action_mailer
 

data/lib/action_mailer/structured_event_subscriber.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "active_support/structured_event_subscriber"
+
+module ActionMailer
+  class StructuredEventSubscriber < ActiveSupport::StructuredEventSubscriber # :nodoc:
+    # An email was delivered.
+    def deliver(event)
+      exception = event.payload[:exception_object]
+      payload = {
+        message_id: event.payload[:message_id],
+        duration_ms: event.duration.round(2),
+        mail: event.payload[:mail],
+        perform_deliveries: event.payload[:perform_deliveries],
+      }
+
+      if exception
+        payload[:exception_class] = exception.class.name
+        payload[:exception_message] = exception.message
+      end
+
+      emit_debug_event("action_mailer.delivered", payload)
+    end
+    debug_only :deliver
+
+    # An email was generated.
+    def process(event)
+      emit_debug_event("action_mailer.processed",
+        mailer: event.payload[:mailer],
+        action: event.payload[:action],
+        duration_ms: event.duration.round(2),
+      )
+    end
+    debug_only :process
+  end
+end
+
+ActionMailer::StructuredEventSubscriber.attach_to :action_mailer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: actionmailer
 version: !ruby/object:Gem::Version
-  version: 8.0.3
+  version: 8.1.0
 platform: ruby
 authors:
 - David Heinemeier Hansson
@@ -15,56 +15,56 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
 - !ruby/object:Gem::Dependency
   name: actionview
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
 - !ruby/object:Gem::Dependency
   name: activejob
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 8.0.3
+        version: 8.1.0
 - !ruby/object:Gem::Dependency
   name: mail
   requirement: !ruby/object:Gem::Requirement
@@ -121,6 +121,7 @@ files:
 - lib/action_mailer/queued_delivery.rb
 - lib/action_mailer/railtie.rb
 - lib/action_mailer/rescuable.rb
+- lib/action_mailer/structured_event_subscriber.rb
 - lib/action_mailer/test_case.rb
 - lib/action_mailer/test_helper.rb
 - lib/action_mailer/version.rb
@@ -133,10 +134,10 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/rails/rails/issues
-  changelog_uri: https://github.com/rails/rails/blob/v8.0.3/actionmailer/CHANGELOG.md
-  documentation_uri: https://api.rubyonrails.org/v8.0.3/
+  changelog_uri: https://github.com/rails/rails/blob/v8.1.0/actionmailer/CHANGELOG.md
+  documentation_uri: https://api.rubyonrails.org/v8.1.0/
   mailing_list_uri: https://discuss.rubyonrails.org/c/rubyonrails-talk
-  source_code_uri: https://github.com/rails/rails/tree/v8.0.3/actionmailer
+  source_code_uri: https://github.com/rails/rails/tree/v8.1.0/actionmailer
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: