2 Ce module contient la classe de definition MACRO
3 qui permet de spécifier les caractéristiques d'une macro-commande
6 import types,string,traceback
12 class MACRO(N_ENTITE.ENTITE):
14 Classe pour definir une macro-commande
16 Cette classe a trois attributs de classe
18 - class_instance qui indique la classe qui devra etre utilisée
19 pour créer l'objet qui servira à controler la conformité d'un
20 macro-commande avec sa définition
22 - label qui indique la nature de l'objet de définition (ici, MACRO)
24 - nommage qui est un module Python qui fournit la fonctionnalité de nommage
26 et les attributs d'instance suivants :
30 - op : le numéro d'opérateur
32 - sd_prod : le type de concept produit. C'est une classe ou une fonction qui retourne
35 - reentrant : vaut 'n' ou 'o'. Indique si l'opérateur est réentrant ou pas. Un opérateur
36 réentrant peut modifier un concept d'entrée et le produire comme concept de sortie
38 - repetable : vaut 'n' ou 'o'. Indique si l'opérateur est répetable ou pas. Un opérateur
39 non répétable ne doit apparaitre qu'une fois dans une exécution. C'est du ressort
40 de l'objet gérant le contexte d'exécution de vérifier cette contrainte.
42 - fr : commentaire associé en français
44 - ang : commentaire associé en anglais
46 - docu : clé de documentation associée
48 - regles : liste des règles associées
50 - op_init : cet attribut vaut None ou une fonction. Si cet attribut ne vaut pas None, cette
51 fonction est exécutée lors des phases d'initialisation de l'étape associée.
53 - niveau : indique le niveau dans lequel est rangé l'opérateur. Les opérateurs peuvent être
54 rangés par niveau. Ils apparaissent alors exclusivement dans leur niveau de rangement.
55 Si niveau vaut None, l'opérateur est rangé au niveau global.
57 - entites : dictionnaire dans lequel sont stockés les sous entités de l'opérateur. Il s'agit
58 des entités de définition pour les mots-clés : FACT, BLOC, SIMP. Cet attribut
59 est initialisé avec args, c'est à dire les arguments d'appel restants.
63 class_instance = N_MACRO_ETAPE.MACRO_ETAPE
67 def __init__(self,nom,op,sd_prod=None,reentrant='n',repetable='o',fr="",ang="",
68 docu="",regles=(),op_init=None,niveau = None,fichier_ini=0,**args):
70 Méthode d'initialisation de l'objet MACRO. Les arguments sont utilisés pour initialiser
71 les attributs de meme nom
73 # XXX fichier_ini n'est pas utilisé pour l'instant
75 # op est obligatoire et permet de spécifier la procédure de construction de la macro
76 # - Si op est un entier la construction de la macro est réalisée par une subroutine fortran opsxxx ou
77 # xxx est donné par la valeur absolue de op. L'execution est egalement effectuée via cette subroutine.
78 # - Si op est une fonction Python, la construction de la macro est effectuée par l'appel à cette fonction
79 # Suivant le cas on garde l info dans self.op ou dans self.proc
80 if type(op) == types.IntType:
88 self.reentrant=reentrant
91 self.repetable = repetable
93 if type(regles)== types.TupleType:
97 self.fichier_ini = fichier_ini
98 # Attribut op_init : Fonction a appeler a la construction de l operateur sauf si == None
101 current_cata=CONTEXT.get_current_cata()
104 current_cata.enregistre(self)
106 self.niveau=current_cata.get_niveau(niveau)
107 self.niveau.enregistre(self)
108 self.affecter_parente()
110 def __call__(self,reuse=None,**args):
112 Construit l'objet MACRO_ETAPE a partir de sa definition (self),
113 puis demande la construction de ses sous-objets et du concept produit.
115 nomsd=self.nommage.GetNomConceptResultat(self.nom)
116 etape= self.class_instance(oper=self,reuse=reuse,args=args)
118 return etape.Build_sd(nomsd)
120 def make_objet(self,mc_list='oui'):
122 Cette méthode crée l'objet MACRO_ETAPE dont la définition est self sans
124 Normalement l'étape est enregistrée auprès de son parent.
125 Si l'argument mc_list vaut 'oui', elle déclenche en plus la construction
128 etape= self.class_instance(oper=self,reuse=None,args={})
129 if mc_list == 'oui':etape.McBuild()
132 def verif_cata(self):
134 Méthode de vérification des attributs de définition
136 if self.op is not None and (type(self.op) != types.IntType or self.op > 0) :
137 self.cr.fatal("L'attribut 'op' doit être un entier signé : %s" %`self.op`)
138 if self.proc is not None and type(self.proc) != types.FunctionType:
139 self.cr.fatal("L'attribut op doit être une fonction Python : %s" % `self.proc`)
140 if type(self.regles) != types.TupleType :
141 self.cr.fatal("L'attribut 'regles' doit être un tuple : %s" %`self.regles`)
142 if type(self.fr) != types.StringType :
143 self.cr.fatal("L'attribut 'fr' doit être une chaîne de caractères : %s" %`self.fr`)
144 if type(self.docu) != types.StringType :
145 self.cr.fatal("L'attribut 'docu' doit être une chaîne de caractères : %s" %`self.docu` )
146 if type(self.nom) != types.StringType :
147 self.cr.fatal("L'attribut 'nom' doit être une chaîne de caractères : %s" %`self.nom`)
148 if self.reentrant not in ('o','n','f'):
149 self.cr.fatal("L'attribut 'reentrant' doit valoir 'o','n' ou 'f' : %s" %`self.reentrant`)
150 self.verif_cata_regles()
154 Méthode pour supprimer les références arrières susceptibles de provoquer
155 des cycles de références