Noyau/N_MACRO.py

   1 # coding=utf-8
   2 # Copyright (C) 2007-2013   EDF R&D
   3 #
   4 # This library is free software; you can redistribute it and/or
   5 # modify it under the terms of the GNU Lesser General Public
   6 # License as published by the Free Software Foundation; either
   7 # version 2.1 of the License.
   8 #
   9 # This library is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12 # Lesser General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU Lesser General Public
  15 # License along with this library; if not, write to the Free Software
  16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  17 #
  18 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  19
  20
  21 """
  22     Ce module contient la classe de definition MACRO
  23     qui permet de spécifier les caractéristiques d'une macro-commande
  24 """
  25
  26 import types
  27 import string
  28 import traceback
  29
  30 import N_ENTITE
  31 import N_MACRO_ETAPE
  32 import nommage
  33 from strfunc import ufmt
  34
  35
  36 class MACRO(N_ENTITE.ENTITE):
  37
  38     """
  39      Classe pour definir une macro-commande
  40
  41      Cette classe a trois attributs de classe
  42
  43      - class_instance qui indique la classe qui devra etre utilisée
  44              pour créer l'objet qui servira à controler la conformité d'un
  45              macro-commande avec sa définition
  46
  47      - label qui indique la nature de l'objet de définition (ici, MACRO)
  48
  49      - nommage qui est un module Python qui fournit la fonctionnalité de nommage
  50
  51      et les attributs d'instance suivants :
  52
  53      - nom   : son nom
  54
  55      - op   : le numéro d'opérateur
  56
  57      - sd_prod : le type de concept produit. C'est une classe ou une fonction qui retourne
  58                        une classe
  59
  60      - reentrant : vaut 'n' ou 'o'. Indique si l'opérateur est réentrant ou pas. Un opérateur
  61                          réentrant peut modifier un concept d'entrée et le produire comme concept de sortie
  62
  63      - repetable : vaut 'n' ou 'o'. Indique si l'opérateur est répetable ou pas. Un opérateur
  64                          non répétable ne doit apparaitre qu'une fois dans une exécution. C'est du ressort
  65                          de l'objet gérant le contexte d'exécution de vérifier cette contrainte.
  66
  67      - fr   : commentaire associé en francais
  68
  69      - docu : clé de documentation associée
  70
  71      - regles : liste des règles associées
  72
  73      - op_init : cet attribut vaut None ou une fonction. Si cet attribut ne vaut pas None, cette
  74                        fonction est exécutée lors des phases d'initialisation de l'étape associée.
  75
  76      - niveau : indique le niveau dans lequel est rangé l'opérateur. Les opérateurs peuvent etre
  77                       rangés par niveau. Ils apparaissent alors exclusivement dans leur niveau de rangement.
  78                       Si niveau vaut None, l'opérateur est rangé au niveau global.
  79
  80      - entites : dictionnaire dans lequel sont stockés les sous entités de l'opérateur. Il s'agit
  81                        des entités de définition pour les mots-clés : FACT, BLOC, SIMP. Cet attribut
  82                        est initialisé avec args, c'est à dire les arguments d'appel restants.
  83
  84
  85     """
  86     class_instance = N_MACRO_ETAPE.MACRO_ETAPE
  87     label = 'MACRO'
  88     nommage = nommage
  89
  90     def __init__(
  91         self, nom, op, sd_prod=None, reentrant='n', repetable='o', fr="",ang="",
  92             docu="", regles=(), op_init=None, niveau = None, fichier_ini=0, UIinfo=None, **args):
  93         """
  94            Méthode d'initialisation de l'objet MACRO. Les arguments sont utilisés pour initialiser
  95            les attributs de meme nom
  96         """
  97         # XXX fichier_ini n'est pas utilisé pour l'instant
  98         self.nom = nom
  99         # op est obligatoire et permet de spécifier la procédure de construction de la macro
 100         # - Si op est un entier la construction de la macro est réalisée par une subroutine fortran opsxxx ou
 101         # xxx est donné par la valeur absolue de op. L'execution est egalement effectuée via cette subroutine.
 102         # - Si op est une fonction Python, la construction de la macro est effectuée par l'appel à cette fonction
 103         # Suivant le cas on garde l info dans self.op ou dans self.proc
 104         if type(op) == types.IntType:
 105             self.proc = None
 106             self.op = op
 107         else:
 108             self.op = None
 109             self.proc = op
 110
 111         self.sd_prod = sd_prod
 112         self.reentrant = reentrant
 113         self.fr = fr
 114         self.ang=ang
 115         self.repetable = repetable
 116         self.docu = docu
 117         if type(regles) == types.TupleType:
 118             self.regles = regles
 119         else:
 120             self.regles = (regles,)
 121         self.fichier_ini = fichier_ini
 122         # Attribut op_init : Fonction a appeler a la construction de l
 123         # operateur sauf si == None
 124         self.op_init = op_init
 125         self.entites = args
 126         current_cata = CONTEXT.get_current_cata()
 127         if niveau == None:
 128             self.niveau = None
 129             current_cata.enregistre(self)
 130         else:
 131             self.niveau = current_cata.get_niveau(niveau)
 132             self.niveau.enregistre(self)
 133         self.UIinfo = UIinfo
 134         self.affecter_parente()
 135         self.check_definition(self.nom)
 136
 137     def __call__(self, reuse=None, **args):
 138         """
 139             Construit l'objet MACRO_ETAPE a partir de sa definition (self),
 140             puis demande la construction de ses sous-objets et du concept produit.
 141         """
 142         nomsd = self.nommage.GetNomConceptResultat(self.nom)
 143         etape = self.class_instance(oper=self, reuse=reuse, args=args)
 144         etape.McBuild()
 145         return etape.Build_sd(nomsd)
 146
 147     def make_objet(self, mc_list='oui'):
 148         """
 149              Cette méthode crée l'objet MACRO_ETAPE dont la définition est self sans
 150              créer sa sdprod.
 151              Normalement l'étape est enregistrée auprès de son parent.
 152              Si l'argument mc_list vaut 'oui', elle déclenche en plus la construction
 153              des objets MCxxx.
 154         """
 155         etape = self.class_instance(oper=self, reuse=None, args={})
 156         if mc_list == 'oui':
 157             etape.McBuild()
 158         return etape
 159
 160     def verif_cata(self):
 161         """
 162             Méthode de vérification des attributs de définition
 163         """
 164         self.check_op(valmax=0)
 165         self.check_proc()
 166         self.check_regles()
 167         self.check_fr()
 168         self.check_docu()
 169         self.check_nom()
 170         self.check_reentrant()
 171         self.verif_cata_regles()
 172
 173     def supprime(self):
 174         """
 175             Méthode pour supprimer les références arrières susceptibles de provoquer
 176             des cycles de références
 177         """
 178         self.niveau = None