U
|
¸ý°dØ" ã @ s U d Z ddlmZ ddlZddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
|
Z
|
dd lm Z dd
|
lm Z d d l mZ d d l mZ d dlmZ er°dZerªdnd ZndZdZe dddZe deed f Ze d¡Zejejkrøe ej ¡ dddddZ e Z d e d < d d d d!d"Z!d#d#d d$d%Z"e ej#d&f Z$G d'd dZ%G d(d& d&Z&d/dd)dd*d+d,Z'G d-d. d.Z(dS )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
|
sqlalchemyzlogging.LoggerÚNone)ÚloggerÚreturnc C s* t tj¡}| t d¡¡ | |¡ d S )Nz.%(asctime)s %(levelname)s %(name)s %(message)s)ÚloggingÚ StreamHandlerÚsysÚstdoutÚ setFormatterÚ FormatterÚ
|
addHandler)r Úhandler© r úEd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\sqlalchemy/log.pyÚ_add_default_handler: s
|
ÿr zSet[Type[Identified]]Ú_logged_classesúType[Identified]Ústr)Úclsr c C s t | dd p| jd | 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| ¡ fdd| _ fdd| _ | _t | ¡ | S )Nc s tj¡S ©N)Ú isEnabledForr ÚDEBUG©Úself©r r r Ú<lambda>N s ÿz class_logger.<locals>.<lambda>c s tj¡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 Zd ZU dZdZded< ded< ded< d d
|
d d Zd d
|
d dZdS )r r Nz Optional[str]Ú logging_nameÚ_IdentifiedLoggerTyper Ú _EchoFlagTypeÚ_echoÚbool©r c C s | j tj¡S r+ )r r, r r- r. r r r r4 e s z Identified._should_log_debugc C s | j tj¡S r+ )r r, r r2 r. r r r r5 h s zIdentified._should_log_info)r( r' Ú __qualname__Ú __slots__r9 Ú__annotations__r4 r5 r r r r r \ s
|
c @ sô e Zd ZU dZejejejejdZde d< dZ
|
ddddd Z dd
|
d
|
d d d dZ dd
|
d
|
d d ddZ dd
|
d
|
d d ddZeZdd
|
d
|
d d ddZdd
|
d
|
d d ddZdd
|
d
|
d d ddZddd
|
d
|
d ddd Zdd d d d Zdd!d"d#Zd$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| tjkr4| jjs4t| j d S r+ )rB r r3 r Ú _echo_mapr2 Úhandlersr )r/ rB rC r r r Ú__init__ s zInstanceLogger.__init__r r )ÚmsgÚargsÚkwargsr c O s | j tj|f|| dS )z/Delegate a debug call to the underlying logger.N)Úlogr r- ©r/ rG rH rI r r r r s zInstanceLogger.debugc O s | j tj|f|| dS )z/Delegate an info call to the underlying logger.N)rJ r r2 rK r r r Úinfo s zInstanceLogger.infoc O s | j tj|f|| dS )z1Delegate a warning call to the underlying logger.N)rJ r ÚWARNINGrK r r r Úwarning¡ s zInstanceLogger.warningc O s | j tj|f|| dS )zB
|
Delegate an error call to the underlying logger.
|
N©rJ r ÚERRORrK r r r Úerror¨ s zInstanceLogger.errorc O s" d|d< | j tj|f|| dS )z4Delegate an exception call to the underlying logger.r
|
Úexc_infoNrO rK r r r Ú exception® s zInstanceLogger.exceptionc O s | j tj|f|| dS )z2Delegate a critical call to the underlying logger.N)rJ r ÚCRITICALrK r r r Úcritical´ s zInstanceLogger.criticalÚint)ÚlevelrG rH rI r c O sj | j jj|krdS | j| j }|tjkr2| j ¡ }||krftrR| dd¡t
|
|d< | j j |||f| dS )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 Zselected_levelr r r rJ ¹ s
|
|
ÿzInstanceLogger.logr= )rW r c C s | j jj|krdS || ¡ kS )z)Is this logger enabled for level 'level'?F)r rY rZ r\ ©r/ rW r r r r, Õ s zInstanceLogger.isEnabledForr> c C s$ | j | j }|tjkr | 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 dt| j| j f }n
|
t| j}|| _|dkr@t |¡}n
|
t||}|| _dS )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 Zd ZdZeddd dddZeddddd dZd
|
dd dd dZddd dddZdS )Ú 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 zecho_property.__get__r r; c C s d S r+ r rj r r r rk s zOptional[Identified]z#Union[echo_property, _EchoFlagType]c C s |d kr | 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 zecho_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[ ÚsetLevelÚWARNr Úsetr! rA r* r7 ÚLoggerr: r r8 rg rh r r r r Ú<module> sB
|
z ÿ
|
