o
0i @ sN d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
m Z m Z dZ
ejZdad+ddZdd Zd
d Zd d
Zdd Zdd Zdd Zdd ZedejZdd Z G dd de Z G dd d e e Z G d d d e!e Z"G d d d e#e Z$G d!d" d"e Z%G d#d$ d$e%Z&e&Z'd%d& Z(e
dfd'd(Z)d)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-2019 Vinay Sajip. All Rights Reserved.
To use, simply 'import logging' and log away!
N)ThreadingTCPServerStreamRequestHandleriF# Tc C s ddl }t| |jr
| }n ||}t| dr || n t|}|j| |d t |}t
zt t
||}t||| W t
dS t
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 Nreadline)encoding) configparser
isinstanceZRawConfigParserZ ConfigParserhasattrZ read_fileio
text_encodingread_create_formatterslogging _acquireLock_clearExistingHandlers_install_handlers_install_loggers _releaseLock)Zfnamedefaultsdisable_existing_loggersr r cp
formattershandlers r 5/opt/alt/python310/lib64/python3.10/logging/config.py
fileConfig3 s
r c C sh | d} | d}t|}| D ]!}|d | }zt||}W q ty1 t| t||}Y qw |S )z)Resolve a dotted name to a global object..r )splitpop
__import__getattrAttributeError)nameusedfoundnr r r _resolveV s
r% c C s t tj| S N)mapstrstrip)Zalistr r r
_strip_spacesd s r* c C s | d d }t |s i S |d}t|}i }|D ];}d| }| j|dddd}| j|d ddd}| j|d
dd d}tj}| | d } | rJt| }||||}
|
||< q|S )
z Create and return formattersr keys,z formatter_%sformatTN)rawfallbackdatefmtstyle%class)lenr r* getr
Formatterr% ) r Zflistr ZformZsectnameZfsZdfsZstlc
class_namefr r r r g s$
r c
C s^ | d d }t |s i S |d}t|}i }g }|D ]}| d| }|d }|dd}z t|tt}W n ttfyE t |}Y nw |dd } t| tt} |d
d }
t|
tt}
|| i |
} || _
d |v rw|d } | | t |r| || t
|tjjr|d
d}
t |
r|| |
f | ||< q|D ] \} }| || q|S )zInstall and return handlersr r+ r, z
handler_%sr3 formatter args()kwargsz{}leveltarget)r4 r r* r5 evalvarsr
r NameErrorr% r! setLevel setFormatter
issubclassr
MemoryHandlerappendZ setTarget)r r hlistr Zfixupshandsectionklassfmtr< r> hr? r@ tr r r r } sF
r c C sT t j}| D ]"}|jj| }||v r$t|t js#|t j g |_d|_ q||_
qdS )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 Z PlaceHolderrD ZNOTSETr propagatedisabled)existing
child_loggersdisable_existingrP logloggerr r r _handle_existing_loggers s rZ c C s | d d }| d}tt|}|d | d }tj}|}d|v r,|d }|| |jdd D ]}|| q3|d } t | rX| d} t| } | D ] }
|
||
qNt|j j
} | g } |D ]}| d | }|d
}
|jd d d
}t|
}|
| v r| |
d }|
d }t |}t | }||k r| | d| |kr| | | |d 7 }||k s| |
d|v r|d }|| |jdd D ]}|| q||_d|_|d } t | r| d} t| } | D ] }
|
||
qqht| | | dS )zCreate and install loggersloggersr+ r, rP Z logger_rootr? Nr z logger_%squalnamerS )r/ r r )r listr* remover
rP rD r
removeHandlerr4
addHandlerrQ rR r+ sortZgetint getLoggerindexrH rS rT rZ )r r rW ZllistrK rP rX r? rN rI rJ rU rV ZqnrS rY iprefixedpflen num_existingr r r r sh
r c C s. t j t t jdd t jdd= dS )z!Clear and close existing handlersN)r
_handlersclearZshutdownZ _handlerListr r r r r s
r z^[a-z_][a-z0-9_]*$c C s t | }|s
td| dS )Nz!Not a valid Python identifier: %rT)
IDENTIFIERmatch
ValueError)smr r r valid_ident s
rp c @ s" e Zd ZdZdddZdd ZdS ) ConvertingMixinz?For ConvertingXXX's, this mixin class provides common functionsTc C sB | j |}||ur |r|| |< t|tttfv r | |_||_|S r& ) configuratorconverttypeConvertingDictConvertingListConvertingTupleparentkey)selfry valuereplaceresultr r r convert_with_key$ s
z ConvertingMixin.convert_with_keyc C s0 | j |}||urt|tttfv r| |_|S r& )rr rs rt ru rv rw rx )rz r{ r} r r r rs 0 s
zConvertingMixin.convertN)T)__name__
__module__ __qualname____doc__r~ rs r r r r rq ! s
rq c @ s, e Zd ZdZdd Zd ddZd ddZdS )
ru z A converting dictionary wrapper.c C t | |}| ||S r& )dict __getitem__r~ rz ry r{ r r r r E zConvertingDict.__getitem__Nc C s t | ||}| ||S r& )r r5 r~ rz ry defaultr{ r r r r5 I s zConvertingDict.getc C s t | ||}| j||ddS NF)r| )r r r~ r r r r r M s zConvertingDict.popr& )r r r r r r5 r r r r r ru B s
ru c @ s" e Zd ZdZdd ZdddZdS ) rv zA converting list wrapper.c C r r& )r^ r r~ r r r r r S r zConvertingList.__getitem__c C s t | |}| |S r& )r^ r rs )rz idxr{ r r r r W s
zConvertingList.popN)r )r r r r r r r r r r rv Q s rv c @ e Zd ZdZdd ZdS )rw zA converting tuple wrapper.c C s t | |}| j||ddS r )tupler r~ r r r r r ] s zConvertingTuple.__getitem__N)r r r r r r r r r rw [ s rw c @ s e Zd ZdZedZedZedZedZ edZ
ddd Z e e
Zd
d Zd d
Zdd Zdd Zdd Zdd Zdd ZdS )BaseConfiguratorzI
The configurator base class which defines some useful defaults.
z%^(?P[a-z]+)://(?P.*)$z ^\s*(\w+)\s*z^\.\s*(\w+)\s*z^\[\s*(\w+)\s*\]\s*z^\d+$ ext_convert cfg_convert)ZextZcfgc C s t || _| | j_d S r& )ru configrr )rz r r r r __init__v s
zBaseConfigurator.__init__c C s | d}|d}z-| |}|D ]"}|d| 7 }zt||}W q ty4 | | t||}Y qw |W S tyY t dd \}}td||f }|||_ |_
|w )z`
Resolve strings to objects using standard import and attribute
syntax.
r r r] NzCannot resolve %r: %s) r r importerr r ImportErrorsysexc_inform __cause__
__traceback__) rz rn r! r" r# Zfragetbvr r r resolvez s&
zBaseConfigurator.resolvec C s
| |S )z*Default converter for the ext:// protocol.)r rz r{ r r r r s
z BaseConfigurator.ext_convertc C s |}| j |}|du rtd| || d }| j| d }|r|| j|}|r6|| d }n1| j|}|rg| d }| j|sO|| }nz
t |}|| }W n
t
yf || }Y nw |rr|| d }ntd||f |s%|S )z*Default converter for the cfg:// protocol.NzUnable to convert %rr zUnable to convert %r at %r) WORD_PATTERNrl rm endr groups DOT_PATTERN
INDEX_PATTERN
DIGIT_PATTERNint TypeError)rz r{ restro dr r$ r r r r s8
z BaseConfigurator.cfg_convertc C s t |tst |trt|}| |_|S t |ts&t |tr&t|}| |_|S t |ts>t |tr>t|ds>t|}| |_|S t |t ri| j
|}|ri| }|d }| j
|d}|ri|d }t| |}||}|S )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 ru r rr rv r^ rw r r r( CONVERT_PATTERNrl groupdictvalue_convertersr5 r )rz r{ ro r r Z converterr r r r rs s6
zBaseConfigurator.convertc sn d}t|s| |} dd} fdd D }|di |}|r5| D ]
\}}t||| q*|S )z1Configure an object with a user-supplied factory.r= r Nc i | ] }t |r| | qS r rp .0kr r r
z5BaseConfigurator.configure_custom..r )r callabler itemssetattr)rz r r7 propsr> r} r! r{ r r r configure_custom s
z!BaseConfigurator.configure_customc C s t |tr t|}|S )z0Utility function which converts lists to tuples.)r r^ r r r r r as_tuple s
zBaseConfigurator.as_tupleN)r r r r recompiler r r r r r staticmethodr r r r r r rs r r r r r r r b s$
" r c @ s^ e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dddZ
dddZ dddZ dS )DictConfiguratorz]
Configure logging using a dictionary-like object to describe the
configuration.
c C s | j }d|vr td|d dkrtd|d |dd}i }t z |r|d|}|D ];}|tjvr>td| ztj| }|| }|d d
}|rX|t| W q1 t yl } ztd | | d
} ~ ww |d |}
|
D ] }z |
||
| d
W qu t y } ztd| | d
} ~ ww |dd
} | rz | | d
W n t y } ztd| d
} ~ ww np|dd
} t |d|}
|
D ] }z |
|
| |
|< W q t y } ztd| | d
} ~ ww |d|}|D ]!}z | || ||< W q t y } ztd| | d
} ~ ww |d|}g }t|D ]<}z| || }||_|||< W q# t y_ } z dt| jv rM|| ntd | | W Y d
} ~ q#d
} ~ ww |D ]'}z| || }||_|||< W qb t y } ztd | | d
} ~ ww tj} t| jj }| g }|d |}
|
D ]^}||v r||d }|d }t |}t |}||k r|| d
| |kr||| |d7 }||k s| | z |
||
| W q t y } ztd| | d
} ~ ww t ||| |dd
} | r9z| | W n' t y* } ztd| d
} ~ ww W t d
S W t d
S W t d
S W t d
S t w )zDo the configuration.versionz$dictionary doesn't specify a versionr] zUnsupported version: %s incrementalFr z No handler found with name %rr? Nz Unable to configure handler %rr[ Tz Unable to configure logger %rrP z Unable to configure root loggerr r z Unable to configure formatter %rfiltersz Unable to configure filter %rtarget not configured yetr ) r rm r r
r r5 ri rD _checkLevel Exceptionconfigure_loggerconfigure_rootr configure_formatterconfigure_filtersortedconfigure_handlerr! r( r rH rP r^ rQ rR r+ rb rd r4 r_ rZ r )rz r r Z
EMPTY_DICTr r! handlerZhandler_configr? r r[ rP rW r r ZdeferredrU rV re rf rg rh r r r configure sB
x v zDictConfigurator.configurec
C s d|v r;|d }z| |}W |S ty: } z dt|vr |d|d< ||d< | |}W Y d}~|S d}~ww |dd}|dd}|dd}|d d}|sYtj} nt|} d
|v rl| ||||d
}|S | |||}|S ) z(Configure a formatter from a dictionary.r= z'format'r- rM Nr0 r1 r2 r3 Zvalidate)r r r( r r5 r
r6 r% )
rz r factoryr} terM Zdfmtr1 cnamer7 r r r r s4 z$DictConfigurator.configure_formatterc C s0 d|v r | |}|S |dd}t|}|S )z%Configure a filter from a dictionary.r= r! r; )r r5 r
ZFilter)rz r r} r! r r r r s
z!DictConfigurator.configure_filterc C L |D ]!}z | | jd | W q ty# } ztd| |d}~ww dS )z/Add filters to a filterer from a list of names.r zUnable to add filter %rN)Z addFilterr r rm )rz Zfiltererr r9 r r r r add_filters z DictConfigurator.add_filtersc
sb t } dd}|r)z | jd | }W n ty( } ztd| |d}~ww dd} dd}d v rJ d}t|sG| |}|}nt d} | | }
t|
tj j
rd v rz | jd
d } t | tj sx
| td | d < W n> ty } z td d |d}~ww t|
tj jrd
v r| d
d
< nt|
tj jrd v r| d d< |
} dd} fdd D }
z |di |
}W n' ty } zdt|vr |
d|
d< |di |
}W Y d}~nd}~ww |r|| |dur|t| |r | || | r/| D ] \}}t||| q#|S )z&Configure a handler from a dictionary.r: Nr zUnable to set formatter %rr? r r= r3 r@ r r z Unable to set target handler %rZmailhostZaddressr c r r r r r r r r r z6DictConfigurator.configure_handler..z'stream'streamZstrmr )r r r r rm r r rF r
r rG r ZHandlerupdater Z SMTPHandlerr Z
SysLogHandlerr( rE rD r r r r )rz r Z config_copyr: r r? r r7 r r rL Zthr r> r} r r! r{ r r r r s
z"DictConfigurator.configure_handlerc C r )z.Add handlers to a logger from a list of names.r zUnable to add handler %rN)ra r r rm )rz rY r rN r r r r add_handlers r z DictConfigurator.add_handlersFc C s | dd}|dur|t| |sA|jdd D ]}|| q| dd}|r1| || | dd}|rC| || dS dS dS )zU
Perform configuration which is common to root and non-root loggers.
r? Nr r )r5 rD r
r r r` r r )rz rY r r r? rN r r r r r common_logger_config s z%DictConfigurator.common_logger_configc C s@ t |}| ||| d|_|dd}|dur ||_dS dS )z.Configure a non-root logger from a dictionary.FrS N)r
rc r rT r5 rS )rz r! r r rY rS r r r r s
z!DictConfigurator.configure_loggerc C s t }| ||| dS )z*Configure a root logger from a dictionary.N)r
rc r )rz r r rP r r r r " s z DictConfigurator.configure_rootN)F)
r r r r r r r r r r r r r r r r r r s $ ?
r c C s t | dS )z%Configure logging using a dictionary.N)dictConfigClassr r r r r
dictConfig) s r c sD G dd dt }G dd dt}G fdddtj ||| |S )au
Start up a socket server on the specified port, and listen for new
configurations.
These will be sent as a file suitable for processing by fileConfig().
Returns a Thread object on which you can call start() to start the server,
and which you can join() when appropriate. To stop the server, call
stopListening().
Use the ``verify`` argument to verify any bytes received across the wire
from a client. If specified, it should be a callable which receives a
single argument - the bytes of configuration data received across the
network - and it should return either ``None``, to indicate that the
passed in bytes could not be verified and should be discarded, or a
byte string which is then passed to the configuration machinery as
normal. Note that you can return transformed bytes, e.g. by decrypting
the bytes passed in.
c @ r )z#listen..ConfigStreamHandlerz
Handler for a logging configuration request.
It expects a completely new logging configuration and uses fileConfig
to install it.
c S s\ z| j }|d}t|dkrtd|d }| j |}t||k r4|||t| }t||k s#| jjdur@| j|}|dur|d}zddl}| |}t
|t sZJ t | W n" t
y t|}zt| W n
t
y~ t Y nw Y nw | jjr| jj W dS W dS W dS ty } z
|jtkr W Y d}~dS d}~ww )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)Z
connectionZrecvr4 structZunpackserververifydecodejsonloadsr r r r r StringIOr traceback print_excreadysetOSErrorerrno RESET_ERROR)rz ZconnchunkZslenr r filer r r r handleI sJ
z*listen..ConfigStreamHandler.handleN)r r r r r r r r r ConfigStreamHandlerB s r c @ s0 e Zd ZdZdZdedddfddZdd ZdS ) z$listen..ConfigSocketReceiverzD
A simple TCP socket-based logging config receiver.
r] Z localhostNc S s> t | ||f| t d| _t d| _|| _|| _d S )Nr r] ) r r r
r abortr timeoutr r )rz Zhostportr r r r r r r w s
z-listen..ConfigSocketReceiver.__init__c S sb dd l }d}|s+| | j gg g | j\}}}|r | t | j}t |r| d S )Nr )
selectZsocketfilenor Zhandle_requestr
r r r Z server_close)rz r r ZrdZwrZexr r r serve_until_stopped s
z8listen..ConfigSocketReceiver.serve_until_stopped)r r r r Zallow_reuse_addressDEFAULT_LOGGING_CONFIG_PORTr r r r r r ConfigSocketReceiverp s
r c s& e Zd Z fddZdd Z ZS )zlisten..Serverc s4 t | || _|| _|| _|| _t | _d S r& ) superr rcvrhdlrr r threadingZEventr )rz r r r r )Server __class__r r r s z listen..Server.__init__c S sZ | j | j| j| j| jd}| jdkr|jd | _| j t |a t
| d S )N)r r r r r r] ) r r r r r Zserver_addressr r
r _listenerr r )rz r r r r run s
zlisten..Server.run)r r r r r
__classcell__r r )r r r s r )r r r ZThread)r r r r r r r listen. s . r c C s> t ztrdt_daW t dS W t dS t w )zN
Stop the listening server which was created with a call to listen().
r] N)r
r r r r r r r r
stopListening s r )NTN)+r r r r
Zlogging.handlersr r r r r Z socketserverr r r Z
ECONNRESETr r r r% r* r r rZ r r r Irk rp objectrq r ru r^ rv r rw r r r r r r r r r r sJ
#&W!
B z