o ADi@sdZddlmZddlZddlmZmZmZmZddl m Z ddlm Z m Z m Z mZejdkr6dd lmZndd lmZGd d d ZdddZdS)z" Logger wrapper and helper class. ) annotationsN)AnyIterableMappingSequence) DropEvent)BindableLoggerContext Processor WrappedLogger) )Selfc@seZdZUdZded< d-d d Zd.d dZd/ddZd/ddZd0ddZ d1ddZ d1ddZ d0d d!Z d2d(d)Z *d3d4d+d,Zd*S)5BoundLoggerBasea 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 cCs||_||_||_dSN)r _processors_context)selfrrrrH/var/www/Datamplify/venv/lib/python3.10/site-packages/structlog/_base.py__init__3s zBoundLoggerBase.__init__returnstrcCs d|jjd|jd|jdS)N) __class____name__rr)rrrr__repr__=s zBoundLoggerBase.__repr__otherobjectboolcCs$z|j|jkWStyYdSw)NF)rAttributeErrorrr#rrr__eq__@s  zBoundLoggerBase.__eq__cCs || Sr)r(r'rrr__ne__Fs zBoundLoggerBase.__ne__ new_valuesrrcKs$||j|j|jj|jfi|S)zS Return a new logger with *new_values* added to the existing ones. )r rrrrr*rrrbindIs zBoundLoggerBase.bindkeyscGs|}|D]}|j|=q|S)z Return a new logger with *keys* removed from the context. Raises: KeyError: If the key is not part of the context. )r,rrr-blkeyrrrunbindSs zBoundLoggerBase.unbindcGs$|}|D] }|j|dq|S)zs Like :meth:`unbind`, but best effort: missing keys are ignored. .. versionadded:: 18.2.0 N)r,rpopr.rrr try_unbind`szBoundLoggerBase.try_unbindcKs|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 reused. Nr)rclearr,r+rrrnewls zBoundLoggerBase.new method_nameevent str | Noneevent_kwdict[str, Any]'tuple[Sequence[Any], Mapping[str, Any]]cCs|j}|jdi||dur||d<|jD] }||j||}qt|tttfr/|fifSt|t r6|St|t r?d|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`. Nr7rzLast 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)rr6r7r9 event_dictprocmsgrrr_process_eventzs -    zBoundLoggerBase._process_eventNcKs@z||||\}}t|j||i|WStyYdSw)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)rGgetattrrr)rr6r7r9argskwrrr_proxy_to_loggers  z BoundLoggerBase._proxy_to_logger)rr rrrr )rr)r#r$rr%)r*rrr)r-rrr)r6rr7r8r9r:rr;r)r6rr7r8r9rrr)r! __module__ __qualname____doc____annotations__rr"r(r)r,r1r3r5rGrKrrrrrs      Gr bound_loggerr rr cCs|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)rPrrr get_contextsrQ)rPr rr )rN __future__rsystypingrrrrstructlog.exceptionsrr r r r version_infortyping_extensionsrrQrrrrs    J