�.W�v � @ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z y d d l m
Z
Wn" e k
r� d d l m
Z
Yn Xd d l
m Z d d d d g Z e e j � Z e e j � Z e e e j f Z d d
d � Z d d
� Z d d � Z Gd d � d e � Z Gd d � d e � Z Gd d � d e � Z e d d d �Z e d d d �Z e d d d �Z! e d d d �Z" e d d d �Z# Gd d � d e � Z$ Gd d � d e � Z% Gd! d � d e � Z& d S)"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 sJ t | t � r@ | j d d | f k r. | j S| j d | j St | � S)N�builtins� __builtin__�.)�
isinstance�type�
__module__�__name__�repr)�
annotationZ base_module� r � /__init__.py�formatannotation s
r c G sv yF | t k r d St | | � } x | D] } t | | | � } q) WWn t k
r^ d SYn Xt | t � sr | Sd S)N)r �getattr�AttributeErrorr �_NonUserDefinedCallables)�clsZ method_name�nested�meth�namer r r �_get_user_defined_method' s
r c $ C s t | � s! t d j | � � � t | t j � r� t | j � } | j d k rU | St | j
j � � } | s� | d j t
t f k r� t d � � | d j } | t t f k r� | d d � } n | t k r� t d � � | j d | � Sy
| j } Wn t k
rYn X| d k r"| Sy
| j } Wn t k
rCYn Xt | � St | t j � rmt j | � St | t j � r�t | j � } t | j
j � � } | j p�f } | j p�i } y | j! | | � } Wn@ t k
r} z d j | � }
t |
� � WYd d } ~ Xn Xx~ | j" j � D]m \ } } | | }
| | k rk|
j d | d
d � | | <q*|
j t
t f k r*|
j# r*| j$ | � q*W| j d | j � � Sd } t | t% � rJt& t% | � d � } | d k r�t | � } q�t& | d
� } | d k r t | � } q�t& | d � } | d k r�t | � } n? t | t' � s�t& t% | � d d � } | d k r�t | � } | d k r�| j d t | j
j � � d d � � St | t j( � r�d j | � }
t |
� � t d j | � � � d S)z/Get a signature object for the passed callable.z {0!r} is not a callable objectNr zinvalid method signature� zinvalid argument type�
parametersz,partial object {0!r} has incorrect arguments�default�_partial_kwargT�__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�replaceZ
__signature__r � __wrapped__� FunctionTyper �
from_function� functools�partial�funcr �items�args�keywords� bind_partial� argumentsr" �popr r r �BuiltinFunctionType)�obj�sig�paramsr/ �wrappedZ
new_paramsZ partial_argsZpartial_keywordsZba�ex�msgZarg_nameZ arg_value�param�call�newZinitr r r r
7 s�
) c @ s e Z d Z d Z d S)�_voidz0A private marker - used in Parameter & SignatureN)r r � __qualname__�__doc__r r r r rM � s rM c @ s e Z d Z d S)�_emptyN)r r rN r r r r rP � s rP c @ s4 e Z d Z d d � Z d d � Z d d � Z d S)�_ParameterKindc O s# t j | | � } | d | _ | S)Nr )�intr$ �_name)�selfr> �kwargsrD r r r r$ � s
z_ParameterKind.__new__c C s | j S)N)rS )rT r r r �__str__� s z_ParameterKind.__str__c C s d j | j � S)Nz<_ParameterKind: {0!r}>)r( rS )rT r r r �__repr__� s z_ParameterKind.__repr__N)r r rN r$ rV rW r r r r rQ � s rQ r �POSITIONAL_ONLYr �POSITIONAL_OR_KEYWORD� �VAR_POSITIONAL� � KEYWORD_ONLY� � VAR_KEYWORDc @ s� e Z d Z d Z d Z e Z e Z e Z
e Z e
Z e Z e e d d d � Z e d
d � � Z e d d
� � Z e d d � � Z e d d � � Z e e e e e d d � Z d d � Z d d � Z d d � Z d d � Z d d � Z d S) 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`.
rS �_kind�_default� _annotationr" Fc C s
| t t t t t f k r' t d � � | | _ | t k ri | t t f k ri d j | � } t | � � | | _ | | _
| d k r� | t k r� t d � � | | _ nU t | � } | t k r� t
j d | t
j � r� d j | � } 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)r4 r3 r5 r1 r0 r2 r` rP r( ra rb rS �str�re�match�Ir" )rT r r/ r! r r" rI r r r r% � s( % zParameter.__init__c C s | j S)N)rS )rT r r r r s zParameter.namec C s | j S)N)ra )rT r r r r! s zParameter.defaultc C s | j S)N)rb )rT r r r r s zParameter.annotationc C s | j S)N)r` )rT r r r r/ ! s zParameter.kindc C s� | t k r | j } | t k r* | j } | t k r? | j } | t k rT | j } | t k ri | j } t | � | | d | d | d | �S)z+Creates a customized copy of the Parameter.r! r r" )rM rS r` rb ra r" r )rT r r/ r r! r" r r r r6 % s zParameter.replacec C s� | j } | j } | t k r? | d k r0 d } d j | � } | j t k ri d j | t | j � � } | j t k r� d j | t | j � � } | t k r� d | } n | t
k r� d | } | S)N� z<{0}>z{0}:{1}z{0}={1}�*z**) r/ rS r4 r( rb rP r ra r r5 r0 )rT r/ � formattedr r r rV ; s
zParameter.__str__c C s" d j | j j t | � | j � S)Nz<{0} at {1:#x} {2!r}>)r( � __class__r �idr )rT r r r rW S s zParameter.__repr__c C s% d j | j j � } t | � � d S)Nzunhashable type: '{0}')r( rj r r' )rT rI r r r �__hash__W s zParameter.__hash__c C sX t | j t � oW | j | j k oW | j | j k oW | j | j k oW | j | j k S)N)�
issubclassrj r rS r` ra rb )rT �otherr r r �__eq__[ s
zParameter.__eq__c C s | j | � S)N)ro )rT rn r r r �__ne__b s zParameter.__ne__N)z_namez_kindz_defaultz _annotationz_partial_kwarg) r r rN rO � __slots__r4 rX r3 rY r5 r[ r1 r] r0 r_ rP �emptyr% �propertyr r! r r/ rM r6 rV rW rl ro rp r r r r r � s* c @ s| e Z d Z d Z d d � Z e d d � � Z e d d � � Z e d d � � Z d
d � Z d d
� Z
d d � Z d S)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)rA �
_signature)rT r
rA r r r r% w s zBoundArguments.__init__c C s | j S)N)rt )rT r r r r
{ s zBoundArguments.signaturec C s� g } x� | j j j � D]~ \ } } | j t t f k sC | j rD Py | j | } Wn t k
rj PYq X| j t k r� | j
| � q | j | � q Wt | � S)N)
rt r r= r/ r0 r1 r" rA �KeyErrorr5 �extend�appendr- )rT r> �
param_namerJ �argr r r r> s
zBoundArguments.argsc C s� i } d } x� | j j j � D]� \ } } | sp | j t t f k sO | j rX d } n | | j k rp d } q | sy q y | j | } Wn t k
r� Yq X| j t k r� | j | � q | | | <q W| S)NFT)
rt r r= r/ r0 r1 r" rA ru �update)rT rU Zkwargs_startedrx rJ ry r r r rU � s(
zBoundArguments.kwargsc C s% d j | j j � } t | � � d S)Nzunhashable type: '{0}')r( rj r r' )rT rI r r r rl � s zBoundArguments.__hash__c C s4 t | j t � o3 | j | j k o3 | j | j k S)N)rm rj r r
rA )rT rn r r r ro � s zBoundArguments.__eq__c C s | j | � S)N)ro )rT rn r r r rp � s zBoundArguments.__ne__N) r r rN rO r% rs r
r> rU rl ro rp r r r r r f s c @ s� e Z d Z d Z d Z e Z e Z e Z
d e d d d � Z e d d � � Z
e d
d � � Z e d d
� � Z e e d d � Z d d � Z d d � Z d d � Z d d d � Z d d � Z d d � Z d d � Z d S) 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% | d k r t � } n� | r� t � } t } x� t | � D]� \ } } | j } | | k r� d } | j | | j � } t | � � n | } | j }
|
d k r� t | � }
| j d |
� } |
| k r� d j |
� } t | � � | | |
<q: Wn t d d � | D� � } | | _ | | _
d S)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 | f Vq d S)N)r )�.0rJ r r r � <genexpr> s z%Signature.__init__.<locals>.<genexpr>) r r4 � enumerater/ r( r2 r rc r6 r| r{ ) rT r �return_annotation�__validate_parameters__rF Ztop_kind�idxrJ r/ rI r r r r r% � s0
zSignature.__init__c C s� t | t j � s' t d j | � � � | j } | j } | j } | j } t | d | � � } t
| d d � } | | | | � } t
| d i � } | j }
t
| d d � } |
r� t |
� } n d } g }
| | } xI | d | � D]7 } | j
| t � } |
j | | d | d t �� q� Wx_ t | | d � � D]G \ } } | j
| t � } |
j | | d | d t d |
| �� qBW| j d
@r�| | | } | j
| t � } |
j | | d | d t �� xi | D]a } t } | d k r
| j
| t � } | j
| t � } |
j | | d | d t d | �� q�W| j d @r�| | } | j d
@rs| d 7} | | } | j
| t � } |
j | | d | d t �� | |
d
| j
d t � d d �S)z2Constructs Signature for the given python functionz {0!r} is not a Python functionN�co_kwonlyargcountr �__annotations__�__kwdefaults__r r/ r! r^ � r r� �returnr� F)r r) r8 r' r( �_parameter_cls�__code__� co_argcount� co_varnamesr- r � __defaults__�len�getrP rw r3 r �co_flagsr5 r1 r0 )r r< r Z func_codeZ pos_countZ arg_namesZ
positionalZkeyword_only_countZ keyword_onlyZ annotationsZdefaultsZ
kwdefaultsZpos_default_countr Znon_default_countr r �offsetr! �indexr r r r9 sd
#
zSignature.from_functionc C s@ y t j | j � SWn% t k
r; t | j j � � SYn Xd S)N)r) �MappingProxyTyper| r r r= )rT r r r r T s
zSignature.parametersc C s | j S)N)r{ )rT r r r r� [ s zSignature.return_annotationc C sF | t k r | j j � } | t k r0 | 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� )rM r r. r{ r )rT r r� r r r r6 _ s zSignature.replacec C s% d j | j j � } t | � � d S)Nzunhashable type: '{0}')r( rj r r' )rT rI r r r rl n s zSignature.__hash__c C s8 t t | � t � sF | j | j k sF t | j � t | j � k rJ d St d d � t | j j � � D� � } x� t | j j � � D]� \ } \ } } | j
t k r� y | j | } Wn t k
r� d SYq0X| | k r0d Sq� y | | } Wn t k
r d SYq� X| | k s,| | j | k r� d Sq� Wd S)NFc s s! | ] \ } } | | f Vq d S)Nr )r} r� rJ r r r r~ x s z#Signature.__eq__.<locals>.<genexpr>T)
rm r r r� r� r �dictr �keysr= r/ r1 ru )rT rn Zother_positionsr� rx rJ Z other_paramZ other_idxr r r ro r s, (
zSignature.__eq__c C s | j | � S)N)ro )rT rn r r r rp � s zSignature.__ne__Fc C su t � } t | j j � � } f } t | � } | rx x? | j j � D]. \ } } | j rF | | k rF | j | | <qF Wx�y t | � }
Wnt k
r�y t | � } Wn t k
r� PYn� X| j t
k r� Pn� | j | k r&| j t k rd } | j
d | j � } t | � � | f } Pne | j t k sD| j t k rQ| f } Pn: | rd| f } Pn' d } | j
d | j � } t | � � Yq{ Xy t | � } Wn t k
r�t d � � Yq{ X| j t t f k r�t d � � | j t
k r|
g } | j | � t | � | | j <P| j | k rEt d j
d | j � � � |
| | j <q{ Wd }
x� t j | | � D]� } | j t k r�t d j
d | j � � � | j t k r�| }
qo| j } y | j | � }
WnO t k
r$| r | j t
k r | j t k r t d j
d | � � � YqoX|
| | <qoW| re|
d k rU| | |
j <n t d | � � | j | | � S)z$Private method. Don't use directly.zA{arg!r} parameter is positional only, but was passed as a keywordry 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�
StopIterationr/ r5 r r4 r( r' r0 rP r1 rv r- � itertools�chainrB ru �_bound_arguments_cls)rT r> rU r; rA r Z
parameters_exZarg_valsrx rJ Zarg_valrI r. Z kwargs_paramr r r �_bind� s�
zSignature._bindc O s | d j | d d � | � 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> rU r r r �bind s zSignature.bindc O s | j | | d d �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.
r; T)r� )rT r> rU r r r r@ s zSignature.bind_partialc C s� g } d } x t | j j � � D]h \ } } t | � } | j } | t k rX d } n% | t k r} | r} | j d � d } | j | � q" Wd j d j | � � } | j
t k r� t | j
� } | d j | � 7} | S)NTFrh z({0})z, z -> {0})
r r r. rc r/ r5 r1 rw r( �joinr� rP r ) rT �resultZrender_kw_only_separatorr� rJ ri r/ ZrenderedZannor r r rV ! s "
zSignature.__str__)z_return_annotationz _parameters)r r rN rO rq r r� r r� rP rr r% � classmethodr9 rs r r� rM r6 rl ro rp r� r� r@ rV r r r r r � s$ %I � )'rO Z
__future__r r r r� r: rd r) � collectionsr � ImportErrorZ ordereddictZfuncsigs.versionr �__all__r r# Z_WrapperDescriptor�allZ_MethodWrapperrC r r r r
�objectrM rP rR rQ r4 r3 r5 r1 r0 r r r r r r r �<module> s<
�
�a