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 sert à nommer les concepts produits par les commandes.
23 Le nom du concept est obtenu en appelant la fonction GetNomConceptResultat
24 du module avec le nom de la commande en argument.
26 Cette fonction parcourt le source dans lequel la commande se trouve, parse le
27 fichier et retrouve le nom du concept qui se trouve à gauche du signe = précédant
28 le nom de la commande.
30 Cette fonction utilise la fonction cur_frame du module N_utils qui retourne la frame
31 d'exécution Python située 2 niveaux au-dessus. C'est à partir de cette frame que
32 l'on retrouve le fichier source et le numéro de ligne où se trouve l'appel à la commande.
40 from functools import partial
44 from strfunc import get_encoding
46 regex1 = '=?\s*%s\s*\('
47 # commentaire standard precede d'un nombre quelconque de blancs (pas
49 pattern_comment = re.compile(r"^\s*#.*")
52 def _GetNomConceptResultat(ope, level=2):
54 Cette fonction recherche dans la pile des appels, l'appel à la commande
55 qui doit etre situé à 2 niveaux au-dessus (cur_frame(2)).
56 On retrouve d'abord la frame d'exécution f. Puis le numéro de la ligne
57 dans le source f.f_lineno et le nom du fichier source (f.f_code.co_filename).
58 A partir de là, on récupère la ligne de source avec linecache.getline
59 et on vérifie que cette ligne correspond véritablement à l'appel.
61 En effet, lorsque les commandes tiennent sur plusieurs lignes, on retrouve
62 la dernière ligne. Il faut donc remonter dans le source jusqu'à la première
65 Enfin la fonction evalnom forme un nom acceptable lorsque le concept est un
66 élément d'une liste, par exemple.
69 f = N_utils.cur_frame(level)
70 lineno = f.f_lineno # XXX Too bad if -O is used
71 # lineno = f_lineno(f) # Ne marche pas toujours
73 filename = unicode(co.co_filename, get_encoding())
75 # pattern pour identifier le debut de la commande
76 pattern_oper = re.compile(regex1 % ope)
80 line = linecache.getline(filename, lineno)
82 if pattern_comment.match(line):
85 if pattern_oper.search(line):
86 l = pattern_oper.split(line)
88 # On suppose que le concept resultat a bien ete
89 # isole en tete de la ligne de source
90 m = evalnom(string.strip(l[0]), f.f_locals)
96 # print "appel inconnu"
100 def evalnom(text, d):
102 Retourne un nom pour le concept resultat identifie par text
103 Pour obtenir ce nom il y a plusieurs possibilites :
104 1. text est un identificateur python c'est le nom du concept
105 2. text est un element d'une liste on construit le nom en
106 evaluant la partie indice dans le contexte de l'appelant d
108 l = re.split('([\[\]]+)', text)
115 ll = re.split('[ ,]+', s)
123 if i + 1 < len(l) and l[i + 1] == '[': # le nom est suivi d un subscript
125 nom = id0 + '_' + str(eval(sub, d))
136 Calcule le numero de ligne courant
137 Devrait marcher meme avec -O
138 Semble ne pas marcher en présence de tuples longs
141 if not hasattr(c, 'co_lnotab'):
144 line = c.co_firstlineno
147 for i in range(0, len(tab), 2):
148 addr = addr + ord(tab[i])
151 line = line + ord(tab[i + 1])
155 class NamingSystem(N_utils.Singleton):
157 """Cette classe définit un système de nommage dynamique des concepts."""
158 _singleton_id = 'nommage.NamingSystem'
162 self.native = _GetNomConceptResultat
163 self.use_global_naming()
165 def use_naming_function(self, function):
166 """Utilise une fonction particulière de nommage."""
167 self.naming_func = function
169 def use_global_naming(self):
170 """Utilise la fonction native de nommage."""
171 self.naming_func = partial(self.native, level=3)
173 def __call__(self, *args):
174 """Appel à la fonction de nommage."""
175 return self.naming_func(*args)
177 GetNomConceptResultat = NamingSystem()