summaryrefslogtreecommitdiffstats
path: root/lib/puppet/transaction/change.rb
blob: b710ee08df22574dd4bb467757ac7451fcefc608 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
require 'puppet/transaction'
require 'puppet/transaction/event'

# Handle all of the work around performing an actual change,
# including calling 'sync' on the properties and producing events.
class Puppet::Transaction::Change
    attr_accessor :is, :should, :path, :property, :changed, :proxy

    # Switch the goals of the property, thus running the change in reverse.
    def backward
        @is, @should = @should, @is
        @property.should = @should

        @property.info "Reversing %s" % self
        return self.go
    end

    def changed?
        self.changed
    end

    # Create our event object.
    def event(name)
        # default to a simple event type
        unless name.is_a?(Symbol)
            @property.warning("Property '%s' returned invalid event '%s'; resetting to default" %
                [@property.class, name])

            name = @property.event(should)
        end

        Puppet::Transaction::Event.new(name, self.resource)
    end

    def initialize(property, currentvalue)
        @property = property
        @path = [property.path,"change"].flatten
        @is = currentvalue

        @should = property.should

        @changed = false
    end

    # Perform the actual change.  This method can go either forward or
    # backward, and produces an event.
    def go
        if self.noop?
            @property.log "is %s, should be %s (noop)" % [property.is_to_s(@is), property.should_to_s(@should)]
            return [event(:noop)]
        end

        # The transaction catches any exceptions here.
        events = @property.sync
        if events.nil?
            events = [(@property.name.to_s + "_changed").to_sym]
        elsif events.is_a?(Array)
            if events.empty?
                events = [(@property.name.to_s + "_changed").to_sym]
            end
        else
            events = [events]
        end

        return events.collect { |name|
            @report = @property.log(@property.change_to_s(@is, @should))
            event(name)
        }
    end

    def forward
        return self.go
    end

    # Is our property noop?  This is used for generating special events.
    def noop?
        return @property.noop
    end

    # The resource that generated this change.  This is used for handling events,
    # and the proxy resource is used for generated resources, since we can't
    # send an event to a resource we don't have a direct relationship.  If we
    # have a proxy resource, then the events will be considered to be from
    # that resource, rather than us, so the graph resolution will still work.
    def resource
        self.proxy || @property.resource
    end

    def to_s
        return "change %s" % @property.change_to_s(@is, @should)
    end
end