src/KERNEL_PY/kernel/__init__.py

   1 # -*- coding: iso-8859-1 -*-
   2 # Copyright (C) 2007-2014  CEA/DEN, EDF R&D, OPEN CASCADE
   3 #
   4 # This library is free software; you can redistribute it and/or
   5 # modify it under the terms of the GNU Lesser General Public
   6 # License as published by the Free Software Foundation; either
   7 # version 2.1 of the License, or (at your option) any later version.
   8 #
   9 # This library is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12 # Lesser General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU Lesser General Public
  15 # License along with this library; if not, write to the Free Software
  16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  17 #
  18 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  19 #
  20
  21 ## \defgroup salome_kernel salome.kernel
  22 #  \{
  23 #  \details Package containing the KERNEL python utilities
  24 #  \defgroup deprecation
  25 #  \defgroup termcolor
  26 #  \defgroup logger
  27 #  \defgroup enumerate
  28 #  \defgroup uiexception
  29 #  \defgroup datamodeler
  30 #  \defgroup diclookup
  31 #  \defgroup service
  32 #  \defgroup studyedit
  33 #  \defgroup unittester
  34 #  \defgroup pyunittester
  35 #  \}
  36
  37 __all__ = [ "deprecation", "logger", "termcolor", "logconfig" ]
  38
  39 # WARN: This file SHOULD NOT import salome stuff so that modules of the
  40 # package could be used outside of a SALOME session context when
  41 # possible. For example logger.py, datamodeler.py, enumerate.py,
  42 # diclookup.py, ... does not need a SALOME running application.
  43
  44 #
  45 # ==============================================================================
  46 # Generic serialization functions for the module datamodeler
  47 # ==============================================================================
  48 #
  49 import pickle
  50
  51 def serialize(dataToSerialize):
  52     """
  53     Creates a string description of the specified data.
  54     .. attribute:: dataToSerialize
  55     a data object to serialize
  56     """
  57     serialstring = pickle.dumps(dataToSerialize)
  58     return serialstring
  59
  60 def unserialize(stringToUnserialize):
  61     """
  62     Creates a data object from its string description. The string description
  63     is supposed to be obtained by a call to serialize.
  64     .. attribute:: stringToUnserialize
  65     a string description of the object
  66     """
  67     data = pickle.loads(stringToUnserialize)
  68     return data
  69
  70 class Callable:
  71     """
  72     This class is used to create class-method (see MetaData)
  73     """
  74     def __init__(self, anycallable):
  75         self.__call__ = anycallable
  76 #
  77 # ==============================================================================
  78 # Basic use cases and unit tests
  79 # ==============================================================================
  80 #
  81
  82 def TEST_serialization():
  83     from testdata import TestData
  84     ref_name = "my study case"
  85     studyData = TestData()
  86     studyData.setName(ref_name)
  87
  88     print "serialize data ..."
  89     serialString = serialize(studyData)
  90     print "unserialize data ..."
  91     unserialData = unserialize(serialString)
  92
  93     res_name = unserialData.getName()
  94     print res_name
  95     if ( ref_name != res_name ):
  96         return False
  97
  98     unserialData.log()
  99     unserialData.setName("an other name")
 100
 101     return True
 102
 103 if __name__ == "__main__":
 104     import unittester
 105     unittester.run("salome/kernel/__init__","TEST_serialization")