mirror of
https://github.com/avatao-content/baseimage-tutorial-framework
synced 2024-11-05 16:31:21 +00:00
69 lines
2.2 KiB
Python
69 lines
2.2 KiB
Python
# Copyright (C) 2018 Avatao.com Innovative Learning Kft.
|
|
# All Rights Reserved. See LICENSE file for details.
|
|
|
|
from collections import defaultdict
|
|
|
|
from transitions import Machine, MachineError
|
|
|
|
from tfw.mixins import CallbackMixin
|
|
from tfw.config.logs import logging
|
|
|
|
LOG = logging.getLogger(__name__)
|
|
|
|
|
|
class FSMBase(Machine, CallbackMixin):
|
|
"""
|
|
A general FSM base class you can inherit from to track user progress.
|
|
See linear_fsm.py for an example use-case.
|
|
TFW uses the transitions library for state machines, please refer to their
|
|
documentation for more information on creating your own machines:
|
|
https://github.com/pytransitions/transitions
|
|
"""
|
|
states, transitions = [], []
|
|
|
|
def __init__(self, initial=None, accepted_states=None):
|
|
self.accepted_states = accepted_states or [self.states[-1].name]
|
|
self.trigger_predicates = defaultdict(list)
|
|
self.trigger_history = []
|
|
|
|
Machine.__init__(
|
|
self,
|
|
states=self.states,
|
|
transitions=self.transitions,
|
|
initial=initial or self.states[0],
|
|
send_event=True,
|
|
ignore_invalid_triggers=True,
|
|
after_state_change='execute_callbacks'
|
|
)
|
|
|
|
def execute_callbacks(self, event_data):
|
|
self._execute_callbacks(event_data.kwargs)
|
|
|
|
def is_solved(self):
|
|
return self.state in self.accepted_states # pylint: disable=no-member
|
|
|
|
def subscribe_predicate(self, trigger, *predicates):
|
|
self.trigger_predicates[trigger].extend(predicates)
|
|
|
|
def unsubscribe_predicate(self, trigger, *predicates):
|
|
self.trigger_predicates[trigger] = [
|
|
predicate
|
|
for predicate in self.trigger_predicates[trigger]
|
|
not in predicates
|
|
]
|
|
|
|
def step(self, trigger):
|
|
predicate_results = (
|
|
predicate()
|
|
for predicate in self.trigger_predicates[trigger]
|
|
)
|
|
|
|
if all(predicate_results):
|
|
try:
|
|
self.trigger(trigger)
|
|
self.trigger_history.append(trigger)
|
|
return True
|
|
except (AttributeError, MachineError):
|
|
LOG.debug('FSM failed to execute nonexistent trigger: "%s"', trigger)
|
|
return False
|