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 BLOC
23 qui permet de spécifier les caractéristiques des blocs de mots clés
26 from __future__ import absolute_import
27 from __future__ import print_function
32 from . import N_ENTITE
33 from . import N_MCBLOC
34 from .N_Exception import AsException
35 from .N_types import force_list
38 class BLOC(N_ENTITE.ENTITE):
41 Classe pour definir un bloc de mots-cles
43 Cette classe a deux attributs de classe :
45 - class_instance qui indique la classe qui devra etre utilisée
46 pour créer l'objet qui servira à controler la conformité d'un
47 bloc de mots-clés avec sa définition
48 - label qui indique la nature de l'objet de définition (ici, BLOC)
51 class_instance = N_MCBLOC.MCBLOC
54 def __init__(self, fr="", docu="", regles=(), statut='f', condition=None,ang="",
57 Un bloc est caractérisé par les attributs suivants :
59 - fr : chaine de caractere commentaire pour aide en ligne (en francais)
60 - regles : liste d'objets de type REGLE pour vérifier la cohérence des sous-objets
61 - statut : obligatoire ('o') ou facultatif ('f')
62 - condition : chaine de caractère evaluable par l'interpreteur Python
63 - entites : dictionnaire contenant les sous-objets de self (mots-clés).
64 La clé du dictionnaire est le nom du mot-clé et la valeur l'objet de
65 définition correspondant. Cet attribut est initialisé avec l'argument
66 args de la méthode __init__
69 # Initialisation des attributs
73 if type(regles) == tuple:
76 self.regles = (regles,)
78 self.condition = condition
80 self.affecter_parente()
82 def __call__(self, val, nom, parent=None):
84 Construit un objet MCBLOC a partir de sa definition (self)
85 de sa valeur (val), de son nom (nom) et de son parent dans l arboresence (parent)
87 return self.class_instance(nom=nom, definition=self, val=val, parent=parent)
91 Cette méthode vérifie si les attributs de définition sont valides.
92 Les éventuels messages d'erreur sont écrits dans l'objet compte-rendu (self.cr).
97 self.check_statut(into=('f', 'o'))
98 self.check_condition()
99 self.verif_cata_regles()
101 def verif_presence(self, dict, globs):
103 Cette méthode vérifie si le dictionnaire passé en argument (dict)
104 est susceptible de contenir un bloc de mots-clés conforme à la
105 définition qu'il porte.
107 Si la réponse est oui, la méthode retourne 1
109 Si la réponse est non, la méthode retourne 0
111 Le dictionnaire dict a pour clés les noms des mots-clés et pour valeurs
112 les valeurs des mots-clés
114 # On recopie le dictionnaire pour protéger l'original
117 if self.condition != None:
119 test = eval(self.condition, globs, dico)
122 # erreur 'normale' : un mot-clé n'est pas présent et on veut
123 # l'évaluer dans la condition
125 l = traceback.format_exception(
126 sys.exc_info()[0], sys.exc_info()[1], sys.exc_info()[2])
127 print(("WARNING : Erreur a l'evaluation de la condition " + ''.join(l)))
130 # le texte de la condition n'est pas du Python correct -->
132 l = traceback.format_exception(
133 sys.exc_info()[0], sys.exc_info()[1], sys.exc_info()[2])
135 "Catalogue entite : ", self.nom, ", de pere : ", self.pere.nom,
136 '\n', "Erreur dans la condition : ", self.condition, ''.join(l))
138 l = traceback.format_exception(
139 sys.exc_info()[0], sys.exc_info()[1], sys.exc_info()[2])
141 "Catalogue entite : ", self.nom, ", de pere : ", self.pere.nom,
142 '\n', "Erreur dans la condition : ", self.condition, ''.join(l))
148 """Définit un ensemble de fonctions utilisables pour écrire les
149 conditions de BLOC."""
150 def au_moins_un(mcsimp, valeurs):
151 """Valide si la (ou une) valeur de 'mcsimp' est au moins une fois dans
152 la ou les 'valeurs'. Similaire à la règle AU_MOINS_UN, 'mcsimp' peut
153 contenir plusieurs valeurs."""
154 test = set(force_list(mcsimp))
155 valeurs = set(force_list(valeurs))
156 return not test.isdisjoint(valeurs)
158 def aucun(mcsimp, valeurs):
159 """Valide si aucune des valeurs de 'mcsimp' n'est dans 'valeurs'."""
160 return not au_moins_un(mcsimp, valeurs)