3
tûœ]Ìh  ã               @   s`  d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ ddlm	Z
 ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZ ddlmZ ejdƒZejdƒZdd„ Zdd„ ZdZddddddddddddd d!œZd"d#„ ejƒ D ƒZd$d#„ ejƒ D ƒZd%d&d'dd(œZejejejejd(œZ d)d*„ Z!d+d,„ ej"_#d-d,„ ej$_#d.d,„ ej%_#d/d,„ ej&_#d0d,„ ej'_#d1d,„ d2d,„ d3d,„ d4d,„ d5d,„ d6d,„ d7d,„ d8d,„ d9d,„ d:d,„ d;d,„ d<d,„ ej(d!œZ)x&e*e)jƒ ƒD ]\Z+Z,e,e)e+d= < �qÈW ej-d>d?„ ƒZ.e.ej&_/d@dA„ Z0dBdC„ Z1ej-dDdE„ ƒZ2e2ej"_/e2ej$_/ej-dFdG„ ƒZ3e3ej4_/e3ej5_/dHdI„ Z6ej7dddJdK„ƒZ8e8ej9_:e8ej;_:dedLdM„Z<e<ej"_:e<ej$_:dfdNdO„Z=e=ej>_:e=ej?_:dPdQ„ Z@dgdRdS„ZAeAejB_:ej7dhdTdU„ƒZCdidVdW„ZDeCejE_:eDejF_:eCejG_:dXdY„ ZHej7djdZd[„ƒZIeIejJ_:d\d]„ ZKej7dkd^d_„ƒZLeLejM_:ej7dld`da„ƒZNeNejO_:ej-dmdbdc„ƒZPePejQ_:dS )nzcthis module contains a set of functions to handle python protocols for nodes
where it makes sense.
é    N)ÚStore)Ú	arguments)Úbases)Úcontext)Ú
exceptions)Ú
decorators)Únode_classes)Úhelpers)Únodes)ÚutilÚraw_buildingÚobjectsc             C   s   d| dd …  S )NZ__ré   © )Únamer   r   ú4/tmp/pip-build-fn42xldr/astroid/astroid/protocols.pyÚ_reflected_name+   s    r   c             C   s   d| dd …  S )NZ__ir   r   )r   r   r   r   Ú_augmented_name/   s    r   zcontextlib.contextmanagerÚ__add__Ú__sub__Ú__truediv__Ú__floordiv__Ú__mul__Ú__pow__Ú__mod__Ú__and__Ú__or__Ú__xor__Ú
__lshift__Ú
__rshift__Ú
__matmul__)ú+ú-ú/z//Ú*z**ú%ú&ú|ú^z<<z>>ú@c             C   s   i | ]\}}t |ƒ|“qS r   )r   )Ú.0ÚkeyÚvaluer   r   r   ú
<dictcomp>D   s   r-   c             C   s   i | ]\}}t |ƒ|d  “qS )ú=)r   )r*   r+   r,   r   r   r   r-   G   s   Ú__pos__Ú__neg__Ú
__invert__)r!   r"   ú~Únotc             C   s   t | }|| ƒ}tj|ƒS )N)Ú_UNARY_OPERATORSr
   Úconst_factory)ÚobjÚopÚfuncr,   r   r   r   Ú_infer_unary_opY   s    r9   c             C   s   t t| jƒ|ƒS )N)r9   ÚtupleÚelts)Úselfr7   r   r   r   Ú<lambda>_   s    r=   c             C   s   t | j|ƒS )N)r9   r;   )r<   r7   r   r   r   r=   `   s    c             C   s   t t| jƒ|ƒS )N)r9   Úsetr;   )r<   r7   r   r   r   r=   a   s    c             C   s   t | j|ƒS )N)r9   r,   )r<   r7   r   r   r   r=   b   s    c             C   s   t t| jƒ|ƒS )N)r9   ÚdictÚitems)r<   r7   r   r   r   r=   c   s    c             C   s   | | S )Nr   )ÚaÚbr   r   r   r=   h   s    c             C   s   | | S )Nr   )rA   rB   r   r   r   r=   i   s    c             C   s   | | S )Nr   )rA   rB   r   r   r   r=   j   s    c             C   s   | | S )Nr   )rA   rB   r   r   r   r=   k   s    c             C   s   | | S )Nr   )rA   rB   r   r   r   r=   l   s    c             C   s   | | S )Nr   )rA   rB   r   r   r   r=   m   s    c             C   s   | | S )Nr   )rA   rB   r   r   r   r=   n   s    c             C   s   | |@ S )Nr   )rA   rB   r   r   r   r=   o   s    c             C   s   | |B S )Nr   )rA   rB   r   r   r   r=   p   s    c             C   s   | |A S )Nr   )rA   rB   r   r   r   r=   q   s    c             C   s   | |> S )Nr   )rA   rB   r   r   r   r=   r   s    c             C   s   | |? S )Nr   )rA   rB   r   r   r   r=   s   s    r.   c             c   s¸   t jtƒ}t|t jƒr�y\t| }yt j|| j|jƒƒV  W n4 tk
rT   |V  Y n tk
rn   t	j
V  Y nX W q´ tk
rŒ   |V  Y q´X n$t| jtƒr®|dkr®t	j
V  n|V  d S )Nr%   )r
   ÚConstÚNotImplementedÚ
isinstanceÚBIN_OP_IMPLr5   r,   Ú	TypeErrorÚ	Exceptionr   ÚUninferableÚstr)r<   ÚopnodeÚoperatorÚotherr   Ú_Únot_implementedÚimplr   r   r   Úconst_infer_binary_opz   s    


rQ   c                s4   | j |d�}‡ fdd„| jD ƒ}t|ƒ|j |_|S )N)Úparentc             3   s*   | ]"}|t jk	rtj|ˆ ƒp t jV  qd S )N)r   rI   r	   Z
safe_infer)r*   Úelt)r   r   r   ú	<genexpr>–   s   z'_multiply_seq_by_int.<locals>.<genexpr>)Ú	__class__r;   Úlistr,   )r<   rK   rM   r   ÚnodeZfiltered_eltsr   )r   r   Ú_multiply_seq_by_int“   s
    

rX   c             c   sX   xR| D ]J}|t jkr tjƒ V  qx.|j|ƒD ] }|t jk	rB|V  q,tjƒ V  q,W qW d S )N)r   rI   r
   ÚUnknownÚinfer)r;   r   rS   Úinferredr   r   r   Ú_filter_uninferable_nodesž   s    


r\   c       	      c   sØ   t jtƒ}t|| jƒrT|dkrT| j|d�}ttjt| j	|ƒt|j	|ƒƒƒ|_	|V  n€t|t jƒr�|dkr�t|j
tƒs~|V  d S t| |||ƒV  nDt|tjƒrÎ|dkrÎtj|ƒ}|s¼tjV  qÔt| |||ƒV  n|V  d S )Nr!   )rR   r$   )r
   rC   rD   rE   rU   rV   Ú	itertoolsÚchainr\   r;   r,   ÚintrX   r   ÚInstancer	   Zclass_instance_as_indexr   rI   )	r<   rK   rL   rM   r   ÚmethodrO   rW   Zas_indexr   r   r   Útl_infer_binary_opª   s&    



rb   c             C   s   |j | |ƒS )N)Úinfer_call_result)r<   rK   rL   rM   r   ra   r   r   r   Úinstance_class_infer_binary_opÊ   s    rd   c       	      c   sþ   |dd… }|j dƒ}xâ| D ]Ú}|tjkr,qt|dƒs8qy|jƒ }W n tk
rZ   wY nX x˜|D ]�}tj|ƒ}y|j||ƒ}W n  t	t
jt
jfk
r    wbY nX |s®|V  qb|tjkr¼P qbyt|j|ƒ||ƒE dH  W qb t
jk
rð   P Y qbX qbW qW dS )z;recursive function to resolve multiple assignments on loopsNr   Úitered)Úpopr   rI   Úhasattrre   rG   r
   rC   ÚgetitemÚAttributeErrorr   ÚAstroidTypeErrorÚAstroidIndexErrorÚ_resolve_looppartrZ   ÚInferenceError)	ÚpartsÚassign_pathr   ÚindexÚpartre   ÚstmtÚ
index_nodeÚassignedr   r   r   rl   á   s:    






rl   c             c   s�   t | tjƒst| ddƒr(t| |||d�S |d krfxN| jj|ƒD ]"}t |tjtjfƒr>|j	E d H  q>W nt
| jj|ƒ||ƒE d H  t| |||d�S )NZis_asyncF)rW   Úunknownro   r   )rE   r
   ÚAsyncForÚgetattrr?   ÚiterrZ   ÚTupleÚListr;   rl   )r<   rW   r   ro   Úlstr   r   r   Úfor_assigned_stmts	  s    r|   c             C   sr   |d krg }y| j j|ƒ}W n6 tk
rR } ztjd| ||d�|‚W Y d d }~X nX |jd|ƒ | jj| ||d�S )Nz6Tried to retrieve a node {node!r} which does not exist)rW   ro   r   r   )rW   r   ro   )r;   rp   Ú
ValueErrorr   rm   ÚinsertrR   Úassigned_stmts)r<   rW   r   ro   rp   Úexcr   r   r   Úsequence_assigned_stmts  s    r�   c             C   s   | j j| |d�S )N)rW   r   )rR   r   )r<   rW   r   ro   r   r   r   Úassend_assigned_stmts2  s    r‚   c       	      c   sb  | j p| jp| jstjV  d S | j r’t| j d dd ƒ|kr’| jj}| jjjƒ }t	|t
jƒob|jdk}|sp|dkrz|V  d S |dkr’tj|ƒV  d S |rÆ|jrÆtj|j|jƒ}|j| j||ƒE d H  d S || jkrêt
jf ƒ}| |_|V  d S || jk�rt
ji ƒ}| |_|V  d S y,tj|ƒ}| j|ƒj|ƒE d H  tjV  W n  tjk
�r\   tjV  Y nX d S )Nr   r   Ú	metaclassÚclassmethodra   )ÚargsÚvarargÚkwargr   rI   rw   rR   ÚtypeÚscoperE   r
   ÚClassDefr   r`   Úcallcontextr   ÚCallSiteZextra_contextÚinfer_argumentr5   Ú
contextmodÚcopy_contextÚdefault_valuerZ   r   Z	NoDefault)	r<   r   r   ZfunctypeÚclsZis_metaclassZ	call_siter†   r‡   r   r   r   Ú_arguments_infer_argname:  sB    




r’   c             C   sF   |j r8|j }tj|ƒ}d |_ tj|ƒ}|j| j|j|ƒS t| |j|ƒS )N)	r‹   rŽ   r�   r   rŒ   r�   rR   r   r’   )r<   rW   r   ro   r‹   r…   r   r   r   Úarguments_assigned_stmtsg  s    

r“   c             c   s:   |s| j V  d S t| j j|ƒ||ƒE d H  t| |||d�S )N)rW   ru   ro   r   )r,   Ú_resolve_assignment_partsrZ   r?   )r<   rW   r   ro   r   r   r   Úassign_assigned_stmtsu  s    r•   c             c   s4   x.t | |||ƒD ]}|d kr&tjV  q|V  qW d S )N)r•   r   rI   )r<   rW   r   ro   r[   r   r   r   Úassign_annassigned_stmts�  s    
r–   c             c   sü   |dd… }|j dƒ}xà| D ]Ø}d}t|tjƒrZy|j| \}}W qœ tk
rV   dS X nBt|dƒrœtj|ƒ}y|j||ƒ}W n t	j
t	jfk
rš   dS X |s¤dS |s°|V  q|tjkr¾dS yt|j|ƒ||ƒE dH  W q t	jk
� rò   dS X qW dS )z2recursive function to resolve multiple assignmentsNr   rh   )rf   rE   r
   ÚDictr@   Ú
IndexErrorrg   rC   rh   r   rj   rk   r   rI   r”   rZ   rm   )rn   ro   r   rp   rq   rt   rN   rs   r   r   r   r”   Ž  s4    




r”   c             c   sB   x0t j| jƒD ] }t|tjƒr(tj|ƒ}|V  qW t| |||d�S )N)rW   ru   ro   r   )	r   Zunpack_inferrˆ   rE   r
   rŠ   r   ZExceptionInstancer?   )r<   rW   r   ro   rt   r   r   r   Úexcepthandler_assigned_stmts¶  s
    

r™   c       
      #   sn  t |j|d�ƒ}t|tjƒrà|j‰ ˆ js6tjdˆ d�‚xDˆ jj	D ],}t |j|ƒƒ}t|t	j
ƒr@|jƒ tkr@P q@W tjˆ d�‚ˆ jt	jƒ}t ‡ fdd„|D ƒd ƒ}|rÞ|jsÊt	jd ƒ}||_|j|_|V  n|jj|d�E d H  nŠt|tjƒ�r^yt |jd|d�ƒ}	W n* tjtjfk
�r.   tj|d�‚Y nX t|	tjƒ�sJtj|	d�‚|	j| |ƒE d H  ntj|d�‚d S )N)r   z,No decorators found on inferred generator %s)rW   c             3   s   | ]}|j ƒ ˆ kr|V  qd S )N)r‰   )r*   rW   )r8   r   r   rT   Ü  s    z)_infer_context_manager.<locals>.<genexpr>Ú	__enter__)ÚnextrZ   rE   r   Ú	GeneratorrR   r   r   rm   r
   ÚFunctionDefÚqnameÚ_CONTEXTLIB_MGRÚnodes_of_classÚYieldr,   rC   Úlinenor`   ZigetattrZAttributeInferenceErrorZBoundMethodrc   )
r<   Úmgrr   r[   Zdecorator_nodeZ	decoratorZpossible_yield_pointsZyield_pointÚconstZenterr   )r8   r   Ú_infer_context_managerÃ  s>    

r¥   c       	      #   s*  yt ‡ fdd„| jD ƒƒ}W n tk
r0   dS X |dkrNt| ||ƒE dH  nÌxÊt| ||ƒD ]º}|}xª|D ]¢}t|dƒsŒtjd| ˆ ||d�‚y|j| }W qj tk
rÒ } ztjd| ˆ ||d�|‚W Y dd}~X qj t	k
�r
 } ztjd| ˆ ||d�|‚W Y dd}~X qjX qjW |V  q\W t
| ˆ ||d	�S )
a  Infer names and other nodes from a *with* statement.

    This enables only inference for name binding in a *with* statement.
    For instance, in the following code, inferring `func` will return
    the `ContextManager` class, not whatever ``__enter__`` returns.
    We are doing this intentionally, because we consider that the context
    manager result is whatever __enter__ returns and what it is binded
    using the ``as`` keyword.

        class ContextManager(object):
            def __enter__(self):
                return 42
        with ContextManager() as f:
            pass

        # ContextManager().infer() will return ContextManager
        # f.infer() will return 42.

    Arguments:
        self: nodes.With
        node: The target of the assignment, `as (a, b)` in `with foo as (a, b)`.
        context: Inference context used for caching already inferred objects
        assign_path:
            A list of indices, where each index specifies what item to fetch from
            the inference results.
    c             3   s   | ]\}}|ˆ kr|V  qd S )Nr   )r*   r£   Úvars)rW   r   r   rT     s    z&with_assigned_stmts.<locals>.<genexpr>Nr;   z0Wrong type ({targets!r}) for {node!r} assignment)rW   Útargetsro   r   zCTried to infer a nonexistent target with index {index} in {node!r}.z1Tried to unpack a non-iterable value in {node!r}.)rW   ru   ro   r   )r›   r@   ÚStopIterationr¥   rg   r   rm   r;   r˜   rG   r?   )	r<   rW   r   ro   r£   Úresultr6   rp   r€   r   )rW   r   Úwith_assigned_stmtsò  sH    


rª   c             c   s6   | j |kr | jj|d�E dH  ntjd| ||d�‚dS )z9Infer names and other nodes from an assignment expression)r   Nz$Cannot infer NamedExpr node {node!r})rW   ro   r   )Útargetr,   rZ   r   rm   )r<   rW   r   ro   r   r   r   Únamed_expr_assigned_stmts;  s    
r¬   c          -   #   s´  ‡ fdd„‰ | j ƒ }t|tjtjfƒs:tjd| |||d�‚|dkrJtjƒ }t|tjƒ�rÐ|j	}|j
d }tdd„ |jtjƒD ƒƒd	krštjd
| |||d�‚yt|j|ƒƒ}W n tjk
rÊ   tjV  dS X |tjksât|dƒ rîtjV  dS ytj|jƒ ƒ}W n tk
�r   tjV  dS X x®t|jƒD ] \}	}
t|
tjƒ�sV|�sJP |jƒ  �q,tjt|j|	d… ƒƒ}xZ|D ]R}t|tjƒ�sš|�sŽP |jƒ  �qttjt| |j|jd�}|j |d� |V  P �qtW �q,W t|tjƒ�r°yt|j!j|d�ƒ}W n  tjk
�r   tjV  dS X |tjk�s0t|dƒ �r<tjV  dS y|jƒ }W n tk
�rf   tjV  dS X |j"}t|tj#ƒ�sŠtjd|d�‚g }ˆ | ||ƒ |�s®tjd|d�‚|d \}}||d	 k}t$||�rÔdn|| ƒ}||d< xÀ|D ]¸}d}x~|D ]v}t|dƒ�sP t|t$ƒ�s |d }y|jƒ }|| }W n4 t%k
�rL   P Y n" tk
�rh   tjV  dS X |}�qúW tjt| | j| jd�}|j |�p–g d� |V  dS W tjV  dS )aD  
    Arguments:
        self: nodes.Starred
        node: a node related to the current underlying Node.
        context: Inference context used for caching already inferred objects
        assign_path:
            A list of indices, where each index specifies what item to fetch from
            the inference results.
    c                s€   |j ƒ }xrt|ƒD ]f\}}t|tjƒrJ|jj| jjkrJ|j|t|ƒfƒ P t|tj	ƒr|j|t|j ƒ ƒfƒ ˆ | ||ƒ qW d S )N)
re   Ú	enumeraterE   r
   ÚStarredr,   r   ÚappendÚlenry   )Zstarredr«   Úlookupsre   rp   Úelement)Ú$_determine_starred_iteration_lookupsr   r   r³   X  s    zDstarred_assigned_stmts.<locals>._determine_starred_iteration_lookupszDStatement {stmt!r} enclosing {node!r} must be an Assign or For node.)rW   rr   ru   r   Nr   c             s   s   | ]
}d V  qdS )é   Nr   )r*   rN   r   r   r   rT   w  s    z)starred_assigned_stmts.<locals>.<genexpr>r´   z>Too many starred arguments in the  assignment targets {lhs!r}.)rW   r§   ru   r   re   )ÚctxrR   r¢   Ú
col_offset)r;   )r   z8Could not make sense of this, the target must be a tuplez5Could not make sense of this, needs at least a lookupéÿÿÿÿr·   )&Z	statementrE   r
   ÚAssignÚForr   rm   rŽ   ZInferenceContextr,   r§   Úsumr    r®   r›   rZ   r   rI   rg   ÚcollectionsÚdequere   rG   r­   r;   ÚpopleftÚreversedrf   rz   r   r¢   r¶   Zpostinitrx   r«   ry   Úslicer˜   )r<   rW   r   ro   rr   r,   ÚlhsÚrhsr;   rp   Z	left_nodeZlhs_eltsZ
right_nodeÚpackedZinferred_iterablere   r«   r±   Zlast_element_indexZlast_element_lengthZis_starred_lastZlookup_slicer²   Zfound_elementÚlookupZitered_inner_elementZunpackedr   )r³   r   Ústarred_assigned_stmtsL  sÒ    
	




rÄ   )NNN)NNN)NNN)NNN)NNN)NNN)NNN)NNN)NN)NNN)RÚ__doc__r»   rL   Zoperator_modr]   Zastroidr   r   r   r   rŽ   r   r   r   r	   r
   r   Zlazy_importr   r   r   r   rŸ   ZBIN_OP_METHODr@   ZREFLECTED_BIN_OP_METHODZAUGMENTED_OP_METHODZUNARY_OP_METHODÚposÚnegÚinvertÚnot_r4   r9   ry   Zinfer_unary_oprz   ÚSetrC   r—   ÚmatmulrF   rV   Z_KEYZ_IMPLZyes_if_nothing_inferredrQ   Zinfer_binary_oprX   r\   rb   rd   r`   rŠ   rl   Zraise_if_nothing_inferredr|   r¹   r   ZComprehensionr�   r‚   Z
AssignNameZ
AssignAttrr’   r“   Ú	Argumentsr•   r–   r¸   Ú	AnnAssignÚ	AugAssignr”   r™   ÚExceptHandlerr¥   rª   ÚWithr¬   Z	NamedExprrÄ   r®   r   r   r   r   Ú<module>   sÚ   



(

-

(	/E 2