§
    _÷#dQ  ã                   óV  — d 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 ddlmZ ddl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 ddlmZ ddlmZmZ ddlmZmZ ddl m!Z!m"Z" ddl#m$Z$ ddl%m&Z& ddl'm(Z(  ej)        e*¦  «        Z+ G d„ dej,        ej
        ¦  «        Z- G d„ dej.        ej
        ¦  «        Z/ G d„ dee!¦  «        Z0 G d„ de¦  «        Z1 G d„ de!¦  «        Z2 G d„ d¦  «        Z3de&d e-d!dfd"„Z4de&d e-d!dfd#„Z5de(d e-d!dfd$„Z6de(d e-d!dfd%„Z7d&ed!ee8ef         fd'„Z9dS )(zñAllow todos to be inserted into your documentation.

Inclusion of todos can be switched of by a configuration variable.
The todolist directive collects all todos of your project and lists them along
with a backlink to the original location.
é    )ÚAnyÚDictÚListÚTupleÚcast)Únodes)ÚElementÚNode)Ú
directives)ÚBaseAdmonitionN)Úaddnodes)ÚSphinx)ÚDomain)ÚBuildEnvironment)ÚNoUri)Ú_Ú__)ÚloggingÚ	texescape)ÚSphinxDirectiveÚnew_document)Ú
OptionSpec)ÚHTMLTranslator)ÚLaTeXTranslatorc                   ó   — e Zd ZdS )Ú	todo_nodeN©Ú__name__Ú
__module__Ú__qualname__© ó    ú1/usr/lib/python3/dist-packages/sphinx/ext/todo.pyr   r      ó   € € € € € Ø€Dr"   r   c                   ó   — e Zd ZdS )ÚtodolistNr   r!   r"   r#   r&   r&   #   r$   r"   r&   c                   ór   ‡ — e Zd ZU dZeZdZdZdZdZ	e
j        e
j        dœZeed<   dee         fˆ fd„Zˆ xZS )	ÚTodozO
    A todo entry, displayed (if configured) in the form of an admonition.
    Tr   F)ÚclassÚnameÚoption_specÚreturnc                 ó&  •— | j                              d¦  «        sdg| j         d<   t          ¦   «                              ¦   «         \  }t	          |t
          j        ¦  «        r|gS t	          |t          ¦  «        r‘|                     dt          j	        t          d¦  «        ¬¦  «        ¦  «         | j        j        |d<   |                      |¦  «         |                      |¦  «         | j        j                             |¦  «         |gS t$          ‚)Nr)   zadmonition-todor   r(   )ÚtextÚdocname)ÚoptionsÚgetÚsuperÚrunÚ
isinstancer   Úsystem_messager   ÚinsertÚtitler   Úenvr/   Úadd_nameÚset_source_infoÚstateÚdocumentÚnote_explicit_targetÚRuntimeError)ÚselfÚtodoÚ	__class__s     €r#   r3   zTodo.run6   sì   ø€ ØŒ|×Ò Ñ(Ô(ð 	8Ø%6Ð$7ˆDŒL˜Ñ!å‘'”'—+’+‘-”-‰ˆÝ�d�EÔ0Ñ1Ô1ð 
	Ø�6ˆMÝ˜�iÑ(Ô(ð 	Ø�KŠK˜�5œ;­A¨f©I¬IÐ6Ñ6Ô6Ñ7Ô7Ð7Ø"œhÔ.ˆD�‰OØ�MŠM˜$ÑÔÐØ× Ò  Ñ&Ô&Ð&ØŒJÔ×4Ò4°TÑ:Ô:Ð:Ø�6ˆMåÐr"   )r   r   r    Ú__doc__r   Ú
node_classÚhas_contentÚrequired_argumentsÚoptional_argumentsÚfinal_argument_whitespacer   Úclass_optionÚ	unchangedr+   r   Ú__annotations__r   r
   r3   Ú__classcell__)rA   s   @r#   r(   r(   '   s›   ø€ € € € € € ðð ð €JØ€KØÐØÐØ %ÐàÔ(ØÔ$ðð €K�ð ð ñ ð
�T˜$”Zð ð ð ð ð ð ð ð ð ð r"   r(   c                   ó    — e Zd ZdZdZedeeee	         f         fd„¦   «         Z
deddfd„Zdee         deddfd	„Zd
ededej        ddfd„ZdS )Ú
TodoDomainr@   r,   c                 ó8   — | j                              di ¦  «        S ©NÚtodos)ÚdataÚ
setdefault©r?   s    r#   rP   zTodoDomain.todosL   s   € àŒy×#Ò# G¨RÑ0Ô0Ð0r"   r/   Nc                 ó<   — | j                              |d ¦  «         d S ©N)rP   Úpop)r?   r/   s     r#   Ú	clear_doczTodoDomain.clear_docP   s   € ØŒ
�Š�w Ñ%Ô%Ð%Ð%Ð%r"   ÚdocnamesÚ	otherdatac                 ó<   — |D ]}|d         |         | j         |<   Œd S rO   )rP   )r?   rX   rY   r/   s       r#   Úmerge_domaindatazTodoDomain.merge_domaindataS   s4   € Øð 	>ð 	>ˆGØ"+¨GÔ"4°WÔ"=ˆDŒJ�wÑÐð	>ð 	>r"   r8   r<   c                 ór  — | j                              |g ¦  «        }|                     t          ¦  «        D ]€}|j                             d|¦  «         |                     |¦  «         |j        j        rBt           
                    t          d¦  «        |d                              ¦   «         |¬¦  «         Œ�d S )Nútodo-definedzTODO entry found: %sé   )Úlocation)rP   rR   Úfindallr   ÚappÚemitÚappendÚconfigÚtodo_emit_warningsÚloggerÚwarningr   Úastext)r?   r8   r/   r<   rP   r@   s         r#   Úprocess_doczTodoDomain.process_docW   s¯   € à”
×%Ò% g¨rÑ2Ô2ˆØ×$Ò$¥YÑ/Ô/ð 	.ð 	.ˆDØŒG�LŠL˜¨Ñ.Ô.Ð.Ø�LŠL˜ÑÔÐàŒzÔ,ð .Ý—’�rÐ"8Ñ9Ô9¸4À¼7¿>º>Ñ;KÔ;KØ(,ð ñ .ô .ð .øð	.ð 	.r"   )r   r   r    r*   ÚlabelÚpropertyr   Ústrr   r   rP   rW   r[   r   r   r<   ri   r!   r"   r#   rM   rM   H   sÕ   € € € € € Ø€DØ€Eàð1�t˜C  i¤Ð0Ô1ð 1ð 1ð 1ñ „Xð1ð& ð &¨ð &ð &ð &ð &ð>¨¨c¬ð >¸tð >Èð >ð >ð >ð >ð	.Ð/ð 	.¸#ð 	.Ø#œnð	.Ø15ð	.ð 	.ð 	.ð 	.ð 	.ð 	.r"   rM   c                   óJ   — e Zd ZU dZdZdZdZdZi Ze	e
d<   dee         fd„ZdS )ÚTodoListz%
    A list of all todo entries.
    Fr   r+   r,   c                 ó"   — t          d¦  «        gS )NÚ )r&   rS   s    r#   r3   zTodoList.runn   s   € õ ˜‘”ˆ~Ðr"   N)r   r   r    rB   rD   rE   rF   rG   r+   r   rJ   r   r
   r3   r!   r"   r#   rn   rn   c   sh   € € € € € € ðð ð €KØÐØÐØ %ÐØ €K�Ð Ð Ñ ð�T˜$”Zð ð ð ð ð ð r"   rn   c                   ó€   — e Zd Zdedej        deddfd„Zdej        deddfd„Zde	dedej
        fd	„Zde	deddfd
„ZdS )ÚTodoListProcessorra   Údoctreer/   r,   Nc                 ó  — |j         | _         |j        | _        |j        | _        t          t          |j                             d¦  «        ¦  «        | _        t          d¦  «        | _        |  	                    ||¦  «         d S )Nr@   rp   )
Úbuilderrd   r8   r   rM   Ú
get_domainÚdomainr   r<   Úprocess)r?   ra   rs   r/   s       r#   Ú__init__zTodoListProcessor.__init__u   sg   € Ø”{ˆŒØ”jˆŒØ”7ˆŒÝ�: s¤w×'9Ò'9¸&Ñ'AÔ'AÑBÔBˆŒÝ$ RÑ(Ô(ˆŒà�Š�W˜gÑ&Ô&Ð&Ð&Ð&r"   c                 ó”  — t          | j        j                             ¦   «         g ¦  «        }t	          |                     t          ¦  «        ¦  «        D ]ó}| j        j        s|j	         
                    |¦  «         Œ)|                     d¦  «        rt          j        ¦   «         g}ng }|D ]†}|                     ¦   «         }|d                              ¦   «          |                      ||¦  «         |                     |¦  «         |                      ||¦  «        }|                     |¦  «         Œ‡|                     |¦  «         Œôd S )NÚids)Úsumrw   rP   ÚvaluesÚlistr`   r&   rd   Útodo_include_todosÚparentÚremover1   r   ÚtargetÚdeepcopyÚclearÚresolve_referencerc   Úcreate_todo_referenceÚreplace_self)	r?   rs   r/   rP   ÚnodeÚcontentr@   Únew_todoÚtodo_refs	            r#   rx   zTodoListProcessor.process~   s7  € Ý!$ T¤[Ô%6×%=Ò%=Ñ%?Ô%?ÀÑ!DÔ!DˆÝ˜Ÿš­Ñ2Ô2Ñ3Ô3ð 	'ð 	'ˆDØ”;Ô1ð Ø”×"Ò" 4Ñ(Ô(Ð(Øà�xŠx˜‰Œð Ý*/¬,©.¬.Ð)9��à�àð 	)ð 	)�àŸ=š=™?œ?�Ø˜”×%Ò%Ñ'Ô'Ð'à×&Ò& x°Ñ9Ô9Ð9Ø—’˜xÑ(Ô(Ð(à×5Ò5°d¸GÑDÔD�Ø—’˜xÑ(Ô(Ð(Ð(à×Ò˜gÑ&Ô&Ð&Ð&ð+	'ð 	'r"   r@   c                 ó¾  — | j         j        rt          d¦  «        }nt          d¦  «        |j        |j        fz  }|d |                     d¦  «        …         }||                     d¦  «        dz   d …         }t          j        dg¬¦  «        }|t          j        |¦  «        z  }t          j	        t          d¦  «        t          d¦  «        ¦  «        }t          j
        d	d	|d
¬¦  «        }	 | j                             ||d         ¦  «        |d<   |dxx         d|d         d         z   z  cc<   n# t          $ r Y nw xY w||z  }|t          j        |¦  «        z  }|S )Nz<<original entry>>z3(The <<original entry>> is located in %s, line %d.)z<<z>>é   ztodo-source)Úclasseszoriginal entryrp   T)Úinternalr/   Úrefuriú#r{   r   )rd   Útodo_link_onlyr   ÚsourceÚlineÚfindr   Ú	paragraphÚTextÚemphasisÚ	referenceru   Úget_relative_urir   )	r?   r@   r/   ÚdescriptionÚprefixÚsuffixÚparaÚlinktextr™   s	            r#   r†   z'TodoListProcessor.create_todo_reference—   s|  € ØŒ;Ô%ð 	5ÝÐ0Ñ1Ô1ˆKˆKåÐRÑSÔSØ œK¨¬Ð3ñ4ˆKð Ð4˜k×.Ò.¨tÑ4Ô4Ð4Ô5ˆØ˜[×-Ò-¨dÑ3Ô3°aÑ7Ð8Ð8Ô9ˆåŒ¨ Ð7Ñ7Ô7ˆØ•”
˜6Ñ"Ô"Ñ"ˆõ ”>¥!Ð$4Ñ"5Ô"5µqÐ9IÑ7JÔ7JÑKÔKˆÝ”O B¨¨H¸tÐDÑDÔDˆ	ð	Ø"&¤,×"?Ò"?ÀÈÈiÌÑ"YÔ"YˆI�hÑØ�hÐÐÔ 3¨¨e¬°Q¬Ñ#7Ñ7ÐÐÑÐøÝð 	ð 	ð 	àˆDð	øøøð 	�	ÑˆØ•”
˜6Ñ"Ô"Ñ"ˆàˆs   Ã-AD1 Ä1
D>Ä=D>c                 óü   — |                      t          j        ¦  «        D ]}d|v r||d<   Œ| xj        |z  c_        | j                             | j        || j        ¦  «         | j                             |¦  «         dS )z'Resolve references in the todo content.ÚrefdocN)r`   r   Úpending_xrefr<   r8   Úresolve_referencesru   r�   )r?   r@   r/   rˆ   s       r#   r…   z#TodoListProcessor.resolve_reference³   s�   € à—L’L¥Ô!6Ñ7Ô7ð 	)ð 	)ˆDØ˜4ÐÐØ!(��X‘øð 	ˆŒ˜ÑˆŒØŒ×#Ò# D¤M°7¸D¼LÑIÔIÐIØŒ×Ò˜TÑ"Ô"Ð"Ð"Ð"r"   )r   r   r    r   r   r<   rl   ry   rx   r   r–   r†   r…   r!   r"   r#   rr   rr   t   sÅ   € € € € € ð'˜Fð '¨U¬^ð 'Àcð 'Èdð 'ð 'ð 'ð 'ð'˜uœ~ð '¸ð 'Àð 'ð 'ð 'ð 'ð2¨)ð ¸cð ÀeÄoð ð ð ð ð8	# ið 	#¸#ð 	#À$ð 	#ð 	#ð 	#ð 	#ð 	#ð 	#r"   rr   r?   rˆ   r,   c                 ó`   — | j         j        r|                      |¦  «         d S t          j        ‚rU   )rd   r   Úvisit_admonitionr   ÚSkipNode©r?   rˆ   s     r#   Úvisit_todo_noder¨   ¿   s1   € Ø„{Ô%ð Ø×Ò˜dÑ#Ô#Ð#Ð#Ð#åŒnÐr"   c                 ó0   — |                       |¦  «         d S rU   )Údepart_admonitionr§   s     r#   Údepart_todo_noder«   Æ   s   € Ø×Ò˜4Ñ Ô Ð Ð Ð r"   c                 óÊ  — | j         j        rÌ| j                             d¦  «         | j                             |                      |¦  «        ¦  «         t          t          j        |d         ¦  «        }t          j	        | 
                    ¦   «         | j         j        ¦  «        }| j                             d|z  ¦  «         |                     d¦  «         d S t          j        ‚)Nz 
\begin{sphinxadmonition}{note}{r   z%s:})rd   r   Úbodyrc   Úhypertarget_tor   r   r7   r   Úescaperh   Úlatex_enginerV   r¦   )r?   rˆ   Ú
title_noder7   s       r#   Úlatex_visit_todo_noder²   Ê   s·   € Ø„{Ô%ð 	ØŒ	×ÒÐ=Ñ>Ô>Ð>ØŒ	×Ò˜×,Ò,¨TÑ2Ô2Ñ3Ô3Ð3å�%œ+ t¨A¤wÑ/Ô/ˆ
ÝÔ  ×!2Ò!2Ñ!4Ô!4°d´kÔ6NÑOÔOˆØŒ	×Ò˜ %™Ñ(Ô(Ð(Ø�Š�‰ŒˆˆˆåŒnÐr"   c                 ó:   — | j                              d¦  «         d S )Nz\end{sphinxadmonition}
)r­   rc   r§   s     r#   Úlatex_depart_todo_noder´   ×   s   € Ø„I×ÒÐ0Ñ1Ô1Ð1Ð1Ð1r"   ra   c           	      ó˜  — |                       d¦  «         |                      ddd¦  «         |                      ddd¦  «         |                      ddd¦  «         |                      t          ¦  «         |                      t          t
          t          ft          t          ft
          t          ft
          t          ft
          t          f¬¦  «         |  	                    dt          ¦  «         |  	                    d	t          ¦  «         |                      t          ¦  «         |                      d
t          ¦  «         t           j        dddœS )Nr]   r   FÚhtmlr’   re   )r¶   Úlatexr.   ÚmanÚtexinfor@   r&   zdoctree-resolvedr�   T)ÚversionÚenv_versionÚparallel_read_safe)Ú	add_eventÚadd_config_valueÚadd_noder&   r   r¨   r«   r²   r´   Úadd_directiver(   rn   Ú
add_domainrM   Úconnectrr   ÚsphinxÚ__display_version__)ra   s    r#   ÚsetuprÅ   Û   s,  € Ø‡M‚M�.Ñ!Ô!Ð!Ø×ÒÐ-¨u°fÑ=Ô=Ð=Ø×ÒÐ)¨5°&Ñ9Ô9Ð9Ø×ÒÐ-¨u°fÑ=Ô=Ð=à‡L‚L•ÑÔÐØ‡L‚L•Ý&Õ(8Ð9Ý-Õ/EÐFÝ&Õ(8Ð9Ý%Õ'7Ð8Ý)Õ+;Ð<ð ñ >ô >ð >ð ×Ò�f�dÑ#Ô#Ð#Ø×Ò�j¥(Ñ+Ô+Ð+Ø‡N‚N•:ÑÔÐØ‡K‚KÐ"Õ$5Ñ6Ô6Ð6åÔ-ØØ"ðð ð r"   ):rB   Útypingr   r   r   r   r   Údocutilsr   Údocutils.nodesr	   r
   Údocutils.parsers.rstr   Ú+docutils.parsers.rst.directives.admonitionsr   rÃ   r   Úsphinx.applicationr   Úsphinx.domainsr   Úsphinx.environmentr   Úsphinx.errorsr   Úsphinx.localer   r   Úsphinx.utilr   r   Úsphinx.util.docutilsr   r   Úsphinx.util.typingr   Úsphinx.writers.htmlr   Úsphinx.writers.latexr   Ú	getLoggerr   rf   Ú
Admonitionr   ÚGeneralr&   r(   rM   rn   rr   r¨   r«   r²   r´   rl   rÅ   r!   r"   r#   ú<module>rØ      sg  ððð ð 0Ð /Ð /Ð /Ð /Ð /Ð /Ð /Ð /Ð /Ð /Ð /Ð /Ð /à Ð Ð Ð Ð Ð Ø (Ð (Ð (Ð (Ð (Ð (Ð (Ð (Ø +Ð +Ð +Ð +Ð +Ð +Ø FÐ FÐ FÐ FÐ FÐ Fà €€€Ø Ð Ð Ð Ð Ð Ø %Ð %Ð %Ð %Ð %Ð %Ø !Ð !Ð !Ð !Ð !Ð !Ø /Ð /Ð /Ð /Ð /Ð /Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ð Ð Ø *Ð *Ð *Ð *Ð *Ð *Ð *Ð *Ø >Ð >Ð >Ð >Ð >Ð >Ð >Ð >Ø )Ð )Ð )Ð )Ð )Ð )Ø .Ð .Ð .Ð .Ð .Ð .Ø 0Ð 0Ð 0Ð 0Ð 0Ð 0à	ˆÔ	˜8Ñ	$Ô	$€ð	ð 	ð 	ð 	ð 	�Ô  %¤-ñ 	ô 	ð 	ð	ð 	ð 	ð 	ð 	ˆuŒ}˜eœmñ 	ô 	ð 	ðð ð ð ð ˆ>˜?ñ ô ð ðB.ð .ð .ð .ð .�ñ .ô .ð .ð6ð ð ð ð ˆñ ô ð ð"H#ð H#ð H#ð H#ð H#ñ H#ô H#ð H#ðV˜.ð °	ð ¸dð ð ð ð ð!˜>ð !°ð !¸tð !ð !ð !ð !ð
 ð 
°yð 
ÀTð 
ð 
ð 
ð 
ð2 ð 2¸	ð 2Àdð 2ð 2ð 2ð 2ðˆvð ˜$˜s C˜xœ.ð ð ð ð ð ð r"   