63 lines
1.8 KiB
Python
63 lines
1.8 KiB
Python
|
"""
|
||
|
Module defining global singleton classes.
|
||
|
|
||
|
This module raises a RuntimeError if an attempt to reload it is made. In that
|
||
|
way the identities of the classes defined here are fixed and will remain so
|
||
|
even if numpy itself is reloaded. In particular, a function like the following
|
||
|
will still work correctly after numpy is reloaded::
|
||
|
|
||
|
def foo(arg=np._NoValue):
|
||
|
if arg is np._NoValue:
|
||
|
...
|
||
|
|
||
|
That was not the case when the singleton classes were defined in the numpy
|
||
|
``__init__.py`` file. See gh-7844 for a discussion of the reload problem that
|
||
|
motivated this module.
|
||
|
|
||
|
"""
|
||
|
from __future__ import division, absolute_import, print_function
|
||
|
|
||
|
|
||
|
__ALL__ = [
|
||
|
'ModuleDeprecationWarning', 'VisibleDeprecationWarning', '_NoValue'
|
||
|
]
|
||
|
|
||
|
|
||
|
# Disallow reloading this module so as to preserve the identities of the
|
||
|
# classes defined here.
|
||
|
if '_is_loaded' in globals():
|
||
|
raise RuntimeError('Reloading numpy._globals is not allowed')
|
||
|
_is_loaded = True
|
||
|
|
||
|
|
||
|
class ModuleDeprecationWarning(DeprecationWarning):
|
||
|
"""Module deprecation warning.
|
||
|
|
||
|
The nose tester turns ordinary Deprecation warnings into test failures.
|
||
|
That makes it hard to deprecate whole modules, because they get
|
||
|
imported by default. So this is a special Deprecation warning that the
|
||
|
nose tester will let pass without making tests fail.
|
||
|
|
||
|
"""
|
||
|
pass
|
||
|
|
||
|
|
||
|
class VisibleDeprecationWarning(UserWarning):
|
||
|
"""Visible deprecation warning.
|
||
|
|
||
|
By default, python will not show deprecation warnings, so this class
|
||
|
can be used when a very visible warning is helpful, for example because
|
||
|
the usage is most likely a user bug.
|
||
|
|
||
|
"""
|
||
|
pass
|
||
|
|
||
|
|
||
|
class _NoValue(object):
|
||
|
"""Special keyword value.
|
||
|
|
||
|
This class may be used as the default value assigned to a deprecated
|
||
|
keyword in order to check if it has been given a user defined value.
|
||
|
"""
|
||
|
pass
|