U
|
O ±dª ã @ s d Z ddlZddddgZde kr*edd ZG d
|
d deZd e_G d d de Z
|
d e
|
_G d d dZ e Z G dd dej Zd e_dS )aI
|
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.
|
|
é NÚModuleDeprecationWarningÚVisibleDeprecationWarningÚ_NoValueÚ _CopyModeÚ
|
_is_loadedz'Reloading numpy._globals is not allowedTc @ s e Zd ZdZdS )r a6 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.
|
|
N©Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__© r r úEd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\numpy/_globals.pyr ! s Únumpyc @ s e Zd ZdZdS )r zá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.
|
|
Nr r r r r r / s c s, e Zd ZdZdZ fddZdd Z ZS )Ú _NoValueTypeaW 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.
|
|
Nc s | j st | ¡| _ | j S )N)Ú_NoValueType__instanceÚsuperÚ__new__)Úcls©Ú __class__r r r P s z_NoValueType.__new__c C s dS )Nz
|
<no value>r ©Úselfr r r Ú__repr__V s z_NoValueType.__repr__)r r r
|
r r r r Ú __classcell__r r r r r < s r c @ s$ e Zd ZdZdZdZdZdd ZdS )r a
|
An enumeration for the copy modes supported
|
by numpy.copy() and numpy.array(). The following three modes are supported,
|
|
- ALWAYS: This means that a deep copy of the input
|
array will always be taken.
|
- IF_NEEDED: This means that a deep copy of the input
|
array will be taken only if necessary.
|
- NEVER: This means that the deep copy will never be taken.
|
If a copy cannot be avoided then a `ValueError` will be
|
raised.
|
|
Note that the buffer-protocol could in theory do copies. NumPy currently
|
assumes an object exporting the buffer protocol will never do this.
|
TFé c C s. | t jkrdS | t jkr dS t| dd S )NTFz is neither True nor False.)r ÚALWAYSÚ IF_NEEDEDÚ
|
ValueErrorr r r r Ú__bool__r s
|
|
|
z_CopyMode.__bool__N)r r r
|
r r r ZNEVERr r r r r r ] s
|
)r ÚenumZ__ALL__ÚglobalsÚ RuntimeErrorr ÚDeprecationWarningr r Ú UserWarningr r r ÚEnumr r r r r Ú<module> s" þ
|
|
|
