eSrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK J r Jr Sr\R rSqSSjrSrSrSrS rS rS rS r\R6"S \R85rSr"SS\5r "SS\!\ 5r""SS\#\ 5r$"SS\%\ 5r&"SS\5r'Sr("SS\'5r)\)r*Sr+\S4Sjr,Sr-g) 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-2022 Vinay Sajip. All Rights Reserved. To use, simply 'import logging' and log away! N)ThreadingTCPServerStreamRequestHandleriF#cSSKn[U[5(ad[RR U5(d[ US35e[RRU5(d[US35e[XR5(aUnO[URU5n[US5(aURU5 O&[R"U5nURXS9 [#U5n[$R& [)5 [+XW5n[-XXU5 SSS5 g!UR an[USU35eSnAff=f!,(df  g=f)a, 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). rNz doesn't existz is an empty filereadline)encodingz is invalid: ) configparser isinstancestrospathexistsFileNotFoundErrorgetsize RuntimeErrorRawConfigParser ConfigParserhasattr read_fileio text_encodingread ParsingError_create_formatterslogging_lock_clearExistingHandlers_install_handlers_install_loggers) fnamedefaultsdisable_existing_loggersrrcpe formattershandlerss 4/opt/imh/python3.13/lib/python3.13/logging/config.py fileConfigr'5s0%ww~~e$$#ug^$<= =''%(9:; ;%5566  ;**84Buj)) U#++H51$B'J  %R4'?@  (( ;% aS9: : ; s*3D<%D<"E$<E! EE!$ E2cURS5nURS5n[U5nUHnUS-U-n[X#5nM U$![a [U5 [X#5nM@f=f)z)Resolve a dotted name to a global object..r)splitpop __import__getattrAttributeError)nameusedfoundns r&_resolver3^sv ::c?D 88A;D t E czA~ &E%E L & t E%E &s A  A10A1c6[[RU5$N)mapr strip)alists r& _strip_spacesr9ls syy%  cUSSn[U5(d0$URS5n[U5n0nUHnSU-nURUSSSS9nURUS SSS9nURUS SS S9nURUS SSS9n[R n XRS 5n U (a [ U 5n Ub![U[[55nU "XVXxS9n O U "XVU5n XU'M U$)zCreate and return formattersr$keys,z formatter_%sformatTN)rawfallbackdatefmtstyle%r class)r ) lenr*r9getr Formatterr3evalvars) r"flistr$formsectnamefsdfsstlr c class_namefs r&rros | V $E u:: KK E % EJ!D( VVHhD4V @ffXydTfBffXwD3f?66(JD46H   \%%g. $A  Hd7m4H"32A"3A4#$ r:cUSSn[U5(d0$URS5n[U5n0n/nUGHAnUSU-nUSnURSS5n[ U[ [ 55nURSS 5n [ U [ [ 55n URS S 5n [ U [ [ 55n U"U 0U D6n X[l S U;aUS n U RU 5 [U5(aU RX5 [U[ RR5(a4URS S5n [U 5(aUR!X45 XU'GMD UHupU R#X>5 M U$![[4a [U5nGNGf=f)zInstall and return handlersr%r<r=z handler_%srD formatterargs()kwargsz{}leveltarget)rEr*r9rFrHrIrr. NameErrorr3r/setLevel setFormatter issubclassr% MemoryHandlerappend setTarget)r"r$hlistr%fixupshandsectionklassfmtrVrXhrYrZts r&rrs zN6 "E u:: KK E % EH F\D() kk+r* $W .E{{64(D$w-(Xt,fd7m, 4 "6 " g G$E JJu  s88 NN:? + eW--;; < <[[2.F6{{ qk*/2 HK  O+ * $UOE $s!F##GGc[RnUHwnURRUnXA;aP[ U[R 5(d/UR [R5 /UlSUl MoMqX%l My g)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) rrootmanager loggerDictr PlaceHolderr\NOTSETr% propagatedisabled)existing child_loggersdisable_existingrklogloggers r&_handle_existing_loggersrwso < *DLL++0023H  MMOM[3&' Z NN;N; ""2& >r"Q&ACxHMEx=Ll"A;v&(2!((!5Ql" OOB  g G$E OOE "#A   #$$ # u::KK$E!%(E!!(.15TX6FGr:c[RR5 [R"[RSS5 [RSS2 g)z!Clear and close existing handlersN)r _handlersclearshutdown _handlerListr:r&rrs;  W))!,-Qr:z^[a-z_][a-z0-9_]*$cX[RU5nU(d[SU-5eg)Nz!Not a valid Python identifier: %rT) IDENTIFIERmatch ValueError)sms r& valid_identr)s)A [a-z]+)://(?P.*)$z ^\s*(\w+)\s*z^\.\s*(\w+)\s*z^\[([^\[\]]*)\]\s*z^\d+$ ext_convert cfg_convert)extcfgcD[U5UlXRlgr5)rconfigr)rrs r&__init__BaseConfigurator.__init__s$V, #'  r:cPURS5nURS5nURU5nUHnUSU-- n[XE5nM U$![a URU5 [XE5nMFf=f![ an[ SU<SU<35nXveSnAff=f)zH Resolve strings to objects using standard import and attribute syntax. r)rzCannot resolve z: N)r*r+importerr-r. ImportErrorr)rrr/r0r1fragr#vs r&resolveBaseConfigurator.resolves wws|xx{ MM$'Ed "1#E0EL&1MM$'#E0E1 a;:B=A>>B B% B  B%c$URU5$)z*Default converter for the ext:// protocol.)rrrs r&rBaseConfigurator.ext_converts||E""r:cUnURRU5nUc[SU-5eX#R5SnURUR 5SnU(aUR RU5nU(aXCR 5SnOjURRU5nU(aHUR 5SnURRU5(dXEnO[U5nXFnU(aX#R5SnO[SU<SU<35eU(aMU$![a XEnNHf=f)z*Default converter for the cfg:// protocol.NzUnable to convert %rrzUnable to convert z at ) WORD_PATTERNrrendrgroups DOT_PATTERN INDEX_PATTERN DIGIT_PATTERNint TypeError)rrrestrdrr2s r&rBaseConfigurator.cfg_converts7    # #D ) 93e;< <>D AHHJqM*A$$**40((*Q-(A**006Ahhjm#1177<< !A+$'H$%D>D$38$&@AA'$,$-+$%F+s;EEEc[U[5(d([U[5(a[U5nXlU$[U[5(d([U[ 5(a[ U5nXlU$[U[ 5(d9[U[5(a$[US5(d[ U5nXlU$[U[5(arURRU5nU(aPUR5nUSnURRUS5nU(aUSn[X5nU"U5nU$)z Convert values to an appropriate type. dicts, lists and tuples are replaced by their converting alternatives. Strings are checked to see if they have a conversion format and are converted if they do. _fieldsprefixNsuffix)r rrrrr}rrrr CONVERT_PATTERNr groupdictvalue_convertersrFr-)rrrrr converterrs r&rBaseConfigurator.converts %00Zt5L5L"5)E!% $ #E>22z%7N7N"5)E!%  E?33E5))'%2K2K#E*E!%  s # #$$**51AKKM8 1155fdC x[F ' 8I%f-E r:c\URS5n[U5(dURU5nUVs0sH!o3S:wdM [U5(dMX1U_M# nnU"S0UD6nURSS5nU(a%UR 5Hupx[ XWU5 M U$s snf)z1Configure an object with a user-supplied factory.rWr)Nr)r+callablerritemssetattr) rrrPkrXrpropsr/rs r&configure_custom!BaseConfigurator.configure_customs JJt {{ QA(.P18, A,!AY,PV 3% ${{} e, - Qs B)B) B)cF[U[5(a [U5nU$)z0Utility function which converts lists to tuples.)r r}rrs r&as_tupleBaseConfigurator.as_tuples eT " "%LE r:rN)rrrrrrecompilerrrrrr staticmethodr,rrrrrrrrrrr:r&rrqsjj!IJO::o.L**./KJJ45MJJx(M J'H(*# D8 r:rc^[T[R[R45(agSSKJn [TU5(agSS/n[ U4SjU55$)z*Check that *obj* implements the Queue API.Tr)Queue put_nowaitrFc3P># UHn[[TUS55v M g7fr5)rr-).0methodobjs r& (_is_queue_like_object.. s)646VT2334s#&)r queuer SimpleQueuemultiprocessing.queuesall)rMPQueueminimal_queue_interfaces` r&_is_queue_like_objectrs\# U%6%67887#w ,U3 646 66r:c`\rSrSrSrSrSrSrSrSr Sr S r SS jr SS jr SS jrS rg)DictConfiguratorizQ Configure logging using a dictionary-like object to describe the configuration. c URnSU;a [S5eUSS:wa[SUS-5eURSS5n0n[R U(aUR SU5nUH}nU[R ;a[SU-5e[R UnXEnUR S S 5nU(a'UR[R"U55 M}M UR S U5n U HnURXZUS 5 M UR SS 5n U (aURU S 5 GOGOURSS 5n [5 UR SU5n U HnURX5X'M UR SU5nUHnURX5X'M UR SU5n/n[U5H!nUR!XE5nXVlXdU'M# UH!nUR!XE5nXVlXdU'M# [R*n [-U R.R0R355nUR55 /nUR S U5n U HnUU;asUR7U5S-nUS-n[9U5n[9U5nUU:a-UUS UU:XaUR)UU5 US- nUU:aM-UR;U5 URXZU5 M [=UUU 5 UR SS 5n U (aURU 5 S S S 5 g ![an [S U-5U eS n A ff=f![an [SU-5U eS n A ff=f![an [S5U eS n A ff=f![an [SU-5U eS n A ff=f![an [SU-5U eS n A ff=f![aEn S[%U R&5;aUR)U5 S n A GMb[S U-5U eS n A ff=f![an [S U-5U eS n A ff=f![an [SU-5U eS n A ff=f![an [S5U eS n A ff=f!,(df  g =f)zDo the configuration.versionz$dictionary doesn't specify a versionr|zUnsupported version: %s incrementalFr%zNo handler found with name %rrYNzUnable to configure handler %rryTzUnable to configure logger %rrkzUnable to configure root loggerr!r$z Unable to configure formatter %rfilterszUnable to configure filter %rz not configured yetr))rrr+rrrFrr\ _checkLevel Exceptionconfigure_loggerconfigure_rootrconfigure_formatterconfigure_filtersortedconfigure_handlerr/r __cause__r`rkr}rlrmr<rrrEr~rw)rrr EMPTY_DICTr%r/handlerhandler_configrYr#ryrkrtr$rdeferredrrrsrrrrs r& configureDictConfigurator.configuresT F "CD D )  !6 9JJK Kjj6  ]]!::j*=$D7#4#44(*36:*;<<A&-&7&7&=G-5^N$2$6$6w$EE$ ' 0 01D1DU1K L %%!**Y ;#D=--dDM4H$ zz&$/:++D$7$*::.H$#O &($ZZ jA &DG+/+C+C?  !#  **Y ;#Dx'$NN4014#'#: #H '*8} ,.'{6E2h> - 4 4Xa[ AFA ,.!-=--dDMB$<)=)9;zz&$/:++D1Y] )A",.248.9#:?@AA%=(*.04*56;<==%:(*2389::%G(*8:>*?@EFGG%D(*57;*<=BCDD%A0C 4DD$OOD11",.248.9#:?@A A%=(*.04*56;<==N%=(*.04*56;<==2%:(*2389::[]s_ASAM<3SN&SN>7SO#S?O=&S;P S"Q0?CSS#R7*S"R2< NNNS N;'N66N;;S> O OOS O:&O55O::S= PPPS Q-(*Q(SQ((Q--S0 R:R  RS R/R**R//S2 S < SS  S Sc0SU;aUSnURU5nU$UR SS5nUR SS5nUR SS5nUR S S5nUR S S5n U(d[ R n O [U5n 0n U bXS 'S U;aU "XVXqS 40U D6nU$U "XVU40U D6nU$![aDnS[U5;aeURS5US'X!S'URU5nSnAU$SnAff=f) z(Configure a formatter from a dictionary.rWz'format'r>rgNrArBrCrDr validate)rrr r+rFrrGr3) rrfactoryrtergdfmtrBcnamer rPrXs r&r$DictConfigurator.configure_formattersA 6>TlG 7..v6J 5**Xt,C::i.DJJw,EJJw-Ezz*d3H%%UOF #%-z"V#3eJ-?J6J 3e6v6 I 7SW,!' 8 4u &t ..v68 I 7sC D9DDcSU;aURU5nU$URSS5n[R"U5nU$)z%Configure a filter from a dictionary.rWr/rU)rrFrFilter)rrrr/s r&r!DictConfigurator.configure_filtersE 6>**62F ::fb)D^^D)F r:cUHUn[U5(d[[USS55(aUnOURSUnURU5 MW g![an[ SU-5UeSnAff=f)z/Add filters to a filterer from a list of names.filterNrzUnable to add filter %r)rr-r addFilterrr)rfiltererrrRfilter_r#s r& add_filtersDictConfigurator.add_filterss{A GA;;(71h+E"F"FG"kk)4Q7G""7+  G !:Q!>?QF GsAA A;'A66A;c 2SU;aURS5nO[R"5nURSS5nURS[RR 5nURS/5nU"U/UQ7SU06nU"U40UD6nXxlU$)Nr respect_handler_levelFlistenerr%)r+r rrr% QueueListenerr:) rrfrXqrhllklassr%r:r"s r&_configure_queue_handler)DictConfigurator._configure_queue_handlers f  7#A Ajj0%8J(8(8(F(FG::j"-!BhBcB$V$#r:c [U5nURSS5nU(aURSUnURSS5nURSS5nSU;a6URS5n[ U5(dUR U5nUnGOaURS5n [ U 5(aU n OUR U 5n [U [RR5(aS U;a[R"US 5US 'S U;aYUS n URS U n [U [R5(dURU5 [S 5eXS 'GO5GO3[U [RR 5(Ga|SU;aUSn [U ["5(a:UR U 5n[ U5(d[SU -5eU"5US'Oe[U [5(a2SU ;a[SU -5eUR%[U 55US'O['U 5(d[SU -5eSU;Ga:USn[U[(5(a8[U[RR*5(d[SU-5eO[U["5(a^UR U5n[U[(5(a7[U[RR*5(d[SU-5eOR[U[5(a/SU;a[SU-5eUR%[U55nO[SU-5e[ U5(d[SU-5eUUS'S U;au/nUS HdnURS Un[U[R5(dURU5 [SU-5eUR-U5 Mf UUS 'O[U [RR.5(aSU;aUR1US5US'OF[U [RR25(aSU;aUR1US5US'[U [RR 5(a"[4R6"UR8U 5nOU nUVs0sH#nUS:wdM [;U5(dMUUU_M% nnU"S0UD6nU(aUR=U5 Ub%UR?[R"U55 U(aURAUU5 URSS5nU(a'URC5Hunn[EUUU5 M U$![an[ SU-5UeSnAff=f![an[ S W -5UeSnAff=f![an[ SW-5UeSnAff=fs snf![a7nS[#U5;aeURS5US'U"S0UD6nSnAGN?SnAff=f)z&Configure a handler from a dictionary.rTNr$zUnable to set formatter %rrYrrWrD flushLevelrZr%ztarget not configured yetzUnable to set target handler %rr zInvalid queue specifier %rr:zInvalid listener specifier %rz)Required handler %r is not configured yetz!Unable to set required handler %rmailhostaddressr)z'stream'streamstrmr)#rr+rrrrrr^rr%r_rr Handlerupdater QueueHandlerr rrrr;r` SMTPHandlerr SysLogHandler functoolspartialr?rr]r\r6rr)rr config_copyrTr#rYrrPr)r,rftnthqspecr<lspecr:rbhnrhrrXrr*rr/rs r&r"DictConfigurator.configure_handlers6l JJ{D1  : KK 5i@  7D)**Y- 6> 4 AA;;LLOGJJw'E U+%!1!1!?!?@@6)+2+>+>vl?S+TF<(v%X#H-![[4R8)"goo>>"MM+6"+,G"HH+-x(&E7#3#3#@#@AAf$"7OE!%-- LL/'{{"+,H5,P"QQ*+#w#E400u,"+,H5,P"QQ*.*?*?U *Lw2599'(Du(LMM'":.E!%..)%1A1A1O1OPP"+,Ke,S"TT Q&eS11'+||E':H)(D99$.x9I9I9W9W$X$X&/0ORW0W&X X't44#50&/0ORW0W&X X'+'<'!>??#++D,I,I5Q(.P118, A,!VAY,P '&v&F     *   OOG//6 7    VW - 3% ${{} ee, - e : "&(1"2389: :8%X()JR)OPVWWXf%Z()Lr)QRXYYZQ 'R( $ZZ1F6N&v&F 'ssW AW.,A-X= X0 X0 X0*X5 W+W&&W+. X 8XX  X-X((X-5 Y6?,Y11Y6cUH%nURURSU5 M' g![an[SU-5UeSnAff=f)z.Add handlers to a logger from a list of names.r%zUnable to add handler %rN)rrrr)rrvr%rhr#s r& add_handlersDictConfigurator.add_handlers{sUA H!!$++j"9!"<= H !;a!?@aG Hs!- A AA cURSS5nUb%UR[R"U55 U(d}URSSHnUR U5 M URSS5nU(aUR X5 URSS5nU(aURX5 ggg)zE Perform configuration which is common to root and non-root loggers. rYNr%r)rFr\rrr%rrVr6)rrvrrrYrhr%rs r&common_logger_config%DictConfigurator.common_logger_configs 7D)   OOG//6 7__Q'$$Q'(zz*d3H!!&3jjD1G  1r:c[R"U5nURXBU5 SUlUR SS5nUbXTlgg)z.Configure a non-root logger from a dictionary.FrpN)rrrYrqrFrp)rr/rrrvrps r&r!DictConfigurator.configure_loggersJ""4( !!&+>JJ{D1  (  !r:cR[R"5nURX1U5 g)z*Configure a root logger from a dictionary.N)rrrY)rrrrks r&rDictConfigurator.configure_roots   " !!$ .ConfigStreamHandleriz Handler for a logging configuration request. It expects a completely new logging configuration and uses fileConfig to install it. cURnURS5n[U5S:XGa3[R"SU5SnURRU5n[U5U:a0X!RU[U5- 5-n[U5U:aM0UR R bUR R U5nUbIURS5nSSKnURU5n[U[5(de[U5 UR R&(a%UR R&R)5 ggg![aK [R"U5n[!U5 Np![a ["R$"5 Nf=ff=f![*anUR,[.:waeSnAgSnAff=f)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>LrNzutf-8) connectionrecvrEstructunpackserververifydecodejsonloadsr rrarrStringIOr' traceback print_excreadysetOSErrorerrno RESET_ERROR)rconnchunkslenrnrfiler#s r&handle*listen..ConfigStreamHandler.handles  ! u:?!==u5a8D OO006Ee*t+ % $U2C(D De*t+{{))5 $ 2 25 9( % W 5 6'#zz%0A#-a#6#66#6&qM{{(( ))--/)-# )6$&;;u#5D6 *4 0#,6 ) 3 3 56 6 77k)* saBF;#AF;*7E#!?F;# F8 FF;F40F81F;3F44F88F;; G$GG$rN)rrrrrr|rrr:r&ConfigStreamHandlerrds  % r:r~c6\rSrSrSrSrS\SSS4SjrSrSr g) $listen..ConfigSocketReceiveriz4 A simple TCP socket-based logging config receiver. r| localhostNc[R"XU4U5 [R SUlSSS5 SUlX@lXPlg!,(df  N"=f)Nrr|)rrrraborttimeoutrsrl)rhostportr"rsrls r&r-listen..ConfigSocketReceiver.__init__sB  ' 'TlG D DLJ K s A Ac^SSKnSnU(dURURR5///UR5up4nU(aUR 5 [ R  URnSSS5 U(dMUR5 g!,(df  N(=f)Nr) selectsocketfilenorhandle_requestrrr server_close)rrrrdwrexs r&serve_until_stopped8listen..ConfigSocketReceiver.serve_until_stoppeds E#]]DKK,>,>,@+A+-r+/<<9 '')]] JJE# e    #]s / B B,)rrsrrl) rrrrrallow_reuse_addressDEFAULT_LOGGING_CONFIG_PORTrrrrr:r&ConfigSocketReceiverrs&   +2M!d ! r:rc2>^\rSrSrUU4SjrSrSrU=r$)listen..Serveri c>[TU]5 XlX lX0lX@l[ R"5Ulgr5) superrrcvrhdlrrrl threadingEventrs)rrrrrlServer __class__s r&rlisten..Server.__init__ s2 &$ ( *III K"*DJr:clURURURURURS9nURS:XaUR SUlURR 5 [R Uq SSS5 UR5 g!,(df  N=f)N)rr"rsrlrr|) rrrrsrlserver_addressrtrr _listenerr)rrks r&runlisten..Server.runsYYDIItyy%)ZZ&*kk3FyyA~"11!4 JJNN "   & & (s B%% B3)rrrrsrl)rrrrrrr __classcell__)rrs@r&rr s + ) )r:r)rrrThread)rrlr~rrs @r&listenrs@(,2,\ 1 :)!!), &T JJr:c[R [(a S[lSqSSS5 g!,(df  g=f)zF Stop the listening server which was created with a call to listen(). r|N)rrrrrr:r& stopListeningr!s&  9IOI s 3 A)NTN).rrvrLrrlogging.handlersr r rrirrq socketserverrrr ECONNRESETrwrr'r3r9rrrwrrrIrrobjectrrrr}rrrrrrr`rarrrr:r&rs"   A#   &AR !:$L/,THn ZZ,bdd 3 fB @T? @#T?#@e_@AvAF66R='R=h #( ,DuKnr: