Methods

Included Modules

Instance Public methods

attribute_before_last_save(attr_name)

Returns the original value of an attribute before the last save. Behaves similarly to attribute_was. This method is useful in after callbacks to get the original value of an attribute before the save that just occurred

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 73
      def attribute_before_last_save(attr_name)
        mutations_before_last_save.original_value(attr_name)
      end
🔎 See on GitHub

attribute_change_to_be_saved(attr_name)

Alias for attribute_change

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 93
      def attribute_change_to_be_saved(attr_name)
        mutations_from_database.change_to_attribute(attr_name)
      end
🔎 See on GitHub

attribute_in_database(attr_name)

Alias for attribute_was

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 98
      def attribute_in_database(attr_name)
        mutations_from_database.original_value(attr_name)
      end
🔎 See on GitHub

attributes_in_database()

Alias for changed_attributes

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 118
      def attributes_in_database
        mutations_from_database.changed_values
      end
🔎 See on GitHub

changed_attribute_names_to_save()

Alias for changed

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 113
      def changed_attribute_names_to_save
        mutations_from_database.changed_attribute_names
      end
🔎 See on GitHub

changes_to_save()

Alias for changes

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 108
      def changes_to_save
        mutations_from_database.changes
      end
🔎 See on GitHub

has_changes_to_save?()

Alias for changed?

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 103
      def has_changes_to_save?
        mutations_from_database.any_changes?
      end
🔎 See on GitHub

reload(*)

reload the record and clears changed attributes.

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 30
      def reload(*)
        super.tap do
          @previously_changed = ActiveSupport::HashWithIndifferentAccess.new
          @mutations_before_last_save = nil
          @attributes_changed_by_setter = ActiveSupport::HashWithIndifferentAccess.new
          @mutations_from_database = nil
        end
      end
🔎 See on GitHub

saved_change_to_attribute(attr_name)

Returns the change to an attribute during the last save. If the attribute was changed, the result will be an array containing the original value and the saved value.

Behaves similarly to attribute_change. This method is useful in after callbacks, to see the change in an attribute that just occurred

This method can be invoked as saved_change_to_name in instead of saved_change_to_attribute("name")

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 65
      def saved_change_to_attribute(attr_name)
        mutations_before_last_save.change_to_attribute(attr_name)
      end
🔎 See on GitHub

saved_change_to_attribute?(attr_name, **options)

Did this attribute change when we last saved? This method can be invoked as saved_change_to_name? instead of saved_change_to_attribute?("name"). Behaves similarly to attribute_changed?. This method is useful in after callbacks to determine if the call to save changed a certain attribute.

Options

from When passed, this method will return false unless the original value is equal to the given option

to When passed, this method will return false unless the value was changed to the given value

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 52
      def saved_change_to_attribute?(attr_name, **options)
        mutations_before_last_save.changed?(attr_name, **options)
      end
🔎 See on GitHub

saved_changes()

Returns a hash containing all the changes that were just saved.

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 83
      def saved_changes
        mutations_before_last_save.changes
      end
🔎 See on GitHub

saved_changes?()

Did the last call to save have any changes to change?

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 78
      def saved_changes?
        mutations_before_last_save.any_changes?
      end
🔎 See on GitHub

will_save_change_to_attribute?(attr_name, **options)

Alias for attribute_changed?

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 88
      def will_save_change_to_attribute?(attr_name, **options)
        mutations_from_database.changed?(attr_name, **options)
      end
🔎 See on GitHub