"hdZddlmZddlZddlmZmZmZmZddl m Z ddlm Z m Z m Z mZejdk\rdd lmZndd lmZGd d Zd d Zy)z" Logger wrapper and helper class. ) annotationsN)AnyIterableMappingSequence) DropEvent)BindableLoggerContext Processor WrappedLogger) )SelfceZdZUdZded< ddZddZddZddZddZ dd Z dd Z dd Z dd Z d ddZy )BoundLoggerBasea Immutable context carrier. Doesn't do any actual logging; examples for useful subclasses are: - the generic `BoundLogger` that can wrap anything, - `structlog.stdlib.BoundLogger`. - `structlog.twisted.BoundLogger`, See also `custom-wrappers`. r _loggerc.||_||_||_yN)r _processors_context)selflogger processorscontexts L/var/www/html/sandstorm/venv/lib/python3.12/site-packages/structlog/_base.py__init__zBoundLoggerBase.__init__3s  % cjd|jjd|jd|jdS)N) __class____name__rr)rs r__repr__zBoundLoggerBase.__repr__=s64>>**+9T]]4E]SWScScRffhiircT |j|jk(S#t$rYywxYw)NF)rAttributeErrorrothers r__eq__zBoundLoggerBase.__eq__@s, ==ENN2 2  s  ''c&|j| Sr)r(r&s r__ne__zBoundLoggerBase.__ne__Fs;;u%%%rc |j|j|j|jj|jfi|S)zS Return a new logger with *new_values* added to the existing ones. )r!rrrr new_valuess rbindzBoundLoggerBase.bindIsB~~ LL    #DMM # #DMM @Z @  rcN|j}|D]}|j|=|S)z Return a new logger with *keys* removed from the context. Raises: KeyError: If the key is not part of the context. )r.rrkeysblkeys runbindzBoundLoggerBase.unbindSs1YY[ !C C  ! rcl|j}|D]}|jj|d |S)zs Like :meth:`unbind`, but best effort: missing keys are ignored. .. versionadded:: 18.2.0 N)r.rpopr0s r try_unbindzBoundLoggerBase.try_unbind`s7 YY[ 'C KKOOC & ' rc Z|jj|jdi|S)z Clear context and binds *new_values* using `bind`. Only necessary with dict implementations that keep global state like those wrapped by `structlog.threadlocal.wrap_dict` when threads are reused. )rclearr.r,s rnewzBoundLoggerBase.newls( tyy&:&&rcX|jj}|jdi||||d<|jD]}||j||}t |t ttfr|fifSt |tr|St |trd|fSd}t|)a Combines creates an ``event_dict`` and runs the chain. Call it to combine your *event* and *context* into an event_dict and process using the processor chain. Args: method_name: The name of the logger method. Is passed into the processors. event: The event -- usually the first positional argument to a logger. event_kw: Additional event keywords. For example if someone calls ``log.info("foo", bar=42)``, *event* would to be ``"foo"`` and *event_kw* ``{"bar": 42}``. Raises: structlog.DropEvent: if log entry should be dropped. ValueError: if the final processor doesn't return a str, bytes, bytearray, tuple, or a dict. Returns: `tuple` of ``(*args, **kw)`` .. note:: Despite underscore available to custom wrapper classes. See also `custom-wrappers`. .. versionchanged:: 14.0.0 Allow final processor to return a `dict`. .. versionchanged:: 20.2.0 Allow final processor to return `bytes`. .. versionchanged:: 21.2.0 Allow final processor to return a `bytearray`. eventr9zLast processor didn't return an appropriate value. Valid return values are a dict, a tuple of (args, kwargs), bytes, or a str.) rcopyupdaterr isinstancestrbytes bytearraytupledict ValueError)r method_namer=event_kw event_dictprocmsgs r_process_eventzBoundLoggerBase._process_eventzsZ--,,.  %H%  "'Jw $$ EDdllKDJ E j3y"9 :="$ $ j% (  j$ 'z> ! Z orNc  |j|||\}}t|j||i|S#t$rYywxYw)a Run processor chain on event & call *method_name* on wrapped logger. DRY convenience method that runs :func:`_process_event`, takes care of handling :exc:`structlog.DropEvent`, and finally calls *method_name* on :attr:`_logger` with the result. Args: method_name: The name of the method that's going to get called. Technically it should be identical to the method the user called because it also get passed into processors. event: The event -- usually the first positional argument to a logger. event_kw: Additional event keywords. For example if someone calls ``log.info("foo", bar=42)``, *event* would to be ``"foo"`` and *event_kw* ``{"bar": 42}``. .. note:: Despite underscore available to custom wrapper classes. See also `custom-wrappers`. N)rLgetattrrr)rrGr=rHargskws r_proxy_to_loggerz BoundLoggerBase._proxy_to_loggersN: **;xHHD"574<<5tBrB B  s14 AA)rr rzIterable[Processor]rr )returnrA)r'objectrRbool)r-rrRr)r1rArRr)rGrAr= str | NonerHzdict[str, Any]rRz'tuple[Sequence[Any], Mapping[str, Any]]r)rGrAr=rUrHrrRr)r" __module__ __qualname____doc____annotations__rr#r(r*r.r4r7r;rLrQr9rrrrs   (   j &    'DD'1D=KD 0DN59!!'1!FI! !rrc|jS)aD Return *bound_logger*'s context. The type of *bound_logger* and the type returned depend on your configuration. Args: bound_logger: The bound logger whose context you want. Returns: The *actual* context from *bound_logger*. It is *not* copied first. .. versionadded:: 20.2.0 )r) bound_loggers r get_contextr\s   r)r[r rRr )rX __future__rsystypingrrrrstructlog.exceptionsrr r r r version_infortyping_extensionsrr\r9rrrcsI # 33*EEw&FFR!r