Utilites/message.py

   1 """
   2 Module message
   3 --------------
   4     le module message propose la fonction MESSAGE pour afficher
   5     sur la stderr, le texte passé en argument.
   6     N.B. : la fonction MESSAGE n'est opérante que pour les développeurs
   7            (la variable DEVELOPPEUR doit être définie)
   8 """
   9
  10 try :
  11         from developpeur import DEVELOPPEUR
  12 except :
  13         DEVELOPPEUR=None
  14
  15 def NULL( *l_args, **d_args  ) : pass
  16
  17 if DEVELOPPEUR :
  18
  19     import developpeur
  20     developpeur.sortie.write( "import de "+__name__+" : $Id$" )
  21     developpeur.sortie.write( "\n" )
  22
  23     import sys
  24     import ici
  25
  26     def MESSAGE( text , offset=1 ) :
  27
  28         """
  29         Fonction MESSAGE
  30         ----------------
  31         La fonction MESSAGE affiche sur la stderr, le texte passé en argument.
  32         Elle précise également le nom du fichier et le numéro de la ligne où
  33         elle a été appelée.
  34
  35         Usage :
  36         from message import MESSAGE
  37
  38         MESSAGE("debut du traitement")
  39         MESSAGE( "Exception interceptée "+str(e) )
  40         """
  41
  42         ici.ICI( offset )
  43         developpeur.sortie.write( str(text)+'\n' )
  44         developpeur.sortie.flush()
  45         return
  46
  47
  48
  49     def DEBUT() :
  50
  51         """
  52         Fonction DEBUT
  53         --------------
  54         La fonction DEBUT affiche sur la stderr, le texte signalant le début
  55         d'un traitement
  56
  57         Usage :
  58             from message import *
  59             DEBUT()
  60             N.B. : la fonction DEBUT n'est opérante que pour les développeurs
  61         """
  62
  63         developpeur.sortie.write( '\n\n' )
  64         MESSAGE("DEBUT du traitement [",offset=2)
  65         return
  66
  67
  68
  69     def FIN() :
  70
  71         """
  72         Fonction FIN
  73         ------------
  74         La fonction FIN affiche sur la stderr, le texte signalant la fin
  75         d'un traitement
  76
  77         Usage :
  78             from message import *
  79             FIN()
  80
  81             N.B. : la fonction FIN n'est opérante que pour les développeurs
  82         """
  83
  84         MESSAGE("] FIN du traitement",offset=2)
  85         return
  86
  87 else :
  88     MESSAGE= NULL
  89     DEBUT = NULL
  90     FIN = NULL