h' d Z ddlmZ ddlZddlZddlmZmZmZm Z ddl
m Z ddl m
Z
ddlmZmZ ddlmZ d d
lmZ d d lmZ d d lmZ d d
lmZ d dlm Z m Z G d de Z G d d Z e e
fZ!d#dZ" G d d Z# G d de Z ee G d d Z$ ee G d d Z%d$d Z& G d! d" Z'dS )%z
Processors and tools specific to the `Twisted `_
networking engine.
See also :doc:`structlog's Twisted support `.
) annotationsN)AnyCallableSequenceTextIOlog)Failure) ILogObservertextFromEventDict) implementer )BoundLoggerBase)_BUILTIN_DEFAULT_PROCESSORS)until_not_interrupted) JSONRenderer) EventDict
WrappedLoggerc & e Zd ZdZd
d dZd
d d ZdS ) BoundLoggera
Twisted-specific version of `structlog.BoundLogger`.
Works exactly like the generic one except that it takes advantage of
knowing the logging methods in advance.
Use it like::
configure(
wrapper_class=structlog.twisted.BoundLogger,
)
Nevent
str | Nonekwr returnc | j d|fi |S )zG
Process event and call ``log.msg()`` with the result.
msg_proxy_to_loggerselfr r s ^/var/www/html/web-builder-api.evdpl.com/venv/lib/python3.11/site-packages/structlog/twisted.pyr zBoundLogger.msg/ ! %t$UE88R888 c | j d|fi |S )zG
Process event and call ``log.err()`` with the result.
errr r s r! r% zBoundLogger.err5 r" r# N)r r r r r r )__name__
__module__ __qualname____doc__r r% r# r! r r sP 9 9 9 9 9 9 9 9 9 9 9 9r# r c e Zd ZdZddZdS )
LoggerFactoryz
Build a Twisted logger when an *instance* is called.
>>> from structlog import configure
>>> from structlog.twisted import LoggerFactory
>>> configure(logger_factory=LoggerFactory())
argsr r r c t S )z
Positional arguments are silently ignored.
:rvalue: A new Twisted logger.
.. versionchanged:: 0.4.0
Added support for optional positional arguments.
r )r r. s r! __call__zLoggerFactory.__call__E s
r# N)r. r r r r' r( r) r* r0 r+ r# r! r- r- < s2 r# r- eventDictr r tuple[Any, Any, EventDict]c | dd }| dd }| dd }t |t r$t |t rt d |r$t |t rt d t |t st |t r|pd}|}t |t r|}|s%t j dk rt }t |t r$t |t st | }||| fS ) z
Removes all possible *_why*s and *_stuff*s, analyzes exc_info and returns
a tuple of ``(_stuff, _why, eventDict)``.
**Modifies** *eventDict*!
_stuffN_whyr z3Both _stuff and event contain an Exception/Failure.z!Both `_why` and `event` supplied.error)NNN) pop
isinstance _FAIL_TYPES
ValueErrorstrsysexc_infor
BaseException)r2 r5 r6 r s r! _extractStuffAndWhyr@ T sD ]]8T
*
*F == & &D MM'4 ( (E&+&& P:e[+I+I PNOOO >
5#&& ><=== fk * * z%/M/M w% clnn(::: &-(( !FG1L1L ! 4 ""r# c * e Zd ZdZd
dZdd
Zdd Zd S ) ReprWrappera
Wrap a string and return it as the ``__repr__``.
This is needed for ``twisted.python.log.err`` that calls `repr` on
``_stuff``:
>>> repr("foo")
"'foo'"
>>> repr(ReprWrapper("foo"))
'foo'
Note the extra quotes in the unwrapped example.
stringr< r Nonec || _ d S r& rC )r rC s r! __init__zReprWrapper.__init__ s
r# otherobjectboolc L t || j o| j |j k S )z5
Check for equality, just for tests.
)r9 __class__rC )r rH s r! __eq__zReprWrapper.__eq__ s&
udn - - M$+ 2M
r# c | j S r& rF )r s r! __repr__zReprWrapper.__repr__ s
{r# N)rC r< r rD )rH rI r rJ )r r< )r' r( r) r* rG rM rO r+ r# r! rB rB y sZ
r# rB c e Zd ZdZd d
Zd S )
r a
Behaves like `structlog.processors.JSONRenderer` except that it formats
tracebacks and failures itself if called with ``err()``.
.. note::
This ultimately means that the messages get logged out using ``msg()``,
and *not* ``err()`` which renders failures in separate lines.
Therefore it will break your tests that contain assertions using
`flushLoggedErrors
`_.
*Not* an adapter like `EventAdapter` but a real formatter. Also does *not*
require to be adapted using it.
Use together with a `JSONLogObserverWrapper`-wrapped Twisted logger like
`plainJSONStdOutLogger` for pure-JSON logs.
loggerr namer< r2 r r $tuple[Sequence[Any], dict[str, Any]]c t | \ }}}|dk rH||d< t |t r-| d |d< | n||d< t t
j | ||| fddifS )Nr% r verbose)detail exception
_structlogT)r@ r9 r
getTraceback cleanFailurerB GenericJSONRendererr0 r rQ rR r2 r5 r6 s r! r0 zJSONRenderer.__call__ s #6i"@"@ i 5==!%Ig &'**
&)/)<)`_
.. versionadded:: 0.2.0
observerr r rD c || _ d S r& ) _observer)r rk s r! rG z JSONLogObserverWrapper.__init__ s
!r# r2 r r< c d|vr@t j t | | d d f|d< d|d< | | S )NrX system)r ro messageT)jsondumpsr getrm rg s r! r0 z JSONLogObserverWrapper.__call__ sq y ( (
!2 %" " #,--"9"9 $Ii '+Il #~~i(((r# N)rk r r rD )r2 r r r< rh r+ r# r! rj rj sF " " " ") ) ) ) ) )r# rj c N t t t j S )a
Return a logger that writes only the message to stdout.
Transforms non-`JSONRenderer` messages to JSON.
Ideal for JSONifying log entries from Twisted plugins and libraries that
are outside of your control::
$ twistd -n --logger structlog.twisted.plainJSONStdOutLogger web
{"event": "Log opened.", "system": "-"}
{"event": "twistd 13.1.0 (python 2.7.3) starting up.", "system": "-"}
{"event": "reactor class: twisted...EPollReactor.", "system": "-"}
{"event": "Site starting on 8080", "system": "-"}
{"event": "Starting factory ", ...}
...
Composes `PlainFileLogObserver` and `JSONLogObserverWrapper` to a usable
logger.
.. versionadded:: 0.2.0
)rj r^ r= stdoutr+ r# r! plainJSONStdOutLoggerrv s , ""6sz"B"B C CCr# c & e Zd ZdZ dddZddZdS ) EventAdapterax
Adapt an ``event_dict`` to Twisted logging system.
Particularly, make a wrapped `twisted.python.log.err
`_
behave as expected.
Arguments:
dictRenderer:
Renderer that is used for the actual log message. Please note that
structlog comes with a dedicated `JSONRenderer`.
**Must** be the last processor in the chain and requires a *dictRenderer*
for the actual formatting as an constructor argument in order to be able to
fully support the original behaviors of ``log.msg()`` and ``log.err()``.
N dictRenderer5Callable[[WrappedLogger, str, EventDict], str] | Noner rD c . |p t d | _ d S )N)r
_dictRenderer)r ry s r! rG zEventAdapter.__init__3 s
* L-H-Lr# rQ r rR r< r2 r r c |dk r4t | \ }}}||d< d|| ||| dfS | ||| S )Nr% r r+ )r5 r6 )r@ r} r\ s r! r0 zEventAdapter.__call__: sx 5==
':)&D&D #FD)!%Ig $ . .vtY G G
!!&$ :::r# r& )ry rz r rD )rQ r rR r< r2 r r r rh r+ r# r! rx rx sU * M M M M M; ; ; ; ; ;r# rx )r2 r r r3 )r rj )(r*
__future__r rq r= typingr r r r twisted.pythonr twisted.python.failurer
twisted.python.logr r zope.interfacer
_baser _configr _utilsr
processorsr r[ r r r r- r? r: r@ rB r^ rj rv rx r+ r# r! r s # " " " " "
2 2 2 2 2 2 2 2 2 2 2 2 * * * * * * > > > > > > > > & & & & & & " " " " " " 0 0 0 0 0 0 ) ) ) ) ) ) ; ; ; ; ; ; , , , , , , , ,9 9 9 9 9/ 9 9 98 * g& "# "# "# "#J <-
-
-
-
-
& -
-
-
`
\+ + + + + + + +6
\ ) ) ) ) ) ) ) )FD D D D2-; -; -; -; -; -; -; -; -; -;r#