Module: VestalVersions::Reversion::InstanceMethods

Defined in:
lib/vestal_versions/reversion.rb

Overview

Provides the base instance methods required to revert a versioned instance.

Instance Method Summary collapse

Instance Method Details

#revert_to(value) ⇒ Object

Accepts a value corresponding to a specific version record, builds a history of changes between that version and the current version, and then iterates over that history updating the object’s attributes until the it’s reverted to its prior state.

The single argument should adhere to one of the formats as documented in the at method of VestalVersions::Versions.

After the object is reverted to the target version, it is not saved. In order to save the object after the reversion, use the revert_to! method.

The version number of the object will reflect whatever version has been reverted to, and the return value of the revert_to method is also the target version number.



29
30
31
32
33
34
35
36
37
38
39
40
41
# File 'lib/vestal_versions/reversion.rb', line 29

def revert_to(value)
  self.class.reflections.each do |association, reflection|
    self.send(association).reset if reflection.macro == :has_many
  end
  
  to_number = versions.number_at(value)

  changes_between(version, to_number).each do |attribute, change|
    write_attribute(attribute, change.last)
  end
  
  reset_version(to_number)
end

#revert_to!(value) ⇒ Object

Behaves similarly to the revert_to method except that it automatically saves the record after the reversion. The return value is the success of the save.



45
46
47
48
49
# File 'lib/vestal_versions/reversion.rb', line 45

def revert_to!(value)
  revert_to(value)
  reset_version if saved = save
  saved
end

#reverted?Boolean

Returns a boolean specifying whether the object has been reverted to a previous version or if the object represents the latest version in the version history.

Returns:

  • (Boolean)


53
54
55
# File 'lib/vestal_versions/reversion.rb', line 53

def reverted?
  version != last_version
end

#versionObject

Returns the current version number for the versioned object.



13
14
15
# File 'lib/vestal_versions/reversion.rb', line 13

def version
  @version ||= last_version
end