§
    N=&bž0  ã                   ó&  — d Z dZddlZddlZddlmZmZ ddlmZ ddl	m
Z
  G d„ de¦  «        Z G d	„ d
e¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        Z G d„ de¦  «        ZdS )a’  
Transforms needed by most or all documents:

- `Decorations`: Generate a document's header & footer.
- `ExposeInternals`: Expose internal attributes.
- `Messages`: Placement of system messages generated after parsing.
- `FilterMessages`: Remove system messages below verbosity threshold.
- `TestMessages`: Like `Messages`, used on test runs.
- `StripComments`: Remove comment elements from the document tree.
- `StripClassesAndElements`: Remove elements with classes
  in `self.document.settings.strip_elements_with_classes`
  and class values in `self.document.settings.strip_classes`.
- `SmartQuotes`: Replace ASCII quotation marks with typographic form.
ÚreStructuredTexté    N)ÚnodesÚutils)Ú	Transform)Úsmartquotesc                   ó(   — e Zd ZdZdZd„ Zd„ Zd„ ZdS )ÚDecorationszD
    Populate a document's decoration element (header, footer).
    i4  c                 ój  — |                       ¦   «         }|rB| j                             ¦   «         }|                     ¦   «         }|                     |¦  «         |                      ¦   «         }|rD| j                             ¦   «         }|                     ¦   «         }|                     |¦  «         d S d S ©N)Úgenerate_headerÚdocumentÚget_decorationÚ
get_headerÚextendÚgenerate_footerÚ
get_footer)ÚselfÚheader_nodesÚ
decorationÚheaderÚfooter_nodesÚfooters         ú?/usr/lib/python3/dist-packages/docutils/transforms/universal.pyÚapplyzDecorations.apply&   s°   € Ø×+Ò+Ñ-Ô-ˆØð 	(Øœ×5Ò5Ñ7Ô7ˆJØ×*Ò*Ñ,Ô,ˆFØ�MŠM˜,Ñ'Ô'Ð'Ø×+Ò+Ñ-Ô-ˆØð 	(Øœ×5Ò5Ñ7Ô7ˆJØ×*Ò*Ñ,Ô,ˆFØ�MŠM˜,Ñ'Ô'Ð'Ð'Ð'ð	(ð 	(ó    c                 ó   — d S r   © )r   s    r   r   zDecorations.generate_header2   s   € Øˆtr   c           
      óF  — | j         j        }|j        s|j        s|j        s|j        �rwg }|j        r|j        s|j        rl|j        r|j        }nt          j        |j	        |j        ¦  «        }| 
                    t          j        dd|¬¦  «        t          j        d¦  «        g¦  «         |j        rXt          j        |j        t          j        ¦   «         ¦  «        }|                     t          j        d|z   dz   ¦  «        ¦  «         |j        rz| 
                    t          j        d¦  «        t          j        ddd¬¦  «        t          j        d	¦  «        t          j        dd
d¬¦  «        t          j        d¦  «        g¦  «         t          j        ddg|¢R Ž gS d S )NÚ zView document source)Úrefuriz.
zGenerated on: zGenerated by ÚDocutilsz https://docutils.sourceforge.io/z from r   z(https://docutils.sourceforge.io/rst.htmlz	 source.
)r   ÚsettingsÚ	generatorÚ	datestampÚsource_linkÚ
source_urlÚ_sourcer   Úrelative_pathÚ_destinationr   r   Ú	referenceÚTextÚtimeÚstrftimeÚgmtimeÚappendÚ	paragraph)r   r"   ÚtextÚsourcer$   s        r   r   zDecorations.generate_footer5   sÕ  € ð ”=Ô)ˆØÔð 	 (Ô"4ð 	ØÔ#ð	Ø'/Ô':ñ	àˆDØÔ$ð 
(¨Ô)9ð 
(ØÔ&ð
(àÔ&ð CØ%Ô0�F�Få"Ô0°Ô1FØ19Ô1AñCô C�Fà—’Ý”O BÐ(>Ø+1ð3ñ 3ô 3å”J˜uÑ%Ô%ð'ñ (ô (ð (ð Ô!ð NÝ œM¨(Ô*<½d¼k¹m¼mÑLÔL�	Ø—’�EœJÐ'7¸)Ñ'CÀeÑ'KÑLÔLÑMÔMÐMØÔ!ð 	/Ø—’Ý”J˜Ñ/Ô/Ý”O B¨
Ø+MðOñ Oô Oå”J˜xÑ(Ô(Ý”O BÐ(:ð,/ð0ñ 0ô 0õ ”J˜|Ñ,Ô,ð.ñ /ô /ð /õ ”O B¨Ð2¨TÐ2Ð2Ð2Ð3Ð3à�4r   N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Údefault_priorityr   r   r   r   r   r   r	   r	      sS   € € € € € ðð ð Ðð
(ð 
(ð 
(ðð ð ð%ð %ð %ð %ð %r   r	   c                   ó"   — e Zd ZdZdZd„ Zd„ ZdS )ÚExposeInternalszL
    Expose internal attributes if ``expose_internals`` setting is set.
    iH  c                 ó8   — t          |t          j        ¦  «         S r   )Ú
isinstancer   r+   ©r   Únodes     r   Únot_TextzExposeInternals.not_Texte   s   € Ý˜d¥E¤JÑ/Ô/Ð/Ð/r   c                 óÎ   — | j         j        j        rQ| j                              | j        ¦  «        D ]3}| j         j        j        D ]}t          ||d ¦  «        }|�||d|z   <   ŒŒ2d S d S )Nz	internal:)r   r"   Úexpose_internalsÚfindallr>   Úgetattr)r   r=   ÚattÚvalues       r   r   zExposeInternals.applyh   sŠ   € ØŒ=Ô!Ô2ð 	8Øœ×-Ò-¨d¬mÑ<Ô<ð 8ð 8�Øœ=Ô1ÔBð 8ð 8�CÝ# D¨#¨tÑ4Ô4�EØÐ(Ø27˜˜[¨3Ñ.Ñ/øð8ð	8ð 	8ð8ð 8r   N)r3   r4   r5   r6   r7   r>   r   r   r   r   r9   r9   ]   sD   € € € € € ðð ð Ðð0ð 0ð 0ð8ð 8ð 8ð 8ð 8r   r9   c                   ó   — e Zd ZdZdZd„ ZdS )ÚMessageszi
    Place any system messages generated after parsing into a dedicated section
    of the document.
    i\  c                 óæ   — | j         j        }d„ |D ¦   «         }|rVt          j        dg¬¦  «        }|t          j        dd¦  «        z  }||z  }g | j         j        d d …<   | xj         |z  c_         d S d S )Nc                 ó    — g | ]}|j         °	|‘ŒS r   )Úparent)Ú.0Úmsgs     r   ú
<listcomp>z"Messages.apply.<locals>.<listcomp>|   s   € Ð@Ð@Ð@˜C°S´ZÐ@�CÐ@Ð@Ð@r   úsystem-messages)Úclassesr   zDocutils System Messages)r   Útransform_messagesr   ÚsectionÚtitle)r   Ú
unfilteredÚmessagesrP   s       r   r   zMessages.applyz   s�   € Ø”]Ô5ˆ
Ø@Ð@ :Ð@Ñ@Ô@ˆØð 	%Ý”mÐ->Ð,?Ð@Ñ@Ô@ˆGà•u”{ 2Ð'AÑBÔBÑBˆGØ�xÑˆGØ24ˆDŒMÔ,¨Q¨Q¨QÑ/ØˆMŒM˜WÑ$ˆMŒMˆMˆMð	%ð 	%r   N©r3   r4   r5   r6   r7   r   r   r   r   rF   rF   q   s5   € € € € € ðð ð
 Ðð	%ð 	%ð 	%ð 	%ð 	%r   rF   c                   ó   — e Zd ZdZdZd„ ZdS )ÚFilterMessagesz³
    Remove system messages below verbosity threshold.

    Convert <problematic> nodes referencing removed messages to <Text>.
    Remove "System Messages" section if empty.
    if  c                 óø  — t          | j                             t          j        ¦  «        ¦  «        D ]b}|d         | j        j        j        k     rE|j                             |¦  «         	 | j        j	        |d         d         = ŒR# t          $ r Y Œ^w xY wŒct          | j                             t          j        ¦  «        ¦  «        D ]U}|d         | j        j	        vr?|j                             |t          j        |                     ¦   «         ¦  «        ¦  «         ŒV| j                             t          j        ¦  «        D ]9}d|d         v r-t!          |¦  «        dk    r|j                             |¦  «         Œ:d S )NÚlevelÚidsr   ÚrefidrM   rN   é   )Útupler   rA   r   Úsystem_messageÚreporterÚreport_levelrI   ÚremoverY   Ú
IndexErrorÚproblematicÚreplacer+   ÚastextrP   Úlenr<   s     r   r   zFilterMessages.apply—   sh  € Ý˜$œ-×/Ò/µÔ0DÑEÔEÑFÔFð 	ð 	ˆDØ�GŒ}˜tœ}Ô5ÔBÒBÐBØ”×"Ò" 4Ñ(Ô(Ð(ðØœÔ)¨$¨u¬+°a¬.Ð9Ð9øÝ"ð ð ð Ø�Dðøøøð	 Cõ ˜$œ-×/Ò/µÔ0AÑBÔBÑCÔCð 	Eð 	EˆDØ�GŒ} D¤MÔ$5Ð5Ð5Ø”×#Ò# D­%¬*°T·[²[±]´]Ñ*CÔ*CÑDÔDÐDøØ”M×)Ò)­%¬-Ñ8Ô8ð 	)ð 	)ˆDØ  D¨¤OÐ3Ð3½¸D¹	¼	ÀQº¸Ø”×"Ò" 4Ñ(Ô(Ð(øð	)ð 	)s   Á*BÂ
BÂBNrT   r   r   r   rV   rV   Œ   s5   € € € € € ðð ð Ðð)ð )ð )ð )ð )r   rV   c                   ó   — e Zd ZdZdZd„ ZdS )ÚTestMessageszk
    Append all post-parse system messages to the end of the document.

    Used for testing purposes.
    ip  c                 óR   — | j         j        D ]}|j        s| xj         |z  c_         Œd S r   )r   rO   rI   )r   rK   s     r   r   zTestMessages.apply±   s;   € Ø”=Ô3ð 	%ð 	%ˆCØ”:ð %Ø�” Ñ$�”øð	%ð 	%r   NrT   r   r   r   rg   rg   §   s5   € € € € € ðð ð Ðð%ð %ð %ð %ð %r   rg   c                   ó   — e Zd ZdZdZd„ ZdS )ÚStripCommentszq
    Remove comment elements from the document tree (only if the
    ``strip_comments`` setting is enabled).
    iä  c                 óÈ   — | j         j        j        rNt          | j                              t
          j        ¦  «        ¦  «        D ]}|j                             |¦  «         Œd S d S r   )	r   r"   Ústrip_commentsr\   rA   r   ÚcommentrI   r`   r<   s     r   r   zStripComments.applyÀ   sh   € ØŒ=Ô!Ô0ð 	)Ý˜dœm×3Ò3µE´MÑBÔBÑCÔCð )ð )�Ø”×"Ò" 4Ñ(Ô(Ð(Ð(ð	)ð 	)ð)ð )r   NrT   r   r   r   rj   rj   ·   s5   € € € € € ðð ð
 Ðð)ð )ð )ð )ð )r   rj   c                   ó"   — e Zd ZdZdZd„ Zd„ ZdS )ÚStripClassesAndElementszÏ
    Remove from the document tree all elements with classes in
    `self.document.settings.strip_elements_with_classes` and all "classes"
    attribute values in `self.document.settings.strip_classes`.
    i¤  c                 óâ  — | j         j        j        rah | j         j        j        £| _        t	          | j                              | j        ¦  «        ¦  «        D ]}|j                             |¦  «         Œ| j         j        j	        sd S | j         j        j	        }| j                              t          j        ¦  «        D ]3}|D ].}	 |d                              |¦  «         Œ# t          $ r Y Œ+w xY wŒ4d S )NrN   )r   r"   Ústrip_elements_with_classesÚstrip_elementsr\   rA   Úcheck_classesrI   r`   Ústrip_classesr   ÚElementÚ
ValueError)r   r=   rt   Úclass_values       r   r   zStripClassesAndElements.applyÐ   s  € ØŒ=Ô!Ô=ð 	)ð#A D¤MÔ$:Ü$?ð#AˆDÔõ ˜dœm×3Ò3°DÔ4FÑGÔGÑHÔHð )ð )�Ø”×"Ò" 4Ñ(Ô(Ð(Ð(àŒ}Ô%Ô3ð 	ØˆFØœÔ.Ô<ˆØ”M×)Ò)­%¬-Ñ8Ô8ð 	ð 	ˆDØ,ð ð �ðØ˜”O×*Ò*¨;Ñ7Ô7Ð7Ð7øÝ!ð ð ð Ø�Dðøøøðð	ð 	s   ÃCÃ
C+Ã*C+c                 ó|   — t          |t          j        ¦  «        sdS |d         d d …         D ]}|| j        v r dS ŒdS )NFrN   T)r;   r   ru   rr   )r   r=   rw   s      r   rs   z%StripClassesAndElements.check_classesã   sV   € Ý˜$¥¤Ñ.Ô.ð 	Ø�5Ø 	œ?¨1¨1¨1Ô-ð 	ð 	ˆKØ˜dÔ1Ð1Ð1Ø�t�tð 2àˆur   N)r3   r4   r5   r6   r7   r   rs   r   r   r   ro   ro   Æ   sD   € € € € € ðð ð Ððð ð ð&ð ð ð ð r   ro   c                   ó¦   — e Zd ZdZdZej        ej        fZ	 ej        ej        ej	        ej
        ej        ej        ej        fZ	 dZ	 d„ Zd„ Zd„ ZdS )ÚSmartQuotesz�
    Replace ASCII quotation marks with typographic form.

    Also replace multiple dashes with em-dash/en-dash characters.
    iW  ÚqDec                 óZ   — t          j        | ||¬¦  «         t          ¦   «         | _        d S )N)Ú	startnode)r   Ú__init__ÚsetÚunsupported_languages)r   r   r}   s      r   r~   zSmartQuotes.__init__  s,   € ÝÔ˜4 °YÐ?Ñ?Ô?Ð?Ý%(¡U¤UˆÔ"Ð"Ð"r   c              #   ó   K  — |D ]x}t          |j        | j        ¦  «        st          |j        j        | j        ¦  «        rdt          |¦  «        fV — ŒOt	          j        ddt          |¦  «        ¦  «        }d|fV — Œyd S )NÚliteralz(?<= )([-\'".`])z\\\1Úplain)r;   rI   Úliteral_nodesÚstrÚreÚsub)r   Útxtnodesr=   Útxts       r   Ú
get_tokenszSmartQuotes.get_tokens	  s›   è è € ð ð 	#ð 	#ˆDÝ˜4œ;¨Ô(:Ñ;Ô;ð #Ý˜dœkÔ0°$Ô2DÑEÔEð#à¥ T¡¤Ð*Ð*Ð*Ð*Ð*õ ”fÐ4°g½sÀ4¹y¼yÑIÔI�Ø˜s�lÐ"Ð"Ð"Ð"ð	#ð 	#r   c                 óÌ  — | j         j                             dd¦  «        }|sd S 	 |                     d¦  «        }n# t          $ r d}Y nw xY w| j         j        j        }| j         j        j        }|r1t          j        j	         
                    t          |¦  «        ¦  «         | j                              t          j        ¦  «        D �]‚}t          || j        ¦  «        rŒt          |j        t          j        ¦  «        rŒ9d„ |                     t          j        ¦  «        D ¦   «         }|                     |¦  «        }|r d|v r|                     dd¦  «        }n|dz  }t+          j        |¦  «        D ]}|t          j        j	        v r|} nJŒ|| j        vr$| j         j                             d|z  |¬¦  «         | j                             |¦  «         d}t          j        |                      |¦  «        | j        |¬	¦  «        }	t=          ||	¦  «        D ]2\  }
}|
j                             |
t          j        |¦  «        ¦  «         Œ3�Œ„| j                             ¦   «          d S )
NÚsmart_quotesFÚaltc                 óP   — g | ]#}t          |j        t          j        ¦  «        °!|‘Œ$S r   )r;   rI   r   Úoption_string)rJ   Útxtnodes     r   rL   z%SmartQuotes.apply.<locals>.<listcomp>0  sG   € ð @ð @ð @ GÝ)¨'¬.Ý*/Ô*=ñ ?ô  ?ð@˜ð @ð @ð @r   z
-x-altquotr   z*No smart quotes defined for language "%s".)Ú	base_node)ÚattrÚlanguage) r   r"   Ú
setdefaultÚ
startswithÚAttributeErrorÚlanguage_codeÚsmartquotes_localesr   Ú
smartcharsÚquotesÚupdateÚdictrA   r   ÚTextElementr;   Únodes_to_skiprI   r+   Úget_language_coderc   r   Únormalize_language_tagr€   r^   ÚwarningÚaddÚeducate_tokensrŠ   Úsmartquotes_actionÚzipÚclear)r   rŒ   ÚalternativeÚdocument_languageÚlc_smartquotesr=   rˆ   ÚlangÚtagÚteacherr�   Únewtexts               r   r   zSmartQuotes.apply  sµ  € Ø”}Ô-×8Ò8¸Ø9>ñ@ô @ˆàð 	ØˆFð	 Ø&×1Ò1°%Ñ8Ô8ˆKˆKøÝð 	 ð 	 ð 	 ØˆKˆKˆKð	 øøøð !œMÔ2Ô@ÐØœÔ/ÔCˆØð 	GÝÔ"Ô)×0Ò0µ°nÑ1EÔ1EÑFÔFÐFð ”M×)Ò)­%Ô*;Ñ<Ô<ð )	Eñ )	EˆDå˜$ Ô 2Ñ3Ô3ð Øå˜$œ+¥uÔ'8Ñ9Ô9ð Øð@ð @¨t¯|ª|½E¼JÑ/GÔ/Gð @ñ @ô @ˆHð
 ×)Ò)Ð*;Ñ<Ô<ˆDàð )Ø 4Ð'Ð'ØŸ<š<¨°bÑ9Ô9�D�Dà˜LÑ(�DåÔ3°DÑ9Ô9ð 
ð 
�Ø�+Ô0Ô7Ð7Ð7Ø�DØ�Eð 8ð ˜tÔ9Ð9Ð9Ø”MÔ*×2Ò2ØDÀtÑKØ"&ð 3ñ (ô (ð (ð Ô*×.Ò.¨tÑ4Ô4Ð4Ø�õ "Ô0Ø—’ Ñ)Ô)ØÔ,°tð=ñ =ô =ˆGõ %(¨°'Ñ$:Ô$:ð Eð EÑ �˜Ø”×&Ò& wµ´
¸7Ñ0CÔ0CÑDÔDÐDÐDñEð 	Ô"×(Ò(Ñ*Ô*Ð*Ð*Ð*s   ¦< ¼AÁ
AN)r3   r4   r5   r6   r7   r   ÚFixedTextElementÚSpecialrž   Úimager‚   ÚmathÚrawrb   r„   r¤   r~   rŠ   r   r   r   r   rz   rz   ì   sž   € € € € € ðð ð ÐàÔ+¨U¬]Ð;€MØMàÔ+¨U¬]Ø”[ %¤-°´Ø”Y Ô 1ð3€Mð GàÐðð+ð +ð +ð#ð #ð #ð<+ð <+ð <+ð <+ð <+r   rz   )r6   Ú__docformat__r†   r,   Údocutilsr   r   Údocutils.transformsr   Údocutils.utilsr   r	   r9   rF   rV   rg   rj   ro   rz   r   r   r   ú<module>r·      sÊ  ððð ð #€à 	€	€	€	Ø €€€Ø !Ð !Ð !Ð !Ð !Ð !Ð !Ð !Ø )Ð )Ð )Ð )Ð )Ð )Ø &Ð &Ð &Ð &Ð &Ð &ð<ð <ð <ð <ð <�)ñ <ô <ð <ð~8ð 8ð 8ð 8ð 8�iñ 8ô 8ð 8ð(%ð %ð %ð %ð %ˆyñ %ô %ð %ð6)ð )ð )ð )ð )�Yñ )ô )ð )ð6%ð %ð %ð %ð %�9ñ %ô %ð %ð )ð )ð )ð )ð )�Iñ )ô )ð )ð#ð #ð #ð #ð #˜iñ #ô #ð #ðLf+ð f+ð f+ð f+ð f+�)ñ f+ô f+ð f+ð f+ð f+r   