§
    _÷#dèR  ã                   óL  — d Z ddl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	m
Z
mZmZmZmZmZ ddlmZmZ ddlmZmZmZmZmZ ddlmZ dd	lmZmZ  ej        d
¦  «        Z ej        d¦  «        Z ej        d¦  «        Zde de fd„Z!dej"        deej#                 fd„Z$d"dej"        deej%                 dee          fd„Z&de de fd„Z' G d„ d¦  «        Z( G d„ d¦  «        Z) G d„ de)¦  «        Z* G d„ dej+        ¦  «        Z, G d„ de)¦  «        Z- G d „ d!¦  «        Z.dS )#z,Utilities parsing and analyzing Python code.é    N)ÚOrderedDict)Ú	Signature)ÚDEDENTÚINDENTÚNAMEÚNEWLINEÚNUMBERÚOPÚSTRING)ÚCOMMENTÚNL)ÚAnyÚDictÚListÚOptionalÚTuple)Úast)ÚparseÚunparsez^\s*#: ?(.*)?
?$z^\s*$z^\s*(#.*)?$ÚcodeÚreturnc                 ó.   — |                       dd¦  «        S )Núú )Úreplace)r   s    ú6/usr/lib/python3/dist-packages/sphinx/pycode/parser.pyÚfilter_whitespacer      s   € Ø�<Š<˜˜cÑ"Ô"Ð"ó    Únodec                 óT   — t          | t          j        ¦  «        r| j        S | j        gS )z3Get list of targets from Assign and AnnAssign node.)Ú
isinstancer   ÚAssignÚtargetsÚtarget)r   s    r   Úget_assign_targetsr%      s(   € å�$�œ
Ñ#Ô#ð ØŒ|Ðà”ˆ}Ðr   Úselfc                 óf  — |r|j         }| j        j        }|dv rt          d| z  ¦  «        ‚|dk    r'|�| j        |k    r| j        gS t          d| z  ¦  «        ‚|dv rBg }| j        D ]6}	 |                     t          ||¦  «        ¦  «         Œ'# t          $ r Y Œ3w xY w|S |dk    rX| j        j        j        dk    r1|r/| j        j        |k    rdt          | j	        |¦  «        d	         z  gS t          d| z  ¦  «        ‚|d
k    r| gS |dk    rt          | j        |¦  «        S t          d|z  ¦  «        ‚)zÆConvert assignment-AST to variable names.

    This raises `TypeError` if the assignment does not create new variable::

        ary[0] = 'foo'
        dic["bar"] = 'baz'
        # => TypeError
    )ÚIndexÚNumÚSliceÚStrÚ	Subscriptz%r does not create new variableÚNameNz*The assignment %r is not instance variable)r   r   Ú	Attributez%sr   ÚstrÚStarredzUnexpected node name %r)ÚargÚ	__class__Ú__name__Ú	TypeErrorÚidÚeltsÚextendÚget_lvar_namesÚvalueÚattrÚNotImplementedError)r   r&   Úself_idÚ	node_nameÚmembersÚelts         r   r8   r8       sŠ  € ð ð Ø”(ˆà”Ô'€IØÐAÐAÐAÝÐ9¸DÑ@ÑAÔAÐAØ	�fÒ	Ð	Øˆ<˜4œ7 gÒ-Ð-Ø”G�9ÐåÐHÈ4ÑOÑPÔPÐPØ	Ð'Ð	'Ð	'ØˆØ”9ð 	ð 	ˆCðØ—’�~¨c°4Ñ8Ô8Ñ9Ô9Ð9Ð9øÝð ð ð Ø�ðøøøàˆØ	�kÒ	!Ð	!ØŒ:ÔÔ(¨FÒ2Ð2°tÐ2ÀÄ
ÄÐQXÒ@XÐ@Xà�>¨$¬)°TÑ:Ô:¸1Ô=Ñ=Ð>Ð>åÐHÈ4ÑOÑPÔPÐPØ	�eÒ	Ð	ØˆvˆØ	�iÒ	Ð	Ý˜dœj¨$Ñ/Ô/Ð/å!Ð";¸iÑ"GÑHÔHÐHs   Á)#BÂ
BÂBÚsc                 ó˜   — dd„}| |_         t          j        |¦  «        }|r(|                     d¦  «                             d¦  «        S dS )z1Remove common leading indentation from docstring.r   Nc                  ó   — d S ©N© rD   r   r   Údummyzdedent_docstring.<locals>.dummyL   s   € àˆr   z
Ú ©r   N)Ú__doc__ÚinspectÚgetdocÚlstripÚrstrip)r@   rE   Ú	docstrings      r   Údedent_docstringrN   J   s]   € ðð ð ð ð €E„MÝ”˜uÑ%Ô%€IØð Ø×Ò Ñ'Ô'×.Ò.¨vÑ6Ô6Ð6àˆrr   c                   ó~   — e Zd ZdZdededeeef         deeef         deddfd	„Zd
ede	fd„Z
dede	fd„Zdefd„ZdS )ÚTokenz)Better token wrapper for tokenize module.Úkindr9   ÚstartÚendÚsourcer   Nc                 óL   — || _         || _        || _        || _        || _        d S rC   )rQ   r9   rR   rS   rT   )r&   rQ   r9   rR   rS   rT   s         r   Ú__init__zToken.__init__[   s)   € àˆŒ	ØˆŒ
ØˆŒ
ØˆŒØˆŒˆˆr   Úotherc                 ó$  — t          |t          ¦  «        r| j        |k    S t          |t          ¦  «        r| j        |k    S t          |t
          t          f¦  «        r| j        | j        gt          |¦  «        k    S |€dS t          d|z  ¦  «        ‚)NFzUnknown value: %r)r!   ÚintrQ   r/   r9   ÚlistÚtupleÚ
ValueError)r&   rW   s     r   Ú__eq__zToken.__eq__c   sŽ   € Ý�e�SÑ!Ô!ð 		:Ø”9 Ò%Ð%Ý˜�sÑ#Ô#ð 	:Ø”: Ò&Ð&Ý˜¥¥e˜}Ñ-Ô-ð 	:Ø”I˜tœzÐ*­d°5©k¬kÒ9Ð9Øˆ]Ø�5åÐ0°5Ñ8Ñ9Ô9Ð9r   Ú
conditionsc                 ó:   ‡ — t          ˆ fd„|D ¦   «         ¦  «        S )Nc              3   ó$   •K  — | ]
}‰|k    V — Œd S rC   rD   )Ú.0Ú	candidater&   s     €r   ú	<genexpr>zToken.match.<locals>.<genexpr>p   s(   øè è € ÐAÐA¨�4˜9Ò$ÐAÐAÐAÐAÐAÐAr   )Úany)r&   r^   s   ` r   ÚmatchzToken.matcho   s&   ø€ ÝÐAÐAÐAÐA°jÐAÑAÔAÑAÔAÐAr   c                 ól   — dt           j        | j                 ›d| j                             ¦   «         ›d�S )Nz<Token kind=z value=ú>)ÚtokenizeÚtok_namerQ   r9   Ústrip©r&   s    r   Ú__repr__zToken.__repr__r   s:   € € Ý-5Ô->¸t¼yÔ-IÐ-IÐ-IØ-1¬Z×-=Ò-=Ñ-?Ô-?Ð-?Ð-?ðAð 	Ar   )r3   Ú
__module__Ú__qualname__rH   rY   r   r   r/   rV   Úboolr]   re   rl   rD   r   r   rP   rP   X   sÙ   € € € € € Ø3Ð3ð˜Sð ¨ð °U¸3À¸8´_ð È5ÐQTÐVYÐQYÌ?ð ØðØ!%ðð ð ð ð
:˜Cð 
: Dð 
:ð 
:ð 
:ð 
:ðB ð B¨ð Bð Bð Bð BðA˜#ð Að Að Að Að Að Ar   rP   c                   ón   — e Zd Zdee         ddfd„Zdedefd„Zdee	         fd„Z
dedee	         fd	„ZdS )
ÚTokenProcessorÚbuffersr   Nc                 óˆ   ‡— t          |¦  «        Š|| _        t          j        ˆfd„¦  «        | _        d | _        d | _        d S )Nc                  ó"   •— t          ‰ ¦  «        S rC   )Únext)Úliness   €r   ú<lambda>z)TokenProcessor.__init__.<locals>.<lambda>{   s   ø€ µt¸E±{´{€ r   )Úiterrr   rh   Úgenerate_tokensÚtokensÚcurrentÚprevious)r&   rr   rv   s     @r   rV   zTokenProcessor.__init__x   sC   ø€ Ý�W‘”ˆØˆŒÝÔ.Ð/BÐ/BÐ/BÐ/BÑCÔCˆŒØ(,ˆŒØ)-ˆŒˆˆr   Úlinenoc                 ó"   — | j         |dz
           S ©zReturns specified line.é   ©rr   ©r&   r}   s     r   Úget_linezTokenProcessor.get_line   ó   € àŒ|˜F Q™JÔ'Ð'r   c                 óš   — 	 | j         | _        t          t          | j        ¦  «        Ž | _         n# t
          $ r
 d| _         Y nw xY w| j         S )z_Fetch the next token from source code.

        Returns ``None`` if sequence finished.
        N)r{   r|   rP   ru   rz   ÚStopIterationrk   s    r   Úfetch_tokenzTokenProcessor.fetch_tokenƒ   sX   € ð
	 Ø œLˆDŒMÝ ¥$ t¤{Ñ"3Ô"3Ð4ˆDŒLˆLøÝð 	 ð 	 ð 	 ØˆDŒLˆLˆLð	 øøøð Œ|Ðs   ‚,/ ¯AÁAÚ	conditionc                 óÐ  — g }|                       ¦   «         rÏ|                     | j        ¦  «         | j        |k    rn©| j        t          dgk    r ||                      t          dg¦  «        z  }nc| j        t          dgk    r ||                      t          dg¦  «        z  }n1| j        t          dgk    r||                      t          dg¦  «        z  }|                       ¦   «         °Ï|S )zlFetch tokens until specified token appeared.

        .. note:: This also handles parenthesis well.
        ú(ú)ú{ú}ú[ú])r‡   Úappendr{   r
   Úfetch_until)r&   rˆ   rz   s      r   r‘   zTokenProcessor.fetch_until�   sé   € ð
 ˆØ×ÒÑ Ô ð 		6Ø�MŠM˜$œ,Ñ'Ô'Ð'ØŒ|˜yÒ(Ð(ØØ”¥" c Ò*Ð*Ø˜$×*Ò*­B°¨9Ñ5Ô5Ñ5��Ø”¥" c Ò*Ð*Ø˜$×*Ò*­B°¨9Ñ5Ô5Ñ5��Ø”¥" c Ò*Ð*Ø˜$×*Ò*­B°¨9Ñ5Ô5Ñ5�ð ×ÒÑ Ô ð 		6ð ˆr   )r3   rm   rn   r   r/   rV   rY   rƒ   r   rP   r‡   r   r‘   rD   r   r   rq   rq   w   s¡   € € € € € ð.  S¤	ð .¨dð .ð .ð .ð .ð(˜sð ( sð (ð (ð (ð (ð˜X eœ_ð ð ð ð ð Sð ¨T°%¬[ð ð ð ð ð ð r   rq   c                   óX   ‡ — e Zd ZdZdee         ddfˆ fd„Zdee         fd„Zdd„Z	ˆ xZ
S )	ÚAfterCommentParserzÈPython source code parser to pick up comments after assignments.

    This parser takes code which starts with an assignment statement,
    and returns the comment for the variable if one exists.
    rv   r   Nc                 óX   •— t          ¦   «                              |¦  «         d | _        d S rC   )ÚsuperrV   Úcomment©r&   rv   r2   s     €r   rV   zAfterCommentParser.__init__«   s&   ø€ Ý‰Œ×Ò˜ÑÔÐØ&*ˆŒˆˆr   c                 óŽ  — g }|                       ¦   «         �r-|                     | j        ¦  «         | j        t          dgk    r ||                      t          dg¦  «        z  }nÌ| j        t          dgk    r ||                      t          dg¦  «        z  }nš| j        t          dgk    r ||                      t          dg¦  «        z  }nh| j        t
          k    r||                      t          ¦  «        z  }n:| j        t          dgk    rn<| j        j        t          t          t          t          fvrn|                       ¦   «         �°-|S )z%Fetch right-hand value of assignment.rŠ   r‹   rŒ   r�   rŽ   r�   ú;)r‡   r�   r{   r
   r‘   r   r   rQ   r   r	   r   )r&   rz   s     r   Úfetch_rvaluezAfterCommentParser.fetch_rvalue¯   s0  € àˆØ×ÒÑ Ô ñ 	Ø�MŠM˜$œ,Ñ'Ô'Ð'ØŒ|¥ C˜yÒ(Ð(Ø˜$×*Ò*­B°¨9Ñ5Ô5Ñ5��Ø”¥" c Ò*Ð*Ø˜$×*Ò*­B°¨9Ñ5Ô5Ñ5��Ø”¥" c Ò*Ð*Ø˜$×*Ò*­B°¨9Ñ5Ô5Ñ5��Ø”¥Ò'Ð'Ø˜$×*Ò*­6Ñ2Ô2Ñ2��Ø”¥" c Ò*Ð*ØØ”Ô"­2­tµV½VÐ*DÐDÐDØð ×ÒÑ Ô ñ 	ð ˆr   c                 ó’  — |                       ¦   «                              t          dgt          t          ¦  «        sC| j        sJ ‚|                       ¦   «                              t          dgt          t          ¦  «        ¯C| j        t          dgk    r|                      ¦   «          | j        t          k    r| j        j        | _        dS dS )z3Parse the code and obtain comment after assignment.ú=N)	r‡   re   r
   r   r   r{   rš   r9   r–   rk   s    r   r   zAfterCommentParser.parseÃ   s²   € ð ×"Ò"Ñ$Ô$×*Ò*­B°¨9µg½wÑGÔGð 	 Ø”<ÐÐÐð ×"Ò"Ñ$Ô$×*Ò*­B°¨9µg½wÑGÔGð 	 ð Œ<�B ˜9Ò$Ð$Ø×ÒÑÔÐàŒ<�7Ò"Ð"Øœ<Ô-ˆDŒLˆLˆLð #Ð"r   rG   )r3   rm   rn   rH   r   r/   rV   rP   rš   r   Ú__classcell__©r2   s   @r   r“   r“   ¤   sŒ   ø€ € € € € ðð ð+˜d 3œið +¨Dð +ð +ð +ð +ð +ð +ð˜d 5œkð ð ð ð ð(.ð .ð .ð .ð .ð .ð .ð .r   r“   c                   óV  ‡ — e Zd ZdZdee         deddfˆ fd„Zdedeee                  fd„Zdeddfd	„Z	deddfd
„Z
dej        ddfd„Zdededdfd„Zdedej        ddfd„Zdeej                 defd„Zdeej                 defd„Zdeej                 fd„Zdedefd„Zdej        ddfˆ fd„Zdej        ddfd„Zdej        ddfd„Zdej        ddfd„Zdej         ddfd„Z!dej"        ddfd„Z#dej$        ddfd„Z%dej&        ddfd„Z'dej        ddfd „Z(dej)        ddfd!„Z*ˆ xZ+S )"ÚVariableCommentPickerz7Python source code parser to pick up variable comments.rr   Úencodingr   Nc                 óT  •— t          j        ¦   «         | _        || _        || _        g | _        g | _        d | _        t          ¦   «         | _	        i | _
        d | _        i | _        g | _        i | _        d | _        d | _        d | _        t%          ¦   «                              ¦   «          d S rC   )Ú	itertoolsÚcountÚcounterrr   r¡   ÚcontextÚcurrent_classesÚcurrent_functionr   ÚcommentsÚannotationsr|   Ú	defordersÚfinalsÚ	overloadsÚtypingÚtyping_finalÚtyping_overloadr•   rV   )r&   rr   r¡   r2   s      €r   rV   zVariableCommentPicker.__init__Ô   s™   ø€ Ý ”Ñ(Ô(ˆŒØˆŒØ ˆŒØ"$ˆŒØ*,ˆÔØ;?ˆÔÝ4?±M´MˆŒØ79ˆÔØ+/ˆŒØ)+ˆŒØ!#ˆŒØ57ˆŒØ%)ˆŒØ+/ˆÔØ.2ˆÔÝ‰Œ×ÒÑÔÐÐÐr   Únamec                 ó€   — | j         r-| j        r$| j        d         dk    r| j        dd…         |gz   S dS | j        |gz   S )z;Get qualified name for given object as a list of string(s).éÿÿÿÿrV   N)r¨   r§   r¦   )r&   r±   s     r   Úget_qualname_forz&VariableCommentPicker.get_qualname_foræ   sU   € àÔ ð 	)ØÔ#ð ¨¬°RÔ(8¸JÒ(FÐ(Fà”| C R CÔ(¨D¨6Ñ1Ð1à�tà”< 4 &Ñ(Ð(r   c                 ó–   — |                       |¦  «        }|r1t          | j        ¦  «        | j        d                     |¦  «        <   d S d S ©Nú.)r´   ru   r¥   r«   Újoin©r&   r±   Úqualnames      r   Ú	add_entryzVariableCommentPicker.add_entryñ   sR   € Ø×(Ò(¨Ñ.Ô.ˆØð 	DÝ15°d´lÑ1CÔ1CˆDŒN˜3Ÿ8š8 HÑ-Ô-Ñ.Ð.Ð.ð	Dð 	Dr   c                 ó’   — |                       |¦  «        }|r/| j                             d                     |¦  «        ¦  «         d S d S r¶   )r´   r¬   r�   r¸   r¹   s      r   Úadd_final_entryz%VariableCommentPicker.add_final_entryö   sO   € Ø×(Ò(¨Ñ.Ô.ˆØð 	3ØŒK×Ò˜sŸxšx¨Ñ1Ô1Ñ2Ô2Ð2Ð2Ð2ð	3ð 	3r   Úfuncc                 óæ   — ddl m} |                      |j        ¦  «        }|rN| j                             d                     |¦  «        g ¦  «        }|                      ||¦  «        ¦  «         d S d S )Nr   )Úsignature_from_astr·   )Úsphinx.util.inspectrÀ   r´   r±   r­   Ú
setdefaultr¸   r�   )r&   r¾   rÀ   rº   r­   s        r   Úadd_overload_entryz(VariableCommentPicker.add_overload_entryû   s„   € à:Ð:Ð:Ð:Ð:Ð:Ø×(Ò(¨¬Ñ3Ô3ˆØð 	7Øœ×1Ò1°#·(²(¸8Ñ2DÔ2DÀbÑIÔIˆIØ×ÒÐ/Ð/°Ñ5Ô5Ñ6Ô6Ð6Ð6Ð6ð	7ð 	7r   r–   c                 óŠ   — |                       |¦  «        }|r+d                     |d d…         ¦  «        }|| j        ||f<   d S d S ©Nr·   r³   )r´   r¸   r©   )r&   r±   r–   rº   Úbasenames        r   Úadd_variable_commentz*VariableCommentPicker.add_variable_comment  sW   € Ø×(Ò(¨Ñ.Ô.ˆØð 	6Ø—x’x ¨¨"¨¤Ñ.Ô.ˆHØ.5ˆDŒM˜8 TÐ*Ñ+Ð+Ð+ð	6ð 	6r   Ú
annotationc                 ó¤   — |                       |¦  «        }|r8d                     |d d…         ¦  «        }t          |¦  «        | j        ||f<   d S d S rÅ   )r´   r¸   r   rª   )r&   r±   rÈ   rº   rÆ   s        r   Úadd_variable_annotationz-VariableCommentPicker.add_variable_annotation	  sc   € Ø×(Ò(¨Ñ.Ô.ˆØð 	EØ—x’x ¨¨"¨¤Ñ.Ô.ˆHÝ18¸Ñ1DÔ1DˆDÔ˜h¨Ð-Ñ.Ð.Ð.ð	Eð 	Er   Ú
decoratorsc                 óè   — g }| j         r|                     d| j         z  ¦  «         | j        r|                     | j        ¦  «         |D ]'}	 t          |¦  «        |v r dS Œ# t          $ r Y Œ$w xY wdS )Nz%s.finalTF)r®   r�   r¯   r   r;   )r&   rË   ÚfinalÚ	decorators       r   Úis_finalzVariableCommentPicker.is_final  s¤   € ØˆØŒ;ð 	3Ø�LŠL˜ d¤kÑ1Ñ2Ô2Ð2ØÔð 	,Ø�LŠL˜Ô*Ñ+Ô+Ð+à#ð 	ð 	ˆIðÝ˜9Ñ%Ô%¨Ð.Ð.Ø˜4˜4ð /øå&ð ð ð Ø�ðøøøð ˆuó   ÁA"Á"
A/Á.A/c                 óè   — g }| j         r|                     d| j         z  ¦  «         | j        r|                     | j        ¦  «         |D ]'}	 t          |¦  «        |v r dS Œ# t          $ r Y Œ$w xY wdS )Nz%s.overloadTF)r®   r�   r°   r   r;   )r&   rË   ÚoverloadrÎ   s       r   Úis_overloadz!VariableCommentPicker.is_overload  s¤   € ØˆØŒ;ð 	9Ø�OŠO˜M¨D¬KÑ7Ñ8Ô8Ð8ØÔð 	2Ø�OŠO˜DÔ0Ñ1Ô1Ð1à#ð 	ð 	ˆIðÝ˜9Ñ%Ô%¨Ð1Ð1Ø˜4˜4ð 2øå&ð ð ð Ø�ðøøøð ˆurÐ   c                 óÖ   — | j         r(| j         j        j        r| j         j        j        d         S | j         r2t          | j         j        dd¦  «        r| j         j        j        d         S dS )z8Returns the name of the first argument if in a function.r   ÚposonlyargsN)r¨   ÚargsÚgetattrrÕ   rk   s    r   Úget_selfzVariableCommentPicker.get_self/  sq   € àÔ ð 	 TÔ%:Ô%?Ô%Dð 	ØÔ(Ô-Ô2°1Ô5Ð5ØÔ#ð 	Ý�dÔ+Ô0°-ÀÑFÔFð	ð Ô(Ô-Ô9¸!Ô<Ð<à�4r   r}   c                 ó"   — | j         |dz
           S r   r�   r‚   s     r   rƒ   zVariableCommentPicker.get_line:  r„   r   r   c                 óX   •— t          ¦   «                              |¦  «         || _        dS )z(Updates self.previous to the given node.N)r•   Úvisitr|   )r&   r   r2   s     €r   rÛ   zVariableCommentPicker.visit>  s$   ø€ å‰Œ�Š�dÑÔÐØˆŒˆˆr   c                 ó  — |j         D ]}|                      |j        p|j        ¦  «         |j        dk    r|j        p|j        | _        ŒB|j        dk    r|j        p|j        | _        Œa|j        dk    r|j        p|j        | _        Œ€dS )ú8Handles Import node and record the order of definitions.r®   ztyping.finalztyping.overloadN)Únamesr»   Úasnamer±   r®   r¯   r°   ©r&   r   r±   s      r   Úvisit_Importz"VariableCommentPicker.visit_ImportC  sœ   € à”Jð 	@ð 	@ˆDØ�NŠN˜4œ;Ð3¨$¬)Ñ4Ô4Ð4àŒy˜HÒ$Ð$Ø"œkÐ6¨T¬Y�”�Ø”˜nÒ,Ð,Ø$(¤KÐ$<°4´9�Ô!Ð!Ø”Ð/Ò/Ð/Ø'+¤{Ð'?°d´i�Ô$øð	@ð 	@r   c                 ó  — |j         D ]v}|                      |j        p|j        ¦  «         |j        dk    r|j        dk    r|j        p|j        | _        ŒM|j        dk    r|j        dk    r|j        p|j        | _        ŒwdS )rÝ   r®   rÍ   rÒ   N)rÞ   r»   rß   r±   Úmoduler¯   r°   rà   s      r   Úvisit_ImportFromz&VariableCommentPicker.visit_ImportFromO  s”   € à”Jð 	@ð 	@ˆDØ�NŠN˜4œ;Ð3¨$¬)Ñ4Ô4Ð4àŒ{˜hÒ&Ð&¨4¬9¸Ò+?Ð+?Ø$(¤KÐ$<°4´9�Ô!Ð!Ø” Ò(Ð(¨T¬Y¸*Ò-DÐ-DØ'+¤{Ð'?°d´i�Ô$øð	@ð 	@r   c                 ó`  ‡ — 	 t          |¦  «        }t          ˆ fd„|D ¦   «         g ¦  «        }‰                      |j        ¦  «        }n# t          $ r Y dS w xY wt          |d¦  «        r(|j        r!|D ]}‰                      ||j        ¦  «         Œn7t          |d¦  «        r'|j        r |D ]}‰                      ||j        ¦  «         Œt          ||j
        d…         g‰ j        |j        d…         z   ¦  «        }|                     ¦   «          |j        rot                               |j        ¦  «        rP|D ]K}‰                      |t                               d|j        ¦  «        ¦  «         ‰                      |¦  «         ŒLdS t&                               |d|j
        …         ¦  «        règ }t)          |j        dz
  ¦  «        D ]k}‰                      |j        dz
  |z
  ¦  «        }	t                               |	¦  «        r/|                     t                               d|	¦  «        ¦  «         Œk |rat-          d                     t1          |¦  «        ¦  «        ¦  «        }
|D ]-}‰                      ||
¦  «         ‰                      |¦  «         Œ.dS |D ]}‰                      |¦  «         ŒdS )z3Handles Assign node and pick up a variable comment.c                 óV   •— g | ]%}t          |‰                     ¦   «         ¬ ¦  «        ‘Œ&S )rk   )r8   rØ   )ra   Útr&   s     €r   ú
<listcomp>z6VariableCommentPicker.visit_Assign.<locals>.<listcomp>]  s/   ø€ Ð&`Ð&`Ð&`ÐST¥~°a¸d¿mºm¹o¼oÐ'NÑ'NÔ'NÐ&`Ð&`Ð&`r   NrÈ   Útype_commentz\1r€   ú
)r%   Úsumrƒ   r}   r4   ÚhasattrrÈ   rÊ   ré   r“   Ú
col_offsetrr   r   r–   Ú
comment_rere   rÇ   Úsubr»   Ú	indent_reÚranger�   rN   r¸   Úreversed)r&   r   r#   ÚvarnamesÚcurrent_lineÚvarnameÚparserÚcomment_linesÚiÚbefore_liner–   s   `          r   Úvisit_Assignz"VariableCommentPicker.visit_AssignY  sü  ø€ ð	Ý(¨Ñ.Ô.ˆGÝ"%Ð&`Ð&`Ð&`Ð&`ÐX_Ð&`Ñ&`Ô&`ÐbdÑ"eÔ"eˆHØŸ=š=¨¬Ñ5Ô5ˆLˆLøÝð 	ð 	ð 	ØˆFˆFð	øøøõ �4˜Ñ&Ô&ð 	I¨4¬?ð 	IØ#ð Gð G�Ø×,Ò,¨W°d´oÑFÔFÐFÐFðGå�T˜>Ñ*Ô*ð 	I¨tÔ/@ð 	IØ#ð Ið I�Ø×,Ò,¨W°dÔ6GÑHÔHÐHÐHõ $ \°$´/Ð2BÐ2BÔ%CÐ$DØ$(¤L°´°°Ô$>ñ%?ñ @ô @ˆà�Š‰ŒˆØŒ>ð 	�j×.Ò.¨v¬~Ñ>Ô>ð 	Ø#ð (ð (�Ø×)Ò)¨'µ:·>²>À%ÈÌÑ3XÔ3XÑYÔYÐYØ—’˜wÑ'Ô'Ð'Ð'ØˆFõ �?Š?˜<Ð(8¨¬Ð(8Ô9Ñ:Ô:ð 	ØˆMÝ˜4œ;¨™?Ñ+Ô+ð ð �Ø"Ÿmšm¨D¬K¸!©O¸aÑ,?Ñ@Ô@�Ý×#Ò# KÑ0Ô0ð Ø!×(Ò(­¯ª¸¸{Ñ)KÔ)KÑLÔLÐLÐLààð Ý*¨4¯9ª9µX¸mÑ5LÔ5LÑ+MÔ+MÑNÔN�Ø'ð ,ð ,�GØ×-Ò-¨g°wÑ?Ô?Ð?Ø—N’N 7Ñ+Ô+Ð+Ð+Ø�ð  ð 	$ð 	$ˆGØ�NŠN˜7Ñ#Ô#Ð#Ð#ð	$ð 	$s   ƒAA	 Á	
AÁAc                 ó0   — |                       |¦  «         dS )z6Handles AnnAssign node and pick up a variable comment.N)rú   ©r&   r   s     r   Úvisit_AnnAssignz%VariableCommentPicker.visit_AnnAssign‰  s   € à×Ò˜$ÑÔÐÐÐr   c                 ó\  — t          | j        t          j        t          j        f¦  «        rþt          |j        t          j        ¦  «        rá	 t          | j        ¦  «        }t          |d         |  	                    ¦   «         ¦  «        }|D ]Œ}t          |j        j
        t          ¦  «        r|j        j
        }n&|j        j
                             | j        pd¦  «        }|                      |t          |¦  «        ¦  «         |                      |¦  «         Œ�dS # t"          $ r Y dS w xY wdS dS )z2Handles Expr node and pick up a comment if string.r   úutf-8N)r!   r|   r   r"   Ú	AnnAssignr9   r+   r%   r8   rØ   r@   r/   Údecoder¡   rÇ   rN   r»   r4   )r&   r   r#   ró   rõ   rM   s         r   Ú
visit_Exprz VariableCommentPicker.visit_Expr�  s)  € å�t”}¥s¤zµ3´=Ð&AÑBÔBð 	Ý˜4œ:¥s¤wÑ/Ô/ð	ðÝ,¨T¬]Ñ;Ô;�Ý)¨'°!¬*°d·m²m±o´oÑFÔF�Ø'ð ,ð ,�GÝ! $¤*¤,µÑ4Ô4ð RØ$(¤J¤L˜	˜	à$(¤J¤L×$7Ò$7¸¼Ð8PÈÑ$QÔ$Q˜	à×-Ò-¨gÕ7GÈ	Ñ7RÔ7RÑSÔSÐSØ—N’N 7Ñ+Ô+Ð+Ð+ð,ð ,øõ ð ð ð Ø��ðøøøð	ð 	ð 	ð 	s   ÁCD Ä
D'Ä&D'c                 ó‚   — |j         D ]}|                      |¦  «         Œ|j        D ]}|                      |¦  «         ŒdS )z‹Handles Try node and processes body and else-clause.

        .. note:: pycode parser ignores objects definition in except-clause.
        N)ÚbodyrÛ   Úorelse)r&   r   Úsubnodes      r   Ú	visit_TryzVariableCommentPicker.visit_TryŸ  sZ   € ð
 ”yð 	 ð 	 ˆGØ�JŠJ�wÑÔÐÐØ”{ð 	 ð 	 ˆGØ�JŠJ�wÑÔÐÐð	 ð 	 r   c                 óÎ  — | j                              |j        ¦  «         |                      |j        ¦  «         |                      |j        ¦  «        r|                      |j        ¦  «         | j                             |j        ¦  «         || _        |j	        D ]}|  
                    |¦  «         Œ| j                             ¦   «          | j                              ¦   «          dS )z&Handles ClassDef node and set context.N)r§   r�   r±   r»   rÏ   Údecorator_listr½   r¦   r|   r  rÛ   Úpop©r&   r   Úchilds      r   Úvisit_ClassDefz$VariableCommentPicker.visit_ClassDef©  sÐ   € àÔ×#Ò# D¤IÑ.Ô.Ð.Ø�Š�t”yÑ!Ô!Ð!Ø�=Š=˜Ô,Ñ-Ô-ð 	,Ø× Ò  ¤Ñ+Ô+Ð+ØŒ×Ò˜DœIÑ&Ô&Ð&ØˆŒØ”Yð 	ð 	ˆEØ�JŠJ�uÑÔÐÐØŒ×ÒÑÔÐØÔ× Ò Ñ"Ô"Ð"Ð"Ð"r   c                 óÜ  — | j         €ä|                      |j        ¦  «         |                      |j        ¦  «        r|                      |j        ¦  «         |                      |j        ¦  «        r|                      |¦  «         | j         	                    |j        ¦  «         || _         |j
        D ]}|                      |¦  «         Œ| j                             ¦   «          d| _         dS dS )z)Handles FunctionDef node and set context.N)r¨   r»   r±   rÏ   r	  r½   rÓ   rÃ   r¦   r�   r  rÛ   r
  r  s      r   Úvisit_FunctionDefz'VariableCommentPicker.visit_FunctionDef¶  sé   € àÔ Ð(Ø�NŠN˜4œ9Ñ%Ô%Ð%Ø�}Š}˜TÔ0Ñ1Ô1ð 0Ø×$Ò$ T¤YÑ/Ô/Ð/Ø×Ò Ô 3Ñ4Ô4ð .Ø×'Ò'¨Ñ-Ô-Ð-ØŒL×Ò ¤	Ñ*Ô*Ð*Ø$(ˆDÔ!Øœð "ð "�Ø—
’
˜5Ñ!Ô!Ð!Ð!ØŒL×ÒÑÔÐØ$(ˆDÔ!Ð!Ð!ð )Ð(r   c                 ó0   — |                       |¦  «         dS )z.Handles AsyncFunctionDef node and set context.N)r  rü   s     r   Úvisit_AsyncFunctionDefz,VariableCommentPicker.visit_AsyncFunctionDefÅ  s   € à×Ò˜tÑ$Ô$Ð$Ð$Ð$r   ),r3   rm   rn   rH   r   r/   rV   r   r´   r»   r½   r   ÚFunctionDefrÃ   rÇ   ÚASTrÊ   Úexprro   rÏ   rÓ   r1   rØ   rY   rƒ   rÛ   ÚImportrá   Ú
ImportFromrä   r"   rú   r   rý   ÚExprr  ÚTryr  ÚClassDefr  r  ÚAsyncFunctionDefr  r�   rž   s   @r   r    r    Ñ   sd  ø€ € € € € ØAÐAð  S¤	ð °Sð ¸Tð ð ð ð ð ð ð$	) Sð 	)¨X°d¸3´iÔ-@ð 	)ð 	)ð 	)ð 	)ðD˜cð D dð Dð Dð Dð Dð
3 Cð 3¨Dð 3ð 3ð 3ð 3ð
7 s¤ð 7¸4ð 7ð 7ð 7ð 7ð6¨ð 6°sð 6¸tð 6ð 6ð 6ð 6ðE¨Cð E¸S¼Wð EÈð Eð Eð Eð Eð 4¨¬¤>ð °dð ð ð ð ð  d¨3¬8¤nð ¸ð ð ð ð ð 	˜( 3¤7Ô+ð 	ð 	ð 	ð 	ð(˜sð ( sð (ð (ð (ð (ð˜#œ'ð  dð ð ð ð ð ð ð

@ ¤ð 
@°ð 
@ð 
@ð 
@ð 
@ð@ S¤^ð @¸ð @ð @ð @ð @ð.$ ¤ð .$°ð .$ð .$ð .$ð .$ð`  C¤Mð  °dð  ð  ð  ð  ð˜sœxð ¨Dð ð ð ð ð$ ˜cœgð  ¨$ð  ð  ð  ð  ð# 3¤<ð #°Dð #ð #ð #ð #ð) c¤oð )¸$ð )ð )ð )ð )ð%¨3Ô+?ð %ÀDð %ð %ð %ð %ð %ð %ð %ð %r   r    c                   ó~   ‡ — e Zd ZdZdee         ddfˆ fd„Zdedeeeef         ddfd„Z	dd	„Z
d
eddfd„Zdd„Zˆ xZS )ÚDefinitionFinderzXPython source code parser to detect location of functions,
    classes and methods.
    rv   r   Nc                 ó‚   •— t          ¦   «                              |¦  «         d | _        g | _        g | _        i | _        d S rC   )r•   rV   rÎ   r¦   ÚindentsÚdefinitionsr—   s     €r   rV   zDefinitionFinder.__init__Ï  s>   ø€ Ý‰Œ×Ò˜ÑÔÐØ*.ˆŒØ"$ˆŒØGIˆŒØ<>ˆÔÐÐr   r±   Úentryc                 ór   — | j         r%| j         d         d         dk    r|d         dk    rdS || j        |<   dS )zAdd a location of definition.r³   r   ÚdefN)r  r  )r&   r±   r   s      r   Úadd_definitionzDefinitionFinder.add_definitionÖ  sH   € àŒ<ð 	+˜DœL¨Ô,¨QÔ/°5Ò8Ð8¸UÀ1¼XÈÒ=NÐ=NàˆDà%*ˆDÔ˜TÑ"Ð"Ð"r   c                 óJ  — 	 |                       ¦   «         }|€dS |t          k    rný|t          dgk    rG| j        �1| j                             t
          t          t          t          ¦  «        r| j	        €|| _	        n©|                     t          dg¦  «        r|                      d¦  «         nw|                     t          dg¦  «        r|                      d¦  «         nE|t          k    r| j                             d¦  «         n|t          k    r|                      ¦   «          �Œ#)z1Parse the code to obtain location of definitions.TNú@Úclassr"  )rW   NN)r‡   r   r
   r|   re   r   r   r   r   rÎ   r   Úparse_definitionr  r�   Úfinalize_block)r&   Útokens     r   r   zDefinitionFinder.parseÞ  s  € ð	&Ø×$Ò$Ñ&Ô&ˆEØˆ}Ø�Ø�'Ò!Ð!ØØ�2˜s˜)Ò#Ð#¨¬Ð)>Ø)-¬×)<Ò)<½WÅbÍ&ÕRXÑ)YÔ)Yð *?à”>Ð)Ø%*�D”NøØ—’�d G˜_Ñ-Ô-ð &Ø×%Ò% gÑ.Ô.Ð.Ð.Ø—’�d E˜]Ñ+Ô+ð &Ø×%Ò% eÑ,Ô,Ð,Ð,Ø�&’�Ø”×#Ò#Ð$9Ñ:Ô:Ð:Ð:Ø�&’�Ø×#Ò#Ñ%Ô%Ð%ñ#	&r   Útypc                 ó„  — |                       ¦   «         }| j                             |j        ¦  «         d                     | j        ¦  «        }| j        r| j        j        d         }d| _        n|j        d         }|                      t          dg¦  «         |                       ¦   «          	                    t          t          ¦  «        r9|                      t          ¦  «         | j                             |||f¦  «         dS |                      ||||j        d         f¦  «         | j                             ¦   «          dS )zParse AST of definition.r·   r   Nú:)r‡   r¦   r�   r9   r¸   rÎ   rR   r‘   r
   re   r   r   r   r  r#  rS   r
  )r&   r*  r±   ÚfuncnameÚ	start_poss        r   r'  z!DefinitionFinder.parse_definitionó  s  € à×ÒÑ!Ô!ˆØŒ×Ò˜DœJÑ'Ô'Ð'Ø—8’8˜DœLÑ)Ô)ˆàŒ>ð 	&ØœÔ,¨QÔ/ˆIØ!ˆDŒNˆNàœ
 1œˆIà×Ò�"˜c˜Ñ#Ô#Ð#Ø×ÒÑÔ×#Ò#¥G­WÑ5Ô5ð 	Ø×Ò�VÑ$Ô$Ð$ØŒL×Ò  h°	Ð :Ñ;Ô;Ð;Ð;Ð;ð ×Ò ¨3°	¸4¼8ÀA¼;Ð*GÑHÔHÐHØŒL×ÒÑÔÐÐÐr   c                 ó¬  — | j                              ¦   «         }|d         dk    r®|\  }}}| j        j        d         dz
  }t                               |                      |¦  «        ¦  «        r2|dz  }t                               |                      |¦  «        ¦  «        °2|                      ||||f¦  «         | j                             ¦   «          dS dS )zFinalize definition block.r   rW   r€   N)	r  r
  r{   rS   Úemptyline_rere   rƒ   r#  r¦   )r&   Ú
definitionr*  r-  r.  Úend_poss         r   r(  zDefinitionFinder.finalize_block  sÔ   € à”\×%Ò%Ñ'Ô'ˆ
Ø�aŒ=˜GÒ#Ð#Ø'1Ñ$ˆC�˜9Ø”lÔ& qÔ)¨AÑ-ˆGÝ×$Ò$ T§]¢]°7Ñ%;Ô%;Ñ<Ô<ð Ø˜1‘�õ ×$Ò$ T§]¢]°7Ñ%;Ô%;Ñ<Ô<ð ð ×Ò ¨3°	¸7Ð*CÑDÔDÐDØŒL×ÒÑÔÐÐÐð $Ð#r   rG   )r3   rm   rn   rH   r   r/   rV   r   rY   r#  r   r'  r(  r�   rž   s   @r   r  r  Ê  s×   ø€ € € € € ðð ð?˜d 3œið ?¨Dð ?ð ?ð ?ð ?ð ?ð ?ð+ 3ð +¨u°S¸#¸s°]Ô/Cð +Èð +ð +ð +ð +ð&ð &ð &ð &ð* Cð ¨Dð ð ð ð ð*
ð 
ð 
ð 
ð 
ð 
ð 
ð 
r   r  c                   ó@   — e Zd ZdZddededdfd„Zdd„Zdd	„Zdd
„ZdS )ÚParserzyPython source code parser to pick up variable comments.

    This is a better wrapper for ``VariableCommentPicker``.
    rÿ   r   r¡   r   Nc                 ó�   — t          |¦  «        | _        || _        i | _        i | _        i | _        i | _        g | _        i | _        d S rC   )	r   r   r¡   rª   r©   r«   r  r¬   r­   )r&   r   r¡   s      r   rV   zParser.__init__  sH   € Ý% dÑ+Ô+ˆŒ	Ø ˆŒØ79ˆÔØ46ˆŒØ)+ˆŒØ<>ˆÔØ!#ˆŒØ57ˆŒˆˆr   c                 óV   — |                       ¦   «          |                      ¦   «          dS )zParse the source code.N)Úparse_commentsr'  rk   s    r   r   zParser.parse%  s,   € à×ÒÑÔÐØ×ÒÑÔÐÐÐr   c                 ó*  — t          | j        ¦  «        }t          | j                             d¦  «        | j        ¦  «        }|                     |¦  «         |j        | _        |j        | _        |j        | _        |j	        | _	        |j
        | _
        dS )z$Parse the code and pick up comments.TN)r   r   r    Ú
splitlinesr¡   rÛ   rª   r©   r«   r¬   r­   )r&   ÚtreeÚpickers      r   r7  zParser.parse_comments*  sy   € å�T”YÑÔˆÝ& t¤y×';Ò';¸DÑ'AÔ'AÀ4Ä=ÑQÔQˆØ�Š�TÑÔÐØ!Ô-ˆÔØœˆŒØÔ)ˆŒØ”mˆŒØÔ)ˆŒˆˆr   c                 ó”   — t          | j                             d¦  «        ¦  «        }|                     ¦   «          |j        | _        dS )z0Parse the location of definitions from the code.TN)r  r   r9  r   r  )r&   rö   s     r   r'  zParser.parse_definition5  s=   € å! $¤)×"6Ò"6°tÑ"<Ô"<Ñ=Ô=ˆØ�Š‰ŒˆØ!Ô-ˆÔÐÐr   )rÿ   rG   )	r3   rm   rn   rH   r/   rV   r   r7  r'  rD   r   r   r4  r4    sˆ   € € € € € ðð ð
8ð 8˜Sð 8¨Cð 8¸dð 8ð 8ð 8ð 8ð ð  ð  ð  ð
	*ð 	*ð 	*ð 	*ð.ð .ð .ð .ð .ð .r   r4  rC   )/rH   rI   r£   Úrerh   Úcollectionsr   r   r)  r   r   r   r   r	   r
   r   r   r   r®   r   r   r   r   r   Úsphinx.pycode.astr   r   r   Úcompilerî   rð   r0  r/   r   r  r  r%   r1   r8   rN   rP   rq   r“   ÚNodeVisitorr    r  r4  rD   r   r   ú<module>rB     sü  ðØ 2Ð 2Ø €€€Ø Ð Ð Ð Ø 	€	€	€	Ø €€€Ø #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ø CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CÐ CØ  Ð  Ð  Ð  Ð  Ð  Ð  Ð  Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3à !Ð !Ð !Ð !Ð !Ð !Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,àˆRŒZÐ.Ñ/Ô/€
ØˆBŒJ�xÑ Ô €	ØˆrŒz˜.Ñ)Ô)€ð#˜Cð # Cð #ð #ð #ð #ð˜SœWð ¨¨c¬h¬ð ð ð ð ð'Ið 'I˜œð 'I¨°´Ô(9ð 'IÀTÈ#ÄYð 'Ið 'Ið 'Ið 'IðT˜ð  ð ð ð ð ðAð Að Að Að Añ Aô Að Að>*ð *ð *ð *ð *ñ *ô *ð *ðZ*.ð *.ð *.ð *.ð *.˜ñ *.ô *.ð *.ðZv%ð v%ð v%ð v%ð v%˜CœOñ v%ô v%ð v%ðrHð Hð Hð Hð H�~ñ Hô Hð HðV$.ð $.ð $.ð $.ð $.ñ $.ô $.ð $.ð $.ð $.r   