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.
37 from __future__ import absolute_import
39 from builtins import str
40 from builtins import range
45 from functools import partial
49 from .strfunc import get_encoding
51 from six.moves import range
53 regex1 = '=?\s*%s\s*\('
54 # commentaire standard precede d'un nombre quelconque de blancs (pas
56 pattern_comment = re.compile(r"^\s*#.*")
59 def _GetNomConceptResultat(ope, level=2):
61 Cette fonction recherche dans la pile des appels, l'appel à la commande
62 qui doit etre situé à 2 niveaux au-dessus (cur_frame(2)).
63 On retrouve d'abord la frame d'exécution f. Puis le numéro de la ligne
64 dans le source f.f_lineno et le nom du fichier source (f.f_code.co_filename).
65 A partir de là, on récupère la ligne de source avec linecache.getline
66 et on vérifie que cette ligne correspond véritablement à l'appel.
68 En effet, lorsque les commandes tiennent sur plusieurs lignes, on retrouve
69 la dernière ligne. Il faut donc remonter dans le source jusqu'à la première
72 Enfin la fonction evalnom forme un nom acceptable lorsque le concept est un
73 élément d'une liste, par exemple.
76 f = N_utils.cur_frame(level)
77 lineno = f.f_lineno # XXX Too bad if -O is used
78 # lineno = f_lineno(f) # Ne marche pas toujours
80 filename = six.text_type(co.co_filename, get_encoding())
82 # pattern pour identifier le debut de la commande
83 pattern_oper = re.compile(regex1 % ope)
87 line = linecache.getline(filename, lineno)
89 if pattern_comment.match(line):
92 if pattern_oper.search(line):
93 l = pattern_oper.split(line)
95 # On suppose que le concept resultat a bien ete
96 # isole en tete de la ligne de source
97 m = evalnom(l[0].strip(), f.f_locals)
103 # print "appel inconnu"
107 def evalnom(text, d):
109 Retourne un nom pour le concept resultat identifie par text
110 Pour obtenir ce nom il y a plusieurs possibilites :
111 1. text est un identificateur python c'est le nom du concept
112 2. text est un element d'une liste on construit le nom en
113 evaluant la partie indice dans le contexte de l'appelant d
115 l = re.split('([\[\]]+)', text)
122 ll = re.split('[ ,]+', s)
130 if i + 1 < len(l) and l[i + 1] == '[': # le nom est suivi d un subscript
132 nom = id0 + '_' + str(eval(sub, d))
143 Calcule le numero de ligne courant
144 Devrait marcher meme avec -O
145 Semble ne pas marcher en présence de tuples longs
148 if not hasattr(c, 'co_lnotab'):
151 line = c.co_firstlineno
154 for i in range(0, len(tab), 2):
155 addr = addr + ord(tab[i])
158 line = line + ord(tab[i + 1])
162 class NamingSystem(N_utils.Singleton):
164 """Cette classe définit un système de nommage dynamique des concepts."""
165 _singleton_id = 'nommage.NamingSystem'
169 self.native = _GetNomConceptResultat
170 self.use_global_naming()
172 def use_naming_function(self, function):
173 """Utilise une fonction particulière de nommage."""
174 self.naming_func = function
176 def use_global_naming(self):
177 """Utilise la fonction native de nommage."""
178 self.naming_func = partial(self.native, level=3)
180 def __call__(self, *args):
181 """Appel à la fonction de nommage."""
182 return self.naming_func(*args)
184 GetNomConceptResultat = NamingSystem()