module ActiveRecord::AttributeMethods::Dirty

Public Instance Methods

attribute_before_last_save(attr_name) click to toggle source

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

# File lib/active_record/attribute_methods/dirty.rb, line 72
def attribute_before_last_save(attr_name)
  mutations_before_last_save.original_value(attr_name)
end
attribute_change_to_be_saved(attr_name) click to toggle source

Alias for attribute_change

# File lib/active_record/attribute_methods/dirty.rb, line 92
def attribute_change_to_be_saved(attr_name)
  mutations_from_database.change_to_attribute(attr_name)
end
attribute_in_database(attr_name) click to toggle source

Alias for attribute_was

# File lib/active_record/attribute_methods/dirty.rb, line 97
def attribute_in_database(attr_name)
  mutations_from_database.original_value(attr_name)
end
attributes_in_database() click to toggle source

Alias for changed_attributes

# File lib/active_record/attribute_methods/dirty.rb, line 117
def attributes_in_database
  mutations_from_database.changed_values
end
changed_attribute_names_to_save() click to toggle source

Alias for changed

# File lib/active_record/attribute_methods/dirty.rb, line 112
def changed_attribute_names_to_save
  mutations_from_database.changed_attribute_names
end
changes_to_save() click to toggle source

Alias for changes

# File lib/active_record/attribute_methods/dirty.rb, line 107
def changes_to_save
  mutations_from_database.changes
end
has_changes_to_save?() click to toggle source

Alias for changed?

# File lib/active_record/attribute_methods/dirty.rb, line 102
def has_changes_to_save?
  mutations_from_database.any_changes?
end
reload(*) click to toggle source

reload the record and clears changed attributes.

Calls superclass method
# File lib/active_record/attribute_methods/dirty.rb, line 29
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
saved_change_to_attribute(attr_name) click to toggle source

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")

# File lib/active_record/attribute_methods/dirty.rb, line 64
def saved_change_to_attribute(attr_name)
  mutations_before_last_save.change_to_attribute(attr_name)
end
saved_change_to_attribute?(attr_name, **options) click to toggle source

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

# File lib/active_record/attribute_methods/dirty.rb, line 51
def saved_change_to_attribute?(attr_name, **options)
  mutations_before_last_save.changed?(attr_name, **options)
end
saved_changes() click to toggle source

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

# File lib/active_record/attribute_methods/dirty.rb, line 82
def saved_changes
  mutations_before_last_save.changes
end
saved_changes?() click to toggle source

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

# File lib/active_record/attribute_methods/dirty.rb, line 77
def saved_changes?
  mutations_before_last_save.any_changes?
end
will_save_change_to_attribute?(attr_name, **options) click to toggle source

Alias for attribute_changed?

# File lib/active_record/attribute_methods/dirty.rb, line 87
def will_save_change_to_attribute?(attr_name, **options)
  mutations_from_database.changed?(attr_name, **options)
end

Private Instance Methods

_create_record(*) click to toggle source
Calls superclass method
# File lib/active_record/attribute_methods/dirty.rb, line 138
def _create_record(*)
  id = partial_writes? ? super(keys_for_partial_write) : super
  changes_applied
  id
end
_update_record(*) click to toggle source
Calls superclass method
# File lib/active_record/attribute_methods/dirty.rb, line 132
def _update_record(*)
  affected_rows = partial_writes? ? super(keys_for_partial_write) : super
  changes_applied
  affected_rows
end
keys_for_partial_write() click to toggle source
# File lib/active_record/attribute_methods/dirty.rb, line 144
def keys_for_partial_write
  changed_attribute_names_to_save & self.class.column_names
end
write_attribute_without_type_cast(attr_name, value) click to toggle source
Calls superclass method
# File lib/active_record/attribute_methods/dirty.rb, line 122
def write_attribute_without_type_cast(attr_name, value)
  name = attr_name.to_s
  if self.class.attribute_alias?(name)
    name = self.class.attribute_alias(name)
  end
  result = super(name, value)
  clear_attribute_change(name)
  result
end