Your IP : 216.73.216.85
B
�.W�v � @ s\ d Z ddlmZmZmZ ddlZddlZddlZddlZyddl m
Z
W n e k
rh ddl m
Z
Y nX ddl
mZ dddd gZeej�Zeej�ZeeejfZd"d
d �Zd d
� Zdd � ZG dd� de�ZG dd� de�Z G dd� de �Z e ddd�Z e ddd�Z e ddd�Z!e dd d�Z"e d d d�Z#G d d� de�Z$G d d� de�Z%G d!d� de�Z&dS )#z�Function signature objects for callables
Back port of Python 3.3's function signature tools from the inspect module,
modified to be compatible with Python 2.6, 2.7 and 3.3+.
� )�absolute_import�division�print_functionN)� OrderedDict)� __version__�BoundArguments� Parameter� Signature� signaturec C s8 t | t�r0| jdd|fkr | jS | jd | j S t| �S )N�builtinsZ __builtin__�.)�
isinstance�type�
__module__�__name__�repr)�
annotation� base_module� r �B/opt/alt/python37/lib/python3.7/site-packages/funcsigs/__init__.py�formatannotation s
r c G s\ y4| t krd S t| |�}x|D ]}t|||�}q W W n tk
rH d S X t|t�sX|S d S )N)r �getattr�AttributeErrorr
�_NonUserDefinedCallables)�cls� method_name�nested�meth�namer r r �_get_user_defined_method' s
r c
C s t | �std�| ���t| tj�r�t| j�}| jdkr:|S t |j
� � �}|r^|d j t
tfkrftd��|d j }|ttfkr�|dd� }n|tk r�td��|j|d�S y
| j}W n tk
r� Y nX |dk r�|S y
| j}W n tk
r� Y n
X t|�S t| tj��rt�| �S t| tj��r
t| j �}t |j
� � �}| j �pBd}| j �pNi }y|j!||�}W n6 tk
�r� } zd �| �}
t|
��W dd} ~ X Y nX x`|j"� � D ]R\} } || }
| |k�r�|
j| d
d �|| < n"|
j t
tfk�r�|
j#�s�|�$| � �q�W |j|� � d�S d}t| t%��rxt&t%| �d �}|dk �r<t|�}n:t&| d
�}|dk �rZt|�}n t&| d�}|dk �r�t|�}n.t| t'��s�t&t%| �d d�}|dk �r�t|�}|dk �r�|jt |j
� � �dd� d�S t| tj(��r�d�| �}
t|
��td�| ���dS )z/Get a signature object for the passed callable.z {0!r} is not a callable objectNr zinvalid method signature� zinvalid argument type)�
parametersr z,partial object {0!r} has incorrect argumentsT)�default�_partial_kwarg�__call__�__new__�__init__Zim_funcz-no signature found for builtin function {0!r}z,callable {0!r} is not supported by signature))�callable� TypeError�formatr
�types�
MethodTyper
�__func__�__self__�tupler! �values�kind� _VAR_KEYWORD�
_KEYWORD_ONLY�
ValueError�_POSITIONAL_OR_KEYWORD�_POSITIONAL_ONLY�_VAR_POSITIONAL�replace�
__signature__r � __wrapped__� FunctionTyper �
from_function� functools�partial�funcr �items�args�keywords� bind_partial� argumentsr# �popr r r �BuiltinFunctionType)�obj�sig�paramsr0 �wrapped�
new_params� partial_args�partial_keywords�ba�ex�msgZarg_name� arg_value�param�call�new�initr r r r
7 s�
c @ s e Zd ZdZdS )�_voidz0A private marker - used in Parameter & SignatureN)r r � __qualname__�__doc__r r r r rU � s rU c @ s e Zd ZdS )�_emptyN)r r rV r r r r rX � s rX c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�_ParameterKindc O s t j| f|�� }|d |_|S )Nr )�intr% �_name)�selfr@ �kwargsrF r r r r% � s
z_ParameterKind.__new__c C s | j S )N)r[ )r\ r r r �__str__� s z_ParameterKind.__str__c C s d� | j�S )Nz<_ParameterKind: {0!r}>)r) r[ )r\ r r r �__repr__� s z_ParameterKind.__repr__N)r r rV r% r^ r_ r r r r rY � s rY �POSITIONAL_ONLY)r r �POSITIONAL_OR_KEYWORD� �VAR_POSITIONAL� � KEYWORD_ONLY� � VAR_KEYWORDc @ s� e Zd ZdZdZeZeZe Z
e Z e
ZeZeedfdd�Zedd� �Zedd � �Zed
d � �Zed d
� �Zeeeeefdd�Zdd� Zdd� Zdd� Zdd� Z dd� Z dS )r a� Represents a parameter in a function signature.
Has the following public attributes:
* name : str
The name of the parameter as a string.
* default : object
The default value for the parameter if specified. If the
parameter has no default value, this attribute is not set.
* annotation
The annotation for the parameter if specified. If the
parameter has no annotation, this attribute is not set.
* kind : str
Describes how argument values are bound to the parameter.
Possible values: `Parameter.POSITIONAL_ONLY`,
`Parameter.POSITIONAL_OR_KEYWORD`, `Parameter.VAR_POSITIONAL`,
`Parameter.KEYWORD_ONLY`, `Parameter.VAR_KEYWORD`.
)r[ �_kind�_default� _annotationr# Fc C s� |t ttttfkrtd��|| _|tk rF|ttfkrFd�|�}t|��|| _ || _
|d krr|t krjtd��|| _ n8t |�}|t kr�t
�d|t
j�s�d�|�}t|��|| _ || _d S )Nz,invalid value for 'Parameter.kind' attributez){0} parameters cannot have default valuesz<None is not a valid name for a non-positional-only parameterz
[a-z_]\w*$z#{0!r} is not a valid parameter name)r5 r4 r6 r2 r1 r3 rh rX r) ri rj r[ �str�re�match�Ir# )r\ r r0 r" r r# rO r r r r& � s(
zParameter.__init__c C s | j S )N)r[ )r\ r r r r s zParameter.namec C s | j S )N)ri )r\ r r r r" s zParameter.defaultc C s | j S )N)rj )r\ r r r r s zParameter.annotationc C s | j S )N)rh )r\ r r r r0 ! s zParameter.kindc C s\ |t kr| j}|t kr | j}|t kr*| j}|t kr8| j}|t krF| j}t| �|||||d�S )z+Creates a customized copy of the Parameter.)r" r r# )rU r[ rh rj ri r# r )r\ r r0 r r" r# r r r r7 % s zParameter.replacec C s� | j }| j}|tkr*|d kr d}d�|�}| jtk rFd�|t| j��}| jtk rbd�|t| j��}|t krtd| }n|t
kr�d| }|S )N� z<{0}>z{0}:{1}z{0}={1}�*z**) r0 r[ r5 r) rj rX r ri r r6 r1 )r\ r0 � formattedr r r r^ ; s
zParameter.__str__c C s d� | jjt| �| j�S )Nz<{0} at {1:#x} {2!r}>)r) � __class__r �idr )r\ r r r r_ S s
zParameter.__repr__c C s d� | jj�}t|��d S )Nzunhashable type: '{0}')r) rr r r( )r\ rO r r r �__hash__W s zParameter.__hash__c C s< t |jt�o:| j|jko:| j|jko:| j|jko:| j|jkS )N)�
issubclassrr r r[ rh ri rj )r\ �otherr r r �__eq__[ s
zParameter.__eq__c C s | � |� S )N)rw )r\ rv r r r �__ne__b s zParameter.__ne__N) r r rV rW � __slots__r5 r` r4 ra r6 rc r2 re r1 rg rX �emptyr& �propertyr r" r r0 rU r7 r^ r_ rt rw rx r r r r r � s* c @ sT e Zd ZdZdd� Zedd� �Zedd� �Zedd � �Zd
d � Z d d
� Z
dd� Z dS )r a Result of `Signature.bind` call. Holds the mapping of arguments
to the function's parameters.
Has the following public attributes:
* arguments : OrderedDict
An ordered mutable mapping of parameters' names to arguments' values.
Does not contain arguments' default values.
* signature : Signature
The Signature object that created this instance.
* args : tuple
Tuple of positional arguments values.
* kwargs : dict
Dict of keyword arguments values.
c C s || _ || _d S )N)rC �
_signature)r\ r
rC r r r r& w s zBoundArguments.__init__c C s | j S )N)r| )r\ r r r r
{ s zBoundArguments.signaturec C s� g }xt| j j�� D ]d\}}|jttfks.|jr0P y| j| }W n tk
rT P Y qX |jt krl|�
|� q|� |� qW t |�S )N)
r| r! r? r0 r1 r2 r# rC �KeyErrorr6 �extend�appendr. )r\ r@ �
param_namerQ �argr r r r@ s
zBoundArguments.argsc C s� i }d}x�| j j�� D ]~\}}|sL|jttfks6|jr<d}n|| jkrLd}q|sRqy| j| }W n tk
rt Y qX |jtkr�|� |� q|||< qW |S )NFT)
r| r! r? r0 r1 r2 r# rC r} �update)r\ r] �kwargs_startedr� rQ r� r r r r] � s(
zBoundArguments.kwargsc C s d� | jj�}t|��d S )Nzunhashable type: '{0}')r) rr r r( )r\ rO r r r rt � s zBoundArguments.__hash__c C s$ t |jt�o"| j|jko"| j|jkS )N)ru rr r r
rC )r\ rv r r r rw � s zBoundArguments.__eq__c C s | � |� S )N)rw )r\ rv r r r rx � s zBoundArguments.__ne__N) r r rV rW r& r{ r
r@ r] rt rw rx r r r r r f s c @ s� e Zd ZdZdZeZeZe Z
de dfdd�Z e dd� �Z
ed d
� �Zed d � �Zeefd
d�Zdd� Zdd� Zdd� Zd dd�Zdd� Zdd� Zd d � ZdS ) r a A Signature object represents the overall signature of a function.
It stores a Parameter object for each parameter accepted by the
function, as well as information specific to the function itself.
A Signature object has the following public attributes and methods:
* parameters : OrderedDict
An ordered mapping of parameters' names to the corresponding
Parameter objects (keyword-only arguments are in the same order
as listed in `code.co_varnames`).
* return_annotation : object
The annotation for the return type of the function if specified.
If the function has no annotation for its return type, this
attribute is not set.
* bind(*args, **kwargs) -> BoundArguments
Creates a mapping from positional and keyword arguments to
parameters.
* bind_partial(*args, **kwargs) -> BoundArguments
Creates a partial mapping from positional and keyword arguments
to parameters (simulating 'functools.partial' behavior.)
)�_return_annotation� _parametersNTc C s� |dkrt � }n�|r�t � }t}x�t|�D ]z\}}|j}||k rZd} | �||j�} t| ��n|}|j}
|
dkr�t|�}
|j|
d�}|
|kr�d�|
�} t| ��|||
< q(W nt dd� |D ��}|| _ || _
dS )z�Constructs Signature from the given list of Parameter
objects and 'return_annotation'. All arguments are optional.
Nz%wrong parameter order: {0} before {1})r z duplicate parameter name: {0!r}c s s | ]}|j |fV qd S )N)r )�.0rQ r r r � <genexpr> s z%Signature.__init__.<locals>.<genexpr>) r r5 � enumerater0 r) r3 r rk r7 r� r� ) r\ r! �return_annotation�__validate_parameters__rH �top_kind�idxrQ r0 rO r r r r r& � s0
zSignature.__init__c C s� t |tj�std�|���| j}|j}|j}|j}t |d|� �}t
|dd�}|||| � }t
|di �} |j }
t
|dd�} |
r�t |
�} nd} g }
|| }x4|d|� D ]$}| �
|t�}|
�|||td�� q�W xBt||d� �D ].\}}| �
|t�}|
�|||t|
| d�� q�W |jd @ �rL||| }| �
|t�}|
�|||td�� xJ|D ]B}t}| dk �rp| �
|t�}| �
|t�}|
�|||t|d�� �qRW |jd
@ �r�|| }|jd @ �r�|d 7 }|| }| �
|t�}|
�|||td�� | |
| �
d t�d
d�S )z2Constructs Signature for the given python functionz {0!r} is not a Python functionN�co_kwonlyargcountr �__annotations__�__kwdefaults__)r r0 )r r0 r" rf � r �returnF)r� r� )r
r* r: r( r) �_parameter_cls�__code__� co_argcount� co_varnamesr. r � __defaults__�len�getrX r r4 r� �co_flagsr6 r2 r1 )r r> r � func_code� pos_count� arg_names�
positional�keyword_only_count� keyword_only� annotations�defaults�
kwdefaults�pos_default_countr! �non_default_countr r �offsetr" �indexr r r r; sd
zSignature.from_functionc C s0 y t �| j�S tk
r* t| j�� �S X d S )N)r* �MappingProxyTyper� r r r? )r\ r r r r! T s zSignature.parametersc C s | j S )N)r� )r\ r r r r� [ s zSignature.return_annotationc C s0 |t kr| j�� }|t kr | j}t| �||d�S )z�Creates a customized copy of the Signature.
Pass 'parameters' and/or 'return_annotation' arguments
to override them in the new copy.
)r� )rU r! r/ r� r )r\ r! r� r r r r7 _ s
zSignature.replacec C s d� | jj�}t|��d S )Nzunhashable type: '{0}')r) rr r r( )r\ rO r r r rt n s zSignature.__hash__c C s� t t|�t�r.| j|jks.t| j�t|j�kr2dS tdd� t|j�� �D ��}x�t| j� � �D ]�\}\}}|j
t kr�y|j| }W n t k
r� dS X ||kr�dS q^y || }W n t k
r� dS X ||ks�||j| kr^dS q^W dS )NFc s s | ]\}}||fV qd S )Nr )r� r� rQ r r r r� x s z#Signature.__eq__.<locals>.<genexpr>T)
ru r r r� r� r! �dictr� �keysr? r0 r2 r} )r\ rv Zother_positionsr� r� rQ Z other_paramZ other_idxr r r rw r s,
zSignature.__eq__c C s | � |� S )N)rw )r\ rv r r r rx � s zSignature.__ne__Fc C s� t � }t| j�� �}d}t|�}|rTx.| j�� D ] \}} | jr0||kr0| j||< q0W �xry t|�}
W n� tk
�r, y t|�} W n tk
r� P Y n�X | j t
kr�P n�| j |kr�| j t kr�d} | j
| j d�} t| ��| f}P nH| j tks�| jtk r�| f}P n*|�r| f}P nd} | j
| j d�} t| ��Y qXX y t|�} W n tk
�rX td��Y qXX | j ttfk�rrtd��| j t
k�r�|
g} | �|� t| �|| j < P | j |k�r�tdj
| j d���|
|| j < qXW d}
x�t�||�D ]�} | j t k�r�tdj
| j d���| j tk�r| }
�q�| j }y|�|�}
W nD tk
�rj |�sf| j t
k�rf| jtk�rftdj
|d���Y n
X |
||< �q�W |�r�|
dk �r�|||
j < n td| ��| �| |�S ) z$Private method. Don't use directly.r zA{arg!r} parameter is positional only, but was passed as a keyword)r� z'{arg!r} parameter lacking default valuez too many positional argumentsz$multiple values for argument {arg!r}Nz too many keyword arguments %r)r �iterr! r/ r? r# r" �next�
StopIterationr0 r6 r r5 r) r( r1 rX r2 r~ r. � itertools�chainrD r} �_bound_arguments_cls)r\ r@ r] r= rC r! �
parameters_ex�arg_valsr� rQ �arg_valrO r/ � kwargs_paramr r r �_bind� s�
zSignature._bindc O s | d � | dd� |�S )z�Get a BoundArguments object, that maps the passed `args`
and `kwargs` to the function's signature. Raises `TypeError`
if the passed arguments can not be bound.
r r N)r� )r@ r] r r r �bind s zSignature.bindc O s | j ||dd�S )z�Get a BoundArguments object, that partially maps the
passed `args` and `kwargs` to the function's signature.
Raises `TypeError` if the passed arguments can not be bound.
T)r= )r� )r\ r@ r] r r r rB s zSignature.bind_partialc C s� g }d}xZt | j�� �D ]H\}}t|�}|j}|tkr<d}n|tkrV|rV|�d� d}|�|� qW d�d� |��}| j
t k r�t | j
�}|d�|�7 }|S )NTFrp z({0})z, z -> {0})
r� r! r/ rk r0 r6 r2 r r) �joinr� rX r ) r\ �result�render_kw_only_separatorr� rQ rq r0 �rendered�annor r r r^ ! s
zSignature.__str__)F)r r rV rW ry r r� r r� rX rz r& � classmethodr; r{ r! r� rU r7 rt rw rx r� r� rB r^ r r r r r � s& % I
)N)'rW �
__future__r r r r� r< rl r* � collectionsr � ImportErrorZ ordereddictZfuncsigs.versionr �__all__r r$ �_WrapperDescriptor�all�_MethodWrapperrE r r r r
�objectrU rX rZ rY r5 r4 r6 r2 r1 r r r r r r r �<module> s@
a