##// END OF EJS Templates
demandimport: add support for PyPy...
Bryan O'Sullivan -
r27536:f7d890bc default
parent child Browse files
Show More
@@ -1,270 +1,282
1 # demandimport.py - global demand-loading of modules for Mercurial
1 # demandimport.py - global demand-loading of modules for Mercurial
2 #
2 #
3 # Copyright 2006, 2007 Matt Mackall <mpm@selenic.com>
3 # Copyright 2006, 2007 Matt Mackall <mpm@selenic.com>
4 #
4 #
5 # This software may be used and distributed according to the terms of the
5 # This software may be used and distributed according to the terms of the
6 # GNU General Public License version 2 or any later version.
6 # GNU General Public License version 2 or any later version.
7
7
8 '''
8 '''
9 demandimport - automatic demandloading of modules
9 demandimport - automatic demandloading of modules
10
10
11 To enable this module, do:
11 To enable this module, do:
12
12
13 import demandimport; demandimport.enable()
13 import demandimport; demandimport.enable()
14
14
15 Imports of the following forms will be demand-loaded:
15 Imports of the following forms will be demand-loaded:
16
16
17 import a, b.c
17 import a, b.c
18 import a.b as c
18 import a.b as c
19 from a import b,c # a will be loaded immediately
19 from a import b,c # a will be loaded immediately
20
20
21 These imports will not be delayed:
21 These imports will not be delayed:
22
22
23 from a import *
23 from a import *
24 b = __import__(a)
24 b = __import__(a)
25 '''
25 '''
26
26
27 from __future__ import absolute_import
27 from __future__ import absolute_import
28
28
29 import contextlib
29 import contextlib
30 import os
30 import os
31 import sys
31 import sys
32
32
33 # __builtin__ in Python 2, builtins in Python 3.
33 # __builtin__ in Python 2, builtins in Python 3.
34 try:
34 try:
35 import __builtin__ as builtins
35 import __builtin__ as builtins
36 except ImportError:
36 except ImportError:
37 import builtins
37 import builtins
38
38
39 contextmanager = contextlib.contextmanager
39 contextmanager = contextlib.contextmanager
40
40
41 _origimport = __import__
41 _origimport = __import__
42
42
43 nothing = object()
43 nothing = object()
44
44
45 # Python 3 doesn't have relative imports nor level -1.
45 # Python 3 doesn't have relative imports nor level -1.
46 level = -1
46 level = -1
47 if sys.version_info[0] >= 3:
47 if sys.version_info[0] >= 3:
48 level = 0
48 level = 0
49 _import = _origimport
49 _import = _origimport
50
50
51 def _hgextimport(importfunc, name, globals, *args, **kwargs):
51 def _hgextimport(importfunc, name, globals, *args, **kwargs):
52 try:
52 try:
53 return importfunc(name, globals, *args, **kwargs)
53 return importfunc(name, globals, *args, **kwargs)
54 except ImportError:
54 except ImportError:
55 if not globals:
55 if not globals:
56 raise
56 raise
57 # extensions are loaded with "hgext_" prefix
57 # extensions are loaded with "hgext_" prefix
58 hgextname = 'hgext_%s' % name
58 hgextname = 'hgext_%s' % name
59 nameroot = hgextname.split('.', 1)[0]
59 nameroot = hgextname.split('.', 1)[0]
60 contextroot = globals.get('__name__', '').split('.', 1)[0]
60 contextroot = globals.get('__name__', '').split('.', 1)[0]
61 if nameroot != contextroot:
61 if nameroot != contextroot:
62 raise
62 raise
63 # retry to import with "hgext_" prefix
63 # retry to import with "hgext_" prefix
64 return importfunc(hgextname, globals, *args, **kwargs)
64 return importfunc(hgextname, globals, *args, **kwargs)
65
65
66 class _demandmod(object):
66 class _demandmod(object):
67 """module demand-loader and proxy"""
67 """module demand-loader and proxy"""
68 def __init__(self, name, globals, locals, level=level):
68 def __init__(self, name, globals, locals, level=level):
69 if '.' in name:
69 if '.' in name:
70 head, rest = name.split('.', 1)
70 head, rest = name.split('.', 1)
71 after = [rest]
71 after = [rest]
72 else:
72 else:
73 head = name
73 head = name
74 after = []
74 after = []
75 object.__setattr__(self, "_data",
75 object.__setattr__(self, "_data",
76 (head, globals, locals, after, level, set()))
76 (head, globals, locals, after, level, set()))
77 object.__setattr__(self, "_module", None)
77 object.__setattr__(self, "_module", None)
78 def _extend(self, name):
78 def _extend(self, name):
79 """add to the list of submodules to load"""
79 """add to the list of submodules to load"""
80 self._data[3].append(name)
80 self._data[3].append(name)
81
81
82 def _addref(self, name):
82 def _addref(self, name):
83 """Record that the named module ``name`` imports this module.
83 """Record that the named module ``name`` imports this module.
84
84
85 References to this proxy class having the name of this module will be
85 References to this proxy class having the name of this module will be
86 replaced at module load time. We assume the symbol inside the importing
86 replaced at module load time. We assume the symbol inside the importing
87 module is identical to the "head" name of this module. We don't
87 module is identical to the "head" name of this module. We don't
88 actually know if "as X" syntax is being used to change the symbol name
88 actually know if "as X" syntax is being used to change the symbol name
89 because this information isn't exposed to __import__.
89 because this information isn't exposed to __import__.
90 """
90 """
91 self._data[5].add(name)
91 self._data[5].add(name)
92
92
93 def _load(self):
93 def _load(self):
94 if not self._module:
94 if not self._module:
95 head, globals, locals, after, level, modrefs = self._data
95 head, globals, locals, after, level, modrefs = self._data
96 mod = _hgextimport(_import, head, globals, locals, None, level)
96 mod = _hgextimport(_import, head, globals, locals, None, level)
97 # load submodules
97 # load submodules
98 def subload(mod, p):
98 def subload(mod, p):
99 h, t = p, None
99 h, t = p, None
100 if '.' in p:
100 if '.' in p:
101 h, t = p.split('.', 1)
101 h, t = p.split('.', 1)
102 if getattr(mod, h, nothing) is nothing:
102 if getattr(mod, h, nothing) is nothing:
103 setattr(mod, h, _demandmod(p, mod.__dict__, mod.__dict__))
103 setattr(mod, h, _demandmod(p, mod.__dict__, mod.__dict__))
104 elif t:
104 elif t:
105 subload(getattr(mod, h), t)
105 subload(getattr(mod, h), t)
106
106
107 for x in after:
107 for x in after:
108 subload(mod, x)
108 subload(mod, x)
109
109
110 # Replace references to this proxy instance with the actual module.
110 # Replace references to this proxy instance with the actual module.
111 if locals and locals.get(head) == self:
111 if locals and locals.get(head) == self:
112 locals[head] = mod
112 locals[head] = mod
113
113
114 for modname in modrefs:
114 for modname in modrefs:
115 modref = sys.modules.get(modname, None)
115 modref = sys.modules.get(modname, None)
116 if modref and getattr(modref, head, None) == self:
116 if modref and getattr(modref, head, None) == self:
117 setattr(modref, head, mod)
117 setattr(modref, head, mod)
118
118
119 object.__setattr__(self, "_module", mod)
119 object.__setattr__(self, "_module", mod)
120
120
121 def __repr__(self):
121 def __repr__(self):
122 if self._module:
122 if self._module:
123 return "<proxied module '%s'>" % self._data[0]
123 return "<proxied module '%s'>" % self._data[0]
124 return "<unloaded module '%s'>" % self._data[0]
124 return "<unloaded module '%s'>" % self._data[0]
125 def __call__(self, *args, **kwargs):
125 def __call__(self, *args, **kwargs):
126 raise TypeError("%s object is not callable" % repr(self))
126 raise TypeError("%s object is not callable" % repr(self))
127 def __getattribute__(self, attr):
127 def __getattribute__(self, attr):
128 if attr in ('_data', '_extend', '_load', '_module', '_addref'):
128 if attr in ('_data', '_extend', '_load', '_module', '_addref'):
129 return object.__getattribute__(self, attr)
129 return object.__getattribute__(self, attr)
130 self._load()
130 self._load()
131 return getattr(self._module, attr)
131 return getattr(self._module, attr)
132 def __setattr__(self, attr, val):
132 def __setattr__(self, attr, val):
133 self._load()
133 self._load()
134 setattr(self._module, attr, val)
134 setattr(self._module, attr, val)
135
135
136 _pypy = '__pypy__' in sys.builtin_module_names
137
136 def _demandimport(name, globals=None, locals=None, fromlist=None, level=level):
138 def _demandimport(name, globals=None, locals=None, fromlist=None, level=level):
137 if not locals or name in ignore or fromlist == ('*',):
139 if not locals or name in ignore or fromlist == ('*',):
138 # these cases we can't really delay
140 # these cases we can't really delay
139 return _hgextimport(_import, name, globals, locals, fromlist, level)
141 return _hgextimport(_import, name, globals, locals, fromlist, level)
140 elif not fromlist:
142 elif not fromlist:
141 # import a [as b]
143 # import a [as b]
142 if '.' in name: # a.b
144 if '.' in name: # a.b
143 base, rest = name.split('.', 1)
145 base, rest = name.split('.', 1)
144 # email.__init__ loading email.mime
146 # email.__init__ loading email.mime
145 if globals and globals.get('__name__', None) == base:
147 if globals and globals.get('__name__', None) == base:
146 return _import(name, globals, locals, fromlist, level)
148 return _import(name, globals, locals, fromlist, level)
147 # if a is already demand-loaded, add b to its submodule list
149 # if a is already demand-loaded, add b to its submodule list
148 if base in locals:
150 if base in locals:
149 if isinstance(locals[base], _demandmod):
151 if isinstance(locals[base], _demandmod):
150 locals[base]._extend(rest)
152 locals[base]._extend(rest)
151 return locals[base]
153 return locals[base]
152 return _demandmod(name, globals, locals, level)
154 return _demandmod(name, globals, locals, level)
153 else:
155 else:
154 # There is a fromlist.
156 # There is a fromlist.
155 # from a import b,c,d
157 # from a import b,c,d
156 # from . import b,c,d
158 # from . import b,c,d
157 # from .a import b,c,d
159 # from .a import b,c,d
158
160
159 # level == -1: relative and absolute attempted (Python 2 only).
161 # level == -1: relative and absolute attempted (Python 2 only).
160 # level >= 0: absolute only (Python 2 w/ absolute_import and Python 3).
162 # level >= 0: absolute only (Python 2 w/ absolute_import and Python 3).
161 # The modern Mercurial convention is to use absolute_import everywhere,
163 # The modern Mercurial convention is to use absolute_import everywhere,
162 # so modern Mercurial code will have level >= 0.
164 # so modern Mercurial code will have level >= 0.
163
165
164 # The name of the module the import statement is located in.
166 # The name of the module the import statement is located in.
165 globalname = globals.get('__name__')
167 globalname = globals.get('__name__')
166
168
167 def processfromitem(mod, attr):
169 def processfromitem(mod, attr):
168 """Process an imported symbol in the import statement.
170 """Process an imported symbol in the import statement.
169
171
170 If the symbol doesn't exist in the parent module, it must be a
172 If the symbol doesn't exist in the parent module, it must be a
171 module. We set missing modules up as _demandmod instances.
173 module. We set missing modules up as _demandmod instances.
172 """
174 """
173 symbol = getattr(mod, attr, nothing)
175 symbol = getattr(mod, attr, nothing)
174 if symbol is nothing:
176 if symbol is nothing:
175 symbol = _demandmod(attr, mod.__dict__, locals, level=1)
177 symbol = _demandmod(attr, mod.__dict__, locals, level=1)
176 setattr(mod, attr, symbol)
178 setattr(mod, attr, symbol)
177
179
178 # Record the importing module references this symbol so we can
180 # Record the importing module references this symbol so we can
179 # replace the symbol with the actual module instance at load
181 # replace the symbol with the actual module instance at load
180 # time.
182 # time.
181 if globalname and isinstance(symbol, _demandmod):
183 if globalname and isinstance(symbol, _demandmod):
182 symbol._addref(globalname)
184 symbol._addref(globalname)
183
185
184 if level >= 0:
186 if level >= 0:
185 # Mercurial's enforced import style does not use
187 # Mercurial's enforced import style does not use
186 # "from a import b,c,d" or "from .a import b,c,d" syntax. In
188 # "from a import b,c,d" or "from .a import b,c,d" syntax. In
187 # addition, this appears to be giving errors with some modules
189 # addition, this appears to be giving errors with some modules
188 # for unknown reasons. Since we shouldn't be using this syntax
190 # for unknown reasons. Since we shouldn't be using this syntax
189 # much, work around the problems.
191 # much, work around the problems.
190 if name:
192 if name:
191 return _hgextimport(_origimport, name, globals, locals,
193 return _hgextimport(_origimport, name, globals, locals,
192 fromlist, level)
194 fromlist, level)
193
195
194 mod = _hgextimport(_origimport, name, globals, locals, level=level)
196 if _pypy:
197 # PyPy's __import__ throws an exception if invoked
198 # with an empty name and no fromlist. Recreate the
199 # desired behaviour by hand.
200 mn = globalname
201 mod = sys.modules[mn]
202 if getattr(mod, '__path__', nothing) is nothing:
203 mn = mn.rsplit('.', 1)[0]
204 mod = sys.modules[mn]
205 if level > 1:
206 mn = mn.rsplit('.', level - 1)[0]
207 mod = sys.modules[mn]
208 else:
209 mod = _hgextimport(_origimport, name, globals, locals,
210 level=level)
195
211
196 for x in fromlist:
212 for x in fromlist:
197 processfromitem(mod, x)
213 processfromitem(mod, x)
198
214
199 return mod
215 return mod
200
216
201 # But, we still need to support lazy loading of standard library and 3rd
217 # But, we still need to support lazy loading of standard library and 3rd
202 # party modules. So handle level == -1.
218 # party modules. So handle level == -1.
203 mod = _hgextimport(_origimport, name, globals, locals)
219 mod = _hgextimport(_origimport, name, globals, locals)
204 # recurse down the module chain
220 # recurse down the module chain
205 for comp in name.split('.')[1:]:
221 for comp in name.split('.')[1:]:
206 if getattr(mod, comp, nothing) is nothing:
222 if getattr(mod, comp, nothing) is nothing:
207 setattr(mod, comp,
223 setattr(mod, comp,
208 _demandmod(comp, mod.__dict__, mod.__dict__))
224 _demandmod(comp, mod.__dict__, mod.__dict__))
209 mod = getattr(mod, comp)
225 mod = getattr(mod, comp)
210
226
211 for x in fromlist:
227 for x in fromlist:
212 processfromitem(mod, x)
228 processfromitem(mod, x)
213
229
214 return mod
230 return mod
215
231
216 ignore = [
232 ignore = [
217 '__future__',
233 '__future__',
218 '_hashlib',
234 '_hashlib',
219 '_xmlplus',
235 '_xmlplus',
220 'fcntl',
236 'fcntl',
221 'win32com.gen_py',
237 'win32com.gen_py',
222 '_winreg', # 2.7 mimetypes needs immediate ImportError
238 '_winreg', # 2.7 mimetypes needs immediate ImportError
223 'pythoncom',
239 'pythoncom',
224 # imported by tarfile, not available under Windows
240 # imported by tarfile, not available under Windows
225 'pwd',
241 'pwd',
226 'grp',
242 'grp',
227 # imported by profile, itself imported by hotshot.stats,
243 # imported by profile, itself imported by hotshot.stats,
228 # not available under Windows
244 # not available under Windows
229 'resource',
245 'resource',
230 # this trips up many extension authors
246 # this trips up many extension authors
231 'gtk',
247 'gtk',
232 # setuptools' pkg_resources.py expects "from __main__ import x" to
248 # setuptools' pkg_resources.py expects "from __main__ import x" to
233 # raise ImportError if x not defined
249 # raise ImportError if x not defined
234 '__main__',
250 '__main__',
235 '_ssl', # conditional imports in the stdlib, issue1964
251 '_ssl', # conditional imports in the stdlib, issue1964
236 '_sre', # issue4920
252 '_sre', # issue4920
237 'rfc822',
253 'rfc822',
238 'mimetools',
254 'mimetools',
239 # setuptools 8 expects this module to explode early when not on windows
255 # setuptools 8 expects this module to explode early when not on windows
240 'distutils.msvc9compiler'
256 'distutils.msvc9compiler'
241 ]
257 ]
242
258
243 def isenabled():
259 def isenabled():
244 return builtins.__import__ == _demandimport
260 return builtins.__import__ == _demandimport
245
261
246 def enable():
262 def enable():
247 "enable global demand-loading of modules"
263 "enable global demand-loading of modules"
248 # PyPy doesn't work with demand import.
249 if '__pypy__' in sys.builtin_module_names:
250 return
251
252 if os.environ.get('HGDEMANDIMPORT') != 'disable':
264 if os.environ.get('HGDEMANDIMPORT') != 'disable':
253 builtins.__import__ = _demandimport
265 builtins.__import__ = _demandimport
254
266
255 def disable():
267 def disable():
256 "disable global demand-loading of modules"
268 "disable global demand-loading of modules"
257 builtins.__import__ = _origimport
269 builtins.__import__ = _origimport
258
270
259 @contextmanager
271 @contextmanager
260 def deactivated():
272 def deactivated():
261 "context manager for disabling demandimport in 'with' blocks"
273 "context manager for disabling demandimport in 'with' blocks"
262 demandenabled = isenabled()
274 demandenabled = isenabled()
263 if demandenabled:
275 if demandenabled:
264 disable()
276 disable()
265
277
266 try:
278 try:
267 yield
279 yield
268 finally:
280 finally:
269 if demandenabled:
281 if demandenabled:
270 enable()
282 enable()
General Comments 0
You need to be logged in to leave comments. Login now