§
    _÷#dˆG  ã            
       óZ  — U d Z ddlZddlZddlmZ ddlmZ ddlmZm	Z	m
Z
mZmZmZmZ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 e	rddlmZ dZ dZ! ed„ ¦  «        Z"ee#e$f         e%d<   e" &                    ej'        ej'        ej(        ej)        ej*        e!ej+        dœ¦  «          ed„ ¦  «        Z,ee$e$f         e%d<   e, &                    ej*        e!ej+        dœ¦  «          ed„ ej(        dej)        dej+        di¦  «        Z-de#ddfd„Z.deej/                 ddfd„Z0 G d„ d ej/        ¦  «        Z1 G d!„ d"e1¦  «        Z2 G d#„ d$e1¦  «        Z3 G d%„ dej4        ¦  «        Z5 G d&„ d'ej6        ¦  «        Z7 G d(„ d)ej6        ¦  «        Z8 G d*„ d+ej9        j:        ¦  «        Z;edeej<        ddf         fd,„¦   «         Z=edee;ddf         fd-„¦   «         Z>edee;ddf         fd.„¦   «         Z?edZd0e@ded1         fd2„¦   «         ZAed3e#ded1         fd4„¦   «         ZB G d5„ d6¦  «        ZC G d7„ d8ejD        ¦  «        ZEd9e#d:e#d;ee#         de@fd<„ZF G d=„ d>ejD        ¦  «        ZG G d?„ d@ejD        ¦  «        ZH G dA„ dBejD        ¦  «        ZI G dC„ dDejD        ¦  «        ZJ G dE„ dFejD        ¦  «        ZK G dG„ dHejD        ¦  «        ZL G dI„ dJeL¦  «        ZM G dK„ dLeL¦  «        ZNdMedee#         fdN„ZO G dO„ dPejP        ¦  «        ZQ G dQ„ dR¦  «        ZR G dS„ dT¦  «        ZSdUdVdWedXeddfdY„ZTdS )[z%Logging utility functions for Sphinx.é    N)Údefaultdict)Úcontextmanager)
ÚIOÚTYPE_CHECKINGÚAnyÚDictÚ	GeneratorÚListÚOptionalÚTupleÚTypeÚUnion)Únodes)ÚNode)Úget_source_line)ÚSphinxWarning)Úcolorize)Úabspath)ÚSphinxÚsphinxé   c                  ó   — t           j        S ©N)ÚloggingÚWARNING© ó    ú5/usr/lib/python3/dist-packages/sphinx/util/logging.pyú<lambda>r      s   € µ'´/€ r   ÚLEVEL_NAMES)ÚCRITICALÚSEVEREÚERRORr   ÚINFOÚVERBOSEÚDEBUGc                  ó   — dS )Nr   r   r   r   r   r   r   #   s   € °A€ r   ÚVERBOSITY_MAP)r   é   é   c                  ó   — dS )NÚbluer   r   r   r   r   r   *   s   €  € r   ÚdarkredÚredÚdarkgrayÚnameÚreturnÚSphinxLoggerAdapterc                 ón   — t          j        t          dz   | z   ¦  «        }d|_        t	          |i ¦  «        S )aü  Get logger wrapped by :class:`sphinx.util.logging.SphinxLoggerAdapter`.

    Sphinx logger always uses ``sphinx.*`` namespace to be independent from
    settings of root logger.  It ensures logging is consistent even if a
    third-party extension or imported application resets logger settings.

    Example usage::

        >>> from sphinx.util import logging
        >>> logger = logging.getLogger(__name__)
        >>> logger.info('Hello, this is an extension!')
        Hello, this is an extension!
    ú.F)r   Ú	getLoggerÚ	NAMESPACEÚdisabledr2   )r0   Úloggers     r   r5   r5   2   s4   € õ Ô�y¨3™°Ñ5Ñ6Ô6€Fà€F„Oå˜v rÑ*Ô*Ð*r   Úrecordsc                 óÎ   — | D ]a}|                      ¦   «         |_        d|_        t          |dd¦  «        }t	          |t
          j        ¦  «        rt          |¦  «        |_        ŒbdS )zConvert LogRecord serializable.r   ÚlocationN)	Ú
getMessageÚmsgÚargsÚgetattrÚ
isinstancer   r   Úget_node_locationr;   )r9   Úrr;   s      r   Úconvert_serializablerC   H   sf   € àð 5ð 5ˆà—’‘”ˆŒØˆŒå˜1˜j¨$Ñ/Ô/ˆÝ�h¥¤
Ñ+Ô+ð 	5Ý*¨8Ñ4Ô4ˆAŒJøð5ð 5r   c                   ó<   ‡ — e Zd ZU dZdZdZeed<   defˆ fd„Z	ˆ xZ
S )ÚSphinxLogRecordz$Log record class supporting locationÚ Nr;   r1   c                 ó²   •— t          ¦   «                              ¦   «         }t          | dd ¦  «        }|r|›d| j        ›|›�}n| j        |vr
| j        |z   }|S )Nr;   z: )Úsuperr<   r?   Úprefix)ÚselfÚmessager;   Ú	__class__s      €r   r<   zSphinxLogRecord.getMessageY   sg   ø€ Ý‘'”'×$Ò$Ñ&Ô&ˆÝ˜4 ¨TÑ2Ô2ˆØð 	,Ø$, H H¨d¬k¨k¸7¸7ÐCˆGˆGØŒ[ Ð'Ð'Ø”k GÑ+ˆGàˆr   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__rI   r;   r   Ú__annotations__Ústrr<   Ú__classcell__©rL   s   @r   rE   rE   T   sa   ø€ € € € € € Ø.Ð.Ø€FØ€HˆcÐÐÑð˜Cð ð ð ð ð ð ð ð ð ð r   rE   c                   ó   — e Zd ZdZdZdS )ÚSphinxInfoLogRecordz)Info log record class supporting locationrF   N)rM   rN   rO   rP   rI   r   r   r   rV   rV   d   s   € € € € € Ø3Ð3Ø€F€F€Fr   rV   c                   ó.   — e Zd ZdZedefd„¦   «         ZdS )ÚSphinxWarningLogRecordz,Warning log record class supporting locationr1   c                 ób   — | j         t          j        k    rdS | j         t          j        k    rdS dS )Nz
CRITICAL: zERROR: z	WARNING: )Úlevelnor   r!   r#   ©rJ   s    r   rI   zSphinxWarningLogRecord.prefixk   s0   € àŒ<�7Ô+Ò+Ð+Ø�<ØŒ\�Wœ]Ò*Ð*Ø�9à�;r   N)rM   rN   rO   rP   ÚpropertyrR   rI   r   r   r   rX   rX   i   s?   € € € € € Ø6Ð6Øð˜ð ð ð ñ „Xðð ð r   rX   c            
       ó¦   ‡ — e Zd ZdZg d¢Zdeeef         dedededdf
ˆ fd	„Z	dedededdfd
„Z
dededeeef         fd„Zdej        ddfd„Zˆ xZS )r2   z9LoggerAdapter allowing ``type`` and ``subtype`` keywords.)ÚtypeÚsubtyper;   ÚnonlÚcolorÚonceÚlevelr=   r>   Úkwargsr1   Nc                 óÈ   •— t          |t          ¦  «        r  t          ¦   «         j        ||g|¢R i |¤Ž d S t          |         } t          ¦   «         j        ||g|¢R i |¤Ž d S r   )r@   ÚintrH   Úlogr    )rJ   rc   r=   r>   rd   rZ   rL   s         €r   rg   zSphinxLoggerAdapter.logy   s{   ø€ Ý�e�SÑ!Ô!ð 	7Ø�E‰GŒGŒK˜˜sÐ4 TÐ4Ð4Ð4¨VÐ4Ð4Ð4Ð4Ð4å! %Ô(ˆGØ�E‰GŒGŒK˜ Ð6 tÐ6Ð6Ð6¨vÐ6Ð6Ð6Ð6Ð6r   c                 ó4   —  | j         t          |g|¢R i |¤Ž d S r   )rg   r%   )rJ   r=   r>   rd   s       r   ÚverbosezSphinxLoggerAdapter.verbose€   s,   € ØˆŒ•˜#Ð/ Ð/Ð/Ð/¨Ð/Ð/Ð/Ð/Ð/r   c                 ó‚   — |                      di ¦  «        }| j        D ]}||v r|                     |¦  «        ||<   Œ||fS )NÚextra)Ú
setdefaultÚKEYWORDSÚpop)rJ   r=   rd   rk   Úkeywords        r   ÚprocesszSphinxLoggerAdapter.processƒ   sS   € Ø×!Ò! '¨2Ñ.Ô.ˆØ”}ð 	5ð 	5ˆGØ˜&Ð Ð Ø!'§¢¨GÑ!4Ô!4��g‘øà�Fˆ{Ðr   Úrecordc                 ó:   — | j                              |¦  «         d S r   )r8   Úhandle©rJ   rq   s     r   rs   zSphinxLoggerAdapter.handle‹   s   € ØŒ×Ò˜6Ñ"Ô"Ð"Ð"Ð"r   )rM   rN   rO   rP   rm   r   rf   rR   r   rg   ri   r   r   rp   r   Ú	LogRecordrs   rS   rT   s   @r   r2   r2   u   s  ø€ € € € € ØCÐCØGÐGÐG€Hð7˜˜s C˜xœð 7¨sð 7¸3ð 7È#ð 7ÐRVð 7ð 7ð 7ð 7ð 7ð 7ð0˜3ð 0 sð 0°cð 0¸dð 0ð 0ð 0ð 0ð˜3ð ¨ð °°s¸D°yÔ1Að ð ð ð ð#˜WÔ.ð #°4ð #ð #ð #ð #ð #ð #ð #ð #r   c                   ó   — e Zd ZdZdS )ÚWarningStreamHandlerzStreamHandler for warnings.N)rM   rN   rO   rP   r   r   r   rw   rw   �   s   € € € € € Ø%Ð%Ø€Dr   rw   c                   ó6   ‡ — e Zd ZdZdej        ddfˆ fd„Zˆ xZS )ÚNewLineStreamHandlerzAStreamHandler which switches line terminator by record.nonl flag.rq   r1   Nc                 ó  •— 	 |                       ¦   «          t          |dd¦  «        rd| _        t          ¦   «                              |¦  «         d| _        |                      ¦   «          d S # d| _        |                      ¦   «          w xY w)Nr`   FrF   ú
)Úacquirer?   Ú
terminatorrH   ÚemitÚrelease)rJ   rq   rL   s     €r   r~   zNewLineStreamHandler.emit—   sz   ø€ ð	Ø�LŠL‰NŒNˆNÝ�v˜v uÑ-Ô-ð %à"$�”Ý‰GŒG�LŠL˜Ñ Ô Ð à"ˆDŒOØ�LŠL‰NŒNˆNˆNˆNøð #ˆDŒOØ�LŠL‰NŒNˆNˆNøøøs   ƒAA- Á-B
)rM   rN   rO   rP   r   ru   r~   rS   rT   s   @r   ry   ry   ”   sT   ø€ € € € € ØKÐKð	˜7Ô,ð 	°ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	r   ry   c                   ó¤   ‡ — e Zd ZU dZeej                 ed<   dˆ fd„Zdej        de	fd„Z
dd„Zd	ej        ddfd
„Zdeej                 fd„Zˆ xZS )ÚMemoryHandlerzHandler buffering all logs.Úbufferr1   Nc                 óJ   •— t          ¦   «                              d¦  «         d S )Néÿÿÿÿ)rH   Ú__init__)rJ   rL   s    €r   r…   zMemoryHandler.__init__¨   s!   ø€ Ý‰Œ×Ò˜ÑÔÐÐÐr   rq   c                 ó   — dS )NFr   rt   s     r   ÚshouldFlushzMemoryHandler.shouldFlush«   s   € Øˆur   c                 ó   — d S r   r   r[   s    r   ÚflushzMemoryHandler.flush®   s	   € ð 	ˆr   r8   c                 óÖ   — |                       ¦   «          	 | j        D ]}|                     |¦  «         Œg | _        |                      ¦   «          d S # |                      ¦   «          w xY wr   )r|   r‚   rs   r   )rJ   r8   rq   s      r   ÚflushTozMemoryHandler.flushTo³   sd   € Ø�Š‰Œˆð	Øœ+ð &ð &�Ø—’˜fÑ%Ô%Ð%Ð%ØˆDŒKà�LŠL‰NŒNˆNˆNˆNøˆD�LŠL‰NŒNˆNˆNøøøs   –&A ÁA(c                 ó$   — | j         g c}| _         |S r   )r‚   )rJ   r‚   s     r   ÚclearzMemoryHandler.clear¼   s   € Ø"œk¨2Ðˆ�”Øˆr   ©r1   N)rM   rN   rO   rP   r
   r   ru   rQ   r…   Úboolr‡   r‰   ÚLoggerr‹   r�   rS   rT   s   @r   r�   r�   £   sÙ   ø€ € € € € € Ø%Ð%à�Ô"Ô#Ð#Ð#Ñ#ðð ð ð ð ð ð 'Ô"3ð ¸ð ð ð ð ðð ð ð ð
˜gœnð °ð ð ð ð ð�t˜GÔ-Ô.ð ð ð ð ð ð ð ð r   r�   c               #   óŠ  K  — t          j        t          ¦  «        } t          ¦   «         }|                     t           j        ¦  «         	 g }| j        dd…         D ]A}t          |t          ¦  «        r*|  	                    |¦  «         | 
                    |¦  «         ŒB|                      |¦  «         |V — |  	                    |¦  «         |D ]}|                      |¦  «         Œ|                     | ¦  «         dS # |  	                    |¦  «         |D ]}|                      |¦  «         Œ|                     | ¦  «         w xY w)zgContext manager to postpone logging warnings temporarily.

    Similar to :func:`pending_logging`.
    N)r   r5   r6   r�   ÚsetLevelr   Úhandlersr@   rw   ÚremoveHandlerÚappendÚ
addHandlerr‹   ©r8   Ú
memhandlerr“   Úhandlers       r   Úpending_warningsrš   Á   s`  è è € õ Ô�yÑ)Ô)€FÝ‘”€JØ×Ò�œÑ(Ô(Ð(ð#ØˆØ” q q qÔ)ð 	)ð 	)ˆGÝ˜'Õ#7Ñ8Ô8ð )Ø×$Ò$ WÑ-Ô-Ð-Ø—’ Ñ(Ô(Ð(øà×Ò˜*Ñ%Ô%Ð%ØÐÐÐà×Ò˜ZÑ(Ô(Ð(àð 	'ð 	'ˆGØ×Ò˜gÑ&Ô&Ð&Ð&à×Ò˜6Ñ"Ô"Ð"Ð"Ð"øð 	×Ò˜ZÑ(Ô(Ð(àð 	'ð 	'ˆGØ×Ò˜gÑ&Ô&Ð&Ð&à×Ò˜6Ñ"Ô"Ð"Ð"øøøs   Á
A,C< Ã<AEc               #   óÎ  K  — t          j        t          ¦  «        } t          ¦   «         }	 g }| j        dd…         D ],}|                      |¦  «         |                     |¦  «         Œ-|                      |¦  «         |V — |                      |¦  «         |D ]}|                      |¦  «         ŒdS # |                      |¦  «         |D ]}|                      |¦  «         Œw xY w)zèContext manager to suppress logging all logs temporarily.

    For example::

        >>> with suppress_logging():
        >>>     logger.warning('Warning message!')  # suppressed
        >>>     some_long_process()
        >>>
    N)r   r5   r6   r�   r“   r”   r•   r–   r—   s       r   Úsuppress_loggingrœ   Ý   s  è è € õ Ô�yÑ)Ô)€FÝ‘”€Jð'ØˆØ” q q qÔ)ð 	%ð 	%ˆGØ× Ò  Ñ)Ô)Ð)Ø�OŠO˜GÑ$Ô$Ð$Ð$à×Ò˜*Ñ%Ô%Ð%ØÐÐÐà×Ò˜ZÑ(Ô(Ð(àð 	'ð 	'ˆGØ×Ò˜gÑ&Ô&Ð&Ð&ð	'ð 	'øð 	×Ò˜ZÑ(Ô(Ð(àð 	'ð 	'ˆGØ×Ò˜gÑ&Ô&Ð&Ð&ð	'øøøs   «AB3 Â31C$c               #   óð   K  — t          j        t          ¦  «        } 	 t          ¦   «         5 }|V — ddd¦  «         n# 1 swxY w Y   |                     | ¦  «         dS # |                     | ¦  «         w xY w)a$  Context manager to postpone logging all logs temporarily.

    For example::

        >>> with pending_logging():
        >>>     logger.warning('Warning message!')  # not flushed yet
        >>>     some_long_process()
        >>>
        Warning message!  # the warning is flushed here
    N)r   r5   r6   rœ   r‹   )r8   r˜   s     r   Úpending_loggingrž   ú   s½   è è € õ Ô�yÑ)Ô)€Fð#ÝÑÔð 	 :ØÐÐÐð	ð 	ð 	ñ 	ô 	ð 	ð 	ð 	ð 	ð 	ð 	øøøð 	ð 	ð 	ð 	ð 	×Ò˜6Ñ"Ô"Ð"Ð"Ð"øˆ
×Ò˜6Ñ"Ô"Ð"Ð"øøøs+   �A «<°A ¼A Á A ÁA ÁA ÁA5TÚskip©NNNc              #   óF  K  — t          j        t          ¦  «        }| du rdV — dS 	 t          ¦   «         }|j        D ]}|j                             d|¦  «         ŒdV — |j        D ]}|                     |¦  «         ŒdS # |j        D ]}|                     |¦  «         Œw xY w)z9Context manager to skip WarningIsErrorFilter temporarily.FNr   )r   r5   r6   ÚDisableWarningIsErrorFilterr“   ÚfiltersÚinsertÚremoveFilter)rŸ   r8   Údisablerr™   s       r   Úskip_warningiserrorr§     s×   è è € õ Ô�yÑ)Ô)€Fàˆu€}€}Øˆˆˆˆˆð		/Ý2Ñ4Ô4ˆHØ!œ?ð 4ð 4�ð ”×&Ò& q¨(Ñ3Ô3Ð3Ð3ØˆEˆEˆEà!œ?ð /ð /�Ø×$Ò$ XÑ.Ô.Ð.Ð.ð/ð /ø˜6œ?ð /ð /�Ø×$Ò$ XÑ.Ô.Ð.Ð.ð/øøøs   §7A? Á?!B rI   c              #   óà  K  — t          j        t          ¦  «        }d}|j        D ]}t	          |t
          ¦  «        r|} nŒdV — dS d}|j        D ]}t	          |t          ¦  «        r|} nŒ|r(	 |j        }| |_        dV — ||_        dS # ||_        w xY wt          | ¦  «        }	 | 	                    |¦  «         dV — | 
                    |¦  «         dS # | 
                    |¦  «         w xY w)zþContext manager to prepend prefix to all warning log records temporarily.

    For example::

        >>> with prefixed_warnings("prefix:"):
        >>>     logger.warning('Warning message!')  # => prefix: Warning message!

    .. versionadded:: 2.0
    N)r   r5   r6   r“   r@   rw   r£   ÚMessagePrefixFilterrI   Ú	addFilterr¥   )rI   r8   Úwarning_handlerr™   Úprefix_filterÚ_filterÚpreviouss          r   Úprefixed_warningsr¯   "  sH  è è € õ Ô�yÑ)Ô)€FØ€OØ”?ð ð ˆÝ�gÕ3Ñ4Ô4ð 	Ø%ˆOØˆEð	ð
 	ˆˆˆØˆà€MØ"Ô*ð ð ˆÝ�gÕ2Ñ3Ô3ð 	Ø#ˆMØˆEð	ð ð 8ð	,Ø$Ô+ˆHØ#)ˆMÔ ØˆEˆEˆEà#+ˆMÔ Ð Ð ø 8ˆMÔ Ð+Ð+Ð+Ð+õ ,¨FÑ3Ô3ˆð	8Ø×%Ò% mÑ4Ô4Ð4ØˆEˆEˆEà×(Ò(¨Ñ7Ô7Ð7Ð7Ð7øˆO×(Ò(¨Ñ7Ô7Ð7Ð7øøøs   Á/B
 Â
	BÂ&C ÃC-c                   ó>   — e Zd Zdd„Zeded         fd„¦   «         ZdS )ÚLogCollectorr1   Nc                 ó   — g | _         d S r   )Úlogsr[   s    r   r…   zLogCollector.__init__Q  s   € Ø-/ˆŒ	ˆ	ˆ	r   r    c              #   ó’   K  — t          ¦   «         5 }d V — |                     ¦   «         | _        d d d ¦  «         d S # 1 swxY w Y   d S r   )rž   r�   r³   )rJ   r˜   s     r   ÚcollectzLogCollector.collectT  s�   è è € åÑÔð 	+ *ØˆEˆEˆEà"×(Ò(Ñ*Ô*ˆDŒIð	+ð 	+ð 	+ñ 	+ô 	+ð 	+ð 	+ð 	+ð 	+ð 	+ð 	+ð 	+øøøð 	+ð 	+ð 	+ð 	+ð 	+ð 	+s   ‘<¼A ÁA rŽ   )rM   rN   rO   r…   r   r	   rµ   r   r   r   r±   r±   P  sU   € € € € € ð0ð 0ð 0ð 0ð ð+˜Ð#3Ô4ð +ð +ð +ñ „^ð+ð +ð +r   r±   c                   ó,   — e Zd ZdZdej        defd„ZdS )Ú
InfoFilterz"Filter error and warning messages.rq   r1   c                 ó4   — |j         t          j        k     rdS dS )NTF)rZ   r   r   rt   s     r   ÚfilterzInfoFilter.filter_  s   € ØŒ>�GœOÒ+Ð+Ø�4à�5r   N©rM   rN   rO   rP   r   ru   r�   r¹   r   r   r   r·   r·   \  s?   € € € € € Ø,Ð,ð˜WÔ.ð °4ð ð ð ð ð ð r   r·   r^   r_   Úsuppress_warningsc                 ó|   — | €dS |D ]4}d|v r|                      dd¦  «        \  }}n|d}}|| k    r
|d|dfv r dS Œ5dS )z/Check whether the warning is suppressed or not.NFr4   r)   Ú*T)Úsplit)r^   r_   r»   Úwarning_typeÚtargetÚ	subtargets         r   Úis_suppressed_warningrÂ   f  st   € à€|Øˆuð *ð ð ˆØ�,ÐÐØ ,× 2Ò 2°3¸Ñ :Ô :ÑˆF�I�Ià ,¨d�IˆFà�TŠ>ˆ>˜i¨D°'¸3Ð+?Ð?Ð?Ø�4�4øàˆ5r   c                   ó>   ‡ — e Zd ZdZd	ˆ fd„Zdej        defd„Zˆ xZ	S )
ÚWarningSuppressorz#Filter logs by `suppress_warnings`.Úappr   r1   Nc                 óV   •— || _         t          ¦   «                              ¦   «          d S r   ©rÅ   rH   r…   ©rJ   rÅ   rL   s     €r   r…   zWarningSuppressor.__init__|  ó&   ø€ ØˆŒÝ‰Œ×ÒÑÔÐÐÐr   rq   c                 óä   — t          |dd¦  «        }t          |dd¦  «        }	 | j        j        j        }n# t          $ r g }Y nw xY wt          |||¦  «        rdS | j        xj        dz  c_        dS )Nr^   rF   r_   Fr)   T)r?   rÅ   Úconfigr»   ÚAttributeErrorrÂ   Ú
_warncount)rJ   rq   r^   r_   r»   s        r   r¹   zWarningSuppressor.filter€  s—   € Ý�v˜v rÑ*Ô*ˆÝ˜& )¨RÑ0Ô0ˆð	#Ø $¤¤Ô AÐÐøÝð 	#ð 	#ð 	#à "ÐÐÐð	#øøøõ !  wÐ0AÑBÔBð 	Ø�5àŒHÐÔ 1Ñ$ÐÔØ�4s   ¤6 ¶AÁA©rÅ   r   r1   N©
rM   rN   rO   rP   r…   r   ru   r�   r¹   rS   rT   s   @r   rÄ   rÄ   y  sh   ø€ € € € € Ø-Ð-ðð ð ð ð ð ð˜WÔ.ð °4ð ð ð ð ð ð ð ð r   rÄ   c                   ó>   ‡ — e Zd ZdZd	ˆ fd„Zdej        defd„Zˆ xZ	S )
ÚWarningIsErrorFilterz#Raise exception if warning emitted.rÅ   r   r1   Nc                 óV   •— || _         t          ¦   «                              ¦   «          d S r   rÇ   rÈ   s     €r   r…   zWarningIsErrorFilter.__init__”  rÉ   r   rq   c                 óZ  — t          |dd¦  «        rdS | j        j        r‹t          |dd¦  «        }	 |j        |j        z  }n# t
          t          f$ r
 |j        }Y nw xY w|r#t          |dz   t          |¦  «        z   ¦  «        }nt          |¦  «        }|j	        �||j	        d         ‚|‚dS )NÚskip_warningsiserrorFTr;   rF   ú:r)   )
r?   rÅ   Úwarningiserrorr=   r>   Ú	TypeErrorÚ
ValueErrorr   rR   Úexc_info)rJ   rq   r;   rK   Úexcs        r   r¹   zWarningIsErrorFilter.filter˜  sÐ   € Ý�6Ð1°5Ñ9Ô9ð 	à�4ØŒXÔ$ð 	Ý˜v z°2Ñ6Ô6ˆHð%Ø œ* v¤{Ñ2��øÝ�zÐ*ð %ð %ð %Ø œ*���ð%øøøð ð -Ý# H¨s¡NµS¸±\´\Ñ$AÑBÔB��å# GÑ,Ô,�ØŒÐ*Ø˜vœ¨qÔ1Ð1à�	à�4s   ²A ÁAÁArÎ   rÏ   rT   s   @r   rÑ   rÑ   ‘  sh   ø€ € € € € Ø-Ð-ðð ð ð ð ð ð˜WÔ.ð °4ð ð ð ð ð ð ð ð r   rÑ   c                   ó,   — e Zd ZdZdej        defd„ZdS )r¢   z6Disable WarningIsErrorFilter if this filter installed.rq   r1   c                 ó   — d|_         dS )NT)rÔ   rt   s     r   r¹   z"DisableWarningIsErrorFilter.filter²  s   € Ø&*ˆÔ#Øˆtr   Nrº   r   r   r   r¢   r¢   ¯  s?   € € € € € Ø@Ð@ð˜WÔ.ð °4ð ð ð ð ð ð r   r¢   c                   óF   ‡ — e Zd ZdZdeddfˆ fd„Zdej        defd„Z	ˆ xZ
S )r©   z"Prepend prefix to all log records.rI   r1   Nc                 óV   •— || _         t          ¦   «                              ¦   «          d S r   )rI   rH   r…   )rJ   rI   rL   s     €r   r…   zMessagePrefixFilter.__init__º  s&   ø€ ØˆŒÝ‰Œ×ÒÑÔÐÐÐr   rq   c                 óB   — | j         r| j         dz   |j        z   |_        dS )Nú T)rI   r=   rt   s     r   r¹   zMessagePrefixFilter.filter¾  s&   € ØŒ;ð 	8Øœ sÑ*¨V¬ZÑ7ˆFŒJØˆtr   ©rM   rN   rO   rP   rR   r…   r   ru   r�   r¹   rS   rT   s   @r   r©   r©   ·  sv   ø€ € € € € Ø,Ð,ð˜sð  tð ð ð ð ð ð ð˜WÔ.ð °4ð ð ð ð ð ð ð ð r   r©   c                   óH   ‡ — e Zd ZdZd	deddfˆ fd„Zdej        defd„Z	ˆ xZ
S )
Ú
OnceFilterzShow the message only once.rF   r0   r1   Nc                 óX   •— t          ¦   «                              |¦  «         i | _        d S r   )rH   r…   Úmessages)rJ   r0   rL   s     €r   r…   zOnceFilter.__init__Ç  s&   ø€ Ý‰Œ×Ò˜ÑÔÐØ)+ˆŒˆˆr   rq   c                 óº   — t          |dd¦  «        }|sdS | j                             |j        g ¦  «        }|j        |v rdS |                     |j        ¦  «         dS )Nrb   rF   TF)r?   rå   rl   r=   r>   r•   )rJ   rq   rb   Úparamss       r   r¹   zOnceFilter.filterË  sd   € Ý�v˜v rÑ*Ô*ˆØð 	Ø�4à”]×-Ò-¨f¬j¸"Ñ=Ô=ˆFØŒ{˜fÐ$Ð$Ø�uà�MŠM˜&œ+Ñ&Ô&Ð&Ø�4r   )rF   rá   rT   s   @r   rã   rã   Ä  s{   ø€ € € € € Ø%Ð%ð,ð ,˜Sð ,¨$ð ,ð ,ð ,ð ,ð ,ð ,ð
˜WÔ.ð 
°4ð 
ð 
ð 
ð 
ð 
ð 
ð 
ð 
r   rã   c                   óV   ‡ — e Zd ZU dZeej                 ed<   d
ˆ fd„Zde	de
fd	„Zˆ xZS )ÚSphinxLogRecordTranslatorz‚Converts a log record to one Sphinx expects

    * Make a instance of SphinxLogRecord
    * docname to path if location given
    ÚLogRecordClassrÅ   r   r1   Nc                 óV   •— || _         t          ¦   «                              ¦   «          d S r   rÇ   rÈ   s     €r   r…   z"SphinxLogRecordTranslator.__init__à  rÉ   r   rq   c                 ó   — t          |t          j        ¦  «        r| j        |_        t          |dd ¦  «        }t          |t          ¦  «        re|\  }}|r,|r*| j        j         	                    |¦  «        ›d|›�|_
        nŽ|r(d| j        j         	                    |¦  «        z  |_
        ndd |_
        n\t          |t          j        ¦  «        rt          |¦  «        |_
        n-|r+d|vr'd| j        j         	                    |¦  «        z  |_
        dS )Nr;   rÕ   z%sT)r@   r   ru   rê   rL   r?   ÚtuplerÅ   ÚenvÚdoc2pathr;   r   r   rA   )rJ   rq   r;   ÚdocnameÚlinenos        r   r¹   z SphinxLogRecordTranslator.filterä  s  € Ý�f�gÔ/Ñ0Ô0ð 	3à#Ô2ˆFÔå˜6 :¨tÑ4Ô4ˆÝ�h¥Ñ&Ô&ð 	EØ&‰OˆG�VØð '˜6ð 'Ø-1¬X¬\×-BÒ-BÀ7Ñ-KÔ-KÐ-KÐ-KÈVÈVÐ"T�”�Øð 'Ø"&¨¬¬×)>Ò)>¸wÑ)GÔ)GÑ"G�”�à"&�”�Ý˜¥%¤*Ñ-Ô-ð 	EÝ/°Ñ9Ô9ˆFŒOˆOØð 	E˜# XÐ-Ð-Ø" T¤X¤\×%:Ò%:¸8Ñ%DÔ%DÑDˆFŒOàˆtr   rÎ   )rM   rN   rO   rP   r   r   ru   rQ   r…   rX   r�   r¹   rS   rT   s   @r   ré   ré   Ø  s‚   ø€ € € € € € ðð ð
 ˜Ô*Ô+Ð+Ð+Ñ+ðð ð ð ð ð ðÐ3ð ¸ð ð ð ð ð ð ð ð r   ré   c                   ó   — e Zd ZdZeZdS )ÚInfoLogRecordTranslatorz/LogRecordTranslator for INFO level log records.N)rM   rN   rO   rP   rV   rê   r   r   r   ró   ró   ú  s   € € € € € Ø9Ð9Ø(€N€N€Nr   ró   c                   ó   — e Zd ZdZeZdS )ÚWarningLogRecordTranslatorz2LogRecordTranslator for WARNING level log records.N)rM   rN   rO   rP   rX   rê   r   r   r   rõ   rõ   ÿ  s   € € € € € Ø<Ð<Ø+€N€N€Nr   rõ   Únodec                 ó~   — t          | ¦  «        \  }}|rt          |¦  «        }|r	|r|›d|›�S |rd|z  S |rd|z  S d S )NrÕ   z%s:z<unknown>:%s)r   r   )rö   ÚsourceÚlines      r   rA   rA     sp   € Ý$ TÑ*Ô*�N€VˆTØð !Ý˜‘”ˆØð �$ð Ø ˜&˜& $ $Ð'Ð'Ø	ð Ø�v‰~ÐØ	ð Ø Ñ$Ð$àˆtr   c                   ó2   ‡ — e Zd Zdej        defˆ fd„Zˆ xZS )ÚColorizeFormatterrq   r1   c                 óÒ   •— t          ¦   «                              |¦  «        }t          |dd ¦  «        }|€t                               |j        ¦  «        }|rt          ||¦  «        S |S )Nra   )rH   Úformatr?   Ú	COLOR_MAPÚgetrZ   r   )rJ   rq   rK   ra   rL   s       €r   rý   zColorizeFormatter.format  s^   ø€ Ý‘'”'—.’. Ñ(Ô(ˆÝ˜ ¨Ñ.Ô.ˆØˆ=Ý—M’M &¤.Ñ1Ô1ˆEàð 	Ý˜E 7Ñ+Ô+Ð+àˆNr   )rM   rN   rO   r   ru   rR   rý   rS   rT   s   @r   rû   rû     sN   ø€ € € € € ð	˜WÔ.ð 	°3ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	r   rû   c                   ó:   — e Zd ZdZdeddfd„Zdeddfd„Zd	d„ZdS )
ÚSafeEncodingWriterz7Stream writer which ignores UnicodeEncodeError silentlyÚstreamr1   Nc                 óD   — || _         t          |dd¦  «        pd| _        d S )NÚencodingÚascii)r  r?   r  )rJ   r  s     r   r…   zSafeEncodingWriter.__init__!  s%   € ØˆŒÝ ¨
°GÑ<Ô<ÐGÀˆŒˆˆr   Údatac                 óô   — 	 | j                              |¦  «         d S # t          $ rO | j                              |                     | j        d¦  «                             | j        ¦  «        ¦  «         Y d S w xY w)NÚreplace)r  ÚwriteÚUnicodeEncodeErrorÚencoder  Údecode©rJ   r  s     r   r	  zSafeEncodingWriter.write%  s„   € ð	[ØŒK×Ò˜dÑ#Ô#Ð#Ð#Ð#øÝ!ð 	[ð 	[ð 	[ð ŒK×Ò˜dŸkšk¨$¬-¸ÑCÔC×JÒJÈ4Ì=ÑYÔYÑZÔZÐZÐZÐZÐZð	[øøøs   ‚ žAA7Á6A7c                 óf   — t          | j        d¦  «        r| j                             ¦   «          d S d S )Nr‰   )Úhasattrr  r‰   r[   s    r   r‰   zSafeEncodingWriter.flush-  s:   € Ý�4”; Ñ(Ô(ð 	 ØŒK×ÒÑÔÐÐÐð	 ð 	 r   rŽ   )	rM   rN   rO   rP   r   r…   rR   r	  r‰   r   r   r   r  r    s~   € € € € € ØAÐAðH˜rð H dð Hð Hð Hð Hð[˜#ð [ $ð [ð [ð [ð [ð ð  ð  ð  ð  ð  r   r  c                   ó6   — e Zd ZdZdddeddfd„Zdeddfd	„ZdS )
ÚLastMessagesWriterzBStream writer storing last 10 messages in memory to save trackbackrÅ   r   r  r1   Nc                 ó   — || _         d S r   )rÅ   )rJ   rÅ   r  s      r   r…   zLastMessagesWriter.__init__4  s   € ØˆŒˆˆr   r  c                 óD   — | j         j                             |¦  «         d S r   )rÅ   Ú
messagelogr•   r  s     r   r	  zLastMessagesWriter.write7  s!   € ØŒÔ×"Ò" 4Ñ(Ô(Ð(Ð(Ð(r   )rM   rN   rO   rP   r   r…   rR   r	  r   r   r   r  r  2  se   € € € € € ØLÐLð˜Hð ¨bð °Tð ð ð ð ð)˜#ð ) $ð )ð )ð )ð )ð )ð )r   r  rÅ   r   ÚstatusÚwarningc                 ór  — t          j        t          ¦  «        }|                     t           j        ¦  «         d|_        |j        dd…         D ]}|                     |¦  «         Œt          t          |¦  «        ¦  «        }| 
                    t          ¦   «         ¦  «         | 
                    t          | ¦  «        ¦  «         |                     t          | j                 ¦  «         |                     t!          ¦   «         ¦  «         t#          t          |¦  «        ¦  «        }| 
                    t%          | ¦  «        ¦  «         | 
                    t'          | ¦  «        ¦  «         | 
                    t)          | ¦  «        ¦  «         | 
                    t+          ¦   «         ¦  «         |                     t           j        ¦  «         |                     t!          ¦   «         ¦  «         t          j        t1          | |¦  «        ¦  «        }| 
                    t          ¦   «         ¦  «         |                     t          | j                 ¦  «         |                     t!          ¦   «         ¦  «         |                     |¦  «         |                     |¦  «         |                     |¦  «         dS )zSetup root logger for SphinxFN)r   r5   r6   r’   r&   Ú	propagater“   r”   ry   r  rª   r·   ró   r(   Ú	verbosityÚsetFormatterrû   rw   rÄ   rõ   rÑ   rã   r   ÚStreamHandlerr  r–   )rÅ   r  r  r8   r™   Úinfo_handlerr«   Úmessagelog_handlers           r   Úsetupr  ;  sE  € åÔ�yÑ)Ô)€FØ
‡O‚O•G”MÑ"Ô"Ð"Ø€FÔð ”? 1 1 1Ô%ð &ð &ˆØ×Ò˜WÑ%Ô%Ð%Ð%å'Õ(:¸6Ñ(BÔ(BÑCÔC€LØ×Ò�:™<œ<Ñ(Ô(Ð(Ø×ÒÕ2°3Ñ7Ô7Ñ8Ô8Ð8Ø×Ò�-¨¬Ô6Ñ7Ô7Ð7Ø×ÒÕ/Ñ1Ô1Ñ2Ô2Ð2å*Õ+=¸gÑ+FÔ+FÑGÔG€OØ×ÒÕ/°Ñ4Ô4Ñ5Ô5Ð5Ø×ÒÕ8¸Ñ=Ô=Ñ>Ô>Ð>Ø×ÒÕ2°3Ñ7Ô7Ñ8Ô8Ð8Ø×Ò�j™lœlÑ+Ô+Ð+Ø×Ò�Wœ_Ñ-Ô-Ð-Ø× Ò Õ!2Ñ!4Ô!4Ñ5Ô5Ð5å Ô.Õ/AÀ#ÀvÑ/NÔ/NÑOÔOÐØ× Ò ¥¡¤Ñ.Ô.Ð.Ø×Ò¥¨c¬mÔ <Ñ=Ô=Ð=Ø×#Ò#Õ$5Ñ$7Ô$7Ñ8Ô8Ð8à
×Ò�lÑ#Ô#Ð#Ø
×Ò�oÑ&Ô&Ð&Ø
×ÒÐ(Ñ)Ô)Ð)Ð)Ð)r   )T)UrP   r   Úlogging.handlersÚcollectionsr   Ú
contextlibr   Útypingr   r   r   r   r	   r
   r   r   r   r   Údocutilsr   Údocutils.nodesr   Údocutils.utilsr   Úsphinx.errorsr   Úsphinx.util.consoler   Úsphinx.util.osutilr   Úsphinx.applicationr   r6   r%   r    rR   rf   rQ   Úupdater!   r#   r   r$   r&   r(   rþ   r5   ru   rC   rE   rV   rX   ÚLoggerAdapterr2   r  rw   ry   r“   ÚBufferingHandlerr�   ÚHandlerrš   rœ   rž   r�   r§   r¯   r±   ÚFilterr·   rÂ   rÄ   rÑ   r¢   r©   rã   ré   ró   rõ   rA   Ú	Formatterrû   r  r  r  r   r   r   ú<module>r0     se  ðØ +Ð +Ð +à €€€Ø Ð Ð Ð Ø #Ð #Ð #Ð #Ð #Ð #Ø %Ð %Ð %Ð %Ð %Ð %Ø ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^Ð ^à Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø *Ð *Ð *Ð *Ð *Ð *à 'Ð 'Ð 'Ð 'Ð 'Ð 'Ø (Ð (Ð (Ð (Ð (Ð (Ø &Ð &Ð &Ð &Ð &Ð &àð *Ø)Ð)Ð)Ð)Ð)Ð)ð €	Ø
€à)˜kÐ*AÐ*AÑBÔB€ˆT�#�s�(Œ^Ð BÐ BÑ BØ × Ò ØÔ ØÔØŒ]ØŒØŒLØØŒ]ðð ñ ô ð ð !, ¨I¨IÑ 6Ô 6€ˆt�C˜�HŒ~Ð 6Ð 6Ñ 6Ø × Ò Ø„|ØØ„}ðð ñ ô ð ð ˆK˜˜à#œM¨9Ø#œO¨UØ#œM¨:ðñô €	ð+�Cð +Ð1ð +ð +ð +ð +ð,	5 $ wÔ'8Ô"9ð 	5¸dð 	5ð 	5ð 	5ð 	5ðð ð ð ð �gÔ'ñ ô ð ð ð ð ð ð ˜/ñ ô ð ð
	ð 	ð 	ð 	ð 	˜_ñ 	ô 	ð 	ð#ð #ð #ð #ð #˜'Ô/ñ #ô #ð #ð4	ð 	ð 	ð 	ð 	˜7Ô0ñ 	ô 	ð 	ð
ð ð ð ð ˜7Ô0ñ ô ð ðð ð ð ð �GÔ$Ô5ñ ô ð ð< ð#˜) G¤O°T¸4Ð$?Ô@ð #ð #ð #ñ „ð#ð6 ð'˜) M°4¸Ð$=Ô>ð 'ð 'ð 'ñ „ð'ð8 ð#˜ =°$¸Ð#<Ô=ð #ð #ð #ñ „ð#ð& ð/ð /˜dð /¨iÐ8HÔ.Ið /ð /ð /ñ „ð/ð& ð*8˜cð *8 iÐ0@Ô&Að *8ð *8ð *8ñ „ð*8ðZ	+ð 	+ð 	+ð 	+ð 	+ñ 	+ô 	+ð 	+ðð ð ð ð �”ñ ô ð ð ð ¨cð ÀdÈ3Äið ÐTXð ð ð ð ð&ð ð ð ð ˜œñ ô ð ð0ð ð ð ð ˜7œ>ñ ô ð ð<ð ð ð ð  '¤.ñ ô ð ð
ð 
ð 
ð 
ð 
˜'œ.ñ 
ô 
ð 
ðð ð ð ð �”ñ ô ð ð(ð ð ð ð  ¤ñ ô ð ðD)ð )ð )ð )ð )Ð7ñ )ô )ð )ð
,ð ,ð ,ð ,ð ,Ð!:ñ ,ô ,ð ,ð
˜Dð  X¨c¤]ð ð ð ð ð
ð 
ð 
ð 
ð 
˜Ô)ñ 
ô 
ð 
ð ð  ð  ð  ð  ñ  ô  ð  ð&)ð )ð )ð )ð )ñ )ô )ð )ð*ˆxð * ð *¨bð *°Tð *ð *ð *ð *ð *ð *r   