Salome HOME
cht version
[tools/eficas.git] / Noyau / N_OPER.py
1 # coding=utf-8
2 # Copyright (C) 2007-2021   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 OPER
23     qui permet de spécifier les caractéristiques d'un opérateur
24 """
25
26 from __future__ import absolute_import
27 import types
28 import traceback
29
30 from . import N_ENTITE
31 from . import N_ETAPE
32 from . import nommage
33
34
35 class OPER(N_ENTITE.ENTITE):
36
37     """
38      Classe pour definir un opérateur
39
40      Cette classe a trois attributs de classe
41
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              opérateur avec sa définition
45
46      - label qui indique la nature de l'objet de définition (ici, OPER)
47
48      - nommage qui est un module Python qui fournit la fonctionnalité de nommage
49
50      et les attributs d'instance suivants :
51
52      - nom   : son nom
53
54      - op   : le numéro d'opérateur
55
56      - sd_prod : le type de concept produit. C'est une classe ou une fonction qui retourne
57                        une classe
58
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
61
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.
65
66      - fr   : commentaire associé en francais
67
68      - docu : clé de documentation associée
69
70      - regles : liste des règles associées
71
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.
74
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.
78
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.
82
83
84     """
85     class_instance = N_ETAPE.ETAPE
86     label = 'OPER'
87     nommage = nommage
88
89     def __init__(self, nom, op=None, sd_prod=None, reentrant='n', repetable='o', fr="",ang="",fenetreIhm=None,
90                  docu="", regles=(), op_init=None, niveau = None, UIinfo=None, **args):
91         """
92            Méthode d'initialisation de l'objet OPER. Les arguments sont utilisés pour initialiser
93            les attributs de meme nom
94         """
95         self.nom = nom
96         self.op = op
97         self.sd_prod = sd_prod
98         self.reentrant = reentrant
99         self.fr = fr
100         self.ang = ang
101         self.repetable = repetable
102         self.docu = docu
103         self.fenetreIhm= fenetreIhm
104         if type(regles) == tuple:
105             self.regles = regles
106         else:
107             self.regles = (regles,)
108         # Attribut op_init : Fonction a appeler a la construction de l
109         # operateur sauf si == None
110         self.op_init = op_init
111         self.entites = args
112         current_cata = CONTEXT.getCurrentCata()
113         if niveau == None:
114             self.niveau = None
115             current_cata.enregistre(self)
116         else:
117             self.niveau = current_cata.getNiveau(niveau)
118             self.niveau.enregistre(self)
119         self.UIinfo = UIinfo
120         self.affecter_parente()
121         self.checkDefinition(self.nom)
122         self.txtNomComplet=""
123         self.dejaPrepareDump=False
124
125     def __call__(self, reuse=None, nomXML=None,**args):
126         """
127             Construit l'objet ETAPE a partir de sa definition (self),
128             puis demande la construction de ses sous-objets et du concept produit.
129         """
130         if nomXML == None : nomsd = self.nommage.getNomConceptResultat(self.nom)
131         else : nomsd = nomXML
132         etape = self.class_instance(oper=self, reuse=reuse, args=args)
133         etape.MCBuild()
134         while etape.doitEtreRecalculee == True :
135             etape.doitEtreRecalculee = False
136             etape.deepUpdateConditionBlocApresCreation()
137             etape.reConstruitResteVal()
138             etape.state='modified'
139             #print ('on recalcule la validite depuis N_OPER')
140         #   etape.isValid(cr='oui')
141         etape.metAJourNomASSD(nomsd)
142         return etape.buildSd(nomsd)
143
144     def make_objet(self, mc_list='oui'):
145         """
146              Cette méthode crée l'objet ETAPE dont la définition est self sans
147               l'enregistrer ni créer sa sdprod.
148              Si l'argument mc_list vaut 'oui', elle déclenche en plus la construction
149              des objets MCxxx.
150         """
151         etape = self.class_instance(oper=self, reuse=None, args={})
152         if mc_list == 'oui':
153             etape.MCBuild()
154         return etape
155
156     def verifCata(self):
157         """
158             Méthode de vérification des attributs de définition
159         """
160         self.checkRegles()
161         self.checkFr()
162         self.checkReentrant()
163         self.checkDocu()
164         self.checkNom()
165         self.checkOp(valmin=0)
166         self.verifCataRegles()
167
168     def supprime(self):
169         """
170             Méthode pour supprimer les références arrières susceptibles de provoquer
171             des cycles de références
172         """
173         self.niveau = None