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
26 from __future__ import absolute_import
30 from . import N_ENTITE
31 from . import N_MACRO_ETAPE
35 class MACRO(N_ENTITE.ENTITE):
38 Classe pour definir une macro-commande
40 Cette classe a trois attributs de classe
42 - class_instance qui indique la classe qui devra etre utilisée
43 pour créer l'objet qui servira à controler la conformité d'un
44 macro-commande avec sa définition
46 - label qui indique la nature de l'objet de définition (ici, MACRO)
48 - nommage qui est un module Python qui fournit la fonctionnalité de nommage
50 et les attributs d'instance suivants :
54 - op : le numéro d'opérateur
56 - sd_prod : le type de concept produit. C'est une classe ou une fonction qui retourne
59 - reentrant : vaut 'n' ou 'o'. Indique si l'opérateur est réentrant ou pas. Un opérateur
60 réentrant peut modifier un concept d'entrée et le produire comme concept de sortie
62 - repetable : vaut 'n' ou 'o'. Indique si l'opérateur est répetable ou pas. Un opérateur
63 non répétable ne doit apparaitre qu'une fois dans une exécution. C'est du ressort
64 de l'objet gérant le contexte d'exécution de vérifier cette contrainte.
66 - fr : commentaire associé en francais
68 - docu : clé de documentation associée
70 - regles : liste des règles associées
72 - op_init : cet attribut vaut None ou une fonction. Si cet attribut ne vaut pas None, cette
73 fonction est exécutée lors des phases d'initialisation de l'étape associée.
75 - niveau : indique le niveau dans lequel est rangé l'opérateur. Les opérateurs peuvent etre
76 rangés par niveau. Ils apparaissent alors exclusivement dans leur niveau de rangement.
77 Si niveau vaut None, l'opérateur est rangé au niveau global.
79 - entites : dictionnaire dans lequel sont stockés les sous entités de l'opérateur. Il s'agit
80 des entités de définition pour les mots-clés : FACT, BLOC, SIMP. Cet attribut
81 est initialisé avec args, c'est à dire les arguments d'appel restants.
85 class_instance = N_MACRO_ETAPE.MACRO_ETAPE
90 self, nom, op, sd_prod=None, reentrant='n', repetable='o', fr="",ang="",
91 docu="", regles=(), op_init=None, niveau = None, fichier_ini=0, UIinfo=None, **args):
93 Méthode d'initialisation de l'objet MACRO. Les arguments sont utilisés pour initialiser
94 les attributs de meme nom
96 # XXX fichier_ini n'est pas utilisé pour l'instant
98 # op est obligatoire et permet de spécifier la procédure de construction de la macro
99 # - Si op est un entier la construction de la macro est réalisée par une subroutine fortran opsxxx ou
100 # xxx est donné par la valeur absolue de op. L'execution est egalement effectuée via cette subroutine.
101 # - Si op est une fonction Python, la construction de la macro est effectuée par l'appel à cette fonction
102 # Suivant le cas on garde l info dans self.op ou dans self.proc
110 self.sd_prod = sd_prod
111 self.reentrant = reentrant
114 self.repetable = repetable
116 if type(regles) == tuple:
119 self.regles = (regles,)
120 self.fichier_ini = fichier_ini
121 # Attribut op_init : Fonction a appeler a la construction de l
122 # operateur sauf si == None
123 self.op_init = op_init
125 current_cata = CONTEXT.get_current_cata()
128 current_cata.enregistre(self)
130 self.niveau = current_cata.get_niveau(niveau)
131 self.niveau.enregistre(self)
133 self.affecter_parente()
134 self.check_definition(self.nom)
136 def __call__(self, reuse=None, **args):
138 Construit l'objet MACRO_ETAPE a partir de sa definition (self),
139 puis demande la construction de ses sous-objets et du concept produit.
141 nomsd = self.nommage.GetNomConceptResultat(self.nom)
142 etape = self.class_instance(oper=self, reuse=reuse, args=args)
144 return etape.Build_sd(nomsd)
146 def make_objet(self, mc_list='oui'):
148 Cette méthode crée l'objet MACRO_ETAPE dont la définition est self sans
150 Normalement l'étape est enregistrée auprès de son parent.
151 Si l'argument mc_list vaut 'oui', elle déclenche en plus la construction
154 etape = self.class_instance(oper=self, reuse=None, args={})
159 def verif_cata(self):
161 Méthode de vérification des attributs de définition
163 self.check_op(valmax=0)
169 self.check_reentrant()
170 self.verif_cata_regles()
174 Méthode pour supprimer les références arrières susceptibles de provoquer
175 des cycles de références