| """ | |
| This disables builtin functions (and one exception class) which are | |
| removed from Python 3.3. | |
| This module is designed to be used like this:: | |
| from future.builtins.disabled import * | |
| This disables the following obsolete Py2 builtin functions:: | |
| apply, cmp, coerce, execfile, file, input, long, | |
| raw_input, reduce, reload, unicode, xrange | |
| We don't hack __builtin__, which is very fragile because it contaminates | |
| imported modules too. Instead, we just create new functions with | |
| the same names as the obsolete builtins from Python 2 which raise | |
| NameError exceptions when called. | |
| Note that both ``input()`` and ``raw_input()`` are among the disabled | |
| functions (in this module). Although ``input()`` exists as a builtin in | |
| Python 3, the Python 2 ``input()`` builtin is unsafe to use because it | |
| can lead to shell injection. Therefore we shadow it by default upon ``from | |
| future.builtins.disabled import *``, in case someone forgets to import our | |
| replacement ``input()`` somehow and expects Python 3 semantics. | |
| See the ``future.builtins.misc`` module for a working version of | |
| ``input`` with Python 3 semantics. | |
| (Note that callable() is not among the functions disabled; this was | |
| reintroduced into Python 3.2.) | |
| This exception class is also disabled: | |
| StandardError | |
| """ | |
| from __future__ import division, absolute_import, print_function | |
| from future import utils | |
| OBSOLETE_BUILTINS = ['apply', 'chr', 'cmp', 'coerce', 'execfile', 'file', | |
| 'input', 'long', 'raw_input', 'reduce', 'reload', | |
| 'unicode', 'xrange', 'StandardError'] | |
| def disabled_function(name): | |
| ''' | |
| Returns a function that cannot be called | |
| ''' | |
| def disabled(*args, **kwargs): | |
| ''' | |
| A function disabled by the ``future`` module. This function is | |
| no longer a builtin in Python 3. | |
| ''' | |
| raise NameError('obsolete Python 2 builtin {0} is disabled'.format(name)) | |
| return disabled | |
| if not utils.PY3: | |
| for fname in OBSOLETE_BUILTINS: | |
| locals()[fname] = disabled_function(fname) | |
| __all__ = OBSOLETE_BUILTINS | |
| else: | |
| __all__ = [] | |