import threading
import time
-from . import debug_print
+from transitions.extensions import HierarchicalMachine as Machine
+from . import debug_print, error_print
class Action:
- action_types = [
+ ACTION_TYPES = [
'command',
'interrupt_wait',
'pause',
'wait',
]
+ STATES = [
+ 'initial',
+ 'loading',
+ 'failed',
+ {
+ 'name': 'loaded',
+ 'children': ['running']
+ }
+ ]
+
+ TRANSITIONS = [
+ {
+ 'trigger': 'load',
+ 'source': 'initial',
+ 'dest': 'loading'
+ },
+ {
+ 'trigger': 'fail',
+ 'source': 'loading',
+ 'dest': 'failed'
+ },
+ {
+ 'trigger': 'success',
+ 'source': 'loading',
+ 'dest': 'loaded'
+ },
+ {
+ 'trigger': 'run',
+ 'source': 'loaded',
+ 'dest': 'loaded_running',
+ 'after': 'finish_action'
+ },
+ {
+ 'trigger': 'interrupt',
+ 'source': 'loaded_running',
+ 'dest': 'loaded',
+ 'before': 'trigger_interrupt'
+ },
+ {
+ 'trigger': 'finish_action',
+ 'source': 'loaded_running',
+ 'dest': 'loaded'
+ }
+ ]
+
def __init__(self, action, key, **kwargs):
- if action in self.action_types:
- self.action = action
- else:
- raise Exception("Unknown action {}".format(action))
+ Machine(model=self, states=self.STATES,
+ transitions=self.TRANSITIONS, initial='initial',
+ ignore_invalid_triggers=True, queued=True)
+ self.action = action
self.key = key
self.mapping = key.parent
self.arguments = kwargs
self.sleep_event = None
+ self.waiting_music = None
+ self.load()
def ready(self):
- if 'music' in self.arguments:
- return self.arguments['music'].is_loaded(allow_substates=True)
+ return self.is_loaded(allow_substates=True)
+
+ def callback_loaded(self, success):
+ if success:
+ self.success()
+ else:
+ self.fail()
+
+ # Machine states / events
+ def on_enter_loading(self):
+ if self.action in self.ACTION_TYPES:
+ if 'music' in self.arguments:
+ self.arguments['music'].subscribe_loaded(self.callback_loaded)
+ else:
+ self.success()
else:
- return True
+ error_print("Unknown action {}".format(self.action))
+ self.fail()
+
- def run(self):
+ def on_enter_loaded_running(self):
debug_print(self.description())
getattr(self, self.action)(**self.arguments)
- def description(self):
- return getattr(self, self.action + "_print")(**self.arguments)
-
- def interrupt(self):
+ def trigger_interrupt(self):
if getattr(self, self.action + "_interrupt", None):
return getattr(self, self.action + "_interrupt")(**self.arguments)
+ # Helpers
def music_list(self, music):
if music is not None:
return [music]
else:
return self.mapping.open_files.values()
+ def description(self):
+ if getattr(self, self.action + "_print", None):
+ return getattr(self, self.action + "_print")(**self.arguments)
+ else:
+ return "unknown action {}".format(self.action)
+
# Actions
def command(self, command="", **kwargs):
# FIXME: todo
music.stop(fade_out=fade_out)
if previous is not None:
+ self.waiting_music = previous
previous.stop(
fade_out=fade_out,
wait=wait,
return message
- # Interruptions
+ # Interruptions (only for non-"atomic" actions)
def wait_interrupt(self, duration=0, music=None, **kwargs):
if self.sleep_event is not None:
self.sleep_event.set()
if music is not None:
music.wait_event.set()
+ def stop_interrupt(self, music=None, fade_out=0, wait=False,
+ set_wait_id=None, **kwargs):
+ if self.waiting_music is not None:
+ self.waiting_music.wait_event.set()
{
'trigger': 'load',
'source': 'initial',
- 'dest': 'loading'
+ 'dest': 'loading',
+ 'after': 'poll_loaded'
},
{
'trigger': 'fail',
'trigger': 'stopped',
'source': '*',
'dest': 'loaded',
- 'before': 'trigger_stopped_events'
+ 'before': 'trigger_stopped_events',
+ 'conditions': ['is_in_use']
}
]
transitions=self.TRANSITIONS, initial='initial',
ignore_invalid_triggers=True)
+ self.loaded_callbacks = []
self.mapping = mapping
self.filename = filename
self.name = name or filename
self.wait_event.clear()
self.wait_event.wait()
+ # Let other subscribe for an event when they are ready
+ def subscribe_loaded(self, callback):
+ with file_lock:
+ if self.is_loaded(allow_substates=True):
+ callback(True)
+ elif self.is_failed():
+ callback(False)
+ else:
+ self.loaded_callbacks.append(callback)
+
+ def poll_loaded(self):
+ for callback in self.loaded_callbacks:
+ callback(self.is_loaded())
+ self.loaded_callbacks = []
+
# Callbacks
def finished_callback(self):
self.stopped()