]>
Commit | Line | Data |
---|---|---|
1 | from kivy.uix.widget import Widget | |
2 | from kivy.properties import AliasProperty, BooleanProperty, \ | |
3 | ListProperty, StringProperty | |
4 | from kivy.uix.behaviors import ButtonBehavior | |
5 | ||
6 | from .action import Action | |
7 | from .helpers import debug_print | |
8 | import time | |
9 | import threading | |
10 | from transitions.extensions import HierarchicalMachine as Machine | |
11 | ||
12 | class Key(ButtonBehavior, Widget): | |
13 | STATES = [ | |
14 | 'initial', | |
15 | 'configuring', | |
16 | 'configured', | |
17 | 'loading', | |
18 | 'failed', | |
19 | { | |
20 | 'name': 'loaded', | |
21 | 'children': [ | |
22 | 'no_config', | |
23 | 'no_actions', | |
24 | 'running', | |
25 | 'protecting_repeat' | |
26 | ] | |
27 | } | |
28 | ] | |
29 | ||
30 | TRANSITIONS = [ | |
31 | { | |
32 | 'trigger': 'configure', | |
33 | 'source': 'initial', | |
34 | 'dest': 'configuring' | |
35 | }, | |
36 | { | |
37 | 'trigger': 'fail', | |
38 | 'source': 'configuring', | |
39 | 'dest': 'failed', | |
40 | 'after': 'key_loaded_callback' | |
41 | }, | |
42 | { | |
43 | 'trigger': 'success', | |
44 | 'source': 'configuring', | |
45 | 'dest': 'configured', | |
46 | 'after': 'load' | |
47 | }, | |
48 | { | |
49 | 'trigger': 'no_config', | |
50 | 'source': 'configuring', | |
51 | 'dest': 'loaded_no_config', | |
52 | 'after': 'key_loaded_callback' | |
53 | }, | |
54 | { | |
55 | 'trigger': 'load', | |
56 | 'source': 'configured', | |
57 | 'dest': 'loading' | |
58 | }, | |
59 | { | |
60 | 'trigger': 'fail', | |
61 | 'source': 'loading', | |
62 | 'dest': 'failed', | |
63 | 'after': 'key_loaded_callback' | |
64 | }, | |
65 | { | |
66 | 'trigger': 'success', | |
67 | 'source': 'loading', | |
68 | 'dest': 'loaded', | |
69 | 'after': 'key_loaded_callback' | |
70 | }, | |
71 | { | |
72 | 'trigger': 'no_actions', | |
73 | 'source': 'loading', | |
74 | 'dest': 'loaded_no_actions', | |
75 | 'after': 'key_loaded_callback' | |
76 | }, | |
77 | { | |
78 | 'trigger': 'reload', | |
79 | 'source': ['loaded','failed'], | |
80 | 'dest': 'configuring', | |
81 | 'after': 'key_loaded_callback' | |
82 | }, | |
83 | { | |
84 | 'trigger': 'run', | |
85 | 'source': 'loaded', | |
86 | 'dest': 'loaded_running', | |
87 | 'after': ['run_actions', 'finish'], | |
88 | # if a child, like loaded_no_actions, has no transitions, then it | |
89 | # is bubbled to the parent, and we don't want that. | |
90 | 'conditions': ['is_loaded'] | |
91 | }, | |
92 | { | |
93 | 'trigger': 'finish', | |
94 | 'source': 'loaded_running', | |
95 | 'dest': 'loaded_protecting_repeat' | |
96 | }, | |
97 | { | |
98 | 'trigger': 'repeat_protection_finished', | |
99 | 'source': 'loaded_protecting_repeat', | |
100 | 'dest': 'loaded' | |
101 | }, | |
102 | ] | |
103 | ||
104 | key_sym = StringProperty(None) | |
105 | custom_color = ListProperty([0, 1, 0]) | |
106 | description_title = StringProperty("") | |
107 | description = ListProperty([]) | |
108 | state = StringProperty("") | |
109 | ||
110 | def get_alias_line_cross_color(self): | |
111 | if not self.is_failed() and ( | |
112 | not self.is_loaded(allow_substates=True)\ | |
113 | or self.is_loaded_running()\ | |
114 | or self.is_loaded_protecting_repeat()): | |
115 | return [120/255, 120/255, 120/255, 1] | |
116 | else: | |
117 | return [0, 0, 0, 0] | |
118 | ||
119 | def set_alias_line_cross_color(self): | |
120 | pass | |
121 | ||
122 | line_cross_color = AliasProperty( | |
123 | get_alias_line_cross_color, | |
124 | set_alias_line_cross_color, | |
125 | bind=['state']) | |
126 | ||
127 | def get_alias_line_color(self): | |
128 | if self.is_loaded_running(): | |
129 | return [0, 0, 0, 1] | |
130 | else: | |
131 | return [120/255, 120/255, 120/255, 1] | |
132 | ||
133 | def set_alias_line_color(self): | |
134 | pass | |
135 | ||
136 | line_color = AliasProperty(get_alias_line_color, set_alias_line_color, | |
137 | bind=['state']) | |
138 | ||
139 | def get_alias_color(self): | |
140 | if self.is_loaded_inactive(): | |
141 | return [1, 1, 1, 1] | |
142 | elif self.is_loaded_protecting_repeat(): | |
143 | return [*self.custom_color, 100/255] | |
144 | elif self.is_loaded_running(): | |
145 | return [*self.custom_color, 100/255] | |
146 | elif self.is_loaded(allow_substates=True): | |
147 | return [*self.custom_color, 1] | |
148 | elif self.is_failed(): | |
149 | return [0, 0, 0, 1] | |
150 | else: | |
151 | return [*self.custom_color, 100/255] | |
152 | def set_alias_color(self): | |
153 | pass | |
154 | ||
155 | color = AliasProperty(get_alias_color, set_alias_color, | |
156 | bind=['state', 'custom_color']) | |
157 | ||
158 | def __init__(self, **kwargs): | |
159 | self.actions = [] | |
160 | self.current_action = None | |
161 | ||
162 | Machine(model=self, states=self.STATES, | |
163 | transitions=self.TRANSITIONS, initial='initial', | |
164 | ignore_invalid_triggers=True, queued=True) | |
165 | super(Key, self).__init__(**kwargs) | |
166 | ||
167 | # Kivy events | |
168 | def on_key_sym(self, key, key_sym): | |
169 | if key_sym != "": | |
170 | self.configure() | |
171 | ||
172 | def on_press(self): | |
173 | self.list_actions() | |
174 | ||
175 | # Machine states / events | |
176 | def is_loaded_or_failed(self): | |
177 | return self.is_loaded(allow_substates=True) or self.is_failed() | |
178 | ||
179 | def is_loaded_inactive(self): | |
180 | return self.is_loaded_no_config() or self.is_loaded_no_actions() | |
181 | ||
182 | def on_enter_configuring(self): | |
183 | if self.key_sym in self.parent.key_config: | |
184 | self.config = self.parent.key_config[self.key_sym] | |
185 | ||
186 | self.actions = [] | |
187 | for key_action in self.config['actions']: | |
188 | self.add_action(key_action[0], **key_action[1]) | |
189 | ||
190 | if 'description' in self.config['properties']: | |
191 | self.set_description(self.config['properties']['description']) | |
192 | if 'color' in self.config['properties']: | |
193 | self.set_color(self.config['properties']['color']) | |
194 | self.success() | |
195 | else: | |
196 | self.no_config() | |
197 | ||
198 | def on_enter_loading(self): | |
199 | if len(self.actions) > 0: | |
200 | for action in self.actions: | |
201 | action.load() | |
202 | else: | |
203 | self.no_actions() | |
204 | ||
205 | def run_actions(self, modifiers): | |
206 | self.parent.parent.ids['KeyList'].append(self.key_sym) | |
207 | debug_print("running actions for {}".format(self.key_sym)) | |
208 | start_time = time.time() | |
209 | self.parent.start_running(self, start_time) | |
210 | for self.current_action in self.actions: | |
211 | if self.parent.keep_running(self, start_time): | |
212 | self.list_actions() | |
213 | self.current_action.run(start_time) | |
214 | self.list_actions(last_action_finished=True) | |
215 | ||
216 | self.parent.finished_running(self, start_time) | |
217 | ||
218 | def on_enter_loaded_protecting_repeat(self, modifiers): | |
219 | if 'repeat_delay' in self.config['properties']: | |
220 | self.protecting_repeat_timer = threading.Timer( | |
221 | self.config['properties']['repeat_delay'], | |
222 | self.repeat_protection_finished) | |
223 | self.protecting_repeat_timer.start() | |
224 | else: | |
225 | self.repeat_protection_finished() | |
226 | ||
227 | # This one cannot be in the Machine state since it would be queued to run | |
228 | # *after* the loop is ended... | |
229 | def interrupt(self): | |
230 | self.current_action.interrupt() | |
231 | ||
232 | # Callbacks | |
233 | def key_loaded_callback(self): | |
234 | self.parent.key_loaded_callback() | |
235 | ||
236 | def callback_action_ready(self, action, success): | |
237 | if not success: | |
238 | self.fail() | |
239 | elif all(action.is_loaded_or_failed() for action in self.actions): | |
240 | self.success() | |
241 | ||
242 | # Setters | |
243 | def set_description(self, description): | |
244 | if description[0] is not None: | |
245 | self.description_title = str(description[0]) | |
246 | self.description = [] | |
247 | for desc in description[1 :]: | |
248 | if desc is None: | |
249 | self.description.append("") | |
250 | else: | |
251 | self.description.append(str(desc).replace(" ", " ")) | |
252 | ||
253 | def set_color(self, color): | |
254 | color = [x / 255 for x in color] | |
255 | self.custom_color = color | |
256 | ||
257 | # Actions handling | |
258 | def add_action(self, action_name, **arguments): | |
259 | self.actions.append(Action(action_name, self, **arguments)) | |
260 | ||
261 | def list_actions(self, last_action_finished=False): | |
262 | not_running = (not self.is_loaded_running()) | |
263 | current_action_seen = False | |
264 | action_descriptions = [] | |
265 | for action in self.actions: | |
266 | if not_running: | |
267 | state = "inactive" | |
268 | elif last_action_finished: | |
269 | state = "done" | |
270 | elif current_action_seen: | |
271 | state = "pending" | |
272 | elif action == self.current_action: | |
273 | current_action_seen = True | |
274 | state = "current" | |
275 | else: | |
276 | state = "done" | |
277 | action_descriptions.append([action.description(), state]) | |
278 | self.parent.parent.ids['ActionList'].update_list( | |
279 | self, | |
280 | action_descriptions) |