2 # Copyright (C) 2007-2013 EDF R&D
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.
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.
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
18 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
22 Ce module contient la classe de definition MACRO
23 qui permet de spécifier les caractéristiques d'une macro-commande
33 from strfunc import ufmt
36 class MACRO(N_ENTITE.ENTITE):
39 Classe pour definir une macro-commande
41 Cette classe a trois attributs de classe
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
47 - label qui indique la nature de l'objet de définition (ici, MACRO)
49 - nommage qui est un module Python qui fournit la fonctionnalité de nommage
51 et les attributs d'instance suivants :
55 - op : le numéro d'opérateur
57 - sd_prod : le type de concept produit. C'est une classe ou une fonction qui retourne
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
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.
67 - fr : commentaire associé en francais
69 - docu : clé de documentation associée
71 - regles : liste des règles associées
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.
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.
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.
86 class_instance = N_MACRO_ETAPE.MACRO_ETAPE
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):
94 Méthode d'initialisation de l'objet MACRO. Les arguments sont utilisés pour initialiser
95 les attributs de meme nom
97 # XXX fichier_ini n'est pas utilisé pour l'instant
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:
111 self.sd_prod = sd_prod
112 self.reentrant = reentrant
115 self.repetable = repetable
117 if type(regles) == types.TupleType:
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
126 current_cata = CONTEXT.get_current_cata()
129 current_cata.enregistre(self)
131 self.niveau = current_cata.get_niveau(niveau)
132 self.niveau.enregistre(self)
134 self.affecter_parente()
135 self.check_definition(self.nom)
137 def __call__(self, reuse=None, **args):
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.
142 nomsd = self.nommage.GetNomConceptResultat(self.nom)
143 etape = self.class_instance(oper=self, reuse=reuse, args=args)
145 return etape.Build_sd(nomsd)
147 def make_objet(self, mc_list='oui'):
149 Cette méthode crée l'objet MACRO_ETAPE dont la définition est self sans
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
155 etape = self.class_instance(oper=self, reuse=None, args={})
160 def verif_cata(self):
162 Méthode de vérification des attributs de définition
164 self.check_op(valmax=0)
170 self.check_reentrant()
171 self.verif_cata_regles()
175 Méthode pour supprimer les références arrières susceptibles de provoquer
176 des cycles de références