Utilites/message.py

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