# Copyright (C) 2009, Tutorius.org
# Copyright (C) 2009, Jean-Christophe Savard <savard.jean.christophe@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


"""
This module contains all the data handling class of Tutorius  
"""

import logging
import linecache
import os

from sugar.tutorius import gtkutils, overlayer
from sugar.tutorius.core import Tutorial, State, FiniteStateMachine
from sugar.tutorius.actions import DialogMessage, OnceWrapper, BubbleMessage
from sugar.tutorius.filters import GtkWidgetEventFilter, TimerEvent

class TutorialStore:
        
    def list_avaible_tutorials(self, activity_name):
        """
        Recuperate the list of all tutorials present on disk for a
        given activity.
        """
        NotImplementedError
    

class Serializer:
    """
    Class that provide serializing and deserializing of the FSM
    used in the tutorials to/from disk.
    """
    
    def save_fsm(self,fsm):
        """
        Save fsm to disk.
        """
        NotImplementedError
        
    def load_fsm(self, guid):
        """
        Load fsm from disk.
        """
        NotImplementedError
        
class XMLSerializer(Serializer):
    """
    Class that provide serializing and deserializing of the FSM
    used in the tutorials to/from a xml file.
    """
    
    def save_fsm(self,fsm):
        """
        Save fsm to .xml file
        """
        NotImplementedError

    
    def load_fsm(self, guid):
        """
        Load fsm from xml file who .ini file guid match argument guid.
        """
        NotImplementedError
        
        
class TutorialBundler:
    """
    This class provide the various data handling methods useable by the tutorial
    editor.
    """
    
    def write_metadata_file(data):
        """
        Write metadata to a .ini file.
        """
        NotImplementedError
    
    def write_fsm(fsm):
        """
        Write fsm to disk.
        """
        NotImplementedError
        
    def add_resources(typename, file):
        """
        Add ressources to metadata.
        """
        NotImplementedError