"- d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl m Z m
Z
dZej Zdad dZd Zd Zd Zd
Zd Zd Zd
Z ej dej Z d Z G d de Z G d de e Z! G d de"e Z# G d de$e Z% G d de Z& G d de& Z'e'Z(d Z)edfd Z*d Z+dS ) a
Configuration functions for the logging package for Python. The core package
is based on PEP 282 and comments thereto in comp.lang.python, and influenced
by Apache's log4j system.
Copyright (C) 2001-2023 Vinay Sajip. All Rights Reserved.
To use, simply 'import logging' and log away!
N)ThreadingTCPServerStreamRequestHandleriF# Tc B ddl }t | t rbt j | st
| d t j | st | d t | |j r| }n |
| }t | d r| | n+t j | }| | | n&# |j $ r}t | d| d}~ww xY wt# | }t% j t) t+ || }t- ||| t% j dS # t% j w xY w)aD
Read the logging configuration from a ConfigParser-format file.
This can be called several times from an application, allowing an end user
the ability to select from various pre-canned configurations (if the
developer provides a mechanism to present the choices and load the chosen
configuration).
r Nz doesn't existz is an empty filereadline)encodingz
is invalid: ) configparser
isinstancestrospathexistsFileNotFoundErrorgetsize RuntimeErrorRawConfigParser ConfigParserhasattr read_fileio
text_encodingread ParsingError_create_formatterslogging _acquireLock_clearExistingHandlers_install_handlers_install_loggers _releaseLock) fnamedefaultsdisable_existing_loggersr r cpe
formattershandlerss 5/opt/alt/python311/lib64/python3.11/logging/config.py
fileConfigr( 4 s % <w~~e$$ <#u$<$<$<== = '' < % : : :;; ;% 566 ;
; **844Buj))
2 U#### +H55111( ; ; ; % 9 9a 9 9:: : ; $B''J %R44X'?@@@ s% A&C< <
D DD /F F c | d } | d }t | }| D ]J}|dz |z } t || } # t $ r" t | t || }Y Gw xY w|S )z)Resolve a dotted name to a global object..r )splitpop
__import__getattrAttributeError)nameusedfoundns r' _resolver4 ` s ::c??D 88A;;D t E
& &czA~ &E1%%EE & & & t E1%%EEE & Ls A)BBc 6 t t j | S N)mapr
strip)alists r'
_strip_spacesr: n s sy% c | d d }t | si S | d }t | }i }|D ]}d|z }| |ddd }| |d dd }| |d
dd }t j }| | d } | rt
| } |||| }
|
||< |S )
z Create and return formattersr% keys,z formatter_%sformatTN)rawfallbackdatefmtstyle%class)lenr+ r: getr Formatterr4 ) r# flistr% formsectnamefsdfsstlc
class_namefs r' r r q s | V $E u:: KK E % EJ
!D(
VVHhD4V
@
@ffXydTfBBffXwD3f?? \%%g..
%$$A
Ab#sOO
4 r; c " | d d }t | si S | d }t | }i }g }|D ]}| d|z }|d }| dd } t |t t }n&# t t f$ r t | }Y nw xY w| dd } t | t t } | d
d }
t |
t t }
|| i |
} || _
d |v r |d } | | t | r| || t |t j j r<| d
d }
t |
r| | |
f | ||< |D ] \ } }| || !|S )zInstall and return handlersr& r= r> z
handler_%srE formatter args()kwargsz{}leveltarget)rF r+ r: rG evalvarsr r/ NameErrorr4 r0 setLevel setFormatter
issubclassr&
MemoryHandlerappend setTarget)r# r% hlistr& fixupshandsectionklassfmtrU rW hrX rY ts r' r r s zN6 "E u:: KK E % EH
F \D() kk+r** $W
..EE * $ $ $ UOOEEE ${{64((D$w--((Xt,,fd7mm,, E4 "6 " " g G$E
JJu s88 ,
NN:c? + + + eW - ; < < + [[2..F6{{
+
q&k*** ! !1 HQK Os 7"B B=<B=c t j }| D ]g}|j j | }||v rHt |t j s-| t j g |_ d|_ `||_
hdS )a
When (re)configuring logging, handle loggers which were in the previous
configuration but are not in the new configuration. There's no point
deleting them as other threads may continue to hold references to them;
and by disabling them, you stop them doing any logging.
However, don't disable children of named loggers, as that's probably not
what was intended by the user. Also, allow existing loggers to NOT be
disabled if disable_existing is false.
TN) r rootmanager
loggerDictr PlaceHolderr] NOTSETr& propagatedisabled)existing
child_loggersdisable_existingrl logloggers r' _handle_existing_loggersrx s rl logger_rootrX Nr& z logger_%squalnamerq )rA r* r )r+ listr: remover rl r] r&
removeHandlerrF
addHandlerrm rn r= sortgetint getLoggerindexra rq rr rx )r# r& ru llistrf rl rv rX ri rc re rs rt qnrq rw iprefixedpflen num_existings r' r r s
yM& !E KK E u%% & &E LL G * * * * DL+002233H
MMOOO M 2 2[3&'
Z
NN;N;; "2&&
>>r""Q&ACxHMME x==Ll""A;vv&(22!((!555Q l""
OOB g G$E OOE " " " # $ $A # # # #$
# u:: 2KK$$E!%((E
2
2!!(4.1111 X}6FGGGGGr; c t j t j t j dd t j dd= dS )z!Clear and close existing handlersN)r _handlersclearshutdown _handlerList r; r' r r sI W)!!!,--- QQQ r; z^[a-z_][a-z0-9_]*$c b t | }|st d| z dS )Nz!Not a valid Python identifier: %rT)
IDENTIFIERmatch
ValueError)sms r' valid_identr $ s7 A B[a-z]+)://(?P.*)$z ^\s*(\w+)\s*z^\.\s*(\w+)\s*z^\[\s*(\w+)\s*\]\s*z^\d+$ ext_convert cfg_convert)extcfgc F t | | _ | | j _ d S r6 )r configr )r r s r' __init__zBaseConfigurator.__init__ s! $V,, #' r; c | d }| d } | | }|D ]P}|d|z z
} t || } # t $ r( | | t || }Y Mw xY w|S # t
$ r }t
d|d| }||d}~ww xY w)z`
Resolve strings to objects using standard import and attribute
syntax.
r* r zCannot resolve z: N)r+ r, importerr. r/ ImportErrorr )r r r0 r1 r2 fragr$ vs r' resolvezBaseConfigurator.resolve s
wws||xx{{ MM$''E
1
1d
"1 #E4 0 0EE% 1 1 1MM$''' #E4 0 0EEE1 L
aaa;<D AHHJJqM*A
A$**400
+!((**Q-(AA *0066A + hhjjm # 1 7 7 < < + !#AA +$'HH$%aD#, + + +$%cF + A >DD$*3855$$&@ A A A'
A, s D# #D87D8c t |t s-t |t rt | }| |_ n t |t s,t |t
rt | }| |_ nt |t s22 .z%7N7N ."5))E!%E E?33
.E5))
.29%2K2K
.#E**E!%E
s
#
# .$**511A
.KKMM8 1 5 5fd C C . x[F 'i 8 8I %If - -E r; c , d }t | s| | }fdD } |di |} dd }|r+| D ]\ }}t ||| |S )z1Configure an object with a user-supplied factory.rV c L i | ] }|d k t | || !S r* r .0kr s r'
z5BaseConfigurator.configure_custom.. . PPP1188 A8!VAY888r; r* Nr )r, callabler itemssetattr)r r rO rW r propsr0 r s ` r' configure_customz!BaseConfigurator.configure_custom s JJt {{ QAPPPPPPPV
3%% - ${{}}
-
- ee,,,,
r; c N t |t rt | }|S )z0Utility function which converts lists to tuples.)r r~ r r s r' as_tuplezBaseConfigurator.as_tuple s$ eT " " !%LLE r; N)r r r r recompiler r r r r r staticmethodr- r r r r r r r r r r; r' r r l s !bj!IJJO 2:o..L "* .//K BJ 566M BJx((M |J''H( ( ( *# # # D 8 r; r c N e Zd ZdZd Zd Zd Zd Zd Zd Z d
d Z
d
d
Z d
d Z d S )DictConfiguratorz]
Configure logging using a dictionary-like object to describe the
configuration.
c | j }d|vrt d |d dk rt d|d z | dd }i }t j |rm| d| }|D ]}|t j vrt d|z t j | }|| }| d d
}|r'| t j | }# t $ r} t d |z | d
} ~ ww xY w| d | }
|
D ]E} |
||
| d
!# t $ r} t d|z | d
} ~ ww xY w| dd
} | r; | | d
n# t $ r} t d | d
} ~ ww xY wn|| dd
} t | d| }
|
D ]F} |
|
| |
|< "# t $ r} t d|z | d
} ~ ww xY w| d| }|D ]F} | || ||< "# t $ r} t d|z | d
} ~ ww xY w| d| }g }t | D ]} | || }||_ |||< +# t $ rI} dt% | j v r| | nt d |z | Y d
} ~ yd
} ~ ww xY w|D ]O} | || }||_ |||< +# t $ r} t d |z | d
} ~ ww xY wt j } t- | j j }| g }| d | }
|
D ]}||v r| | dz }|dz }t9 | }t9 | }||k r:|| d
| |k r| || |dz
}||k :| | |
||
| # t $ r} t d|z | d
} ~ ww xY wt= ||| | dd
} | r9 | | n"# t $ r} t d | d
} ~ ww xY wt j d
S # t j w xY w)zDo the configuration.versionz$dictionary doesn't specify a versionr} zUnsupported version: %s incrementalFr& z No handler found with name %rrX Nz Unable to configure handler %rrz Tz Unable to configure logger %rrl z Unable to configure root loggerr" r% z Unable to configure formatter %rfiltersz Unable to configure filter %rtarget not configured yetr* ) r r r, r r rG r r] _checkLevel Exceptionconfigure_loggerconfigure_rootr configure_formatterconfigure_filtersortedconfigure_handlerr0 r
__cause__ra rl r~ rm rn r= r r rF r rx r )r r r
EMPTY_DICTr& r0 handlerhandler_configrX r$ rz rl ru r% r deferredrs rt r r r r s r' configurezDictConfigurator.configure sG F " " CDD D ) ! ! 6 9J JKK K jj 66
Q # N
:!::j*== $
A
AD7#444 ( *36:*; < < <A&-&7&=G-5d^N$2$6$6w$E$EE $ M ' 0 01DU1K1K L L L ( A A A", .248.9 #: #:?@ AA !**Y
;; # = =D= --dGDM4HHHH$ = = = ( *.04*5 6 6;<== zz&$// :: ++D$7777$ : : : ( *2 3 389::: $*::.H$#O#O &((( $ZZ j A A
& G GDG+/+C+C*? @ @EFGG !**Y
;; # D DDD(,(=(=gdm(L(L
$ D D D ( *57;*< = =BCDD "::j*== "8 , ,
A
AD A"&"8"8$ "H"H'+ )0$ A A A6#ak:J:JJJ $OOD 1 1 1 1", .248.9 #: #:?@ A 2 1 1 1 1A % = =D="&"8"8$ "H"H'+ )0$ = = = ( *.04*5 6 6;<== | 7 < < > >??
!#
**Y
;; # = =Dx'' $NN4 0 01 4#'#: #H
'*8}} , . . '{6E6 2h > > - 4 4Xa[ A A A FA , . . !---= --dGDMBBBB$ = = = ( *.04*5 6 6;<==" )=)9; ; ; zz&$// :: ++D1111$ : : : ( *2 3 389::
" " " " "G " " " "sY +=U, )ADU,
D%
D D%% U, E! U, !
F+E>>FU, F7 5U, 7
GGGAU, H98U, 9
III U, 9 JU,
J:"J55J::,U, ''LU,
M"?M U, M""U, *'NU,
N4 N//N44C>U, 3 SU,
S2S--S22,U, T5 4U, 5
U?UUU, ,Vc : d|v rz|d } | | }n# t $ rN}dt | vr | d |d< ||d< | | }Y d}~nd}~ww xY w| dd }| dd }| dd }| d d }|s
t
j } nt | } d
|v r | ||||d
}n
| ||| }|S ) z(Configure a formatter from a dictionary.rV z'format'r? rh NrB rC rD rE validate)r r r
r, rG r rH r4 )
r r factoryr terh dfmtrC cnamerO s
r' r z$DictConfigurator.configure_formatter sJ 6>> TlG
7 ..v66
7
7
7 SWW,,
!'
8 4 4u
&t ..v66
7 **Xt,,C::i..DJJw,,EJJw--E
$% UOO V##3eVJ-?@@3e,,
s $
A<AA77A<c d|v r| | }n*| dd }t j | }|S )z%Configure a filter from a dictionary.rV r0 rT )r rG r Filter)r r r r0 s r' r z!DictConfigurator.configure_filter sG 6>>**622FF::fb))D ^D))F
r; c |D ]} t | s t t |dd r|}n| j d | }| | \# t $ r}t d|z |d}~ww xY wdS )z/Add filters to a filterer from a list of names.filterNr zUnable to add filter %r)r r. r addFilterr r )r filtererr rQ filter_r$ s r' add_filtersz DictConfigurator.add_filters s G GA
GA;; 8(71h+E+E"F"F 8 GG "k) 4Q 7G""7++++
G
G
G !:Q!>??QF
G G Gs AA
B)A<<Bc R t } dd }|r: | j d | }n%# t $ r}t d|z |d}~ww xY w dd } dd }dv r= d }t | s| | }|}n[ d } | | }
t |
t j j
rd v r | j d
d } t | t j s$
| t d | d < n# t $ r }t d d z |d}~ww xY wt |
t j j r#d
v r | d
d
< nAt |
t j j r"dv r | d d< |
}fdD } |di | }
nI# t $ r<}dt% | vr | d | d< |di | }
Y d}~nd}~ww xY w|r|
| |'|
t j | |r| |
| dd }|r+| D ]\ }}t1 |
|| |
S )z&Configure a handler from a dictionary.rS Nr% zUnable to set formatter %rrX r rV rE rY r& r z Unable to set target handler %rmailhostaddressc L i | ] }|d k t | || !S r r r s r' r z6DictConfigurator.configure_handler.. r r; z'stream'streamstrmr* r )r r, r r r r r r_ r r& r` r Handlerupdater SMTPHandlerr
SysLogHandlerr
r^ r] r r r r )r r config_copyrS r$ rX r rO r r rg thrW r r r r0 r s ` r' r z"DictConfigurator.configure_handler s 6ll JJ{D11 :
: K 5i @
:
:
: "&(1"2 3 389:
:
7D))**Y-- 6>>
4 AA;;
$LLOOGGJJw''ELL''E%!1!?@@
EF""E Z01ABB%b'/:: E
k222 '(C D DD')F8$$ E E E$ &*,28,<&= > >CDEE E7#3#?@@
Ef$$%)]]6*3E%F%Fz""E7#3#ABB
EV##$(MM&2C$D$Dy!GPPPPPPP
' W&&v&&FF ' ' 'R((
$ZZ 1 1F6N W&&v&&FFFFFF ' + * * * OOG / 6 6 7 7 7 . VW - - -
3%% - ${{}}
-
- ee,,,,
sF >
A AA A E; ;
F#F F#:I
J
2JJ c |D ]N} | | j d | *# t $ r}t d|z |d}~ww xY wdS )z.Add handlers to a logger from a list of names.r& zUnable to add handler %rN)r r r r )r rw r& ri r$ s r' add_handlersz DictConfigurator.add_handlers s H HA
H!!$+j"9!"<====
H
H
H !;a!?@@aG
H H Hs &-
AA
AFc | dd }|'| t j | |s|j dd D ]}| | | dd }|r| || | dd }|r| || dS dS dS )zU
Perform configuration which is common to root and non-root loggers.
rX Nr& r )rG r] r r r& r r( r )r rw r r rX ri r& r s r' common_logger_configz%DictConfigurator.common_logger_config s
7D)) OOG / 6 6 7 7 7 2_QQQ'
(
($$Q'''' zz*d33H
4!!&(333 jjD11G
2 11111 2 2
2
2r; c t j | }| ||| d|_ | dd }| ||_ dS dS )z.Configure a non-root logger from a dictionary.Frq N)r r r* rr rG rq )r r0 r r rw rq s r' r z!DictConfigurator.configure_logger% s` "4(( !!&&+>>> JJ{D11 (F ! r; c Z t j }| ||| dS )z*Configure a root logger from a dictionary.N)r r r* )r r r rl s r' r z DictConfigurator.configure_root. s. "" !!$ <<<<.ConfigStreamHandlerz
Handler for a logging configuration request.
It expects a completely new logging configuration and uses fileConfig
to install it.
c | j }| d }t | dk rnt j d| d }| j | }t | |k r;|| |t | z
z }t | |k ;| j j | j | }|| d } ddl}| | }t | nX# t $ rK t j
| } t | n## t $ r t j Y nw xY wY nw xY w| j j r"| j j dS dS dS # t& $ r }|j t* k r Y d}~dS d}~ww xY w)z
Handle a request.
Each request is expected to be a 4-byte length, packed using
struct.pack(">L", n), followed by the config file.
Uses fileConfig() to do the grunt work.
z>Lr Nzutf-8)
connectionrecvrF structunpackserververifydecodejsonloadsr/ r r StringIOr( traceback print_excreadysetOSErrorerrno RESET_ERROR)r connchunkslenr< r filer$ s r' handlez*listen..ConfigStreamHandler.handleU s
! u::??!=u55a8D O 0 0 6 6E e**t++ % $U2C(D(D D e**t++{)5 $ 2 25 9 9 ( % W 5 5 6 'KKK #zz% 0 0A &qMMMM ( 6 6 6 $&;u#5#5D 6 *4 0 0 0 0#, 6 6 6 ) 3 5 5 5 5 5 6
6 {( 0 )--////// #?,0 0
7k)) *)))))
s` C0F$ 3(D F$ E1;E
E1 E+(E1*E++E1.F$ 0E11-F$ $
G
.GG
N)r r r r rJ r r; r' ConfigStreamHandlerr2 N s- % % % % % r; rK c . e Zd ZdZdZdedddfdZd ZdS )$listen..ConfigSocketReceiverzD
A simple TCP socket-based logging config receiver.
r} localhostNc t j | ||f| t j d| _ t j d| _ || _ || _ d S )Nr r} ) r r r r abortr timeoutrA r: )r hostportr rA r: s r' r z-listen..ConfigSocketReceiver.__init__ sY 'tTlG D D D " " "DJ " " " DL DJ DKKKr; c : dd l }d}|s~| | j gg g | j \ }}}|r| t j | j }t j |~| d S )Nr )
selectsocketfilenorQ handle_requestr r rP r server_close)r rU rP rdwrexs r' serve_until_stoppedz8listen..ConfigSocketReceiver.serve_until_stopped s MMME
' #]]DK,>,>,@,@+A+-r+/< 9 9
B *'')))$&&&
$&&&
'
r; )r r r r allow_reuse_addressDEFAULT_LOGGING_CONFIG_PORTr r] r r; r' ConfigSocketReceiverrM | sV +2M !d ! ! ! ! r; r` c ( e Zd Z fdZd Z xZS )listen..Serverc t | || _ || _ || _ || _ t
j | _ d S r6 ) superr rcvrhdlrrS r: threadingEventrA )r re rf rS r: Server __class__s r' r z listen..Server.__init__ sN &$ ( ( * * * DI DI DI DK" **DJJJr; c D | | j | j | j | j }| j dk r|j d | _ | j t j |a t j
| d S )N)rS r rA r: r r} ) re rS rf rA r: server_addressrB r r _listenerr r] )r r9 s r' runzlisten..Server.run s YYDIty%)Z&*k 3 3F yA~~ " 1! 4 JNN " " " I " " " & & ( ( ( ( (r; )r r r r rn
__classcell__)rj ri s @r' ri rb sM + + + + + + ) ) ) ) ) ) )r; ri )r r rg Thread)rS r: rK r` ri s @r' listenrq : s (, , , , , 2 , , ,\ 1 >) ) ) ) ) ) )! ) ) ). 6&(;T6 J JJr; c t j t rdt _ dat j dS # t j w xY w)zN
Stop the listening server which was created with a call to listen().
r} N)r r rm rP r r r; r'
stopListeningrs sV
IO I s ? A)NTN),r rD r r logging.handlersr queuer r7 rg r? socketserverr r r_
ECONNRESETrE rm r( r4 r: r r rx r r r Ir r objectr r r r~ r r r r r r. r/ rq rs r r; r' rz s "
A A A A A A A A #
) ) ) ) X ! ! ! ,$ $ $L/ / /,TH TH THn RZ,bd
3
3
f B
@
@
@
@
@T?
@
@
@ # # # # #T? # # #@ @ @ @ @e_ @ @ @A A A A Av A A AFB= B= B= B= B=' B= B= B=H
#( ( (
,D xK xK xK xKt r;