Noyau/N_PROC.py

   1 #@ MODIF N_PROC Noyau  DATE 09/10/2002   AUTEUR DURAND C.DURAND
   2 #            CONFIGURATION MANAGEMENT OF EDF VERSION
   3 # ======================================================================
   4 # COPYRIGHT (C) 1991 - 2002  EDF R&D                  WWW.CODE-ASTER.ORG
   5 # THIS PROGRAM IS FREE SOFTWARE; YOU CAN REDISTRIBUTE IT AND/OR MODIFY
   6 # IT UNDER THE TERMS OF THE GNU GENERAL PUBLIC LICENSE AS PUBLISHED BY
   7 # THE FREE SOFTWARE FOUNDATION; EITHER VERSION 2 OF THE LICENSE, OR
   8 # (AT YOUR OPTION) ANY LATER VERSION.
   9 #
  10 # THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT
  11 # WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF
  12 # MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SEE THE GNU
  13 # GENERAL PUBLIC LICENSE FOR MORE DETAILS.
  14 #
  15 # YOU SHOULD HAVE RECEIVED A COPY OF THE GNU GENERAL PUBLIC LICENSE
  16 # ALONG WITH THIS PROGRAM; IF NOT, WRITE TO EDF R&D CODE_ASTER,
  17 #    1 AVENUE DU GENERAL DE GAULLE, 92141 CLAMART CEDEX, FRANCE.
  18 #
  19 #
  20 # ======================================================================
  21 """
  22     Ce module contient la classe de definition PROC
  23     qui permet de spécifier les caractéristiques d'une procédure
  24 """
  25
  26 import types,string,traceback
  27
  28 import N_ENTITE
  29 import N_PROC_ETAPE
  30
  31 class PROC(N_ENTITE.ENTITE):
  32    """
  33     Classe pour definir un opérateur
  34
  35     Cette classe a deux attributs de classe
  36
  37     - class_instance qui indique la classe qui devra etre utilisée
  38             pour créer l'objet qui servira à controler la conformité d'un
  39             opérateur avec sa définition
  40
  41     - label qui indique la nature de l'objet de définition (ici, PROC)
  42
  43
  44     et les attributs d'instance suivants :
  45
  46     - nom   : son nom
  47
  48     - op   : le numéro d'opérateur
  49
  50     - reentrant : vaut 'n' ou 'o'. Indique si l'opérateur est réentrant ou pas. Un opérateur
  51                         réentrant peut modifier un concept d'entrée et le produire comme concept de sortie
  52
  53     - repetable : vaut 'n' ou 'o'. Indique si l'opérateur est répetable ou pas. Un opérateur
  54                         non répétable ne doit apparaitre qu'une fois dans une exécution. C'est du ressort
  55                         de l'objet gérant le contexte d'exécution de vérifier cette contrainte.
  56
  57     - fr   : commentaire associé en francais
  58
  59     - ang : commentaire associé en anglais
  60
  61     - docu : clé de documentation associée
  62
  63     - regles : liste des règles associées
  64
  65     - op_init : cet attribut vaut None ou une fonction. Si cet attribut ne vaut pas None, cette
  66                       fonction est exécutée lors des phases d'initialisation de l'étape associée.
  67
  68     - niveau : indique le niveau dans lequel est rangé l'opérateur. Les opérateurs peuvent etre
  69                      rangés par niveau. Ils apparaissent alors exclusivement dans leur niveau de rangement.
  70                      Si niveau vaut None, l'opérateur est rangé au niveau global.
  71
  72     - entites : dictionnaire dans lequel sont stockés les sous entités de l'opérateur. Il s'agit
  73                       des entités de définition pour les mots-clés : FACT, BLOC, SIMP. Cet attribut
  74                       est initialisé avec args, c'est à dire les arguments d'appel restants.
  75
  76
  77    """
  78    class_instance = N_PROC_ETAPE.PROC_ETAPE
  79    label = 'PROC'
  80
  81    def __init__(self,nom,op,reentrant='n',repetable='o',fr="",ang="",
  82                 docu="",regles=(),op_init=None,niveau = None,UIinfo=None,**args):
  83       """
  84          Méthode d'initialisation de l'objet PROC. Les arguments sont utilisés pour initialiser
  85          les attributs de meme nom
  86       """
  87       self.nom=nom
  88       self.op=op
  89       self.reentrant=reentrant
  90       self.repetable = repetable
  91       self.fr=fr
  92       self.ang=ang
  93       self.docu=docu
  94       if type(regles)== types.TupleType:
  95           self.regles=regles
  96       else:
  97           self.regles=(regles,)
  98       # Attribut op_init : Fonction a appeler a la construction de l operateur sauf si == None
  99       self.op_init=op_init
 100       self.entites=args
 101       current_cata=CONTEXT.get_current_cata()
 102       if niveau == None:
 103          self.niveau=None
 104          current_cata.enregistre(self)
 105       else:
 106          self.niveau=current_cata.get_niveau(niveau)
 107          self.niveau.enregistre(self)
 108       self.UIinfo=UIinfo
 109       self.affecter_parente()
 110
 111    def __call__(self,**args):
 112       """
 113           Construit l'objet PROC_ETAPE a partir de sa definition (self),
 114           puis demande la construction de ses sous-objets et du concept produit.
 115       """
 116       etape= self.class_instance(oper=self,args=args)
 117       etape.McBuild()
 118       return etape.Build_sd()
 119
 120    def make_objet(self,mc_list='oui'):
 121       """
 122            Cette méthode crée l'objet PROC_ETAPE dont la définition est self sans
 123             l'enregistrer ni créer sa sdprod.
 124            Si l'argument mc_list vaut 'oui', elle déclenche en plus la construction
 125            des objets MCxxx.
 126       """
 127       etape= self.class_instance(oper=self,args={})
 128       if mc_list == 'oui':etape.McBuild()
 129       return etape
 130
 131    def verif_cata(self):
 132       """
 133           Méthode de vérification des attributs de définition
 134       """
 135       if type(self.regles) != types.TupleType :
 136         self.cr.fatal("L'attribut 'regles' doit etre un tuple : %s" %`self.regles`)
 137       if type(self.fr) != types.StringType :
 138         self.cr.fatal("L'attribut 'fr' doit etre une chaine de caractères : %s" %`self.fr`)
 139       if self.reentrant not in ('o','n','f'):
 140         self.cr.fatal("L'attribut 'reentrant' doit valoir 'o','n' ou 'f' : %s" %`self.reentrant`)
 141       if type(self.docu) != types.StringType :
 142         self.cr.fatal("L'attribut 'docu' doit etre une chaine de caractères : %s" %`self.docu` )
 143       if type(self.nom) != types.StringType :
 144         self.cr.fatal("L'attribut 'nom' doit etre une chaine de caractères : %s" %`self.nom`)
 145       if type(self.op) != types.IntType :
 146         self.cr.fatal("L'attribut 'op' doit etre un entier signé : %s" %`self.op`)
 147       self.verif_cata_regles()
 148
 149    def supprime(self):
 150       """
 151           Méthode pour supprimer les références arrières susceptibles de provoquer
 152           des cycles de références
 153       """
 154       self.niveau=None
 155
 156