OwlCyberSecurity - MANAGER
Edit File: utils.cpython-38.pyc
U �p�]� � @ s� d dl mZmZmZ d dlZd dlZd dlZd dlZd dlZd dl m Z m Z m Z d dl mZ d dlmZmZmZ d dlZd dlmZmZ ddd d d d d dddddg Zdd � Zdd� ZG dd� de�Z dd� Z dd � Z dd � Z d d� Z d6d d�Z!d d � Z"da#da$d7d"d#�Z%ej&fd$d%�Z'ed!�dd&ej&d!fd'd ��Z(ed!�ej&fd(d��Z)i a*e�+d)ej,�Z-ed!�d8d,d��Z.d-d.� Z/d/d0� Z0G d1d2� d2e�Z1d3d� Z2d4d5� Z3dS )9� )�division�absolute_import�print_functionN)� issubclass_� issubsctype� issubdtype)� set_module)�ndarray�ufunc�asarray)� getargspec� formatargspecr r r � deprecate�deprecate_with_doc� get_include�info�source�who�lookfor� byte_bounds� safe_evalc C sV ddl } | jdkr.tj�tj�| j�dd�}n$ddlm} tj�tj�|j�d�}|S )a� Return the directory that contains the NumPy \*.h header files. Extension modules that need to compile against NumPy should use this function to locate the appropriate include directory. Notes ----- When using ``distutils``, for example in ``setup.py``. :: import numpy as np ... Extension('extension_name', ... include_dirs=[np.get_include()]) ... r N�coreZinclude) �numpyZ show_config�os�path�join�dirname�__file__� numpy.corer )r �dr � r �1/usr/lib/python3/dist-packages/numpy/lib/utils.pyr s c C s || _ | S �N)�__name__)�func�namer r r! �_set_function_name5 s r& c @ s" e Zd ZdZddd�Zdd� ZdS )� _Deprecatez� Decorator class to deprecate old functions. Refer to `deprecate` for details. See Also -------- deprecate Nc C s || _ || _|| _d S r" )�old_name�new_name�message)�selfr( r) r* r r r! �__init__F s z_Deprecate.__init__c sn | j }| j}| j}|dkr@z �j}W n tk r> �j}Y nX |dkrRd| � n d||f � |dk rr� d| 7 � � �fdd�}t||�}�j}|dkr�� }n�|�� �d�} t | dd� �} | d � � r�| d | }nRt | d �d } | dd� D ](} t | �| k�r �q | t | �d 7 } q�|| d� }d � � |g�}||_z �j } W n tk �r\ Y nX |j �| � |S ) z: Decorator call. Refer to ``decorate``. Nz`%s` is deprecated!z%`%s` is deprecated, use `%s` instead!� c s t j� tdd� �| |�S )z1`arrayrange` is deprecated, use `arange` instead!� �� stacklevel��warnings�warn�DeprecationWarning)�args�kwds�Zdepdocr$ r r! �newfuncb s z$_Deprecate.__call__.<locals>.newfunc� r � z )r( r) r* r# �AttributeErrorr& �__doc__� expandtabs�split� _get_indent�lstrip�lenr �__dict__�update)r+ r$ r5 �kwargsr( r) r* r8 �doc�lines�indent�skip�liner r r7 r! �__call__K sL � z_Deprecate.__call__)NNN)r# � __module__� __qualname__r< r, rJ r r r r! r' : s r' c C sD t j}| D ]&}t|�� �}|r t|t|�| �}q |t jkr@d}|S )zU Determines the leading whitespace that could be removed from all the lines. r )�sys�maxsizerA r@ �min)rF rG rI Zcontentr r r! r? � s r? c O s4 | r&| d }| dd� } t | |�|�S t | |�S dS )a� Issues a DeprecationWarning, adds warning to `old_name`'s docstring, rebinds ``old_name.__name__`` and returns the new function object. This function may also be used as a decorator. Parameters ---------- func : function The function to be deprecated. old_name : str, optional The name of the function to be deprecated. Default is None, in which case the name of `func` is used. new_name : str, optional The new name for the function. Default is None, in which case the deprecation message is that `old_name` is deprecated. If given, the deprecation message is that `old_name` is deprecated and `new_name` should be used instead. message : str, optional Additional explanation of the deprecation. Displayed in the docstring after the warning. Returns ------- old_func : function The deprecated function. Examples -------- Note that ``olduint`` returns a value after printing Deprecation Warning: >>> olduint = np.deprecate(np.uint) DeprecationWarning: `uint64` is deprecated! # may vary >>> olduint(6) 6 r r9 N�r' )r5 rD �fnr r r! r � s , c C s t | d�S )N)r* rP )�msgr r r! �<lambda>� � rS c C s� | j }|d d }|d }|d }t| �jj}| }}|dkrN|| j| 7 }nFt||�D ]2\}} | dk rz||d | 7 }qX||d | 7 }qX||7 }||fS )a# Returns pointers to the end-points of an array. Parameters ---------- a : ndarray Input array. It must conform to the Python-side of the array interface. Returns ------- (low, high) : tuple of 2 integers The first integer is the first byte of the array, the second integer is just past the last byte of the array. If `a` is not contiguous it will not use every byte between the (`low`, `high`) values. Examples -------- >>> I = np.eye(2, dtype='f'); I.dtype dtype('float32') >>> low, high = np.byte_bounds(I) >>> high - low == I.size*I.itemsize True >>> I = np.eye(2); I.dtype dtype('float64') >>> low, high = np.byte_bounds(I) >>> high - low == I.size*I.itemsize True �datar �strides�shapeNr9 )Z__array_interface__r �dtype�itemsize�size�zip) �aZaiZa_dataZastridesZashapeZbytes_aZa_lowZa_highrW Zstrider r r! r � s c C sD | dkrt �� j}|j} g }i }| �� D ]�}t| | t�r(| | }t|�}||�� krl|d|| }d}n|||< |}d}d�t t |j ��} t |j �} |� || | |jj|g� q(d} d} d} d}tt|��D ]|}|| }| t|d �k r�t|d �} | t|d �k �rt|d �} | t|d �k �r2t|d �} |d r�|t|d �7 }q�t|�dk�r�td| �}td| �}td| �}d |d |d |d f }t|d d t|�d d � tt|��D ]t}|| }td|d d |t|d � d |d d |t|d � d |d d |t|d � d |d f � �q�td| � dS )a% Print the NumPy arrays in the given dictionary. If there is no dictionary passed in or `vardict` is None then returns NumPy arrays in the globals() dictionary (all NumPy arrays in the namespace). Parameters ---------- vardict : dict, optional A dictionary possibly containing ndarrays. Default is globals(). Returns ------- out : None Returns 'None'. Notes ----- Prints out the name, shape, bytes and type of all of the ndarrays present in `vardict`. Examples -------- >>> a = np.arange(10) >>> b = np.ones(20) >>> np.who() Name Shape Bytes Type =========================================================== a 10 80 int64 b 20 160 float64 Upper bound on total bytes = 240 >>> d = {'x': np.arange(2.0), 'y': np.arange(3.0), 'txt': 'Some str', ... 'idx':5} >>> np.who(d) Name Shape Bytes Type =========================================================== x 2 16 float64 y 3 24 float64 Upper bound on total bytes = 40 Nz (%s)r r9 z x r. � � z Name %s Shape %s Bytes %s Typer: r- �=� z%s %s %s %s %s %s %s� z' Upper bound on total bytes = %d)rM � _getframe�f_back� f_globals�keys� isinstancer �idr �map�strrW �nbytes�appendrX r% �rangerA �int�max�print)Zvardict�frameZsta�cacher% �varZidv�namestrZoriginalZshapestrZbytestrZmaxnameZmaxshapeZmaxbyteZ totalbytes�k�valZsp1Zsp2Zsp3Zprvalr r r! r sf , � � c C s� t | �}|}| }d}|�|�}|D ]h}||kr4d} n|} |t |� t | � }||kr~|d t |� }|d d|d | }q"|| | }q"|S )N�, � r9 z, r: r. )rA r> ) r% � arguments�widthZ firstwidthrt ZnewstrZsepstr�arglistZargumentZaddstrr r r! � _split_linep s r{ r c C s� t | t� t� g �} | j| ji}| jg}| jg}t|�dkr<q�|�d�}|�� D ]L}t|| t j �rN|| j}||krN|| j}|� |� |� |� |||< qNq.||fS )Nr ) � __import__�globals�localsr# rB rA �popre rf �types� ModuleTyperk )�moduleZthedictZdictlistZ totraverseZthisdict�x�modnameZmoddictr r r! � _makenamedict� s r� c C sx d}d}dd� }t | dt| ��}t |d|�}| j}| jj}td||d� td| j|d� td ||d� td | j|d� td || jj �|d� td || jj �|d� td | jj |d� tdt | j jj�|f |d� tdd|d� |dk�rtd|tj|f |d� d} nH|dk�r2td||f |d� tjdk} n td||f |d� tjdk} td|| �|d� td| j |d� d S ) aO Provide information about ndarray obj. Parameters ---------- obj : ndarray Must be ndarray, not checked. output Where printed output goes. Notes ----- Copied over from the numarray module prior to its removal. Adapted somewhat as only numpy is an option now. Called by info. rw c S s | S r" r )r� r r r! rS � rT z_info.<locals>.<lambda>� __class__r# zclass: ��filezshape: z strides: z itemsize: z aligned: z contiguous: z fortran: zdata pointer: %s%sz byteorder: r: )�endr� )�|r_ z%s%s%sF�>z%sbig%sZbigz %slittle%s�littlez byteswap: ztype: %sN)�getattr�typerV rX � byteorderro rW rY �flagsZaligned� contiguousZfortran�hexZctypesZ_as_parameter_�valuerM ) �obj�outputZextraZticZbp�clsZnmrV ZendianZbyteswapr r r! �_info� s: � r� �L c C sd ddl }ddl}t| d�s$t| d�r,| j} nt| d�r<| j} | dkrPtt� �nt| t�rjt| |d� �n�t| t ��rPt dkr�t |�\a a d}g }t D ]�}zlt | | } t | �|kr�td| |d� n6|�t | �� td | |d� t| � td | |d� |d 7 }W q� tk �r Y q�X q�|dk�r<td | |d� ntd | |d� �n|�| ��r�| j} tt| �� } t| | �|k�r�t| | |�} n| | } td| d |d� t|�| �|d� �n�|�| ��rR| j} d} zZt| d��r.tt| jj�� } | �d�} t| �d k�r.d| d | d < d� | d d� �} W n t k �rF Y nX t| | �|k�rht| | |�} n| | } td| d |d� |�| �}|dk�r�t| d��r�t|�| j�|d� nt|�| �|d� |� | �}|g k�r`td|d� |D ]\}|d dk�r�q�t | |d�}|dk �r6|� |�|��p.d�\}}td||f |d� �q�nt!j"d dk �r�t| t#j$��r�td| j%j|d� t|d� t| d��r~tt| j&j�� } | �d�} t| �d k�r�d| d | d < d� | d d� �} nd} t| d��r d | j' } nd } t| | �|k�r$t| | |�} n| | } td| d |d� |�| j&�}|dk �rjt|�| j&�|d� t|�| �|d� nt|�| �|d� n�|�(| ��rB| j} tt| j�� } | �d�} t| �d k�r�d| d | d < d� | d d� �} nd} t| | �|k�rt| | |�} n| | } td| d |d� t|�| �|d� n t| d ��r`t|�| �|d� dS ) a� Get help information for a function, class, or module. Parameters ---------- object : object or str, optional Input object or name to get information about. If `object` is a numpy object, its docstring is given. If it is a string, available modules are searched for matching objects. If None, information about `info` itself is returned. maxwidth : int, optional Printing width. output : file like object, optional File like object that the output is written to, default is ``stdout``. The object has to be opened in 'w' or 'a' mode. toplevel : str, optional Start search at this level. See Also -------- source, lookfor Notes ----- When used interactively with an object, ``np.info(obj)`` is equivalent to ``help(obj)`` on the Python prompt or ``obj?`` on the IPython prompt. Examples -------- >>> np.info(np.polyval) # doctest: +SKIP polyval(p, x) Evaluate the polynomial p at x. ... When using a string for `object` it is possible to get multiple results. >>> np.info('fft') # doctest: +SKIP *** Found in numpy *** Core FFT routines ... *** Found in numpy.fft *** fft(a, n=None, axis=-1) ... *** Repeat reference found in numpy.fft.fftpack *** *** Total of 3 references found. *** r NZ_ppimport_importer�_ppimport_module�_ppimport_attr)r� z+ *** Repeat reference found in %s *** r� z *** Found in %s ***�-r9 zHelp for %s not found.z+ *** Total of %d references found. ***r: r- z()r, rv �(z Methods: �_�Nonez %s -- %sra zInstance of class: rJ r% z%sz<name>r< ))�pydoc�inspect�hasattrr� r� r rf r r� ri � _namedictr� � _dictlistrg ro rk �KeyErrorZ isfunctionr# r r rA r{ �getdoc�isclassr, �__func__r> r � ExceptionZ allmethodsr� ZsplitdocrM � version_infor� Z InstanceTyper� rJ r% Zismethod)�objectZmaxwidthr� Ztoplevelr� r� ZnumfoundZobjlistrs r� r% rx Zargstrrz Zdoc1�methods�methZthisobjZmethstr�otherrE r r r! r � s� 4 � �� �� � � � � � c C sZ ddl }z,td|�| � |d� t|�| �|d� W n tk rT td|d� Y nX dS )a� Print or write to a file the source code for a NumPy object. The source code is only returned for objects written in Python. Many functions and classes are defined in C and will therefore not return useful information. Parameters ---------- object : numpy object Input object. This can be any object (function, class, module, ...). output : file object, optional If `output` not supplied then source code is printed to screen (sys.stdout). File object must be created with either write 'w' or append 'a' modes. See Also -------- lookfor, info Examples -------- >>> np.source(np.interp) #doctest: +SKIP In file: /usr/lib/python2.6/dist-packages/numpy/lib/function_base.py def interp(x, xp, fp, left=None, right=None): """.... (full docstring printed)""" if isinstance(x, (float, int, number)): return compiled_interp([x], xp, fp, left, right).item() else: return compiled_interp(x, xp, fp, left, right) The source code is only returned for objects written in Python. >>> np.source(np.array) #doctest: +SKIP Not available for this object. r Nz In file: %s r� z Not available for this object.)r� ro Z getsourcefileZ getsourcer� )r� r� r� r r r! r � s )z[a-z0-9_]+\(.*[,=].*\)TFc s� ddl }t|||�� g }t| ��� �� ��s0dS � �� D ]L\}\}} } | dkrPq8d} |�� } �D ]} | | kr`d} qvq`| r8|�|� q8ddddd����fd d ��� �fd d �}|j|d � dd��� }|dt |� g}|ddd� D ]�}� | \} } }dd� | � � �d�D �}z(|d � � }t � |��r8|d � � }W n t k �rT d}Y nX |�d||f � q�|�sz|�d� |dk �r�|�d�|�� n4t |�dk�r�|�� }|d�|�� ntd�|�� dS )a� Do a keyword search on docstrings. A list of objects that matched the search is displayed, sorted by relevance. All given keywords need to be found in the docstring for it to be returned as a result, but the order does not matter. Parameters ---------- what : str String containing words to look for. module : str or list, optional Name of module(s) whose docstrings to go through. import_modules : bool, optional Whether to import sub-modules in packages. Default is True. regenerate : bool, optional Whether to re-generate the docstring cache. Default is False. output : file-like, optional File-like object to write the output to. If omitted, use a pager. See Also -------- source, info Notes ----- Relevance is determined only roughly, by checking if the keywords occur in the function name, at the start of a docstring, etc. Examples -------- >>> np.lookfor('binary representation') # doctest: +SKIP Search results for 'binary representation' ------------------------------------------ numpy.binary_repr Return the binary representation of the input number as a string. numpy.core.setup_common.long_double_representation Given a binary dump as given by GNU od -b, look for long double numpy.base_repr Return a string representation of a number in the given base system. ... r N)r� r� TFi� ����)r$ �classr� r� c s� d}d� |�� �� �d�d d� �� |t� fdd��D ��7 }|t�fdd��D ��7 }|t�� d 7 }|��|d�7 }|��d � d 7 }|t| d d �7 }|S ) Nr r- ra c s g | ]}|� krd �qS )�� r ��.0�w)� first_docr r! � <listcomp>+ s z.lookfor.<locals>.relevance.<locals>.<listcomp>c s g | ]}|� krd �qS )� r r� )r% r r! r� - s r` r� �.r^ �d i����) r �lower�stripr> �sumrA �get�countrn )r% Zdocstr�kind�index�r)�kind_relevance�whats)r� r% r! � relevance' s zlookfor.<locals>.relevancec s �| f� | �� S r" r )r\ )rq r� r r! �relevance_value7 s z lookfor.<locals>.relevance_value)�keyzSearch results for '%s'r: r� ���c S s g | ]}|� � r|� � �qS r )r� )r� rI r r r! r� A s �zlookfor.<locals>.<listcomp>r- r9 rw z %s %szNothing found.r^ )r� �_lookfor_generate_cacheri r� r> �itemsrk �sortr rA r� �_function_signature_re�search� IndexError�writeZgetpagerro )Zwhatr� �import_modules� regenerater� r� �foundr% Z docstringr� r� �okrE r� r� �sZ help_textZixZdoclinesr� Zpagerr )rq r� r� r� r! r � sX / � c C s� ddl }tjd dkr$ddlm} n ddlm} | dkr<d} t| t�rxz t| � W n tk rj i Y S X tj | } n8t| t �s�t| t �r�i }| D ]}|� t |||�� q�|S t| �tkr�|s�tt| � S i }|tt| �< i }d}| j| fg} | �r�| �d�\} } t| �|k�rq�d|t| �< |d7 }d} |�| ��r>d } z | j} W n tk �r` d} Y nX |�rbt| d ��rb| jD ]�}t�|�D ]�}tj�||�}tj�||d �}tj�|��r�|� d ��r�|dd � }ntj�|��r�|}n�q�|dk�r��q�zDtj }tj }z$|� t_ |� t_ td| |f � W 5 |t_ |t_ X W n t k �rX Y �q�Y nX �q��qzt | �D ]�\}}z$t!|dd| |f �}t!|dd�}W n& t"k �r� d| |f }d}Y nX d|k�r�|�r�d||f }|�#| d ��s�t|t$��rjn�qjn$|�|��s"| dk�s"|| k�s"�qj| �%d| |f |f� �qjnL|�&| ��rzd} t | �D ] \}}| �%d| |f |f� �qVnt| d��r�d} z|�'| �}W n t"k �r� d}Y nX |dk r�|| |f|| < q�|S )a� Generate docstring cache for given module. Parameters ---------- module : str, None, module Module for which to generate docstring cache import_modules : bool Whether to import sub-modules in packages. regenerate : bool Re-generate the docstring cache Returns ------- cache : dict {obj_full_name: (docstring, kind, index), ...} Docstring cache for the module, either cached one (regenerate=False) or newly generated. r Nra )�StringIOr Tr9 r� r� �__path__z __init__.pyz.py���r, z%s.%sr# rK r� r� rJ r$ )(r� rM r� �ior� rf ri r| � ImportError�modules�list�tuplerC r� rg �_lookfor_cachesr# r Zismodule�__all__r; r� r� r �listdirr r �isfile�endswith�stdout�stderr� BaseException� _getmembersr� � NameError� startswithr rk r� r� )r� r� r� r� r� rq �mod�seenr� �stackr% �itemr� Z_allZpthZmod_pathZthis_pyZinit_pyZ to_importZ old_stdoutZ old_stderr�n�vZ item_name�mod_namerE r r r! r� Y s� � � r� c sF dd l }z|�� �}W n* tk r@ � fdd�t� �D �}Y nX |S )Nr c s$ g | ] }t � |�r|t� |�f�qS r )r� r� )r� r� �r� r r! r� � s �z _getmembers.<locals>.<listcomp>)r� Z getmembersr� �dir)r� r� �membersr r� r! r� � s r� c @ sx e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd S ) �SafeEvalz� Object to evaluate constant string expressions. This includes strings with lists, dicts and tuples using the abstract syntax tree created by ``compiler.parse``. .. deprecated:: 1.10.0 See Also -------- safe_eval c C s t jdtdd� d S )Nz3SafeEval is deprecated in 1.10 and will be removed.r. r/ r1 �r+ r r r! r, s �zSafeEval.__init__c C s" |j }t| d|j | j�}||�S )N�visit)r� r� r# �default)r+ �noder� r� r r r! r� s zSafeEval.visitc C s t d|j ��d S )Nz Unsupported source construct: %s)� SyntaxErrorr� �r+ r� r r r! r� s �zSafeEval.defaultc C s | � |j�S r" )r� Zbodyr� r r r! �visitExpression s zSafeEval.visitExpressionc C s |j S r" )r� r� r r r! �visitNum s zSafeEval.visitNumc C s |j S r" �r� r� r r r! �visitStr s zSafeEval.visitStrc C s |j S r" r� r� r r r! � visitBytes" s zSafeEval.visitBytesc s t � fdd�t|j|j�D ��S )Nc s$ g | ] \}}� � |�� � |�f�qS r �r� )r� rt r� r� r r! r� & s �z&SafeEval.visitDict.<locals>.<listcomp>)�dictr[ re �values)r+ r� �kwr r� r! � visitDict% s �zSafeEval.visitDictc s t � fdd�|jD ��S )Nc s g | ]}� � |��qS r r� �r� �ir� r r! r� * s z'SafeEval.visitTuple.<locals>.<listcomp>)r� �eltsr� r r� r! � visitTuple) s zSafeEval.visitTuplec s � fdd�|j D �S )Nc s g | ]}� � |��qS r r� r r� r r! r� - s z&SafeEval.visitList.<locals>.<listcomp>)r r� r r� r! � visitList, s zSafeEval.visitListc C sR dd l }t|j|j�r$| �|j� S t|j|j�r@| �|j� S td|j ��d S )Nr zUnknown unary op: %r)�astrf �opZUAddr� ZoperandZUSubr� )r+ r� r r r r! � visitUnaryOp/ s zSafeEval.visitUnaryOpc C s< |j dkrdS |j dkr dS |j dkr*d S td|j ��d S )N�FalseF�TrueTr� zUnknown name: %s)rg r� r� r r r! � visitName8 s zSafeEval.visitNamec C s |j S r" )r� r� r r r! �visitNameConstantB s zSafeEval.visitNameConstantN)r# rK rL r< r, r� r� r� r� r� r� r r r r r r r r r r! r� � s r� c C s ddl }|�| �S )a� Protected string evaluation. Evaluate a string containing a Python literal expression without allowing the execution of arbitrary non-literal code. Parameters ---------- source : str The string to evaluate. Returns ------- obj : object The result of evaluating `source`. Raises ------ SyntaxError If the code has invalid Python syntax, or if it contains non-literal code. Examples -------- >>> np.safe_eval('1') 1 >>> np.safe_eval('[1, 2, 3]') [1, 2, 3] >>> np.safe_eval('{"foo": ("bar", 10.0)}') {'foo': ('bar', 10.0)} >>> np.safe_eval('import os') Traceback (most recent call last): ... SyntaxError: invalid syntax >>> np.safe_eval('open("/home/user/.ssh/id_dsa").read()') Traceback (most recent call last): ... ValueError: malformed node or string: <_ast.Call object at 0x...> r N)r Z literal_eval)r r r r r! r F s ,c C s� | j dkr|S t�| |d�} t�| d �}tj�|�r@|�d�}|jdkr�|dkr�|dk rr| j� tj �|d< |}q�| j� tj �}n t� |� � �dkr�tj ||< |S )aj Utility function to check median result from data for NaN values at the end and return NaN in that case. Input result can also be a MaskedArray. Parameters ---------- data : array Input data to median function result : Array or MaskedArray Result of median function axis : {int, sequence of int, None}, optional Axis or axes along which the median was computed. out : ndarray, optional Output array in which to place the result. Returns ------- median : scalar or ndarray Median or NaN in axes which contained NaN in the input. r r� ).r� FTN.) rZ �npZmoveaxisZisnanZmaZ isMaskedArrayZfilled�ndimrX r� �nanZ count_nonzeroZravel)rU �resultZaxis�outr� r r r! �_median_nancheckv s r )N)r )NTFN)4Z __future__r r r r rM r� �rer2 Znumpy.core.numerictypesr r r Znumpy.core.overridesr r r r r r r Z numpy.compatr r r� r r& r� r' r? r r r r r{ r� r� r� r� r� r r r� �compile�Ir� r r� r� r� r r r r r r! �<module> sl � K49 i 3 N3 � I0