§
    N=&bg+  ã                   ó  — d Z dZddlZddlZddl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mZ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j        ¦  «        ZdZdd„ZdS )zø
Transforms for PEP processing.

- `Headers`: Used to transform a PEP's initial RFC-2822 header.  It remains a
  field list, but some entries get processed.
- `Contents`: Auto-inserts a table of contents.
- `PEPZero`: Special processing for PEP 0.
ÚreStructuredTexté    N)ÚnodesÚutilsÚ	languages)Ú	DataError)Ú	Transform)ÚpartsÚ
referencesÚmiscc                   óx   — e Zd ZdZdZdZdZ ej        dej	        ¦  «        df ej        d¦  «        dffZ
d„ Zd	S )
ÚHeadersz<
    Process fields in a PEP's initial RFC-2822 header.
    ih  zpep-%04dz3http://hg.python.org/peps/file/default/pep-%04d.txtz\$RCSfile: (.+),v \$$z\1z\$[a-zA-Z]+: (.+) \$$c                 ó$  — t          | j        ¦  «        st          d¦  «        ‚| j        d         }t          |t          j        ¦  «        r
d|d         vrt          d¦  «        ‚d }|D �]S}|d                              ¦   «                              ¦   «         dk    �r|d                              ¦   «         }	 t          |¦  «        }| j	        |z  }nè# t          $ rÛ |}d }| j        j                             d|z  |¬	¦  «        }| j                             |¦  «        }t	          j        ||pd
|¬¦  «        }| j                             |¦  «        }	|                     |	¦  «         t          |d         ¦  «        r|g|d         d         d d …<   n$|dxx         t	          j        dd|¦  «        z  cc<   Y nw xY w n�ŒU|€t          d¦  «        ‚|dk    rNt	          j        t$          ¦  «        }
| j                             d|
¦  «         | j                             |
¦  «         t          |¦  «        dk     s6|d         d                              ¦   «                              ¦   «         dk    rt          d¦  «        ‚|D �]’}|d                              ¦   «                              ¦   «         }|d         }t          |¦  «        dk    r&t          d|                     d¬¦  «        z  ¦  «        ‚t          |¦  «        dk    rGt          |d         t          j        ¦  «        s&t          d|                     d¬¦  «        z  ¦  «        ‚n—|dk    r�	 t-          j        dt-          j        t3          j        | j        d         ¦  «        d         ¦  «        ¦  «        }n# t6          $ r d}Y nw xY w|r.|t	          j        ddt	          j        d||¬¦  «        ¦  «        z  }n�Œa|d         }|dk    rC|D ]>}t          |t          j        ¦  «        r"|                     t=          |¦  «        ¦  «         Œ?�Œ²|dk    rD|D ]?}t          |t          j        ¦  «        r#|                     t=          ||¦  «        ¦  «         Œ@�Œü|dv r¹g }t	          j        d¦  «        }tA          j!        d|                     ¦   «         ¦  «        D ]j}t          |¦  «        }| "                    t	          j        ||| j        j#        j$        | j%        |z  z   ¬¦  «        ¦  «         | "                    |¦  «         Œk|d d…         |d d …<   �Œ¹|dk    rOtM          j'        || j(        ¦  «         |r1|                     ¦   «         }t	          j        d||¬¦  «        g|d d …<   �Œ|d k    rO|                     ¦   «         }| j        j#        j$        | j%        d!z  z   }t	          j        d||¬¦  «        g|d d …<   �Œc|d"k    r)t          |¦  «        rtM          j'        || j(        ¦  «         �Œ”d S )#NzDocument tree is empty.r   Úrfc2822ÚclasseszADocument does not begin with an RFC-2822 header; it is not a PEP.Úpepé   z?"PEP" header must contain an integer; "%s" is an invalid value.)Ú	base_nodez(none))ÚrefidÚ z3Document does not contain an RFC-2822 "PEP" header.é   Útitlez	No title!z4PEP header field body contains multiple elements:
%s)Úlevelz=PEP header field body may only contain a single paragraph:
%szlast-modifiedz%d-%b-%YÚsourceé   Úunknown©ÚrefuriÚauthorzdiscussions-to)Úreplaceszreplaced-byÚrequiresú z,?\s+éÿÿÿÿzcontent-typeé   Úversion))ÚlenÚdocumentr   Ú
isinstancer   Ú
field_listÚastextÚlowerÚintÚpep_cvs_urlÚ
ValueErrorÚreporterÚwarningÚset_idÚproblematicÚadd_backrefÚ	paragraphÚpendingÚPEPZeroÚinsertÚnote_pendingÚpformatÚtimeÚstrftimeÚ	localtimeÚosÚstatÚOSErrorÚ	referenceÚreplace_selfÚ
mask_emailÚTextÚreÚsplitÚappendÚsettingsÚpep_base_urlÚpep_urlr   Úclean_rcs_keywordsÚrcs_keyword_substitutions)ÚselfÚheaderr   ÚfieldÚvalueÚcvs_urlÚmsgÚmsgidÚprbÚprbidr4   ÚnameÚbodyÚdateÚparaÚnodeÚnewbodyÚspaceÚrefpepÚpepnoÚpep_typeÚuris                         ú:/usr/lib/python3/dist-packages/docutils/transforms/peps.pyÚapplyzHeaders.apply(   s  € Ý�4”=Ñ!Ô!ð 	7åÐ5Ñ6Ô6Ð6Ø”˜qÔ!ˆÝ˜6¥5Ô#3Ñ4Ô4ð 	8Ø  yÔ 1Ð1Ð1Ýð 7ñ 8ô 8ð 8àˆØð 	ñ 	ˆEØ�QŒx�ŠÑ Ô ×&Ò&Ñ(Ô(¨EÒ1Ñ1Ø˜aœŸšÑ)Ô)�ðAÝ˜e™*œ*�CØ"Ô.°Ñ4�G�GøÝ!ð Að Að AØ�CØ"�GØœ-Ô0×8Ò8ð)Ø+.ñ/Ø:?ð 9ñ Aô A�Cð !œM×0Ò0°Ñ5Ô5�EÝÔ+¨E°5Ð3D¸HØ27ð9ñ 9ô 9�Cà œM×0Ò0°Ñ5Ô5�EØ—O’O EÑ*Ô*Ð*Ý˜5 œ8‘}”}ð AØ*-¨˜˜aœ œ A A A™˜à˜a˜˜œ¥E¤O°B¸¸CÑ$@Ô$@Ñ@˜˜™øøðAøøøð �ñ) 2ð* ˆ;Ýð &ñ 'ô 'ð 'à�!Š8ˆ8å”m¥GÑ,Ô,ˆGØŒM× Ò   GÑ,Ô,Ð,ØŒM×&Ò& wÑ/Ô/Ð/Ýˆv‰;Œ;˜Š?ˆ?˜f Qœi¨œl×1Ò1Ñ3Ô3×9Ò9Ñ;Ô;¸wÒFÐFÝ˜KÑ(Ô(Ð(Øð 6	Oñ 6	OˆEØ˜”8—?’?Ñ$Ô$×*Ò*Ñ,Ô,ˆDØ˜”8ˆDÝ�4‰yŒy˜1Š}ˆ}Ýð !0Ø27·-²-Àa°-Ñ2HÔ2Hñ!Iñ Jô Jð Jå�T‘”˜a’�Ý! $ q¤'­5¬?Ñ;Ô;ð >Ý#ð %>à&+§m¢m¸! mÑ&<Ô&<ñ%=ñ >ô >ð >ð>ð ˜Ò(Ð(ð%Ýœ=Ø"Ýœ¥r¤w¨t¬}¸XÔ/FÑ'GÔ'GÈÔ'JÑKÔKñMô M�D�Døõ ð %ð %ð %Ø$�D�D�Dð%øøøàð KØ�EœOØ˜B¥¤°°DÀÐ IÑ IÔ IñKô Kñ K�Døñ Ø˜”7ˆDØ�xÒÐØ ð <ð <�DÝ! $­¬Ñ8Ô8ð <Ø×)Ò)­*°TÑ*:Ô*:Ñ;Ô;Ð;øñ<ð Ð)Ò)Ð)Ø ð Að A�DÝ! $­¬Ñ8Ô8ð AØ×)Ò)­*°T¸3Ñ*?Ô*?Ñ@Ô@Ð@øñAð Ð@Ð@Ð@Ø�Ýœ
 3™œ�Ý œh x°·²±´Ñ?Ô?ð *ð *�FÝ ™KœK�EØ—N’N¥5¤?Ø Ø $¤Ô 6Ô CØ"&¤,°Ñ"6ñ!7ð$9ñ $9ô $9ñ :ô :ð :ð —N’N 5Ñ)Ô)Ð)Ð)Ø! # 2 #œ,��Q�Q�Q‘‘Ø˜Ò(Ð(ÝÔ(¨¨tÔ/MÑNÔNÐNØð JØŸ;š;™=œ=�DÝ$œ¨r°4ÀÐHÑHÔHÐI�D˜˜˜‘GùØ˜Ò'Ð'ØŸ;š;™=œ=�Ø”mÔ,Ô9¸D¼LÈ2Ñ<MÑM�Ý œ?¨2¨xÀÐDÑDÔDÐE��Q�Q�Q‘‘Ø˜Ò"Ð"¥s¨4¡y¤yÐ"ÝÔ(¨¨tÔ/MÑNÔNÐNùðm6	Oð 6	Os&   Â7CÃC"F6Æ5F6ÍA
NÎN'Î&N'N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Údefault_priorityrH   r,   rC   ÚcompileÚ
IGNORECASErJ   r`   © ó    r_   r   r      sƒ   € € € € € ðð ð Ðà€Gð5€Kð ˆ2Œ:Ð2°B´MÑBÔBÀEÐ
JØˆ2Œ:Ð.Ñ/Ô/°Ð
7ð!:Ðð`Oð `Oð `Oð `Oð `Ori   r   c                   ó   — e Zd ZdZdZd„ ZdS )ÚContentsz~
    Insert an empty table of contents topic and a transform placeholder into
    the document after the RFC 2822 header.
    i|  c                 óL  — t          j        | j        j        j        | j        j        ¦  «        }|j        d         }t          j        d|¦  «        }t          j	        d|dg¬¦  «        }t          j
        |¦  «        }| j                             |¦  «        s|d                              |¦  «         | j                             |¦  «         t          j        t          j        ¦  «        }||z  }| j                             d|¦  «         | j                             |¦  «         d S )NÚcontentsr   )r   Únamesr   )r   Úget_languager&   rF   Úlanguage_coder.   Úlabelsr   r   ÚtopicÚfully_normalize_nameÚhas_namerE   Únote_implicit_targetr4   r	   rk   r6   r7   )rK   ÚlanguagerT   r   rr   r4   s         r_   r`   zContents.apply”   s  € ÝÔ)¨$¬-Ô*@Ô*NØ*.¬-Ô*@ñBô BˆàŒ˜zÔ*ˆÝ”˜B Ñ%Ô%ˆÝ”˜B °
¨|Ð<Ñ<Ô<ˆÝÔ)¨$Ñ/Ô/ˆØŒ}×%Ò% dÑ+Ô+ð 	(Ø�'ŒN×!Ò! $Ñ'Ô'Ð'ØŒ×*Ò*¨5Ñ1Ô1Ð1Ý”-¥¤Ñ/Ô/ˆØ�ÑˆØŒ×Ò˜Q Ñ&Ô&Ð&ØŒ×"Ò" 7Ñ+Ô+Ð+Ð+Ð+ri   N©ra   rb   rc   rd   re   r`   rh   ri   r_   rk   rk   ‹   s5   € € € € € ðð ð
 Ðð,ð ,ð ,ð ,ð ,ri   rk   c                   ó"   — e Zd ZdZdZd„ Zd„ ZdS )ÚTargetNotesz¶
    Locate the "References" section, insert a placeholder for an external
    target footnote insertion transform at the end, and schedule the
    transform to run immediately.
    i  c                 óº  — | j         }t          |¦  «        dz
  }d x}}|dk    r¢t          ||         t          j        ¦  «        r‚||         d                              ¦   «                              ¦   «                              ¦   «         }d|v r	||         }n1d|v r|}|dz  }|dk    r t          ||         t          j        ¦  «        °‚|snt          j        ¦   «         }|t          j        dd¦  «        z  }| 	                    |¦  «         |r| 
                    ||¦  «         n|                     |¦  «         t          j        t          j        ¦  «        }|                     |¦  «         | j                              |d¦  «         t          j        t           j        d| j        i¬¦  «        }|                     |¦  «         | j                              |d¦  «         d S )	Nr   r   r
   Ú	copyrightr   Ú
ReferencesÚcallback)Údetails)r&   r%   r'   r   Úsectionr)   r*   rD   r   r0   r6   rE   r4   r
   ry   r7   r   ÚCallBackÚcleanup_callback)rK   ÚdocÚiÚrefsectr{   Útitle_wordsr4   s          r_   r`   zTargetNotes.apply®   sÃ  € ØŒmˆÝ�‰HŒH�q‰LˆØ"Ð"ˆ�)Ø�1Šfˆf� C¨¤F­E¬MÑ:Ô:ˆfØ˜aœ& œ)×*Ò*Ñ,Ô,×2Ò2Ñ4Ô4×:Ò:Ñ<Ô<ˆKØ˜{Ð*Ð*Ø˜aœ&�ØØ Ð+Ð+Ø�	Ø�‰FˆAð �1Šfˆf� C¨¤F­E¬MÑ:Ô:ˆfð ð 		$Ý”m‘o”oˆGØ•u”{ 2 |Ñ4Ô4Ñ4ˆGØ�JŠJ�wÑÔÐØð $à—
’
˜9 gÑ.Ô.Ð.Ð.ð —
’
˜7Ñ#Ô#Ð#Ý”-¥
Ô 6Ñ7Ô7ˆØ�Š�wÑÔÐØŒ×"Ò" 7¨AÑ.Ô.Ð.Ý”-¥¤Ø)3°TÔ5JÐ(KðMñ Mô Mˆà�Š�wÑÔÐØŒ×"Ò" 7¨AÑ.Ô.Ð.Ð.Ð.ri   c                 ó‚   — t          |j        ¦  «        dk    r&|j        j                             |j        ¦  «         dS dS )z�
        Remove an empty "References" section.

        Called after the `references.TargetNotes` transform is complete.
        r   N)r%   ÚparentÚremove)rK   r4   s     r_   r�   zTargetNotes.cleanup_callbackÌ   sB   € õ ˆwŒ~ÑÔ !Ò#Ð#ØŒNÔ!×(Ò(¨¬Ñ8Ô8Ð8Ð8Ð8ð $Ð#ri   N)ra   rb   rc   rd   re   r`   r�   rh   ri   r_   ry   ry   ¤   sD   € € € € € ðð ð Ðð/ð /ð /ð<9ð 9ð 9ð 9ð 9ri   ry   c                   ó   — e Zd ZdZdZd„ ZdS )r5   z'
    Special processing for PEP 0.
    iø  c                 óª   — t          | j        ¦  «        }| j                             |¦  «         | j        j                             | j        ¦  «         d S ©N)ÚPEPZeroSpecialr&   ÚwalkÚ	startnoder‡   rˆ   )rK   Úvisitors     r_   r`   zPEPZero.applyÞ   sH   € Ý  ¤Ñ/Ô/ˆØŒ×Ò˜7Ñ#Ô#Ð#ØŒÔ×$Ò$ T¤^Ñ4Ô4Ð4Ð4Ð4ri   Nrw   rh   ri   r_   r5   r5   Ö   s5   € € € € € ðð ð Ðð5ð 5ð 5ð 5ð 5ri   r5   c                   óJ   — e Zd ZdZej        Zd„ Zd„ Zd„ Zd„ Z	d„ Z
d„ Zd„ Zd	S )
rŒ   z´
    Perform the special processing needed by PEP 0:

    - Mask email addresses.

    - Link PEP numbers in the second column of 4-column tables to the PEPs
      themselves.
    c                 ó   — d S r‹   rh   ©rK   rX   s     r_   Úunknown_visitzPEPZeroSpecial.unknown_visitñ   s   € Øˆri   c                 óJ   — |                      t          |¦  «        ¦  «         d S r‹   )r@   rA   r’   s     r_   Úvisit_referencezPEPZeroSpecial.visit_referenceô   s$   € Ø×Ò�* TÑ*Ô*Ñ+Ô+Ð+Ð+Ð+ri   c                 ó2   — d|d         v rt           j        ‚d S )Nr   r   )r   ÚSkipNoder’   s     r_   Úvisit_field_listzPEPZeroSpecial.visit_field_list÷   s!   € Ø˜˜YœÐ'Ð'Ý”.Ð ð (Ð'ri   c                 ó6   — |d         dk    | _         d| _        d S )NÚcolsé   r   )Ú	pep_tableÚentryr’   s     r_   Úvisit_tgroupzPEPZeroSpecial.visit_tgroupû   s   € Ø˜fœ¨Ò*ˆŒØˆŒ
ˆ
ˆ
ri   c                 óˆ   — | xj         dz  c_         | j        r(| j         dk    r|d                              d¦  «         d S d S d S )Nr   r   r   Únum)r�   rœ   rE   r’   s     r_   Úvisit_colspeczPEPZeroSpecial.visit_colspecÿ   sQ   € Øˆ
Œ
�a‰ˆ
Œ
ØŒ>ð 	*˜dœj¨Ašo˜oØ�ŒO×"Ò" 5Ñ)Ô)Ð)Ð)Ð)ð	*ð 	*˜o˜ori   c                 ó   — d| _         d S )Nr   )r�   r’   s     r_   Ú	visit_rowzPEPZeroSpecial.visit_row  s   € ØˆŒ
ˆ
ˆ
ri   c                 óú  — | xj         dz  c_         | j        rÛ| j         dk    rÒt          |¦  «        dk    rÁ|d                              d¦  «         |d         }t	          |t
          j        ¦  «        r†t          |¦  «        dk    ru|                     ¦   «         }	 t          |¦  «        }| j	        j
        j        | j        |z  z   }t          j        |||¬¦  «        |d<   d S # t          $ r Y d S w xY wd S d S d S d S d S )Nr   r   r   r    r   r   )r�   rœ   r%   rE   r'   r   r3   r)   r+   r&   rF   rG   rH   r?   r-   )rK   rX   ÚpÚtextr   Úrefs         r_   Úvisit_entryzPEPZeroSpecial.visit_entry  s  € Øˆ
Œ
�a‰ˆ
Œ
ØŒ>ð 	˜dœj¨Ašo˜oµ#°d±)´)¸q².°.Ø�ŒO×"Ò" 5Ñ)Ô)Ð)Ø�Q”ˆAÝ˜!�Uœ_Ñ-Ô-ð µ#°a±&´&¸A²+°+Ø—x’x‘z”z�ðÝ˜d™)œ)�CØœ=Ô1Ô>Ø!œ\¨CÑ/ñ0�Cå œ?¨4°¸cÐBÑBÔB�A�a‘D�D�DøÝ!ð ð ð Ø�D�Dðøøøð	ð 	˜o˜o°.°.ðð °+°+s   ÂAC" Ã"
C0Ã/C0N)ra   rb   rc   rd   r   rH   r“   r•   r˜   rž   r¡   r£   r¨   rh   ri   r_   rŒ   rŒ   ä   s�   € € € € € ðð ð Œo€Gðð ð ð,ð ,ð ,ð!ð !ð !ðð ð ð*ð *ð *ð
ð ð ðð ð ð ð ri   rŒ   )zpeps@python.orgzpython-list@python.orgzpython-dev@python.orgc                 óf  — |                       d¦  «        r›| d                              d¦  «        r€| d         dd…         t          v r	| d         }n?|                      ¦   «                              dd¦  «        }t          j        d|d	¬
¦  «        }|€|S | dxx         d|z  z  cc<   |g| dd…<   | S | S )a¨  
    Mask the email address in `ref` and return a replacement node.

    `ref` is returned unchanged if it contains no email address.

    For email addresses such as "user@host", mask the address as "user at
    host" (text) to thwart simple email address harvesters (except for those
    listed in `non_masked_addresses`).  If a PEP number (`pepno`) is given,
    return a reference including a default email subject.
    r   zmailto:r   Nr   ú@z&#32;&#97;t&#32;r   Úhtml)Úformatz?subject=PEP%%20%s)ÚhasattrÚ
startswithÚnon_masked_addressesr)   Úreplacer   Úraw)r§   r\   ÚreplacementÚreplacement_texts       r_   rA   rA     sË   € ð ‡{‚{�8ÑÔð   X¤×!9Ò!9¸)Ñ!DÔ!Dð ØˆxŒ=˜˜˜ÔÕ 4Ð4Ð4Ø˜aœ&ˆKˆKà"Ÿzšz™|œ|×3Ò3°CÐ9KÑLÔLÐÝœ) BÐ(8ÀÐHÑHÔHˆKØˆ=ØÐà�ˆMˆMŒMÐ1°EÑ9Ñ9ˆMˆM‰MØ!�]ˆC���‰FØˆJàˆ
ri   r‹   )rd   Ú__docformat__r<   rC   r9   Údocutilsr   r   r   r   Údocutils.transformsr   r	   r
   r   r   rk   ry   r5   ÚSparseNodeVisitorrŒ   r¯   rA   rh   ri   r_   ú<module>r¸      sŸ  ðð
ð ð #€à 	€	€	€	Ø 	€	€	€	Ø €€€Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ø Ð Ð Ð Ð Ð Ø )Ð )Ð )Ð )Ð )Ð )Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7ðoOð oOð oOð oOð oOˆiñ oOô oOð oOðd,ð ,ð ,ð ,ð ,ˆyñ ,ô ,ð ,ð2/9ð /9ð /9ð /9ð /9�)ñ /9ô /9ð /9ðd5ð 5ð 5ð 5ð 5ˆiñ 5ô 5ð 5ð0ð 0ð 0ð 0ð 0�UÔ,ñ 0ô 0ð 0ðf1Ð ð
ð ð ð ð ð ri   