htdZddlmZddlmZmZmZmZddlm Z ddlm Z m Z m Z m Z GddZdd ZdS)z" Logger wrapper and helper class. ) annotations)AnyIterableMappingSequence) DropEvent)BindableLoggerContext Processor WrappedLoggercteZdZUdZded< d"d Zd#d Zd$dZd$dZd%dZ d&dZ d&dZ d%dZ d'dZ d(d)d!Zd S)*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 _loggerlogger processorsIterable[Processor]contextr c0||_||_||_dSN)r _processors_context)selfrrrs \/var/www/html/web-builder-api.evdpl.com/venv/lib/python3.11/site-packages/structlog/_base.py__init__zBoundLoggerBase.__init__+s  % returnstrcXd|jj|j|jS)Nz#<{}(context={!r}, processors={!r})>)format __class____name__rr)rs r__repr__zBoundLoggerBase.__repr__5s+4;; N #T]D4D   rotherobjectboolcF |j|jkS#t$rYdSwxYw)NF)rAttributeErrorrr$s r__eq__zBoundLoggerBase.__eq__:s8 =EN2 2   55 s   c.|| Sr)r*r)s r__ne__zBoundLoggerBase.__ne__@s;;u%%%%r new_valuesrc p||j|j|jj|jfi|S)zS Return a new logger with *new_values* added to the existing ones. )r!rrrrr-s rbindzBoundLoggerBase.bindCsA~~ L   #DM #DM @ @Z @ @   rkeyscH|}|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. )r0rrr1blkeys runbindzBoundLoggerBase.unbindMs2YY[[ ! !C C   rcn|}|D]}|j|d|S)zs Like :meth:`unbind`, but best effort: missing keys are ignored. .. versionadded:: 18.2.0 N)r0rpopr3s r try_unbindzBoundLoggerBase.try_unbind[s> YY[[ ' 'C KOOC & & & & rc N|j|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 re-used. )rclearr0r/s rnewzBoundLoggerBase.newgs0 ty&&:&&&r method_nameevent str | Noneevent_kwdict[str, Any]'tuple[Sequence[Any], Mapping[str, Any]]cd|j}|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. Arguments: 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`. Nr?r;zLast processor didn't return an appropriate value. Valid return values are a dict, a tuple of (args, kwargs), bytes, or a str.) rcopyupdaterr isinstancerbytes bytearraytupledict ValueError)rr>r?rA event_dictprocmsgs r_process_eventzBoundLoggerBase._process_eventus`-,,..  %%H%%%  "'Jw $ E EDdlKDDJJ j3y"9 : : %="$ $ j% ( (   j$ ' ' "z> ! Z oorNc  ||||\}}t|j||i|S#t$rYdSwxYw)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. Arguments: 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)rPgetattrrr)rr>r?rAargskws r_proxy_to_loggerz BoundLoggerBase._proxy_to_loggerse> **;xHHHD"574<55tBrBB B   44 s47 AA)rr rrrr )rr)r$r%rr&)r-rrr)r1rrr)r>rr?r@rArBrrCr)r>rr?r@rArrr)r" __module__ __qualname____doc____annotations__rr#r*r,r0r6r9r=rPrUr;rrrrs            &&&&             ' ' ' 'GGGGT59#######rr bound_loggerr rr c|jS)aK Return *bound_logger*'s context. The type of *bound_logger* and the type returned depend on your configuration. Arguments: 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)rZs r get_contextr\s $   rN)rZr rr )rX __future__rtypingrrrrstructlog.exceptionsrr r r r rr\r;rrr`s #"""""333333333333******EEEEEEEEEEEENNNNNNNNb!!!!!!r