Module: ActiveRecord::Suppressor
| Relationships & Source Files | |
| Namespace Children | |
| 
       Modules: 
      
     | |
| Extension / Inclusion / Inheritance Descendants | |
| 
       Included In: 
      
     | |
| Super Chains via Extension / Inclusion / Inheritance | |
| 
         Class Chain: 
        
          self,
           
      ::ActiveSupport::Concern
         | 
    |
| Defined in: | activerecord/lib/active_record/suppressor.rb | 
Overview
Suppressor prevents the receiver from being saved during a given block.
For example, here’s a pattern of creating notifications when new comments are posted. (The notification may in turn trigger an email, a push notification, or just appear in the UI somewhere):
class Comment < ActiveRecord::Base
  belongs_to :commentable, polymorphic: true
  after_create -> { Notification.create! comment: self,
    recipients: commentable.recipients }
end
That’s what you want the bulk of the time. New comment creates a new Notification. But there may well be off cases, like copying a commentable and its comments, where you don’t want that. So you’d have a concern something like this:
module Copyable
  def copy_to(destination)
    Notification.suppress do
      # Copy logic that creates new comments that we do not want
      # triggering notifications.
    end
  end
end
  Class Method Summary
- .registry Internal use only
 
::ActiveSupport::Concern - Extended
| class_methods | Define class methods from given block.  | 
    
| included | Evaluate given block in context of base class, so that you can write class macros here.  | 
    
| prepended | Evaluate given block in context of base class, so that you can write class macros here.  | 
    
| append_features, prepend_features | |
Instance Method Summary
Class Method Details
.registry
    This method is for internal use only.
  
  [ GitHub ]
# File 'activerecord/lib/active_record/suppressor.rb', line 36
def registry # :nodoc: ActiveSupport::IsolatedExecutionState[:active_record_suppressor_registry] ||= {} end
Instance Method Details
#save
    This method is for internal use only.
  
  [ GitHub ]
# File 'activerecord/lib/active_record/suppressor.rb', line 51
def save(**) # :nodoc: Suppressor.registry[self.class.name] ? true : super end
#save!
    This method is for internal use only.
  
  [ GitHub ]
# File 'activerecord/lib/active_record/suppressor.rb', line 55
def save!(**) # :nodoc: Suppressor.registry[self.class.name] ? true : super end