Na}{

File Content: `_globals.py`

"""
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.

"""
__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.

    """


ModuleDeprecationWarning.__module__ = 'numpy'


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.

    """


VisibleDeprecationWarning.__module__ = 'numpy'


class _NoValueType:
    """Special keyword value.

    The instance of this class may be used as the default value assigned to a
    keyword if no other obvious default (e.g., `None`) is suitable,

    Common reasons for using this keyword are:

    - A new keyword is added to a function, and that function forwards its
      inputs to another function or method which can be defined outside of
      NumPy. For example, ``np.std(x)`` calls ``x.std``, so when a ``keepdims``
      keyword was added that could only be forwarded if the user explicitly
      specified ``keepdims``; downstream array libraries may not have added
      the same keyword, so adding ``x.std(..., keepdims=keepdims)``
      unconditionally could have broken previously working code.
    - A keyword is being deprecated, and a deprecation warning must only be
      emitted when the keyword is used.

    """
    __instance = None
    def __new__(cls):
        # ensure that only one instance exists
        if not cls.__instance:
            cls.__instance = super().__new__(cls)
        return cls.__instance

    # needed for python 2 to preserve identity through a pickle
    def __reduce__(self):
        return (self.__class__, ())

    def __repr__(self):
        return "<no value>"


_NoValue = _NoValueType()

Name	Size	Permission
__pycache__	---	0755
compat	---	0755
core	---	0755
distutils	---	0755
doc	---	0755
f2py	---	0755
fft	---	0755
lib	---	0755
linalg	---	0755
ma	---	0755
matrixlib	---	0755
polynomial	---	0755
random	---	0755
testing	---	0755
tests	---	0755
typing	---	0755
LICENSE.txt	1543 bytes	0644
__config__.py	4090 bytes	0644
__init__.cython-30.pxd	36238 bytes	0644
__init__.pxd	34606 bytes	0644
__init__.py	15899 bytes	0644
__init__.pyi	133925 bytes	0644
_distributor_init.py	331 bytes	0644
_globals.py	2949 bytes	0644
_pytesttester.py	6302 bytes	0644
_version.py	498 bytes	0644
char.pyi	1715 bytes	0644
conftest.py	4031 bytes	0644
ctypeslib.py	17550 bytes	0644
ctypeslib.pyi	451 bytes	0644
dual.py	2214 bytes	0644
matlib.py	10365 bytes	0644
py.typed	0 bytes	0644
rec.pyi	971 bytes	0644
setup.py	983 bytes	0644
version.py	371 bytes	0644

File Content: _globals.py

File Content: `_globals.py`