Salome HOME
CCAR: rabattre la version V1_15a4 dans la branche principale
[tools/eficas.git] / Noyau / N_ENTITE.py
1 #@ MODIF N_ENTITE Noyau  DATE 14/09/2004   AUTEUR MCOURTOI M.COURTOIS 
2 # -*- coding: iso-8859-1 -*-
3 #            CONFIGURATION MANAGEMENT OF EDF VERSION
4 # ======================================================================
5 # COPYRIGHT (C) 1991 - 2002  EDF R&D                  WWW.CODE-ASTER.ORG
6 # THIS PROGRAM IS FREE SOFTWARE; YOU CAN REDISTRIBUTE IT AND/OR MODIFY
7 # IT UNDER THE TERMS OF THE GNU GENERAL PUBLIC LICENSE AS PUBLISHED BY
8 # THE FREE SOFTWARE FOUNDATION; EITHER VERSION 2 OF THE LICENSE, OR   
9 # (AT YOUR OPTION) ANY LATER VERSION.                                 
10 #
11 # THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT 
12 # WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF          
13 # MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SEE THE GNU    
14 # GENERAL PUBLIC LICENSE FOR MORE DETAILS.                            
15 #
16 # YOU SHOULD HAVE RECEIVED A COPY OF THE GNU GENERAL PUBLIC LICENSE   
17 # ALONG WITH THIS PROGRAM; IF NOT, WRITE TO EDF R&D CODE_ASTER,       
18 #    1 AVENUE DU GENERAL DE GAULLE, 92141 CLAMART CEDEX, FRANCE.      
19 #                                                                       
20 #                                                                       
21 # ======================================================================
22
23
24 """ 
25     Ce module contient la classe ENTITE qui est la classe de base
26     de toutes les classes de definition d'EFICAS.
27 """
28
29 import N_CR
30 import N_VALIDATOR
31
32 class ENTITE:
33    """
34       Classe de base pour tous les objets de definition : mots cles et commandes
35       Cette classe ne contient que des methodes utilitaires
36       Elle ne peut etre instanciee et doit d abord etre specialisee
37    """
38    CR=N_CR.CR
39    factories={'validator':N_VALIDATOR.validatorFactory}
40
41    def __init__(self,validators=None):
42       """
43          Initialise les deux attributs regles et entites d'une classe dérivée
44          à : pas de règles et pas de sous-entités.
45         
46          L'attribut regles doit contenir la liste des regles qui s'appliquent 
47          sur ses sous-entités
48
49          L'attribut entités doit contenir le dictionnaires des sous-entités 
50          (clé = nom, valeur=objet)
51       """
52       self.regles=()
53       self.entites={}
54       if validators:
55          self.validators=self.factories['validator'](validators)
56       else:
57          self.validators=validators
58
59    def affecter_parente(self):
60       """
61           Cette methode a pour fonction de donner un nom et un pere aux
62           sous entités qui n'ont aucun moyen pour atteindre leur parent 
63           directement
64           Il s'agit principalement des mots cles 
65       """
66       for k,v in self.entites.items():
67         v.pere = self
68         v.nom = k
69
70    def verif_cata(self):
71       """
72           Cette methode sert à valider les attributs de l'objet de définition
73       """
74       raise "La méthode verif_cata de la classe %s doit etre implémentée" % self.__class__.__name__
75
76    def __call__(self):
77       """
78           Cette methode doit retourner un objet dérivé de la classe OBJECT
79       """
80       raise "La méthode __call__ de la classe %s doit etre implémentée" % self.__class__.__name__
81
82    def report(self):
83       """
84          Cette méthode construit pour tous les objets dérivés de ENTITE un 
85          rapport de validation de la définition portée par cet objet
86       """
87       self.cr = self.CR()
88       self.verif_cata()
89       for k,v in self.entites.items() :
90          try :
91             cr = v.report()
92             cr.debut = "Début "+v.__class__.__name__+ ' : ' + k
93             cr.fin = "Fin "+v.__class__.__name__+ ' : ' + k
94             self.cr.add(cr)
95          except:
96             self.cr.fatal("Impossible d'obtenir le rapport de %s %s" %(k,`v`))
97             print "Impossible d'obtenir le rapport de %s %s" %(k,`v`)
98             print "père =",self
99       return self.cr
100
101    def verif_cata_regles(self):
102       """
103          Cette méthode vérifie pour tous les objets dérivés de ENTITE que 
104          les objets REGLES associés ne portent que sur des sous-entités 
105          existantes
106       """
107       for regle in self.regles :
108         l=[]
109         for mc in regle.mcs :
110           if not self.entites.has_key(mc) :
111             l.append(mc)
112         if l != [] :
113           txt = str(regle)
114           self.cr.fatal("Argument(s) non permis : %s pour la règle : %s" %(`l`,txt))
115
116