a
    •˜ëj¢!  ã                   @  s†  U d Z ddlmZ ddl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	 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ZerªdndZndZdZeddd�Zedeed f Ze d¡Zejejkrøe ej¡ dddœdd„Zeƒ Zde d< ddd œd!d"„Z!d#d#d œd$d%„Z"eej#d&f Z$G d'd„ dƒZ%G d(d&„ d&ƒZ&d/dd)dd*œd+d,„Z'G d-d.„ d.ƒZ(dS )0a”  Logging control and utilities.

Control of logging for SA can be performed from the regular python logging
module.  The regular dotted module namespace is used, starting at
'sqlalchemy'.  For class-level logging, the class name is appended.

The "echo" keyword parameter, available on SQLA :class:`_engine.Engine`
and :class:`_pool.Pool` objects, corresponds to a logger specific to that
instance only.

é    )ÚannotationsN)ÚAny)ÚOptional)Úoverload)ÚSet)ÚType)ÚTypeVar)ÚUnioné   )Úpy311)Úpy38)ÚLiteralTé   FÚ_ITÚ
Identified)ÚboundÚdebugZ
sqlalchemyzlogging.LoggerÚNone)ÚloggerÚreturnc                 C  s*   t  tj¡}| t  d¡¡ |  |¡ d S )Nz.%(asctime)s %(levelname)s %(name)s %(message)s)ÚloggingÚStreamHandlerÚsysÚstdoutÚsetFormatterÚ	FormatterÚ
addHandler)r   Úhandler© r   úM/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/sqlalchemy/log.pyÚ_add_default_handler:   s
    ÿr    zSet[Type[Identified]]Ú_logged_classesúType[Identified]Ústr)Úclsr   c                 C  s   t | dd ƒp| jd | j S )NZ_sqla_logger_namespaceÚ.)ÚgetattrÚ
__module__Ú__name__©r$   r   r   r   Ú_qual_logger_name_for_clsE   s    þr*   z	Type[_IT]c                   s>   t  t| ƒ¡‰ ‡ fdd„| _‡ fdd„| _ˆ | _t | ¡ | S )Nc                   s   ˆ   tj¡S ©N)ÚisEnabledForr   ÚDEBUG©Úself©r   r   r   Ú<lambda>N   s   ÿzclass_logger.<locals>.<lambda>c                   s   ˆ   tj¡S r+   )r,   r   ÚINFOr.   r0   r   r   r1   Q   s   ÿ)r   Ú	getLoggerr*   Ú_should_log_debugÚ_should_log_infor   r!   Úaddr)   r   r0   r   Úclass_loggerL   s    
r7   ÚInstanceLoggerc                   @  sJ   e Zd ZU dZdZded< ded< ded< d	d
œdd„Zd	d
œdd„ZdS )r   r   NzOptional[str]Úlogging_nameÚ_IdentifiedLoggerTyper   Ú_EchoFlagTypeÚ_echoÚbool©r   c                 C  s   | j  tj¡S r+   )r   r,   r   r-   r.   r   r   r   r4   e   s    zIdentified._should_log_debugc                 C  s   | j  tj¡S r+   )r   r,   r   r2   r.   r   r   r   r5   h   s    zIdentified._should_log_info)r(   r'   Ú__qualname__Ú	__slots__r9   Ú__annotations__r4   r5   r   r   r   r   r   \   s   
c                   @  sô   e Zd ZU dZejejejejdœZde	d< dZ
dddœdd	„Zdd
d
ddœdd„Zdd
d
ddœdd„Zdd
d
ddœdd„ZeZdd
d
ddœdd„Zdd
d
ddœdd„Zdd
d
ddœdd„Zddd
d
ddœdd„Zdddœdd „Zdd!œd"d#„Zd$S )%r8   a  A logger adapter (wrapper) for :class:`.Identified` subclasses.

    This allows multiple instances (e.g. Engine or Pool instances)
    to share a logger, but have its verbosity controlled on a
    per-instance basis.

    The basic functionality is to return a logging level
    which is based on an instance's echo setting.

    Default implementation is:

    'debug' -> logging.DEBUG
    True    -> logging.INFO
    False   -> Effective level of underlying logger (
    logging.WARNING by default)
    None    -> same as False
    )NFTr   r;   r<   )Úechor   r#   )rB   Únamec                 C  s8   || _ t |¡| _| j| tjkr4| jjs4t| jƒ d S r+   )rB   r   r3   r   Ú	_echo_mapr2   Úhandlersr    )r/   rB   rC   r   r   r   Ú__init__‹   s    zInstanceLogger.__init__r   r   )ÚmsgÚargsÚkwargsr   c                 O  s    | j tj|g|¢R i |¤Ž dS )z/Delegate a debug call to the underlying logger.N)Úlogr   r-   ©r/   rG   rH   rI   r   r   r   r   —   s    zInstanceLogger.debugc                 O  s    | j tj|g|¢R i |¤Ž dS )z/Delegate an info call to the underlying logger.N)rJ   r   r2   rK   r   r   r   Úinfoœ   s    zInstanceLogger.infoc                 O  s    | j tj|g|¢R i |¤Ž dS )z1Delegate a warning call to the underlying logger.N)rJ   r   ÚWARNINGrK   r   r   r   Úwarning¡   s    zInstanceLogger.warningc                 O  s    | j tj|g|¢R i |¤Ž dS )zB
        Delegate an error call to the underlying logger.
        N©rJ   r   ÚERRORrK   r   r   r   Úerror¨   s    zInstanceLogger.errorc                 O  s(   d|d< | j tj|g|¢R i |¤Ž dS )z4Delegate an exception call to the underlying logger.r
   Úexc_infoNrO   rK   r   r   r   Ú	exception®   s    zInstanceLogger.exceptionc                 O  s    | j tj|g|¢R i |¤Ž dS )z2Delegate a critical call to the underlying logger.N)rJ   r   ÚCRITICALrK   r   r   r   Úcritical´   s    zInstanceLogger.criticalÚint)ÚlevelrG   rH   rI   r   c                 O  sn   | j jj|krdS | j| j }|tjkr2| j  ¡ }||krjtrR| 	dd¡t
 |d< | j j|||fi |¤Ž dS )zÎDelegate a log call to the underlying logger.

        The level here is determined by the echo
        flag as well as that of the underlying logger, and
        logger._log() is called directly.

        NÚ
stacklevelr
   )r   ÚmanagerÚdisablerD   rB   r   ÚNOTSETÚgetEffectiveLevelÚ
STACKLEVELÚgetÚSTACKLEVEL_OFFSETÚ_log)r/   rW   rG   rH   rI   Zselected_levelr   r   r   rJ   ¹   s    

ÿzInstanceLogger.logr=   )rW   r   c                 C  s   | j jj|krdS ||  ¡ kS )z)Is this logger enabled for level 'level'?F)r   rY   rZ   r\   ©r/   rW   r   r   r   r,   Ô   s    zInstanceLogger.isEnabledForr>   c                 C  s$   | j | j }|tjkr | j ¡ }|S )z+What's the effective level for this logger?)rD   rB   r   r[   r   r\   ra   r   r   r   r\   Û   s    

z InstanceLogger.getEffectiveLevelN)r(   r'   r?   Ú__doc__r   r[   r2   r-   rD   rA   r@   rF   r   rL   rN   ÚwarnrQ   rS   rU   rJ   r,   r\   r   r   r   r   r8   l   s&   
ür;   )ÚinstanceÚechoflagr   c                 C  sT   | j rdt| jƒ| j f }n
t| jƒ}|| _|dv r@t |¡}n
t||ƒ}|| _dS )zEcreate a logger for an instance that implements :class:`.Identified`.z%s.%s)FNN)r9   r*   Ú	__class__r<   r   r3   r8   r   )rd   re   rC   r   r   r   r   Úinstance_loggerä   s    þ

rg   c                   @  s`   e Zd ZdZeddd dœdd„ƒZeddddœd	d„ƒZd
dddœdd„Zddddœdd„ZdS )Úecho_propertya}      When ``True``, enable log output for this element.

    This has the effect of setting the Python logging level for the namespace
    of this element's class and object reference.  A value of boolean ``True``
    indicates that the loglevel ``logging.INFO`` will be set for the logger,
    whereas the string value ``debug`` will set the loglevel to
    ``logging.DEBUG``.
    zLiteral[None]r"   )rd   Úownerr   c                 C  s   d S r+   r   ©r/   rd   ri   r   r   r   Ú__get__  s    zecho_property.__get__r   r;   c                 C  s   d S r+   r   rj   r   r   r   rk     s    zOptional[Identified]z#Union[echo_property, _EchoFlagType]c                 C  s   |d u r| S |j S d S r+   )r<   rj   r   r   r   rk     s    r   )rd   Úvaluer   c                 C  s   t ||d� d S )N)re   )rg   )r/   rd   rl   r   r   r   Ú__set__  s    zecho_property.__set__N)r(   r'   r?   rb   r   rk   rm   r   r   r   r   rh     s   
rh   )N))rb   Ú
__future__r   r   r   Útypingr   r   r   r   r   r   r	   Úutilr   r   Zutil.typingr   r]   r_   r   r=   r;   r3   Z
rootloggerrW   r[   ÚsetLevelrM   r    Úsetr!   rA   r*   r7   ÚLoggerr:   r   r8   rg   rh   r   r   r   r   Ú<module>	   sB   
y ÿ