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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
module Mocha
# A state machine that is used to constrain the order of invocations.
# An invocation can be constrained to occur when a state {#is}, or {#is_not}, active.
class StateMachine
# Provides a mechanism to change the state of a {StateMachine} at some point in the future.
class State
# @private
def initialize(state_machine, state)
@state_machine, @state = state_machine, state
end
# @private
def activate
@state_machine.current_state = @state
end
# @private
def active?
@state_machine.current_state == @state
end
# @private
def mocha_inspect
"#{@state_machine.name} is #{@state.mocha_inspect}"
end
end
# Provides the ability to determine whether a {StateMachine} is in a specified state at some point in the future.
class StatePredicate
# @private
def initialize(state_machine, state)
@state_machine, @state = state_machine, state
end
# @private
def active?
@state_machine.current_state != @state
end
# @private
def mocha_inspect
"#{@state_machine.name} is not #{@state.mocha_inspect}"
end
end
# @private
attr_reader :name
# @private
attr_accessor :current_state
# @private
def initialize(name)
@name = name
@current_state = nil
end
# Put the {StateMachine} into the state specified by +initial_state_name+.
#
# @param [String] initial_state_name name of initial state
# @return [StateMachine] state machine, thereby allowing invocations of other {StateMachine} methods to be chained.
def starts_as(initial_state_name)
become(initial_state_name)
self
end
# Put the {StateMachine} into the +next_state_name+.
#
# @param [String] next_state_name name of new state
def become(next_state_name)
@current_state = next_state_name
end
# Provides a mechanism to change the {StateMachine} into the state specified by +state_name+ at some point in the future.
#
# Or provides a mechanism to determine whether the {StateMachine} is in the state specified by +state_name+ at some point in the future.
#
# @param [String] state_name name of new state
# @return [State] state which, when activated, will change the {StateMachine} into the state with the specified +state_name+.
def is(state_name)
State.new(self, state_name)
end
# Provides a mechanism to determine whether the {StateMachine} is not in the state specified by +state_name+ at some point in the future.
def is_not(state_name)
StatePredicate.new(self, state_name)
end
# @private
def mocha_inspect
if @current_state
"#{@name} is #{@current_state.mocha_inspect}"
else
"#{@name} has no current state"
end
end
end
end
|
