§
    _÷#dé  ã                   óV  — d Z ddlZddlZddlmZmZmZm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mZ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# ddl$m%Z%m&Z&m'Z'm(Z( ddl)m*Z*m+Z+m,Z, ddl-m.Z. ddl/m0Z0m1Z1m2Z2 ddl3m4Z4 ddl5m6Z6 erddl7m8Z8  e2j9        e:¦  «        Z; G d„ dej<        ¦  «        Z= G d„ de=¦  «        Z> G d„ de=¦  «        Z? G d„ de¦  «        Z@ded ed!ed"efd#„ZA G d$„ d%e¦  «        ZBd&d'd(e#d)eCd"e	jD        fd*„ZEd&d'd+eCd"efd,„ZFdS )-zInput/Output filesé    N)ÚTYPE_CHECKINGÚAnyÚListÚType)Únodes)Ú	Publisher)ÚValues)Ú	FileInputÚInputÚ
NullOutput©ÚParser)Ú
standalone)Ú	Transform)ÚDanglingReferences)ÚUnfilteredWriter)Úaddnodes)ÚRemovedInSphinx70Warning)ÚBuildEnvironment)ÚAutoIndexUpgraderÚDoctreeReadEventÚFigureAlignerÚSphinxTransformer)ÚLocaleÚPreserveTranslatableMessagesÚRemoveTranslatableInline)ÚSphinxDomains)ÚUnicodeDecodeErrorHandlerÚget_filetypeÚlogging)ÚLoggingReporter)ÚUIDTransform©ÚSphinxc                   ó¢   ‡ — e Zd ZU dZg Zeee                  ed<   de	de	ddfˆ fd„Z
dd
„Zdeee                  fˆ fd„Zdej        fˆ fd„Zˆ xZS )ÚSphinxBaseReaderzm
    A base class of readers for Sphinx.

    This replaces reporter by Sphinx's on generating document.
    Ú
transformsÚargsÚkwargsÚreturnNc                 óè   •— ddl m} t          |¦  «        dk    r>t          |d         |¦  «        r(|d         | _        | j        j        | _        |dd …         } t          ¦   «         j        |i |¤Ž d S )Nr   r#   é   )	Úsphinx.applicationr$   ÚlenÚ
isinstanceÚ_appÚenvÚ_envÚsuperÚ__init__)Úselfr(   r)   r$   Ú	__class__s       €ú+/usr/lib/python3/dist-packages/sphinx/io.pyr4   zSphinxBaseReader.__init__.   s{   ø€ Ø-Ð-Ð-Ð-Ð-Ð-Ýˆt‰9Œ9�qŠ=ˆ=�Z¨¨Q¬°Ñ8Ô8ˆ=Ø˜QœˆDŒIØœ	œˆDŒIØ˜˜˜”8ˆDà�‰ŒÔ˜$Ð) &Ð)Ð)Ð)Ð)Ð)ó    Úappr$   c                 ó,   — || _         |j        | _        d S ©N)r0   r1   r2   )r5   r9   s     r7   ÚsetupzSphinxBaseReader.setup7   s   € ØˆŒ	Ø”GˆŒ	ˆ	ˆ	r8   c                 ó¤   •— t          ¦   «                              ¦   «         | j        z   }t          g}|D ]}||v r|                     |¦  «         Œ|S r;   )r3   Úget_transformsr'   r   Úremove)r5   r'   ÚunusedÚ	transformr6   s       €r7   r>   zSphinxBaseReader.get_transforms;   s^   ø€ Ý‘W”W×+Ò+Ñ-Ô-°´Ñ?ˆ
õ %Ð%ˆØð 	-ð 	-ˆIØ˜JÐ&Ð&Ø×!Ò! )Ñ,Ô,Ð,øàÐr8   c                 ó  •— t          ¦   «                              ¦   «         }t          j        |_        t          |¦  «        |_        |j                             | j        j	        ¦  «         |j
        }t          j        |¦  «        |_
        |S )zm
        Creates a new document object which has a special reporter object good
        for logging.
        )r3   Únew_documentr   Údocumentr6   r   ÚtransformerÚset_environmentÚsettingsr1   Úreporterr!   Úfrom_reporter)r5   rD   rH   r6   s      €r7   rC   zSphinxBaseReader.new_documentF   su   ø€ õ
 ‘7”7×'Ò'Ñ)Ô)ˆÝ%Ô.ˆÔõ  1°Ñ:Ô:ˆÔØÔ×,Ò,¨T¬]Ô->Ñ?Ô?Ð?ð Ô$ˆÝ+Ô9¸(ÑCÔCˆÔàˆr8   ©r9   r$   r*   N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r'   r   r   r   Ú__annotations__r   r4   r<   r>   r   rD   rC   Ú__classcell__©r6   s   @r7   r&   r&   %   sâ   ø€ € € € € € ðð ð )+€J��T˜)”_Ô%Ð*Ð*Ñ*ð*˜cð *¨Sð *°Tð *ð *ð *ð *ð *ð *ðð ð ð ð	  T¨)¤_Ô 5ð 	ð 	ð 	ð 	ð 	ð 	ð˜eœnð ð ð ð ð ð ð ð ð ð r8   r&   c                   óV   ‡ — e Zd ZdZdˆ fd„Zdeded	edej	        fd
„Z
dedefd„Zˆ xZS )ÚSphinxStandaloneReaderz-
    A basic document reader for Sphinx.
    r9   r$   r*   Nc                 ó–   •— | j         |j                             ¦   «         z   | _         t          ¦   «                              |¦  «         d S r;   )r'   Úregistryr>   r3   r<   )r5   r9   r6   s     €r7   r<   zSphinxStandaloneReader.setup^   s;   ø€ Øœ/¨C¬L×,GÒ,GÑ,IÔ,IÑIˆŒÝ‰Œ�Š�cÑÔÐÐÐr8   ÚsourceÚparserrG   c                 ó®   — || _         | j        s|| _        || _        |                      |j        ¦  «        | _        |                      ¦   «          | j        S r;   )rV   rW   rG   Úread_sourcer1   ÚinputÚparserD   )r5   rV   rW   rG   s       r7   ÚreadzSphinxStandaloneReader.readb   sM   € ØˆŒØŒ{ð 	!Ø ˆDŒKØ ˆŒØ×%Ò% h¤lÑ3Ô3ˆŒ
Ø�
Š
‰ŒˆØŒ}Ðr8   r1   c                 óŒ   — | j                              ¦   «         }|g}|j                             d|j        |¦  «         |d         S )z-Read content from source and do post-process.zsource-readr   )rV   r\   ÚeventsÚemitÚdocname)r5   r1   ÚcontentÚargs       r7   rY   z"SphinxStandaloneReader.read_sourcek   sA   € à”+×"Ò"Ñ$Ô$ˆð ˆiˆØŒ
�Š˜ s¤{°CÑ8Ô8Ð8Ø�1Œvˆr8   rJ   )rK   rL   rM   rN   r<   r   r   r	   r   rD   r\   r   ÚstrrY   rP   rQ   s   @r7   rS   rS   Y   sœ   ø€ € € € € ðð ðð ð ð ð ð ð˜5ð ¨&ð ¸Fð ÀuÄ~ð ð ð ð ðÐ/ð °Cð ð ð ð ð ð ð ð r8   rS   c                   ó$   ‡ — e Zd ZdZdˆ fd„Zˆ xZS )ÚSphinxI18nReadera  
    A document reader for i18n.

    This returns the source line number of original text as current source line number
    to let users know where the error happened.
    Because the translated texts are partial and they don't have correct line numbers.
    r9   r$   r*   Nc                 óJ  •— t          ¦   «                              |¦  «         | j        |j                             ¦   «         z   | _        t
          t          t          t          t          t          t          t          g}|D ]%}|| j        v r| j                             |¦  «         Œ&d S r;   )r3   r<   r'   rU   r>   r   r   r   r   r   r   r   r"   r?   )r5   r9   r@   rA   r6   s       €r7   r<   zSphinxI18nReader.setup~   s�   ø€ Ý‰Œ�Š�cÑÔÐàœ/¨C¬L×,GÒ,GÑ,IÔ,IÑIˆŒÝ.µÕ8PÝ#¥]µMÕCSÝð ˆð  ð 	2ð 	2ˆIØ˜DœOÐ+Ð+Ø”×&Ò& yÑ1Ô1Ð1øð	2ð 	2r8   rJ   )rK   rL   rM   rN   r<   rP   rQ   s   @r7   re   re   u   sG   ø€ € € € € ðð ð	2ð 	2ð 	2ð 	2ð 	2ð 	2ð 	2ð 	2ð 	2ð 	2r8   re   c                   ó   — e Zd ZdZdZdd„ZdS )ÚSphinxDummyWriterz0Dummy writer module used for generating doctree.)Úhtmlr*   Nc                 ó   — d S r;   © )r5   s    r7   Ú	translatezSphinxDummyWriter.translate�   s   € Øˆr8   )r*   N)rK   rL   rM   rN   Ú	supportedrl   rk   r8   r7   rh   rh   Š   s3   € € € € € Ø:Ð:à€Iðð ð ð ð ð r8   rh   rV   r(   r)   r*   c                 ó   — | S )z.Bypass source object as is to cheat Publisher.rk   )rV   r(   r)   s      r7   ÚSphinxDummySourceClassro   “   s   € à€Mr8   c                   ó0   ‡ — e Zd ZdZdededdfˆ fd„Zˆ xZS )ÚSphinxFileInputzA basic FileInput for Sphinx.r(   r)   r*   Nc                 óD   •— d|d<    t          ¦   «         j        |i |¤Ž d S )NÚsphinxÚerror_handler)r3   r4   )r5   r(   r)   r6   s      €r7   r4   zSphinxFileInput.__init__š   s/   ø€ Ø"*ˆˆÑØ�‰ŒÔ˜$Ð) &Ð)Ð)Ð)Ð)Ð)r8   )rK   rL   rM   rN   r   r4   rP   rQ   s   @r7   rq   rq   ˜   sX   ø€ € € € € Ø'Ð'ð*˜cð *¨Sð *°Tð *ð *ð *ð *ð *ð *ð *ð *ð *ð *r8   rq   r9   r$   r1   Úfilenamec                 ó�  — t          j        dt          d¬¦  «         t          |j        ¦  «        }t          j        d|¦  «         t          ¦   «         }|                     | ¦  «         t          | j
        j        |¦  «        }| j                             | |¦  «        }|j        j        dk    r|j        dk    rt"          j        |_        t%          ||t'          ¦   «         t(          t+          ¦   «         ¬¦  «        }|                     d|j        d¦  «         |                     |¬	¦  «         |                     ¦   «          |j        S )
z(Parse a document and convert to doctree.z#sphinx.io.read_doc() is deprecated.é   )Ú
stacklevelrs   ÚCommonMarkParserrk   ©ÚreaderrW   ÚwriterÚsource_classÚdestinationN)Úsource_path)ÚwarningsÚwarnr   r   r`   ÚcodecsÚregister_errorrS   r<   r   ÚconfigÚsource_suffixrU   Úcreate_source_parserr6   rK   Úsettings_specÚ	RSTParserr   rh   rq   r   Úprocess_programmatic_settingsrG   Ú
set_sourceÚpublishrD   )r9   r1   ru   rt   r{   ÚfiletyperW   Úpubs           r7   Úread_docrŽ   Ÿ   s-  € å„MÐ7Ý*°qð:ñ :ô :ð :õ .¨c¬kÑ:Ô:€MÝ
Ô˜( MÑ2Ô2Ð2å#Ñ%Ô%€FØ
‡L‚L�ÑÔÐÝ˜CœJÔ4°hÑ?Ô?€HØŒ\×.Ò.¨s°HÑ=Ô=€FØÔÔ Ð$6Ò6Ð6¸6Ô;OÐSUÒ;UÐ;Uõ  )Ô6ˆÔå
˜6Ø!Ý,Ñ.Ô.Ý!0Ý *¡¤ð	.ñ .ô .€Cð
 ×%Ò% d¨C¬L¸$Ñ?Ô?Ð?Ø‡N‚N˜x€NÑ(Ô(Ð(Ø‡K‚K�M„M€MØŒ<Ðr8   rŒ   c                 óò  — t          ¦   «         }|                     | ¦  «         | j                             | |¦  «        }|j        j        dk    r|j        dk    rddlm} |j        |_        t          ||t          ¦   «         t          t          ¦   «         ¬¦  «        }ddi| j        j        ¥}t          j        d d…         d	k    r |j        di |¤Ž n$ |j        di |¤Ž                     ¦   «         |_        |S )
Nry   rk   r   r   rz   Ú	tracebackTrw   )r   é   )rS   r<   rU   r†   r6   rK   r‡   Údocutils.parsers.rstr   r   rh   rq   r   r1   rG   ÚdocutilsÚ__version_info__Úget_settingsÚsetup_option_parserÚget_default_values)r9   rŒ   r{   rW   rˆ   r�   Údefaultss          r7   Úcreate_publisherr™   ¿   s  € Ý#Ñ%Ô%€FØ
‡L‚L�ÑÔÐàŒ\×.Ò.¨s°HÑ=Ô=€FØÔÔ Ð$6Ò6Ð6¸6Ô;OÐSUÒ;UÐ;Uð 	=Ð<Ð<Ð<Ð<Ð<à(Ô6ˆÔå
ØØÝ Ñ"Ô"Ý$Ý‘L”Lðñ ô €Cð ˜TÐ6 S¤WÔ%5Ð6€HåÔ   ! Ô$¨Ò/Ð/ØˆÔÐ$Ð$˜8Ð$Ð$Ð$Ð$à.�sÔ.Ð:Ð:°Ð:Ð:×MÒMÑOÔOˆŒØ€Jr8   )GrN   r‚   r€   Útypingr   r   r   r   r“   r   Údocutils.corer   Údocutils.frontendr	   Údocutils.ior
   r   r   Údocutils.parsersr   r’   rˆ   Údocutils.readersr   Údocutils.transformsr   Údocutils.transforms.referencesr   Údocutils.writersr   rs   r   Úsphinx.deprecationr   Úsphinx.environmentr   Úsphinx.transformsr   r   r   r   Úsphinx.transforms.i18nr   r   r   Úsphinx.transforms.referencesr   Úsphinx.utilr   r   r    Úsphinx.util.docutilsr!   Úsphinx.versioningr"   r-   r$   Ú	getLoggerrK   ÚloggerÚReaderr&   rS   re   rh   ro   rq   rc   rD   rŽ   r™   rk   r8   r7   ú<module>r®      s   ðØ Ð Ø €€€Ø €€€Ø 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1Ð 1à €€€Ø Ð Ð Ð Ð Ð Ø #Ð #Ð #Ð #Ð #Ð #Ø $Ð $Ð $Ð $Ð $Ð $Ø 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ð 4Ø #Ð #Ð #Ð #Ð #Ð #Ø 4Ð 4Ð 4Ð 4Ð 4Ð 4Ø 'Ð 'Ð 'Ð 'Ð 'Ð 'Ø )Ð )Ð )Ð )Ð )Ð )Ø =Ð =Ð =Ð =Ð =Ð =Ø -Ð -Ð -Ð -Ð -Ð -à Ð Ð Ð Ð Ð Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø /Ð /Ð /Ð /Ð /Ð /ð2ð 2ð 2ð 2ð 2ð 2ð 2ð 2ð 2ð 2ð 2ð 2ð>ð >ð >ð >ð >ð >ð >ð >ð >ð >à 6Ð 6Ð 6Ð 6Ð 6Ð 6Ø HÐ HÐ HÐ HÐ HÐ HÐ HÐ HÐ HÐ HØ 0Ð 0Ð 0Ð 0Ð 0Ð 0Ø *Ð *Ð *Ð *Ð *Ð *àð *Ø)Ð)Ð)Ð)Ð)Ð)ð 
ˆÔ	˜8Ñ	$Ô	$€ð1ð 1ð 1ð 1ð 1�zÔ(ñ 1ô 1ð 1ðhð ð ð ð Ð-ñ ô ð ð82ð 2ð 2ð 2ð 2Ð'ñ 2ô 2ð 2ð*ð ð ð ð Ð(ñ ô ð ð 3ð ¨sð ¸cð Àcð ð ð ð ð
*ð *ð *ð *ð *�iñ *ô *ð *ð�(ð Ð!1ð ¸Sð ÀUÄ^ð ð ð ð ð@˜(ð ¨cð °ið ð ð ð ð ð r8   