Active Record Attribute Methods Dirty

Provides a way to track changes in your Active Record models. It adds all methods from ActiveModel::Dirty and adds database specific methods.

A newly created Person object is unchanged:

class Person < ActiveRecord::Base
end

person = Person.create(name: "Alisson")
person.changed? # => false

Change the name:

person.name = 'Alice'
person.name_in_database          # => "Allison"
person.will_save_change_to_name? # => true
person.name_change_to_be_saved   # => ["Allison", "Alice"]
person.changes_to_save           # => {"name"=>["Allison", "Alice"]}

Save the changes:

person.save
person.name_in_database        # => "Alice"
person.saved_change_to_name?   # => true
person.saved_change_to_name    # => ["Allison", "Alice"]
person.name_before_last_change # => "Allison"

Similar to ActiveModel::Dirty, methods can be invoked as saved_change_to_name? or by passing an argument to the generic method saved_change_to_attribute?("name").

Methods

Included Modules

Instance Public methods

attribute_before_last_save(attr_name)

Returns the original value of an attribute before the last save.

This method is useful in after callbacks to get the original value of an attribute before the save that triggered the callbacks to run. It can be invoked as name_before_last_save instead of attribute_before_last_save("name").

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

attribute_change_to_be_saved(attr_name)

Returns the change to an attribute that will be persisted during the next save.

This method is useful in validations and before callbacks, to see the change to an attribute that will occur when the record is saved. It can be invoked as name_change_to_be_saved instead of attribute_change_to_be_saved("name").

If the attribute will change, the result will be an array containing the original value and the new value about to be saved.

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

attribute_in_database(attr_name)

Returns the value of an attribute in the database, as opposed to the in-memory value that will be persisted the next time the record is saved.

This method is useful in validations and before callbacks, to see the original value of an attribute prior to any changes about to be saved. It can be invoked as name_in_database instead of attribute_in_database("name").

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

attributes_in_database()

Returns a hash of the attributes that will change when the record is next saved.

The hash keys are the attribute names, and the hash values are the original attribute values in the database (as opposed to the in-memory values about to be saved).

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

changed_attribute_names_to_save()

Returns an array of the names of any attributes that will change when the record is next saved.

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

changes_to_save()

Returns a hash containing all the changes that will be persisted during the next save.

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

has_changes_to_save?()

Will the next call to save have any changes to persist?

📝 Source code 
# File activerecord/lib/active_record/attribute_methods/dirty.rb, line 165
      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 63
      def reload(*)
        super.tap do
          @mutations_before_last_save = nil
          @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.

This method is useful in after callbacks, to see the change in an attribute during the save that triggered the callbacks to run. It can be invoked as saved_change_to_name instead of saved_change_to_attribute("name").

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

saved_change_to_attribute?(attr_name, **options)

Did this attribute change when we last saved?

This method is useful in after callbacks to determine if an attribute was changed during the save that triggered the callbacks to run. It can be invoked as saved_change_to_name? instead of saved_change_to_attribute?("name").

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 84
      def saved_change_to_attribute?(attr_name, **options)
        mutations_before_last_save.changed?(attr_name.to_s, **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 116
      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 111
      def saved_changes?
        mutations_before_last_save.any_changes?
      end
🔎 See on GitHub

will_save_change_to_attribute?(attr_name, **options)

Will this attribute change the next time we save?

This method is useful in validations and before callbacks to determine if the next call to save will change a particular attribute. It can be invoked as will_save_change_to_name? instead of will_save_change_to_attribute?("name").

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 will be changed to the given value

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