From 5cdfcba9e827c2acf7dbad7890e8fcea241714a8 Mon Sep 17 00:00:00 2001
From: mike <michael.jmontcalm@gmail.com>
Date: Wed, 04 Mar 2009 18:57:27 +0000
Subject: TutoriusV1 : Adding basic State tests, cleaned some code bits lying

around
---
(limited to 'src/sugar/tutorius/tests/coretests.py')

diff --git a/src/sugar/tutorius/tests/coretests.py b/src/sugar/tutorius/tests/coretests.py
new file mode 100644
index 0000000..8c9a194
--- /dev/null
+++ b/src/sugar/tutorius/tests/coretests.py
@@ -0,0 +1,137 @@
+# Copyright (C) 2009, Tutorius.org
+# Copyright (C) 2009, Michael Janelle-Montcalm <michael.jmontcalm@gmail.com>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+"""
+Core Tests
+
+This module contains all the tests that pertain to the usage of the Tutorius
+Core. This means that the Event Filters, the Finite State Machine and all the 
+related elements and interfaces are tested here.
+
+"""
+
+import unittest
+
+import logging
+from sugar.tutorius.actions import Action
+from sugar.tutorius.core import *
+from sugar.tutorius.filters import *
+
+# Helper classes to help testing
+class SimpleTutorial(Tutorial):
+    """
+    Fake tutorial
+    """
+    def __init__(self, start_name="INIT"):
+        #Tutorial.__init__(self, "Simple Tutorial", None)
+        self.current_state_name = start_name
+        self.activity = "TODO : This should be an activity"
+    
+    def set_state(self, name):
+        self.current_state_name = name
+
+class TrueWhileActiveAction(Action):
+    """
+    This action's active member is set to True after a do and to False after
+    an undo.
+    
+    Used to verify that a State correctly triggers the do and undo actions.
+    """
+    def __init__(self):
+        self.active = False
+        
+    def do(self):
+        self.active = True
+        
+    def undo(self):
+        self.active = False
+
+class TriggerEventFilter(EventFilter):
+    """
+    This event filter can be triggered by simply calling its execute function.
+    
+    Used to fake events and see the effect on the FSM.
+    """
+    def __init__(self, next_state):
+        EventFilter.__init__(self, next_state)
+        self.toggle_on_callback = False
+    
+    def install_handlers(self, callback, **kwargs):
+        """
+        Forsakes the incoming callback function and just set the inner one.
+        """
+        self._callback = self._inner_cb
+    
+    def _inner_cb(self, event_filter):
+        self.toggle_on_callback = not self.toggle_on_callback
+
+# State testing class
+class StateTest(unittest.TestCase):
+    """
+    This class has to test the State interface as well as the expected 
+    functionality.
+    """
+    
+    def test_action_toggle(self):
+        """
+        Validate that the actions are properly done on setup and undone on
+        teardown.
+        
+        Pretty awesome.
+        """
+        act = TrueWhileActiveAction()
+        
+        state = State("action_test", action_list=[act])
+        
+        assert act.active == False, "Action is not initialized properly"
+        
+        state.setup()
+        
+        assert act.active == True, "Action was not triggered properly"
+        
+        state.teardown()
+        
+        assert act.active == False, "Action was not undone properly"
+    
+    def test_event_filter(self):
+        """
+        Tests the fact that the event filters are correctly installed on setup
+        and uninstalled on teardown.
+        """
+        event_filter = TriggerEventFilter("second_state")
+        
+        state = State("event_test", event_filter_list=[event_filter])
+        state.set_tutorial(SimpleTutorial())
+        
+        assert event_filter.toggle_on_callback == False, "Wrong init of event_filter"
+        assert event_filter._callback == None, "Event filter has a registered callback before installing handlers"
+        
+        state.setup()
+        
+        assert event_filter._callback != None, "Event filter did not register callback!"
+        
+        # 'Trigger' the event - This is more like a EventFilter test.
+        event_filter.do_callback()
+        
+        assert event_filter.toggle_on_callback == True, "Event filter did not execute callback"
+        
+        state.teardown()
+        
+        assert event_filter._callback == None, "Event filter did not remove callback properly"
+    
+    
+if __name__ == "__main__":
+    unittest.main()
\ No newline at end of file
--
cgit v0.9.1