Salome HOME
Minor source update for OM compatibility
[modules/adao.git] / src / daComposant / daCore / ExtendedLogging.py
index a7beee9fe021815219742cc66134669d57534609..5918581c5d1a2e0d6b3f9ae1b9f55f4f73363057 100644 (file)
@@ -1,57 +1,56 @@
-#-*-coding:iso-8859-1-*-
+# -*- coding: utf-8 -*-
 #
-#  Copyright (C) 2008-2015 EDF R&D
+# Copyright (C) 2008-2024 EDF R&D
 #
-#  This library is free software; you can redistribute it and/or
-#  modify it under the terms of the GNU Lesser General Public
-#  License as published by the Free Software Foundation; either
-#  version 2.1 of the License.
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License.
 #
-#  This library 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
-#  Lesser General Public License for more details.
+# This library 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
+# Lesser General Public License for more details.
 #
-#  You should have received a copy of the GNU Lesser General Public
-#  License along with this library; if not, write to the Free Software
-#  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
 #
-#  See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
+# See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
 #
-#  Author: Jean-Philippe Argaud, jean-philippe.argaud@edf.fr, EDF R&D
+# Author: Jean-Philippe Argaud, jean-philippe.argaud@edf.fr, EDF R&D
 
 """
     Ce module permet de mettre en place un logging utilisable partout dans
-    l'application, par défaut à la console, et si nécessaire dans un fichier.
+    l'application, par défaut à la console, et si nécessaire dans un fichier.
 
-    Il doit être appelé en premier dans AssimilationStudy (mais pas directement
-    dans les applications utilisateurs), en l'important et en instanciant un
-    objet :
+    Il doit être appelé en premier dans Aidsm (mais pas directement dans les
+    applications utilisateurs), en l'important et en instanciant un objet :
         import ExtendedLogging ; ExtendedLogging.ExtendedLogging()
 
-    Par défaut, seuls les messages du niveau WARNING ou au-delà sont disponibles
+    Par défaut, seuls les messages du niveau WARNING ou au-delà sont disponibles
     (donc les simples messages d'info ne sont pas disponibles), ce que l'on peut
-    changer à l'instanciation avec le mot-clé "level" :
+    changer à l'instanciation avec le mot-clé "level" :
         import ExtendedLogging ; ExtendedLogging.ExtendedLogging(level=20)
 
-    On peut éventuellement demander à l'objet de sortir aussi les messages dans
-    un fichier (noms par défaut : AssimilationStudy.log, niveau NOTSET) :
+    On peut éventuellement demander à l'objet de sortir aussi les messages dans
+    un fichier (noms par défaut : AdaoOutputLogfile.log, niveau NOTSET) :
         import ExtendedLogging ; ExtendedLogging.ExtendedLogging().setLogfile()
 
     Si on veut changer le nom du fichier ou le niveau global de message, il faut
-    récupérer l'instance et appliquer les méthodes :
+    récupérer l'instance et appliquer les méthodes :
         import ExtendedLogging
         log = ExtendedLogging.ExtendedLogging()
         import logging
         log.setLevel(logging.DEBUG)
         log.setLogfile(filename="toto.log", filemode="a", level=logging.WARNING)
-    et on change éventuellement le niveau avec :
+    et on change éventuellement le niveau avec :
         log.setLogfileLevel(logging.INFO)
 
-    Ensuite, n'importe où dans les applications, il suffit d'utiliser le module
+    Ensuite, n'importe où dans les applications, il suffit d'utiliser le module
     "logging" (avec un petit "l") :
         import logging
-        log = logging.getLogger(NAME) # Avec rien (recommandé) ou un nom NAME
+        log = logging.getLogger(NAME) # Avec rien (recommandé) ou un nom NAME
         log.critical("...")
         log.error("...")
         log.warning("...")
         import logging
         logging.info("...")
 
-    Dans une application, à n'importe quel endroit et autant de fois qu'on veut,
+    Dans une application, à n'importe quel endroit et autant de fois qu'on veut,
     on peut changer le niveau global de message en utilisant par exemple :
         import logging
-        log = logging.getLogger(NAME) # Avec rien (recommandé) ou un nom NAME
+        log = logging.getLogger(NAME) # Avec rien (recommandé) ou un nom NAME
         log.setLevel(logging.DEBUG)
 
     On rappelle les niveaux (attributs de "logging") et leur ordre :
@@ -76,48 +75,77 @@ __all__ = []
 import os
 import sys
 import logging
-from PlatformInfo import PlatformInfo
+import functools
+import time
+from daCore import PlatformInfo
 
-LOGFILE = os.path.join(os.path.abspath(os.curdir),"AssimilationStudy.log")
+LOGFILE = os.path.join(os.path.abspath(os.curdir), "AdaoOutputLogfile.log")
 
 # ==============================================================================
-class ExtendedLogging:
+class ExtendedLogging(object):
+    """
+    Logger général pour disposer conjointement de la sortie standard et de la
+    sortie sur fichier
+    """
+    __slots__ = ("__logfile")
+
     def __init__(self, level=logging.WARNING):
         """
-        Initialise un logging à la console pour TOUS les niveaux de messages.
+        Initialise un logging à la console pour TOUS les niveaux de messages.
         """
-        logging.basicConfig(
-            format = '%(levelname)-8s %(message)s',
-            level  = level,
-            stream = sys.stdout,
+        if sys.version_info.major <= 3 and sys.version_info.minor < 8:
+            if logging.getLogger().hasHandlers():
+                while logging.getLogger().hasHandlers():
+                    logging.getLogger().removeHandler( logging.getLogger().handlers[-1] )
+                __sys_stdout = logging.StreamHandler(sys.stdout)
+                __sys_stdout.setFormatter(logging.Formatter('%(levelname)-8s %(message)s'))
+                logging.getLogger().addHandler(__sys_stdout)
+            else:
+                logging.basicConfig(
+                    format = '%(levelname)-8s %(message)s',
+                    level  = level,
+                    stream = sys.stdout,
+                )
+        else:  # Actif lorsque Python > 3.7
+            logging.basicConfig(
+                format = '%(levelname)-8s %(message)s',
+                level  = level,
+                stream = sys.stdout,
+                force  = True,
             )
         self.__logfile = None
         #
         # Initialise l'affichage de logging
         # ---------------------------------
-        p = PlatformInfo()
+        lpi = PlatformInfo.PlatformInfo()
         #
         logging.info( "--------------------------------------------------" )
-        logging.info( "Lancement de "+p.getName()+" "+p.getVersion() )
+        logging.info( lpi.getName() + " version " + lpi.getVersion() )
         logging.info( "--------------------------------------------------" )
-        logging.info( "Versions logicielles :" )
-        logging.info( "- Python "+p.getPythonVersion() )
-        logging.info( "- Numpy "+p.getNumpyVersion() )
-        logging.info( "- Scipy "+p.getScipyVersion() )
+        logging.info( "Library availability:" )
+        logging.info( "- Python.......: True" )
+        logging.info( "- Numpy........: " + str(lpi.has_numpy) )
+        logging.info( "- Scipy........: " + str(lpi.has_scipy) )
+        logging.info( "- Matplotlib...: " + str(lpi.has_matplotlib) )
+        logging.info( "- Gnuplot......: " + str(lpi.has_gnuplot) )
+        logging.info( "- Sphinx.......: " + str(lpi.has_sphinx) )
+        logging.info( "- Nlopt........: " + str(lpi.has_nlopt) )
+        logging.info( "Library versions:" )
+        logging.info( "- Python.......: " + lpi.getPythonVersion() )
+        logging.info( "- Numpy........: " + lpi.getNumpyVersion() )
+        logging.info( "- Scipy........: " + lpi.getScipyVersion() )
+        logging.info( "- Matplotlib...: " + lpi.getMatplotlibVersion() )
+        logging.info( "- Gnuplot......: " + lpi.getGnuplotVersion() )
+        logging.info( "- Sphinx.......: " + lpi.getSphinxVersion() )
+        logging.info( "- Nlopt........: " + lpi.getNloptVersion() )
         logging.info( "" )
 
-#     def setLogfileLevel(self, level=logging.NOTSET ):
-#         """
-#         Permet de changer globalement le niveau des messages disponibles.
-#         """
-#         logging.getLogger().setLevel(level)
-#
     def setLogfile(self, filename=LOGFILE, filemode="w", level=logging.NOTSET):
         """
         Permet de disposer des messages dans un fichier EN PLUS de la console.
         """
         if self.__logfile is not None:
-            # Supprime le précédent mode de stockage fichier s'il exsitait
+            # Supprime le précédent mode de stockage fichier s'il existait
             logging.getLogger().removeHandler(self.__logfile)
         self.__logfile = logging.FileHandler(filename, filemode)
         self.__logfile.setLevel(level)
@@ -128,8 +156,8 @@ class ExtendedLogging:
 
     def setLogfileLevel(self, level=logging.NOTSET ):
         """
-        Permet de changer le niveau des messages stockés en fichier. Il ne sera
-        pris en compte que s'il est supérieur au niveau global.
+        Permet de changer le niveau des messages stockés en fichier. Il ne sera
+        pris en compte que s'il est supérieur au niveau global.
         """
         self.__logfile.setLevel(level)
 
@@ -139,6 +167,18 @@ class ExtendedLogging:
         """
         return logging.getLevelName( logging.getLogger().getEffectiveLevel() )
 
+# ==============================================================================
+def logtimer(f):
+    @functools.wraps(f)
+    def wrapper(*args, **kwargs):
+        start  = time.clock()  # time.time()
+        result = f(*args, **kwargs)
+        end    = time.clock()  # time.time()
+        msg    = 'TIMER Durée elapsed de la fonction utilisateur "{}": {:.3f}s'
+        logging.debug(msg.format(f.__name__, end - start))
+        return result
+    return wrapper
+
 # ==============================================================================
 if __name__ == "__main__":
-    print '\n AUTODIAGNOSTIC \n'
+    print("\n AUTODIAGNOSTIC\n")