U [h!@sUdZddlmZddlZddlZddlmZddlmZddlmZddlm Z ddlm Z dd lm Z dd lm Z d d l mZd d l mZd dlmZerdZerdnd ZndZdZe dddZe deedfZedZejejkreejdddddZeZde d<ddd d!d"Z!d#d#d d$d%Z"e ej#d&fZ$Gd'ddZ%Gd(d&d&Z&d/dd)dd*d+d,Z'Gd-d.d.Z(dS)0aLogging 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)LiteralTF_IT Identified)ZbounddebugZ sqlalchemyzlogging.LoggerNone)loggerreturncCs*ttj}|td||dS)Nz.%(asctime)s %(levelname)s %(name)s %(message)s)loggingZ StreamHandlersysstdoutZ setFormatterZ FormatterZ addHandler)rZhandlerr4./venv/lib/python3.8/site-packages/sqlalchemy/log.py_add_default_handler:s  rzSet[Type[Identified]]_logged_classesType[Identified]str)clsrcCst|ddp|jd|jS)NZ_sqla_logger_namespace.)getattr __module____name__rrrr_qual_logger_name_for_clsEs r$z Type[_IT]cs>tt|fdd|_fdd|_|_t||S)Ncs tjSN) isEnabledForrDEBUGselfrrrNszclass_logger..cs tjSr%)r&rINFOr(r*rrr+Qs)r getLoggerr$_should_log_debug_should_log_inforraddr#rr*r class_loggerLs  r1InstanceLoggerc@sJeZdZUdZdZded<ded<ded<d d d d Zd d d dZdS)rrNz Optional[str] logging_name_IdentifiedLoggerTyper _EchoFlagType_echoboolrcCs|jtjSr%)rr&rr'r(rrrr.eszIdentified._should_log_debugcCs|jtjSr%)rr&rr,r(rrrr/hszIdentified._should_log_info)r"r! __qualname__ __slots__r3__annotations__r.r/rrrrr\s  c@seZdZUdZejejejejdZde 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 dddZddddd Zdd!d"d#Zd$S)%r2aA 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 )NFTrr5r6)echorr)r<namecCs8||_t||_|j|tjkr4|jjs4t|jdSr%)r<rr-r _echo_mapr,Zhandlersr)r)r<r=rrr__init__s zInstanceLogger.__init__rr)msgargskwargsrcOs|jtj|f||dS)z/Delegate a debug call to the underlying logger.N)logrr'r)r@rArBrrrrszInstanceLogger.debugcOs|jtj|f||dS)z/Delegate an info call to the underlying logger.N)rCrr,rDrrrinfoszInstanceLogger.infocOs|jtj|f||dS)z1Delegate a warning call to the underlying logger.N)rCrZWARNINGrDrrrwarningszInstanceLogger.warningcOs|jtj|f||dS)zB Delegate an error call to the underlying logger. NrCrZERRORrDrrrerrorszInstanceLogger.errorcOs"d|d<|jtj|f||dS)z4Delegate an exception call to the underlying logger.r exc_infoNrGrDrrr exceptionszInstanceLogger.exceptioncOs|jtj|f||dS)z2Delegate a critical call to the underlying logger.N)rCrZCRITICALrDrrrcriticalszInstanceLogger.criticalint)levelr@rArBrcOsj|jjj|krdS|j|j}|tjkr2|j}||krftrR| ddt |d<|jj |||f|dS)zDelegate 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 ) rmanagerdisabler>r<rNOTSETgetEffectiveLevel STACKLEVELgetSTACKLEVEL_OFFSETZ_log)r)rMr@rArBZselected_levelrrrrCs    zInstanceLogger.logr7)rMrcCs|jjj|krdS||kS)z)Is this logger enabled for level 'level'?F)rrOrPrRr)rMrrrr&szInstanceLogger.isEnabledForr8cCs$|j|j}|tjkr |j}|S)z+What's the effective level for this logger?)r>r<rrQrrRrVrrrrRs   z InstanceLogger.getEffectiveLevelN)r"r!r9__doc__rrQr,r'r>r;r:r?rrErFwarnrHrJrKrCr&rRrrrrr2ls&  r5)instanceechoflagrcCsT|jrdt|j|jf}n t|j}||_|dkr@t|}n t||}||_dS)zEcreate a logger for an instance that implements :class:`.Identified`.z%s.%s)FNN)r3r$ __class__r6rr-r2r)rYrZr=rrrrinstance_loggers   r\c@s`eZdZdZeddddddZeddddd 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)rYownerrcCsdSr%rr)rYr^rrr__get__ szecho_property.__get__rr5cCsdSr%rr_rrrr`szOptional[Identified]z#Union[echo_property, _EchoFlagType]cCs|dkr |S|jSdSr%)r6r_rrrr`sr)rYvaluercCst||ddS)N)rZ)r\)r)rYrarrr__set__szecho_property.__set__N)r"r!r9rWrr`rbrrrrr]s r])N))rWZ __future__rrrtypingrrrrrrr utilr r Z util.typingr rSrUrr7r5r-Z rootloggerrMrQZsetLevelZWARNrsetrr;r$r1ZLoggerr4rr2r\r]rrrr sB                y