§
    _÷#dÚ  ã                   ó6  — d Z ddlZddlZddlmZmZ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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 ddlmZ  ej        e¦  «        Z  G d„ de¦  «        Z!de"de"de"defd„Z#deddfd„Z$dedee"ef         fd„Z%dS )að  Extension to save typing and prevent hard-coding of base URLs in reST files.

This adds a new config value called ``extlinks`` that is created like this::

   extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...}

Now you can use e.g. :exmpl:`foo` in your documents.  This will create a
link to ``https://example.invalid/foo.html``.  The link caption depends on
the *caption* value given:

- If it is ``None``, the caption will be the full URL.
- If it is a string, it must contain ``%s`` exactly once.  In this case the
  caption will be *caption* with the role content substituted for ``%s``.

You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.

Both, the url string and the caption string must escape ``%`` as ``%%``.
é    N)ÚAnyÚDictÚListÚTuple)ÚnodesÚutils)ÚNodeÚsystem_message)ÚInliner)ÚSphinx)Ú__)ÚSphinxPostTransform)ÚloggingÚrst)Úsplit_explicit_title)ÚRoleFunctionc                   ó@   — e Zd ZdZdZdeddfd„Zdej        ddfd„Z	dS )	ÚExternalLinksCheckerz¦
    For each external link, check if it can be replaced by an extlink.

    We treat each ``reference`` node without ``internal`` attribute as an external link.
    iô  ÚkwargsÚreturnNc                 óš   — | j         j        sd S | j                             t          j        ¦  «        D ]}|                      |¦  «         Œd S ©N)ÚconfigÚextlinks_detect_hardcoded_linksÚdocumentÚfindallr   Ú	referenceÚ	check_uri)Úselfr   Úrefnodes      ú5/usr/lib/python3/dist-packages/sphinx/ext/extlinks.pyÚrunzExternalLinksChecker.run0   sT   € ØŒ{Ô:ð 	ØˆFà”}×,Ò,­U¬_Ñ=Ô=ð 	$ð 	$ˆGØ�NŠN˜7Ñ#Ô#Ð#Ð#ð	$ð 	$ó    r    c                 óp  — d|v sd|vrdS |d         }|                      ¦   «         }| j        j        j                             ¦   «         D �]j\  }\  }}t
          j        dk     r;t          j        t          j	        |¦  «         
                    dd¦  «        ¦  «        }n:t          j        t          j	        |¦  «         
                    dd¦  «        ¦  «        }|                     |¦  «        }|rÅ|                     ¦   «                              d¦  «        ržd	|                     ¦   «         d         vr‚t          d
¦  «        }	|                     ¦   «                              d¦  «        }
||k    rd|› dt          j	        |¦  «        › d|
› d�}n	d|› d|
› d�}t                                |	|||¬¦  «         �ŒldS )z„
        If the URI in ``refnode`` has a replacement in ``extlinks``,
        emit a warning with a replacement suggestion.
        ÚinternalÚrefuriN)é   é   z\%sz(?P<value>.+)ú%sÚvalueú/zHhardcoded link %r could be replaced by an extlink (try using %r instead)ú:z:`z <z>`ú`)Úlocation)ÚastextÚappr   ÚextlinksÚitemsÚsysÚversion_infoÚreÚcompileÚescapeÚreplaceÚmatchÚ	groupdictÚgetr   r   ÚloggerÚwarning)r   r    ÚuriÚtitleÚaliasÚbase_uriÚ_captionÚuri_patternr9   Úmsgr*   Úreplacements               r!   r   zExternalLinksChecker.check_uri7   sÉ  € ð
 ˜Ð Ð  H°GÐ$;Ð$;ØˆFà�hÔˆØ—’Ñ Ô ˆà+/¬8¬?Ô+C×+IÒ+IÑ+KÔ+Kð 	Hñ 	HÑ'ˆEÑ'�H˜hÝÔ &Ò(Ð(õ !œj­¬°8Ñ)<Ô)<×)DÒ)DÀVÈ_Ñ)]Ô)]Ñ^Ô^��å œj­¬°8Ñ)<Ô)<×)DÒ)DÀTÈ?Ñ)[Ô)[Ñ\Ô\�à×%Ò% cÑ*Ô*ˆEàðHà—’Ñ!Ô!×%Ò% gÑ.Ô.ðHð ˜5Ÿ?š?Ñ,Ô,¨WÔ5Ð5Ð5õ ð 2ñ 3ô 3�àŸšÑ)Ô)×-Ò-¨gÑ6Ô6�Ø˜%’<�<Ø"M eÐ"MÐ"M­s¬z¸%Ñ/@Ô/@Ð"MÐ"MÀEÐ"MÐ"MÐ"M�K�Kà"7 eÐ"7Ð"7¨uÐ"7Ð"7Ð"7�KÝ—’˜s C¨¸w�ÑGÔGÐGùð-	Hð 	Hr#   )
Ú__name__Ú
__module__Ú__qualname__Ú__doc__Údefault_priorityr   r"   r   r   r   © r#   r!   r   r   '   st   € € € € € ðð ð Ðð$˜Cð $ Dð $ð $ð $ð $ð!H ¤ð !H°Tð !Hð !Hð !Hð !Hð !Hð !Hr#   r   ÚnameÚbase_urlÚcaptionr   c                 óp  ‡‡— 	 ‰dz   nW# t           t          f$ rC t                               t	          d¦  «        ¦  «         ‰                     dd¦  «        dz   ŠY nw xY w‰�^	 ‰dz   nW# t           t          f$ rC t                               t	          d¦  «        ¦  «         ‰                     dd¦  «        dz   ŠY nw xY wi g fdt          dt          d	t          d
t          dt          dt          dt          t                   dt          t          t                   t          t                   f         fˆˆfd„}|S )NÚdummyztextlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and all other '%' need to be escaped as '%%'.ú%z%%r)   z|extlinks: Sphinx-6.0 will require a caption string to contain exactly one '%s' and all other '%' need to be escaped as '%%'.ÚtypÚrawtextÚtextÚlinenoÚinlinerÚoptionsÚcontentr   c                 ó®   •— t          j        |¦  «        }t          |¦  «        \  }}}	‰|	z  }
|s
‰€|
}n‰|	z  }t          j        ||d|
¬¦  «        }|gg fS )NF)r%   r&   )r   Úunescaper   r   r   )rR   rS   rT   rU   rV   rW   rX   Úhas_explicit_titler?   ÚpartÚfull_urlÚpnoderM   rN   s               €€r!   Úrolezmake_link_role.<locals>.roleq   ss   ø€ õ Œ~˜dÑ#Ô#ˆÝ*>¸tÑ*DÔ*DÑ'Ð˜E 4Ø˜d‘?ˆØ!ð 	'ØˆØ ��à $™�Ý”  u°uÀXÐNÑNÔNˆØˆw˜ˆ{Ðr#   )Ú	TypeErrorÚ
ValueErrorr<   r=   r   r8   ÚstrÚintr   r   r   r   r	   r
   )rL   rM   rN   r_   s    `` r!   Úmake_link_rolerd   [   s‡  øø€ ð6Ø�7ÑÐÐøÝ•zÐ"ð 6ð 6ð 6Ý�Š•rð 5ñ 6ô 6ñ 	7ô 	7ð 	7ð ×#Ò# C¨Ñ.Ô.°Ñ5ˆˆˆð	6øøøð
 Ðð	8Ø�gÑÐÐøÝ�:Ð&ð 	8ð 	8ð 	8Ý�NŠN�2ð 9ñ :ô :ñ ;ô ;ð ;ð —o’o c¨4Ñ0Ô0°4Ñ7ˆGˆGˆGð		8øøøð 02Èðð •#ð ¥ð ­3ð ½ð ÝðÝ(,ðÝ<@Å¼Iðå��Tœ
¥D­Ô$8Ð8Ô9ðð ð ð ð ð ð ð €Ks#   „
 ŠAAÁAÁ$A* Á*AB>Â=B>r0   c           	      óž   — | j         j                             ¦   «         D ]-\  }\  }}|                      |t	          |||¦  «        ¦  «         Œ.d S r   )r   r1   r2   Úadd_rolerd   )r0   rL   rM   rN   s       r!   Úsetup_link_rolesrg   �   s]   € Ø%(¤ZÔ%8×%>Ò%>Ñ%@Ô%@ð Dð DÑ!ˆÑ!ˆx˜Ø�Š�T�>¨$°¸'ÑBÔBÑCÔCÐCÐCðDð Dr#   c                 óæ   — |                       di d¦  «         |                       ddd¦  «         |                      dt          ¦  «         |                      t          ¦  «         t
          j        ddœS )Nr1   Úenvr   Fzbuilder-initedT)ÚversionÚparallel_read_safe)Úadd_config_valueÚconnectrg   Úadd_post_transformr   ÚsphinxÚ__display_version__)r0   s    r!   Úsetuprq   †   so   € Ø×Ò˜ R¨Ñ/Ô/Ð/Ø×ÒÐ:¸EÀ5ÑIÔIÐIà‡K‚KÐ Õ"2Ñ3Ô3Ð3Ø×ÒÕ/Ñ0Ô0Ð0ÝÔ1ÈÐNÐNÐNr#   )&rI   r5   r3   Útypingr   r   r   r   Údocutilsr   r   Údocutils.nodesr	   r
   Údocutils.parsers.rst.statesr   ro   Úsphinx.applicationr   Úsphinx.localer   Ú!sphinx.transforms.post_transformsr   Úsphinx.utilr   r   Úsphinx.util.nodesr   Úsphinx.util.typingr   Ú	getLoggerrF   r<   r   rb   rd   rg   rq   rK   r#   r!   ú<module>r}      sß  ððð ð& 
€	€	€	Ø 
€
€
€
Ø )Ð )Ð )Ð )Ð )Ð )Ð )Ð )Ð )Ð )Ð )Ð )à !Ð !Ð !Ð !Ð !Ð !Ð !Ð !Ø /Ð /Ð /Ð /Ð /Ð /Ð /Ð /Ø /Ð /Ð /Ð /Ð /Ð /à €€€Ø %Ð %Ð %Ð %Ð %Ð %Ø Ð Ð Ð Ð Ð Ø AÐ AÐ AÐ AÐ AÐ AØ $Ð $Ð $Ð $Ð $Ð $Ð $Ð $Ø 2Ð 2Ð 2Ð 2Ð 2Ð 2Ø +Ð +Ð +Ð +Ð +Ð +à	ˆÔ	˜8Ñ	$Ô	$€ð1Hð 1Hð 1Hð 1Hð 1HÐ.ñ 1Hô 1Hð 1Hðh#˜ð #¨ð #°cð #¸lð #ð #ð #ð #ðLD˜&ð D Tð Dð Dð Dð Dð
Oˆvð O˜$˜s C˜xœ.ð Oð Oð Oð Oð Oð Or#   