§
    _÷#dS  ã                   ó¤   — d 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mZmZmZmZ ddlmZ dd	lmZ dd
lmZ  G d„ d¦  «        ZdS )z,Utilities parsing and analyzing Python code.é    N)ÚOrderedDict)Úimport_module)Ú	Signature)Úpath)ÚAnyÚDictÚListÚOptionalÚTuple)ÚZipFile)ÚPycodeError)ÚParserc            
       ó€  — e Zd ZU eeeef         ef         ed<   eeeef         ee         f         ed<   ee         ed<   eeee         f         ed<   eee	f         ed<   eeeee	e	f         f         ed<   i Z
eeeef         ef         ed<   eded	eee         ee         f         fd
„¦   «         Zeddededed	d fd„¦   «         Zededed	d fd„¦   «         Zededed	d fd„¦   «         Zeded	d fd„¦   «         Zdededed	dfd„Zdd„Zd	eeeef         ee         f         fd„Zd	eeeee	e	f         f         fd„ZdS )ÚModuleAnalyzerÚannotationsÚ	attr_docsÚfinalsÚ	overloadsÚtagorderÚtagsÚcacheÚmodnameÚreturnc                 óœ  — 	 t          | ¦  «        }n&# t          $ r}t          d| z  |¦  «        |‚d}~ww xY wt          |dd¦  «        }t          |dd¦  «        }|r>t          |dd¦  «        r-	 |                     | ¦  «        }|r||fS n# t
          $ r Y nw xY w|€P|rNt          |dd¦  «        r=	 |                     | ¦  «        }n&# t
          $ r}t          d| z  |¦  «        |‚d}~ww xY w|€t          d| z  ¦  «        ‚t          j        t          j	        |¦  «        ¦  «        }| 
                    ¦   «                              d	¦  «        r;|dd
…         }t          j        |¦  «        st          j        |dz   ¦  «        r|dz  }nœ| 
                    ¦   «                              d¦  «        st          d|z  ¦  «        ‚dt          j        z   |v rRdt          j        t          j        ¦  «        z   }t          j        ||d¦  «        \  }}t          j        |¦  «        r|dfS t          j        |¦  «        st          d|z  ¦  «        ‚|dfS )z˜Try to find the source code for a module.

        Returns ('filename', 'source'). One of it can be None if
        no filename or source found
        zerror importing %rNÚ
__loader__Ú__file__Ú
get_sourceÚget_filenamezerror getting filename for %rzno source found for module %r)z.pyoz.pycéÿÿÿÿÚw)z.pyz.pywzsource is not a .py file: %rú.eggú
(?<=\.egg)é   zsource file is not present: %r)r   Ú	Exceptionr   Úgetattrr   ÚImportErrorr   r   ÚnormpathÚabspathÚlowerÚendswithÚisfileÚsepÚreÚescapeÚsplit)	r   ÚmodÚerrÚloaderÚfilenameÚsourceÚpatÚeggpathÚ_s	            ú8/usr/lib/python3/dist-packages/sphinx/pycode/__init__.pyÚget_module_sourcez ModuleAnalyzer.get_module_source   s¦  € ð	LÝ Ñ(Ô(ˆCˆCøÝð 	Lð 	Lð 	LÝÐ2°WÑ<¸cÑBÔBÈÐKøøøøð	Løøøå˜˜l¨DÑ1Ô1ˆÝ˜3 
¨DÑ1Ô1ˆØð 	•g˜f l°DÑ9Ô9ð 	ðØ×*Ò*¨7Ñ3Ô3�Øð ,à# VÐ+Ð+ð,øõ ð ð ð Ø�ðøøøàÐ Ð­7°6¸>È4Ñ+PÔ+PÐð[Ø!×.Ò.¨wÑ7Ô7��øÝð [ð [ð [Ý!Ð"AÀGÑ"KÈSÑQÔQÐWZÐZøøøøð[øøøàÐåÐ=ÀÑGÑHÔHÐHÝ”=¥¤¨hÑ!7Ô!7Ñ8Ô8ˆØ�>Š>ÑÔ×$Ò$Ð%5Ñ6Ô6ð 
	&Ø   ”}ˆHÝ”;˜xÑ(Ô(ð  ­T¬[¸ÀC¹Ñ-HÔ-Hð  Ø˜C‘�øØ—’Ñ!Ô!×*Ò*¨?Ñ;Ô;ð 	&ÝÐ<¸xÑGÑHÔHÐHØ•t”xÑ HÐ,Ð,Ø¥"¤)­D¬HÑ"5Ô"5Ñ5ˆCÝœ # x°Ñ3Ô3‰JˆG�QÝŒ{˜7Ñ#Ô#ð &Ø �~Ð%åŒ{˜8Ñ$Ô$ð 	KÝÐ>ÀÑIÑJÔJÐJØ˜ˆ~Ðs:   ‚ ’
5œ0°5Á.B
 Â

BÂBÂ0C Ã
C)ÃC$Ã$C)ú<string>ÚstringÚsrcnamec                 ó   —  | |||¦  «        S )N© )Úclsr;   r   r<   s       r8   Ú
for_stringzModuleAnalyzer.for_stringK   s   € ð ˆs�6˜7 GÑ,Ô,Ð,ó    r3   c                 ó®  — d|f| j         v r| j         d|f         S 	 t          j        |¦  «        5 }|                     ¦   «         }d d d ¦  «         n# 1 swxY w Y    | |||¦  «        }|| j         d|f<   n_# t          $ rR}dt
          j        z   |v r#|                      ||¦  «        x}| j         d|f<   nt          d|z  |¦  «        |‚Y d }~nd }~ww xY w|S )NÚfiler!   úerror opening %r)	r   ÚtokenizeÚopenÚreadr$   r   r,   Úfor_eggr   )r?   r3   r   Úfr;   Úobjr1   s          r8   Úfor_filezModuleAnalyzer.for_fileP   sN  € à�HÐ ¤Ð*Ð*Ø”9˜V XÐ-Ô.Ð.ð		OÝ”˜xÑ(Ô(ð "¨AØŸš™œ�ð"ð "ð "ñ "ô "ð "ð "ð "ð "ð "ð "øøøð "ð "ð "ð "à�#�f˜g xÑ0Ô0ˆCØ*-ˆCŒI�f˜hÐ&Ñ'Ð'øÝð 	Oð 	Oð 	OØ�œÑ  HÐ,Ð,Ø47·K²KÀÈ'Ñ4RÔ4RÐR��c”i ¨Ð 0Ñ1Ð1å!Ð"4°xÑ"?ÀÑEÔEÈ3ÐNð 2Ð1Ð1Ð1Ð1øøøøð	Oøøøð
 ˆ
s;   œA6 °AÁA6 ÁAÁA6 ÁAÁA6 Á6
CÂ ACÃCc                 ó�  — t          j        t          j        ¦  «        }t          j        d|z   |¦  «        \  }}	 t          |¦  «        5 }|                     |¦  «                             ¦   «         }|                      |||¦  «        cd d d ¦  «         S # 1 swxY w Y   d S # t          $ r}t          d|z  |¦  «        |‚d }~ww xY w)Nr"   rD   )r-   r.   r   r,   r/   r   rG   Údecoder@   r$   r   )	r?   r3   r   ÚSEPr6   ÚrelpathÚeggÚcodeÚexcs	            r8   rH   zModuleAnalyzer.for_egg`   s  € åŒi�œÑ!Ô!ˆÝœ8 M°CÑ$7¸ÑBÔBÑˆ�ð	KÝ˜Ñ!Ô!ð ? SØ—x’x Ñ(Ô(×/Ò/Ñ1Ô1�Ø—~’~ d¨G°XÑ>Ô>ð?ð ?ð ?ð ?ñ ?ô ?ð ?ð ?ð ?ð ?ð ?ð ?øøøð ?ð ?ð ?ð ?ð ?ð ?øõ ð 	Kð 	Kð 	KÝÐ0°8Ñ;¸SÑAÔAÀsÐJøøøøð	Køøøs;   »B" Á
>BÂB" ÂBÂB" ÂBÂB" Â"
CÂ,C Ã Cc                 ó^  — d|f| j         v r(| j         d|f         }t          |t          ¦  «        r|‚|S 	 |                      |¦  «        \  }}|�|                      |||pd¦  «        }n|�|                      ||¦  «        }n# t          $ r}|| j         d|f<   ‚ d }~ww xY w|| j         d|f<   |S )NÚmoduler:   )r   Ú
isinstancer   r9   r@   rK   )r?   r   Úentryr3   r4   rJ   r1   s          r8   Ú
for_modulezModuleAnalyzer.for_modulek   så   € à�gÐ #¤)Ð+Ð+Ø”I˜h¨Ð/Ô0ˆEÝ˜%¥Ñ-Ô-ð Ø�ØˆLð	Ø"×4Ò4°WÑ=Ô=ÑˆH�fØÐ!Ø—n’n V¨W°hÐ6LÀ*ÑMÔM��ØÐ%Ø—l’l 8¨WÑ5Ô5�øøÝð 	ð 	ð 	Ø+.ˆCŒI�h Ð'Ñ(Øøøøøð	øøøð (+ˆŒ	�(˜GÐ#Ñ$Øˆ
s   µAB Â
BÂBÂBr4   Nc                 ó>   — || _         || _        || _        d| _        d S )NF)r   r<   rQ   Ú	_analyzed)Úselfr4   r   r<   s       r8   Ú__init__zModuleAnalyzer.__init__   s$   € ØˆŒØˆŒð ˆŒ	àˆŒˆˆrA   c                 ó
  — | j         rdS 	 t          | j        ¦  «        }|                     ¦   «          t	          ¦   «         | _        |j                             ¦   «         D ]3\  }}|r!|                     ¦   «         dgz   | j        |<   Œ(dg| j        |<   Œ4|j	        | _	        |j
        | _
        |j        | _        |j        | _        |j        | _        d| _         dS # t           $ r }t#          d| j        ›d|›�¦  «        |‚d}~ww xY w)zAnalyze the source code.NÚ Tzparsing z	 failed: )rY   r   rQ   Úparser   r   ÚcommentsÚitemsÚ
splitlinesr   r   r   Údefinitionsr   Ú	defordersr   r$   r   r<   )rZ   ÚparserÚscopeÚcommentrR   s        r8   ÚanalyzezModuleAnalyzer.analyzeˆ   s  € àŒ>ð 	Ø�4ð	VÝ˜DœIÑ&Ô&ˆFØ�LŠL‰NŒNˆNå(™]œ]ˆDŒNØ$*¤O×$9Ò$9Ñ$;Ô$;ð 1ð 1Ñ �˜Øð 1Ø,3×,>Ò,>Ñ,@Ô,@ÀBÀ4Ñ,G�D”N 5Ñ)Ð)à-/¨D�D”N 5Ñ)Ð)à%Ô1ˆDÔØ œ-ˆDŒKØ#Ô-ˆDŒNØÔ*ˆDŒIØ"Ô,ˆDŒMØ!ˆDŒNˆNˆNøÝð 	Vð 	Vð 	VÝ�+¸¼¸¸ÀsÀsÐKÑLÔLÐRUÐUøøøøð	Vøøøs   ‹CC Ã
DÃ"C=Ã=Dc                 ó8   — |                       ¦   «          | j        S )z?Find class and module-level attributes and their documentation.)rg   r   ©rZ   s    r8   Úfind_attr_docszModuleAnalyzer.find_attr_docs¡   s   € à�Š‰ŒˆØŒ~ÐrA   c                 ó8   — |                       ¦   «          | j        S )z?Find class, function and method definitions and their location.)rg   r   ri   s    r8   Ú	find_tagszModuleAnalyzer.find_tags¦   s   € à�Š‰ŒˆØŒyÐrA   )r:   )r   N)Ú__name__Ú
__module__Ú__qualname__r   r   ÚstrÚ__annotations__r	   r   Úintr   r   Ústaticmethodr
   r9   Úclassmethodr@   rK   rH   rW   r[   rg   rj   rl   r>   rA   r8   r   r      s¥  € € € € € € Ø�e˜C ˜H”o sÐ*Ô+Ð+Ð+Ñ+Ø�E˜#˜s˜(”O T¨#¤YÐ.Ô/Ð/Ð/Ñ/Ø�ŒIÐÐÑØ�C˜˜iœÐ(Ô)Ð)Ð)Ñ)Ø�3˜�8ŒnÐÐÑØ
ˆs�E˜#˜s C˜-Ô(Ð(Ô
)Ð)Ð)Ñ)ð )+€Eˆ4��c˜3�h” Ð$Ô%Ð*Ð*Ñ*àð- 3ð -¨5°¸#´ÀÈÄÐ1MÔ+Nð -ð -ð -ñ „\ð-ð^ ð-ð - ð -¨cð -¸Cð -Ø(ð-ð -ð -ñ „[ð-ð ð ð ¨cð Ð6Fð ð ð ñ „[ðð ðK˜sð K¨Sð KÐ5Eð Kð Kð Kñ „[ðKð ð ð Ð)9ð ð ð ñ „[ðð&˜sð ¨Sð ¸3ð À4ð ð ð ð ðVð Vð Vð Vð2  U¨3°¨8¤_°d¸3´iÐ%?Ô @ð ð ð ð ð
˜4  U¨3°°S¨=Ô%9Ð 9Ô:ð ð ð ð ð ð rA   r   )Ú__doc__r-   rE   Úcollectionsr   Ú	importlibr   Úinspectr   Úosr   Útypingr   r   r	   r
   r   Úzipfiler   Úsphinx.errorsr   Úsphinx.pycode.parserr   r   r>   rA   r8   ú<module>r~      s  ðØ 2Ð 2à 	€	€	€	Ø €€€Ø #Ð #Ð #Ð #Ð #Ð #Ø #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ø Ð Ð Ð Ð Ð à %Ð %Ð %Ð %Ð %Ð %Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'ðYð Yð Yð Yð Yñ Yô Yð Yð Yð YrA   