| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/util/__pycache__/ |
Upload File : |
a
�ab�G �
@ s� U d Z ddlZddlZddlmZ ddlmZ ddlmZm Z m
Z
m Z m Z m
Z
mZmZmZmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ e r�dd l m Z d Z d
Z edd� �Z e e!e"f e#d< e �$ej%ej%ej&ej'ej(e ej)d�� edd� �Z*e e"e"f e#d< e*�$ej(e ej)d�� edd� ej&dej'dej)di�Z+e!dd�dd �Z,e
ej- dd �d d �Z.G d d!� d!ej-�Z/G d"d#� d#e/�Z0G d$d%� d%e/�Z1G d&d� dej2�Z3G d'd(� d(ej4�Z5G d)d*� d*ej4�Z6G d+d,� d,ej7j8�Z9ee ej:ddf d-�d.d/��Z;ee e9ddf d-�d0d1��Z<ee e9ddf d-�d2d3��Z=ed`e>e d5 d6�d7d8��Z?ee!e d5 d9�d:d;��Z@G d<d=� d=�ZAG d>d?� d?ejB�ZCe!e!e
e! e>d@�dAdB�ZDG dCdD� dDejB�ZEG dEdF� dFejB�ZFG dGdH� dHejB�ZGG dIdJ� dJejB�ZHG dKdL� dLejB�ZIG dMdN� dNejB�ZJG dOdP� dPeJ�ZKG dQdR� dReJ�ZLeee! dS�dTdU�ZMG dVdW� dWejN�ZOG dXdY� dY�ZPG dZd[� d[�ZQd\eedd]�d^d_�ZRdS )az�
sphinx.util.logging
~~~~~~~~~~~~~~~~~~~
Logging utility functions for Sphinx.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)� defaultdict)�contextmanager)
�IO�
TYPE_CHECKING�Any�Dict� Generator�List�Optional�Tuple�Type�Union)�nodes)�Node��get_source_line)�
SphinxWarning)�colorize)�SphinxZsphinx� c C s t jS �N)�logging�WARNING� r r �7/usr/lib/python3.9/site-packages/sphinx/util/logging.py�<lambda> � r � LEVEL_NAMES)�CRITICALZSEVERE�ERRORr �INFO�VERBOSE�DEBUGc C s dS )Nr r r r r r r * r �
VERBOSITY_MAP)r � � c C s dS )NZbluer r r r r r 1 r ZdarkredZredZdarkgray�SphinxLoggerAdapter��name�returnc C s" t �td | �}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� NAMESPACEZdisabledr& )r( �loggerr r r r+ 9 s r+ )�recordsr) c C s@ | D ]6}|� � |_d|_t|dd�}t|tj�rt|�|_qdS )z Convert LogRecord serializable.r �locationN) �
getMessage�msg�args�getattr�
isinstancer r �get_node_locationr/ )r. �rr/ r r r �convert_serializableO s
r7 c s8 e Zd ZU dZdZdZeed< ed�� fdd� Z � Z
S )�SphinxLogRecordz$Log record class supporting location� Nr/ �r) c sD t � �� }t| dd �}|r,d|| j|f }n| j|vr@| j| }|S )Nr/ z%s: %s%s)�superr0 r3 �prefix)�self�messager/ �� __class__r r r0 ` s
zSphinxLogRecord.getMessage) �__name__�
__module__� __qualname__�__doc__r< r/ r �__annotations__�strr0 �
__classcell__r r r? r r8 [ s
r8 c @ s e Zd ZdZdZdS )�SphinxInfoLogRecordz)Info log record class supporting locationr9 N)rA rB rC rD r< r r r r rH k s rH c @ s" e Zd ZdZeed�dd��ZdS )�SphinxWarningLogRecordz,Warning log record class supporting locationr: c C s( | j tjkrdS | j tjkr dS dS d S )Nz
CRITICAL: zERROR: z WARNING: )�levelnor r r �r= r r r r< r s
z SphinxWarningLogRecord.prefixN)rA rB rC rD �propertyrF r< r r r r rI p s rI c s~ e Zd ZdZg d�Zeeef eeedd�� fdd� Z eeedd�dd �Z
ee e ee f d
�d d �Z
ejdd
�dd�Z� ZS )r& z9LoggerAdapter allowing ``type`` and ``subtype`` keywords.)�type�subtyper/ �nonl�color�onceN)�levelr1 r2 �kwargsr) c sP t |t�r(t� j||g|�R i |�� n$t| }t� j||g|�R i |�� d S r )r4 �intr; �logr )r= rR r1 r2 rS rJ r? r r rU � s
zSphinxLoggerAdapter.log)r1 r2 rS r) c O s | j t|g|�R i |�� d S r )rU r! )r= r1 r2 rS r r r �verbose� s zSphinxLoggerAdapter.verbose)r1 rS r) c C s6 |� di �}| jD ]}||v r|�|�||< q||fS )N�extra)�
setdefault�KEYWORDS�pop)r= r1 rS rW �keywordr r r �process� s
zSphinxLoggerAdapter.process��recordr) c C s | j �|� d S r )r- �handle�r= r^ r r r r_ � s zSphinxLoggerAdapter.handle)rA rB rC rD rY r
rT rF r rU rV r r r\ r � LogRecordr_ rG r r r? r r& | s "c @ s e Zd ZdZdS )�WarningStreamHandlerzStreamHandler for warnings.N)rA rB rC rD r r r r rb � s rb c s* e Zd ZdZejdd�� fdd� Z� ZS )�NewLineStreamHandlerzAStreamHandler which switches line terminator by record.nonl flag.Nr] c sN z8| � � t|dd�r d| _t� �|� W d| _| �� nd| _| �� 0 d S )NrO Fr9 �
)�acquirer3 �
terminatorr; �emit�releaser` r? r r rg � s
�zNewLineStreamHandler.emit)rA rB rC rD r ra rg rG r r r? r rc � s rc c s| e Zd ZU dZeej ed< dd�� fdd� Zeje d�dd �Z
dd�d
d �Z ej dd �d
d�Z
eej d�dd�Z� ZS )�
MemoryHandlerzHandler buffering all logs.�bufferNr: c s t � �d� d S )N���)r; �__init__rK r? r r rl � s zMemoryHandler.__init__r] c C s dS )NFr r` r r r � shouldFlush� s zMemoryHandler.shouldFlushc C s d S r r rK r r r �flush� s zMemoryHandler.flush)r- r) c C s@ | � � z(| jD ]}|�|� qg | _W | �� n
| �� 0 d S r )re rj r_ rh )r= r- r^ r r r �flushTo� s
zMemoryHandler.flushToc C s | j g }| _ |S r )rj )r= rj r r r �clear� s zMemoryHandler.clear)rA rB rC rD r r ra rE rl �boolrm rn ZLoggerro rp rG r r r? r ri � s
ri r: c
c s� t �t�} t� }|�t j� zrg }| jdd� D ]"}t|t�r0| � |� |�
|� q0| � |� |V W | � |� |D ]}| � |� qt|� | � n*| � |� |D ]}| � |� q�|� | � 0 dS )zgContext manager to postpone logging warnings temporarily.
Similar to :func:`pending_logging`.
N)
r r+ r, ri �setLevelr �handlersr4 rb �
removeHandler�append�
addHandlerro �r- �
memhandlerrs �handlerr r r �pending_warnings� s&
�
rz c
c s� t �t�} t� }z^g }| jdd� D ]}| �|� |�|� q$| �|� |V W | �|� |D ]}| �|� q^n | �|� |D ]}| �|� q~0 dS )z�Context manager to suppress logging all logs temporarily.
For example::
>>> with suppress_logging():
>>> logger.warning('Warning message!') # suppressed
>>> some_long_process()
>>>
N)r r+ r, ri rs rt ru rv rw r r r �suppress_logging� s
�
r{ c c sV t �t�} z:t� �}|V W d � n1 s.0 Y W |�| � n |�| � 0 dS )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 r+ r, r{ ro )r- rx r r r �pending_logging s
&r| T�NNN)�skipr) c
c sx t �t�}| du rdV nZz@t� }|jD ]}|j�d|� q(dV W |jD ]}|�|� qJn|jD ]}|�|� qb0 dS )z9Context manager to skip WarningIsErrorFilter temporarily.FNr )r r+ r, �DisableWarningIsErrorFilterrs �filters�insert� removeFilter)r~ r- Zdisablerry r r r �skip_warningiserror s
�
r� �r< r) c c s� t �t�}d}|jD ]}t|t�r|} q6qdV dS d}|jD ]}t|t�r@|} qXq@|r�z |j}| |_dV W ||_q�||_0 n4t| �}z |� |� dV W |�
|� n |�
|� 0 dS )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 r+ r, rs r4 rb r� �MessagePrefixFilterr< � addFilterr� )r< r- �warning_handlerry Z
prefix_filter�_filterZpreviousr r r �prefixed_warnings) s0
r� c @ s0 e Zd Zdd�dd�Zeed d�dd��ZdS )� LogCollectorNr: c C s
g | _ d S r )�logsrK r r r rl X s zLogCollector.__init__r} c c s: t � � }d V |�� | _W d � n1 s,0 Y d S r )r| rp r� )r= rx r r r �collect[ s zLogCollector.collect)rA rB rC rl r r r� r r r r r� W s r� c @ s" e Zd ZdZejed�dd�ZdS )�
InfoFilterz"Filter error and warning messages.r] c C s |j tjk rdS dS d S )NTF)rJ r r r` r r r �filterf s zInfoFilter.filterN�rA rB rC rD r ra rq r� r r r r r� c s r� )rM rN �suppress_warningsr) c C sZ | du r dS |D ]D}d|v r.|� dd�\}}n
|d }}|| kr|d|dfv r dS qdS )z/Check whether the warning is suppressed or not.NFr* r$ �*T)�split)rM rN r� Z warning_type�targetZ subtargetr r r �is_suppressed_warningm s
r� c s: e Zd ZdZddd�� fdd� Zejed�dd �Z� Z S )
�WarningSuppressorz#Filter logs by `suppress_warnings`.r N��appr) c s || _ t� �� d S r �r� r; rl �r= r� r? r r rl � s zWarningSuppressor.__init__r] c C sf t |dd �}t |dd �}z| jjj}W n ty< g }Y n0 t|||�rNdS | j jd7 _dS d S )NrM rN Fr$ T)r3 r� Zconfigr� �AttributeErrorr� Z
_warncount)r= r^ rM rN r� r r r r� � s
zWarningSuppressor.filter�
rA rB rC rD rl r ra rq r� rG r r r? r r� � s r� c s: e Zd ZdZddd�� fdd� Zejed�dd �Z� Z S )
�WarningIsErrorFilterz#Raise exception if warning emitted.r Nr� c s || _ t� �� d S r r� r� r? r r rl � s z WarningIsErrorFilter.__init__r] c C s� t |dd�rdS | jjr�t |dd�}z|j|j }W n ttfyP |j}Y n0 |rlt|d t|� �}nt|�}|j d ur�||j d �q�|�ndS d S )N�skip_warningsiserrorFTr/ r9 �:r$ )
r3 r� Zwarningiserrorr1 r2 � TypeError�
ValueErrorr rF �exc_info)r= r^ r/ r> �excr r r r� � s
zWarningIsErrorFilter.filterr� r r r? r r� � s r� c @ s" e Zd ZdZejed�dd�ZdS )r z6Disable WarningIsErrorFilter if this filter installed.r] c C s
d|_ dS )NT)r� r` r r r r� � s z"DisableWarningIsErrorFilter.filterNr� r r r r r � s r c s: e Zd ZdZedd�� fdd� Zejed�dd�Z � Z
S ) r� z"Prepend prefix to all log records.Nr� c s || _ t� �� d S r )r< r; rl )r= r< r? r r rl � s z MessagePrefixFilter.__init__r] c C s | j r| j d |j |_dS )N� T)r< r1 r` r r r r� � s zMessagePrefixFilter.filter� rA rB rC rD rF rl r ra rq r� rG r r r? r r� � s r� c s< e Zd ZdZd
edd�� fdd�
Zejed�dd �Z � Z
S ) �
OnceFilterzShow the message only once.r9 Nr' c s t � �|� i | _d S r )r; rl �messages)r= r( r? r r rl � s zOnceFilter.__init__r] c C sF t |dd�}|sdS | j�|jg �}|j|v r2dS |�|j� dS d S )NrQ r9 TF)r3 r� rX r1 r2 ru )r= r^ rQ �paramsr r r r� � s
zOnceFilter.filter)r9 r� r r r? r r� � s r� c sH e Zd ZU dZeej ed< ddd�� fdd� Ze e
d�d d
�Z � Z S ) �SphinxLogRecordTranslatorz�Converts a log record to one Sphinx expects
* Make a instance of SphinxLogRecord
* docname to path if location given
�LogRecordClassr Nr� c s || _ t� �� d S r r� r� r? r r rl � s z"SphinxLogRecordTranslator.__init__r] c C s� t |tj�r| j|_t|dd �}t |t�rv|\}}|rT|rTd| jj� |�|f |_
q�|rnd| jj� |� |_
q�d |_
n8t |t j �r�t
|�|_
n |r�d|vr�d| jj� |� |_
dS )Nr/ �%s:%sz%sr� T)r4 r ra r� r@ r3 �tupler� �envZdoc2pathr/ r r r5 )r= r^ r/ Zdocname�linenor r r r� � s
z SphinxLogRecordTranslator.filter)
rA rB rC rD r r ra rE rl rI rq r� rG r r r? r r� � s
r� c @ s e Zd ZdZeZdS )�InfoLogRecordTranslatorz/LogRecordTranslator for INFO level log records.N)rA rB rC rD rH r� r r r r r� s r� c @ s e Zd ZdZeZdS )�WarningLogRecordTranslatorz2LogRecordTranslator for WARNING level log records.N)rA rB rC rD rI r� r r r r r� s r� )�noder) c C s@ t | �\}}|r |r d||f S |r,d| S |r8d| S d S d S )Nr� z%s:z <unknown>:%sr )r� �source�liner r r r5 s r5 c s& e Zd Zejed�� fdd� Z� ZS )�ColorizeFormatterr] c sB t � �|�}t|dd �}|d u r,t�|j�}|r:t||�S |S d S )NrP )r; �formatr3 � COLOR_MAP�getrJ r )r= r^ r> rP r? r r r� s
zColorizeFormatter.format)rA rB rC r ra rF r� rG r r r? r r� s r� c @ s> e Zd ZdZedd�dd�Zedd�dd�Zdd �d
d �ZdS ) �SafeEncodingWriterz7Stream writer which ignores UnicodeEncodeError silentlyN)�streamr) c C s || _ t|dd�pd| _d S )N�encoding�ascii)r� r3 r� )r= r� r r r rl & s zSafeEncodingWriter.__init__��datar) c C sF z| j �|� W n0 ty@ | j �|�| jd��| j�� Y n0 d S )N�replace)r� �write�UnicodeEncodeError�encoder� �decode�r= r� r r r r� * s zSafeEncodingWriter.writer: c C s t | jd�r| j�� d S )Nrn )�hasattrr� rn rK r r r rn 2 s zSafeEncodingWriter.flush) rA rB rC rD r rl rF r� rn r r r r r� $ s r� c @ s2 e Zd ZdZdedd�dd�Zedd�dd �ZdS )
�LastMessagesWriterzBStream writer storing last 10 messages in memory to save trackbackr N)r� r� r) c C s
|| _ d S r )r� )r= r� r� r r r rl 9 s zLastMessagesWriter.__init__r� c C s | j j�|� d S r )r� Z
messagelogru r� r r r r� < s zLastMessagesWriter.write)rA rB rC rD r rl rF r� r r r r r� 7 s r� r )r� �status�warningr) c C s0 t �t�}|�t j� d|_|jdd� D ]}|�|� q*tt |��}|�
t � � |�
t | �� |�t
| j � |�t� � tt |��}|�
t| �� |�
t| �� |�
t| �� |�
t� � |�t j� |�t� � t �t| |��}|�
t � � |�t
| j � |�t� � |�|� |�|� |�|� dS )z Setup root logger for SphinxFN)r r+ r, rr r" Z propagaters rt rc r� r� r� r� r# � verbosityZ setFormatterr� rb r� r� r� r� r �
StreamHandlerr� rv )r� r� r� r- ry Z info_handlerr� Zmessagelog_handlerr r r �setup@ s0
r� )T)SrD r Zlogging.handlers� collectionsr �
contextlibr �typingr r r r r r r
r r r
Zdocutilsr Zdocutils.nodesr Zdocutils.utilsr Z
sphinx.errorsr Zsphinx.util.consoler Zsphinx.applicationr r, r! r rF rT rE �updater r r r r" r# r� r+ ra r7 r8 rH rI Z
LoggerAdapterr& r� rb rc rs ZBufferingHandlerri ZHandlerrz r{ r| rq r� r� r� ZFilterr� r� r� r� r r� r� r� r� r� r5 Z Formatterr� r� r� r� r r r r �<module> s�
0 �
��� -
"