Noyau/N_FACT.py

   1 #@ MODIF N_FACT Noyau  DATE 22/03/2011   AUTEUR COURTOIS M.COURTOIS
   2 # -*- coding: iso-8859-1 -*-
   3 # RESPONSABLE COURTOIS M.COURTOIS
   4 #            CONFIGURATION MANAGEMENT OF EDF VERSION
   5 # ======================================================================
   6 # COPYRIGHT (C) 1991 - 2011  EDF R&D                  WWW.CODE-ASTER.ORG
   7 # THIS PROGRAM IS FREE SOFTWARE; YOU CAN REDISTRIBUTE IT AND/OR MODIFY
   8 # IT UNDER THE TERMS OF THE GNU GENERAL PUBLIC LICENSE AS PUBLISHED BY
   9 # THE FREE SOFTWARE FOUNDATION; EITHER VERSION 2 OF THE LICENSE, OR
  10 # (AT YOUR OPTION) ANY LATER VERSION.
  11 #
  12 # THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT
  13 # WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF
  14 # MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SEE THE GNU
  15 # GENERAL PUBLIC LICENSE FOR MORE DETAILS.
  16 #
  17 # YOU SHOULD HAVE RECEIVED A COPY OF THE GNU GENERAL PUBLIC LICENSE
  18 # ALONG WITH THIS PROGRAM; IF NOT, WRITE TO EDF R&D CODE_ASTER,
  19 #    1 AVENUE DU GENERAL DE GAULLE, 92141 CLAMART CEDEX, FRANCE.
  20 #
  21 #
  22 # ======================================================================
  23
  24
  25 """ Ce module contient la classe de definition FACT
  26     qui permet de spécifier les caractéristiques des mots clés facteurs
  27 """
  28
  29 import types
  30
  31 import N_ENTITE
  32 import N_MCFACT
  33 import N_MCLIST
  34 from N__F import _F
  35 from N_types import is_enum
  36
  37 import N_OBJECT
  38
  39 class FACT(N_ENTITE.ENTITE):
  40    """
  41     Classe pour definir un mot cle facteur
  42
  43     Cette classe a trois attributs de classe
  44
  45       - class_instance qui indique la classe qui devra etre utilisée
  46         pour créer l'objet qui servira à controler la conformité d'un
  47         mot-clé facteur avec sa définition
  48
  49       - list_instance
  50
  51       - label qui indique la nature de l'objet de définition (ici, FACT)
  52    """
  53    class_instance = N_MCFACT.MCFACT
  54    list_instance = N_MCLIST.MCList
  55    label = 'FACT'
  56
  57    def __init__(self,fr="",ang="",docu="",regles=(),statut='f',defaut=None,
  58                      min=0,max=1,validators=None,**args):
  59
  60       """
  61           Un mot-clé facteur est caractérisé par les attributs suivants :
  62
  63             - fr   :
  64             - ang :
  65             - statut :
  66             - defaut :
  67             - regles
  68             - min
  69             - max
  70             - position
  71             - docu
  72       """
  73       N_ENTITE.ENTITE.__init__(self,validators)
  74       # Initialisation des attributs
  75       self.fr=fr
  76       self.ang=ang
  77       self.docu = docu
  78       if type(regles)== types.TupleType:
  79           self.regles=regles
  80       else:
  81           self.regles=(regles,)
  82       self.statut=statut
  83       self.defaut=defaut
  84       self.min=min
  85       self.max=max
  86       self.entites=args
  87       self.position=None
  88       self.affecter_parente()
  89
  90    def __call__(self,val,nom,parent):
  91       """
  92           Construit la structure de donnee pour un mot cle facteur a partir
  93           de sa definition (self) de sa valeur (val), de son nom (nom) et de
  94           son parent dans l arboresence (parent)
  95
  96           Suivant le type de la valeur on retournera soit un objet de type
  97           MCFACT soit une liste de type MCLIST.
  98
  99           La creation d un mot cle facteur depend de son statut
 100             - Si statut ='o'   il est obligatoire
 101             - Si statut == 'd' il est facultatif mais ses sous mots cles avec
 102               defaut sont visibles
 103             - Si statut == 'f' il est facultatif et ses sous mots avec defaut ne
 104               sont pas visibles
 105             - Si statut == 'c' il est cache ???
 106             - Si defaut != None, on utilise cette valeur pour calculer la valeur
 107               par defaut du mot cle facteur
 108       """
 109       if val is None:
 110         if self.defaut == None:
 111           val={}
 112         elif type(self.defaut) == types.TupleType:
 113           val=self.defaut
 114               # Est ce utile ? Le défaut pourrait etre uniquement un dict
 115         elif type(self.defaut) == types.DictType or isinstance(self.defaut,_F):
 116           val=self.defaut
 117         else:
 118           # On ne devrait jamais passer par la
 119           print "On ne devrait jamais passer par la"
 120           return None
 121       elif is_enum(val) and len(val) == 0 and self.statut == 'o':
 122           # On est dans le cas où le mcfact est présent mais est une liste/tuple
 123           # vide. Il est obligatoire donc on l'initialise. Les règles, mots-clés
 124           # obligatoires diront si un mcfact vide est accepté.
 125           val = {}
 126
 127       # On cree toujours une liste de mcfact
 128       l=self.list_instance()
 129       l.init(nom = nom,parent=parent)
 130       if type(val) in (types.TupleType,types.ListType) :
 131          for v in val:
 132             if type(v) == types.DictType or isinstance(v, _F):
 133                objet=self.class_instance(nom=nom,definition=self,val=v,parent=parent)
 134                l.append(objet)
 135             else:
 136                l.append(N_OBJECT.ErrorObj(self,v,parent,nom))
 137       elif type(val) == types.DictType or isinstance(val, _F):
 138          objet=self.class_instance(nom=nom,definition=self,val=val,parent=parent)
 139          l.append(objet)
 140       else:
 141          l.append(N_OBJECT.ErrorObj(self,val,parent,nom))
 142
 143       return l
 144
 145    def verif_cata(self):
 146       if type(self.min) != types.IntType :
 147          if self.min != '**':
 148             self.cr.fatal("L'attribut 'min' doit etre un entier : %s" %`self.min`)
 149       if type(self.max) != types.IntType :
 150          if self.max != '**':
 151             self.cr.fatal("L'attribut 'max' doit etre un entier : %s" %`self.max`)
 152       if self.min > self.max :
 153          self.cr.fatal("Nombres d'occurrence min et max invalides : %s %s" %(`self.min`,`self.max`))
 154       if type(self.fr) != types.StringType :
 155          self.cr.fatal("L'attribut 'fr' doit etre une chaine de caractères : %s" %`self.fr`)
 156       if type(self.regles) != types.TupleType :
 157          self.cr.fatal("L'attribut 'regles' doit etre un tuple : %s" %`self.regles`)
 158       if self.statut not in ['f','o','c','d'] :
 159          self.cr.fatal("L'attribut 'statut' doit valoir 'o','f','c' ou 'd' : %s" %`self.statut`)
 160       if type(self.docu) != types.StringType :
 161          self.cr.fatal("L'attribut 'docu' doit etre une chaine de caractères : %s" %`self.docu`)
 162       if self.validators and not self.validators.verif_cata():
 163          self.cr.fatal("Un des validateurs est incorrect. Raison : "+self.validators.cata_info)
 164       self.verif_cata_regles()
 165