##// END OF EJS Templates
manifest: add some documentation to _lazymanifest python code...
manifest: add some documentation to _lazymanifest python code It was not particularly easy figuring out the design of this class and keeping track of how the pieces work. So might as well write some of it down for the next person.

File last commit:

r37862:670eb4fa default
r42570:c3484ddb 5.0.1 stable
Show More
__init__.py
78 lines | 2.4 KiB | text/x-python | PythonLexer
Siddharth Agarwal
demandimport: move to separate package...
r32420 # hgdemandimport - global demand-loading of modules for Mercurial
#
# Copyright 2017 Facebook Inc.
#
# This software may be used and distributed according to the terms of the
# GNU General Public License version 2 or any later version.
'''demandimport - automatic demand-loading of modules'''
# This is in a separate package from mercurial because in Python 3,
# demand loading is per-package. Keeping demandimport in the mercurial package
# would disable demand loading for any modules in mercurial.
from __future__ import absolute_import
Jun Wu
demandimport: move HGDEMANDIMPORT test to __init__.py...
r33861 import os
Siddharth Agarwal
demandimport: move ignore list to __init__.py...
r32422 import sys
Siddharth Agarwal
demandimport: add python 3 implementation...
r32423 if sys.version_info[0] >= 3:
from . import demandimportpy3 as demandimport
else:
from . import demandimportpy2 as demandimport
Siddharth Agarwal
demandimport: move to separate package...
r32420
Gregory Szorc
demandimport: make module ignores a set (API)...
r37862 # Full module names which can't be lazy imported.
# Extensions can add to this set.
IGNORES = {
Siddharth Agarwal
demandimport: move ignore list to __init__.py...
r32422 '__future__',
'_hashlib',
# ImportError during pkg_resources/__init__.py:fixup_namespace_package
'_imp',
'_xmlplus',
'fcntl',
'nt', # pathlib2 tests the existence of built-in 'nt' module
'win32com.gen_py',
'win32com.shell', # 'appdirs' tries to import win32com.shell
'_winreg', # 2.7 mimetypes needs immediate ImportError
'pythoncom',
# imported by tarfile, not available under Windows
'pwd',
'grp',
# imported by profile, itself imported by hotshot.stats,
# not available under Windows
'resource',
# this trips up many extension authors
'gtk',
# setuptools' pkg_resources.py expects "from __main__ import x" to
# raise ImportError if x not defined
'__main__',
'_ssl', # conditional imports in the stdlib, issue1964
'_sre', # issue4920
'rfc822',
'mimetools',
'sqlalchemy.events', # has import-time side effects (issue5085)
# setuptools 8 expects this module to explode early when not on windows
'distutils.msvc9compiler',
'__builtin__',
'builtins',
'urwid.command_map', # for pudb
Gregory Szorc
demandimport: make module ignores a set (API)...
r37862 }
Siddharth Agarwal
demandimport: move ignore list to __init__.py...
r32422
_pypy = '__pypy__' in sys.builtin_module_names
if _pypy:
Gregory Szorc
demandimport: make module ignores a set (API)...
r37862 # _ctypes.pointer is shadowed by "from ... import pointer" (PyPy 5)
IGNORES.add('_ctypes.pointer')
Siddharth Agarwal
demandimport: move ignore list to __init__.py...
r32422
Gregory Szorc
demandimport: make module ignores a set (API)...
r37862 demandimport.init(IGNORES)
Siddharth Agarwal
demandimport: move ignore list to __init__.py...
r32422
Siddharth Agarwal
demandimport: move to separate package...
r32420 # Re-export.
isenabled = demandimport.isenabled
disable = demandimport.disable
deactivated = demandimport.deactivated
Jun Wu
demandimport: move HGDEMANDIMPORT test to __init__.py...
r33861
def enable():
Jun Wu
demandimport: disable if chg is being used...
r33862 # chg pre-imports modules so do not enable demandimport for it
if ('CHGINTERNALMARK' not in os.environ
and os.environ.get('HGDEMANDIMPORT') != 'disable'):
Jun Wu
demandimport: move HGDEMANDIMPORT test to __init__.py...
r33861 demandimport.enable()